zephyr

History

Kumar Gala ff579a3af3 flash: Convert DT_FLASH_AREA to FLASH_AREA macros Convert with a combo of scripts and by hand fixups: git grep -l DT_FLASH_AREA_._ID \| \ xargs sed -i -r 's/DT_FLASH_AREA_(.)_ID/FLASH_AREA_ID(\L\1)/' git grep -l DT_FLASH_AREA_._OFFSET \| \ xargs sed -i -r 's/DT_FLASH_AREA_(.)_OFFSET/FLASH_AREA_OFFSET(\L\1)/' git grep -l DT_FLASH_AREA_._SIZE \| \ xargs sed -i -r 's/DT_FLASH_AREA_(.)_SIZE/FLASH_AREA_SIZE(\L\1)/' Signed-off-by: Kumar Gala <kumar.gala@linaro.org>		2020-05-13 21:22:53 +02:00
..
boards	samples: littlefs: fix reg error in particle_xenon overlay	2020-05-09 21:21:16 +02:00
src	flash: Convert DT_FLASH_AREA to FLASH_AREA macros	2020-05-13 21:22:53 +02:00
CMakeLists.txt	cmake: use find_package to locate Zephyr	2020-03-27 16:23:46 +01:00
Kconfig	kconfig: Remove redundant $ZEPHYR_BASE from 'source's	2020-01-06 09:48:53 -05:00
README.rst	boards: nrf52840_pca10056: Rename board to nrf52840dk_nrf52840	2020-03-27 09:14:08 +01:00
prj.conf	subsys/fs/littlefs: allow customization of file system configuration	2019-08-06 19:39:26 +02:00
sample.yaml	boards: nrf52840_pca10056: Rename board to nrf52840dk_nrf52840	2020-03-27 09:14:08 +01:00

README.rst

.. _littlefs-sample:

littlefs File System Sample Application
#######################################

Overview
********

This sample app demonstrates use of Zephyr's :ref:`file system API
<file_system_api>` over `littlefs`_, using a file system with a file that
counts the number of times the system has booted.  Other information
about the file system is also displayed.

.. _littlefs:
   https://github.com/ARMmbed/littlefs

Requirements
************

The partition labeled "storage" will be used for the file system; see
:ref:`legacy_flash_partitions`.  If that area does not already have a
compatible littlefs file system its contents will be replaced by an
empty file system.  You will see diagnostics like this::

   [00:00:00.010,192] <inf> littlefs: LittleFS version 2.0, disk version 2.0
   [00:00:00.010,559] <err> littlefs: Corrupted dir pair at 0 1
   [00:00:00.010,559] <wrn> littlefs: can't mount (LFS -84); formatting

The error and warning are normal for a new file system.

After the file system is mounted you'll also see::

   [00:00:00.182,434] <inf> littlefs: filesystem mounted!
   [00:00:00.867,034] <err> fs: failed get file or dir stat (-2)

This error is also normal for Zephyr not finding a file (the boot count,
in this case).

Building and Running
********************

This example should work on any board that provides a "storage"
partition.  Two tested board targets are described below.

You can set ``CONFIG_APP_WIPE_STORAGE`` to force the file system to be
recreated.

NRF52840 Development Kit
========================

On this device the file system will be placed in the SOC flash.

.. zephyr-app-commands::
   :zephyr-app: samples/subsys/fs/littlefs
   :board: nrf52840dk_nrf52840
   :goals: build
   :compact:

Particle Xenon
==============

On this device the file system will be placed on the external SPI NOR
flash memory.

.. zephyr-app-commands::
   :zephyr-app: samples/subsys/fs/littlefs
   :board: particle_xenon
   :goals: build
   :compact: