zephyr/samples/subsys/fs/format
Benjamin Cabé df294e34e1 doc: sphinx-lint: fix bad usage of "default role"
Fixes bad usage of single backticks in lieu of double backticks for
rendering inline literals, or simple '*' for italics.

When appropriate, a better construct than double backticks has been
selected (ex. :file:, :kconfig:option:, :c:func:, ...), or proper :ref:
have been used if the original intention was to have a link.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-09-13 11:42:51 -05:00
..
src
CMakeLists.txt
prj_ram.conf
prj.conf flash: Move dependency on FLASH_PAGE_LAYOUT where it belongs 2024-04-10 10:01:40 +02:00
ramdisk.overlay
README.rst doc: sphinx-lint: fix bad usage of "default role" 2024-09-13 11:42:51 -05:00
sample.yaml hwmv2: Introduce Hardware model version 2 and convert devices 2024-03-02 16:56:33 -05:00

.. zephyr:code-sample:: fs-format
   :name: Format filesystem
   :relevant-api: file_system_api

   Format different storage devices for different file systems.

Overview
***********

This sample shows how to format different storage
devices for different file systems. There are 2 scenarios prepared for this
sample:

* littleFS on flash device
* FAT file system on RAM disk

Building and running
********************

To run this sample, build it for the desired board and scenario and flash it.

The Flash scenario is supported on the nrf52dk/nrf52832 board.
The RAM disk scenario is supported on the mimxrt1064_evk board.
To build the RAM disk sample, the configuration :file:`prj_ram.conf` needs to be used by setting
``CONF_FILE=prj_ram.conf``.

The Flash sample for the nrf 52DK board can be built as follow:

.. zephyr-app-commands::
   :zephyr-app: samples/subsys/fs/format
   :board: nrf52dk/nrf52832
   :goals: build flash
   :compact:

The RAM disk sample for the MIMXRT1064-EVK board can be built as follow:

.. zephyr-app-commands::
   :zephyr-app: samples/subsys/fs/format
   :board: mimxrt1064_evk
   :conf: "prj_ram.conf"
   :goals: build flash
   :compact:

Sample Output
=============

When the sample runs successfully you should see following message on the screen:
.. code-block:: console

  I: LittleFS version 2.4, disk version 2.0
  I: FS at flash-controller@4001e000:0x7a000 is 6 0x1000-byte blocks with 512 cycle
  I: sizes: rd 16 ; pr 16 ; ca 64 ; la 32
  I: Format successful