mirror of
https://github.com/apache/nuttx.git
synced 2026-08-16 18:03:19 +00:00
28cd98c561
Describes some of the quirks of using littlefs on NuttX and links to an issue discussing the sync semantics. Signed-off-by: Matteo Golin <matteo.golin@gmail.com>
31 lines
1.1 KiB
ReStructuredText
31 lines
1.1 KiB
ReStructuredText
========
|
|
LITTLEFS
|
|
========
|
|
|
|
A little fail-safe filesystem designed for microcontrollers from
|
|
https://github.com/littlefs-project/littlefs.
|
|
|
|
In NuttX, littlefs can be interacted with through the virtual file system. This
|
|
means that it can be used normally with ``read()``, ``write()``, etc. calls, as
|
|
well as file operations (``fopen()``, ``fclose()``, etc).
|
|
|
|
.. note::
|
|
|
|
Since littlefs is power-fail safe and must commit writes before they are
|
|
permanently stored (corruption prevention mechanism), it is required to
|
|
periodically call ``fsync`` on the file to commit your writes. The exact
|
|
semantics of when littlefs files are committed are discussed in `this issue
|
|
<https://github.com/apache/nuttx/issues/15840>`_.
|
|
|
|
|
|
..note::
|
|
|
|
If your littlefs setup is experiencing crashes when you boot, try
|
|
troubleshooting by tweaking the ``BLOCK_SIZE_FACTOR`` options in Kconfig. A
|
|
factor of 4 works well for SD cards.
|
|
|
|
.. warning::
|
|
|
|
The littlefs support on NuttX only works with mtd drivers, for storage
|
|
devices such as flash chips, SD cards and eMMC. Performance on SD cards and
|
|
eMMC devices is worse than flash.
|