2021-04-08 00:13:45 +02:00
|
|
|
LwSHELL |version| documentation
|
|
|
|
|
===============================
|
|
|
|
|
|
|
|
|
|
Welcome to the documentation for version |version|.
|
|
|
|
|
|
|
|
|
|
LwSHELL is lightweight dynamic memory manager optimized for embedded systems.
|
|
|
|
|
|
|
|
|
|
.. 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/lwshell>`_ `Donate <https://paypal.me/tilz0R>`_
|
|
|
|
|
|
|
|
|
|
Features
|
|
|
|
|
^^^^^^^^
|
|
|
|
|
|
2021-04-13 23:38:03 +02:00
|
|
|
* Lightweight commands shell for embedded systems
|
|
|
|
|
* Platform independent and very easy to port
|
|
|
|
|
|
|
|
|
|
* Development of library under Win32 platform
|
|
|
|
|
* Written in C language (C99)
|
|
|
|
|
* No dynamic allocation, maximum number of commands assigned at compile time
|
2021-04-08 00:13:45 +02:00
|
|
|
* Highly configurable
|
2021-04-13 23:38:03 +02:00
|
|
|
* Simple help-text with `cmd -v` option
|
2021-04-08 00:13:45 +02:00
|
|
|
* User friendly MIT license
|
|
|
|
|
|
|
|
|
|
Requirements
|
|
|
|
|
^^^^^^^^^^^^
|
|
|
|
|
|
|
|
|
|
* C compiler
|
2021-04-13 23:38:03 +02:00
|
|
|
* Less than ``5kB`` of non-volatile memory
|
2021-04-08 00:13:45 +02:00
|
|
|
|
|
|
|
|
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
|
2022-02-19 01:47:06 +01:00
|
|
|
:caption: Contents
|
2021-04-08 00:13:45 +02:00
|
|
|
|
|
|
|
|
self
|
|
|
|
|
get-started/index
|
|
|
|
|
user-manual/index
|
|
|
|
|
api-reference/index
|
|
|
|
|
examples/index
|
2022-08-21 16:50:08 +02:00
|
|
|
changelog/index
|
2022-02-19 01:47:06 +01:00
|
|
|
|
|
|
|
|
.. toctree::
|
|
|
|
|
:maxdepth: 2
|
|
|
|
|
:caption: Other projects
|
|
|
|
|
:hidden:
|
|
|
|
|
|
2022-10-30 18:24:02 +01:00
|
|
|
LwBTN - Button manager <https://github.com/MaJerle/lwbtn>
|
2022-02-19 01:47:06 +01:00
|
|
|
LwDTC - DateTimeCron <https://github.com/MaJerle/lwdtc>
|
|
|
|
|
LwESP - ESP-AT library <https://github.com/MaJerle/lwesp>
|
2022-05-10 20:38:03 +02:00
|
|
|
LwEVT - Event manager <https://github.com/MaJerle/lwevt>
|
2022-02-19 01:47:06 +01:00
|
|
|
LwGPS - GPS NMEA parser <https://github.com/MaJerle/lwgps>
|
|
|
|
|
LwGSM - GSM-AT library <https://github.com/MaJerle/lwgsm>
|
|
|
|
|
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>
|
2023-02-19 12:42:44 +01:00
|
|
|
LwUTIL - Utility functions <https://github.com/MaJerle/lwutil>
|
|
|
|
|
LwWDG - RTOS task watchdog <https://github.com/MaJerle/lwwdg>
|
