Flexible character LCD library for AVR Microcontrollers
Collin J. Doering
3a38d3ff18
Use README.md as the front page of the documentation generated by doxygen. Signed-off-by: Collin J. Doering <collin.doering@rekahsoft.ca> |
||
---|---|---|
.gitignore | ||
ansi_escapes.h | ||
doxygen.conf | ||
lcd_instr.h | ||
lcdLib.c | ||
lcdLib.h | ||
lcdLibConfig.h | ||
LICENSE | ||
README.md |
Flexible character LCD library for AVR Microcontrollers
Features
- Supports both 8-bit and 4-bit modes of LCD's
- Configurable, so it should work on most devices, albeit with some tweaking
- Read/Write the character LCD
- Control the display using ANSI and ASCII escapes
- Read/Write custom characters to memory and/or the LCD display (not fully implemented)
Tools
This project wouldn't be possible without the following great open source tools:
- AVR-GCC, AVR-libc, and AVR-binutils which form the compiler toolchain that makes open source development for AVR microcontrollers possible.
- avrdude to do in system programming of the AVR microcontrollers
- doxygen to generate documentation.
- Gnu Emacs, because how else would I enter text?
License
Code licensed under GPLv3. Please see the LICENSE file for full details.
Usage
Clone this repository and modify lcdLibConfig.h to your needs. See the documentation for more details.
git clone http://git.rekahsoft.ca/lcdLib.git
doxygen doxygen.conf # If you want to generate offline documentation
Issues
- No interface is given to read/write custom characters, though it can be done manually using
the lower level plumbing function
writeLCDInstr
. - No examples of using the library are currently given but do exist in the git history. They have been split out into their own repository's and soon will be re-added as git submodules. Util that time look into the git history.
Road Map
- Add support for reading/writing custom characters to memory/display
- Add examples projects utilizing lcdLib as git submodules
- Finish documenting functions
- Put the doxygen generated documentation for this library online