Update README.md and doxygen front page
Use README.md as the front page of the documentation generated by doxygen. Signed-off-by: Collin J. Doering <collin.doering@rekahsoft.ca>
This commit is contained in:
parent
28a71ff8e8
commit
3a38d3ff18
40
README.md
40
README.md
@ -3,24 +3,58 @@
|
||||
* [Features](#features)
|
||||
* [Tools](#tools)
|
||||
* [License](#license)
|
||||
* [Building](#building)
|
||||
* [Usage](#usage)
|
||||
* [Issues](#issues)
|
||||
* [Road Map](#road-map)
|
||||
|
||||
## Features <a name="features"></a>
|
||||
|
||||
- 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 <a name="tools"></a>
|
||||
|
||||
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 <a name="license"></a>
|
||||
|
||||
Code licensed under ([GPLv3][]. Please see the LICENSE file for full details.
|
||||
Code licensed under [GPLv3][]. Please see the LICENSE file for full details.
|
||||
|
||||
## Building <a name="building"></a>
|
||||
## Usage <a name="usage"></a>
|
||||
|
||||
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 <a name="issues"></a>
|
||||
|
||||
- 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 <a name="road-map"></a>
|
||||
|
||||
- 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
|
||||
|
||||
|
||||
[AVR-libc]: http://www.nongnu.org/avr-libc/
|
||||
[avrdude]: http://savannah.nongnu.org/projects/avrdude
|
||||
[doxygen]: http://www.stack.nl/~dimitri/doxygen/
|
||||
[Gnu Emacs]: http://www.gnu.org/software/emacs/
|
||||
[GPLv3]: https://www.gnu.org/licenses/gpl.html
|
||||
|
@ -906,7 +906,7 @@ FILTER_SOURCE_PATTERNS =
|
||||
# (index.html). This can be useful if you have a project on for instance GitHub
|
||||
# and want to reuse the introduction page also for the doxygen output.
|
||||
|
||||
USE_MDFILE_AS_MAINPAGE =
|
||||
USE_MDFILE_AS_MAINPAGE = README.md
|
||||
|
||||
#---------------------------------------------------------------------------
|
||||
# Configuration options related to source browsing
|
||||
|
Loading…
Reference in New Issue
Block a user