mirror of
https://github.com/MaJerle/lwbtn.git
synced 2026-02-06 12:43:10 +08:00
85 lines
2.4 KiB
ReStructuredText
85 lines
2.4 KiB
ReStructuredText
LwBTN |version| documentation
|
|
=============================
|
|
|
|
Welcome to the documentation for version |version|.
|
|
|
|
.. image:: static/images/logo.svg
|
|
:align: center
|
|
|
|
.. rst-class:: center
|
|
.. rst-class:: index_links
|
|
|
|
:ref:`download_library` :ref:`getting_started` `Open Github <https://github.com/MaJerle/lwbtn>`_ `Donate <https://paypal.me/tilz0R>`_
|
|
|
|
Features
|
|
^^^^^^^^
|
|
|
|
* Written in C (C11)
|
|
* Platform independent, requires user to provide millisecond timing source
|
|
* No dynamic memory allocation
|
|
* Callback driven event management
|
|
* Support for click, multi click and long press events
|
|
* Support for software debounce for press and release events
|
|
* Easy to use and maintain
|
|
* User friendly MIT license
|
|
|
|
Requirements
|
|
^^^^^^^^^^^^
|
|
|
|
* C compiler
|
|
* Few ``kB`` of non-volatile memory
|
|
|
|
Contribute
|
|
^^^^^^^^^^
|
|
|
|
Fresh contributions are always welcome. Simple instructions to proceed:
|
|
|
|
#. Fork Github repository
|
|
#. Respect `C style & coding rules <https://github.com/MaJerle/c-code-style>`_ used by the library
|
|
#. Create a pull request to ``develop`` branch with new features or bug fixes
|
|
|
|
Alternatively you may:
|
|
|
|
#. Report a bug
|
|
#. Ask for a feature request
|
|
|
|
License
|
|
^^^^^^^
|
|
|
|
.. literalinclude:: ../LICENSE
|
|
|
|
Table of contents
|
|
^^^^^^^^^^^^^^^^^
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
:caption: Contents
|
|
|
|
self
|
|
get-started/index
|
|
user-manual/index
|
|
api-reference/index
|
|
changelog/index
|
|
authors/index
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
:caption: Other projects
|
|
:hidden:
|
|
|
|
LwBTN - Button manager <https://github.com/MaJerle/lwbtn>
|
|
LwDTC - DateTimeCron <https://github.com/MaJerle/lwdtc>
|
|
LwESP - ESP-AT library <https://github.com/MaJerle/lwesp>
|
|
LwEVT - Event manager <https://github.com/MaJerle/lwevt>
|
|
LwGPS - GPS NMEA parser <https://github.com/MaJerle/lwgps>
|
|
LwCELL - Cellular modem host AT library <https://github.com/MaJerle/lwcell>
|
|
LwJSON - JSON parser <https://github.com/MaJerle/lwjson>
|
|
LwMEM - Memory manager <https://github.com/MaJerle/lwmem>
|
|
LwOW - OneWire with UART <https://github.com/MaJerle/lwow>
|
|
LwPKT - Packet protocol <https://github.com/MaJerle/lwpkt>
|
|
LwPRINTF - Printf <https://github.com/MaJerle/lwprintf>
|
|
LwRB - Ring buffer <https://github.com/MaJerle/lwrb>
|
|
LwSHELL - Shell <https://github.com/MaJerle/lwshell>
|
|
LwUTIL - Utility functions <https://github.com/MaJerle/lwutil>
|
|
LwWDG - RTOS task watchdog <https://github.com/MaJerle/lwwdg>
|