alex/esp-idf
alex/esp-idf
1
0
Fork 0
mirror of https://github.com/espressif/esp-idf.git synced 2024-09-20 20:56:01 -04:00
Code Issues Actions 3 Packages Projects Releases Wiki Activity
26800ed71e
esp-idf/examples/storage/wear_levelling
History
Ivan Grokhotkov 26800ed71e global: update note in the partition tables 
The build system automatically determines offsets of partitions from
the partition table, so no manual changes are needed. Instead, add a
note that partition offsets may need to be updated when increasing
the bootloader size.
2019-07-27 10:28:16 +02:00
..
main examples: use new component registration api 2019-06-21 19:53:29 +08:00
CMakeLists.txt cmake: make main a component again 2018-09-11 09:44:12 +08:00
Makefile add wear_levelling component and example 2017-04-17 11:01:17 +08:00
partitions_example.csv global: update note in the partition tables 2019-07-27 10:28:16 +02:00
README.md examples: add FATFS in external Flash example 2019-07-26 08:19:42 +02:00
sdkconfig.defaults partition_table: Check configured flash size fits in partition table 2018-04-26 09:51:55 +10:00

README.md

Wear levelling example

(See the README.md file in the upper level 'examples' directory for more information about examples.)

This example demonstrates how to use wear levelling library and FATFS library to store files in a partition inside SPI flash. Example does the following steps:

  1. Use an "all-in-one" esp_vfs_fat_spiflash_mount function to:
    • find a partition in SPI flash,
    • initialize wear levelling library using this partition
    • mount FAT filesystem using FATFS library (and format the filesystem, if the filesystem can not be mounted),
    • register FAT filesystem in VFS, enabling C standard library and POSIX functions to be used.
  2. Create a file using fopen and write to it using fprintf.
  3. Open file for reading, read back the line, and print it to the terminal.

Wear levelling partition size is set in partitions_example.csv file. See Partition Tables documentation for more information.

How to use example

Hardware required

This example does not require any special hardware, and can be run on any common development board.

Build and flash

Build the project and flash it to the board, then run monitor tool to view serial output:

idf.py -p PORT flash monitor

(Replace PORT with serial port name.)

(To exit the serial monitor, type Ctrl-].)

See the Getting Started Guide for full steps to configure and use ESP-IDF to build projects.

Example output

Here is a typical example console output.

I (280) example: Mounting FAT filesystem
W (440) vfs_fat_spiflash: f_mount failed (13)
I (440) vfs_fat_spiflash: Formatting FATFS partition, allocation unit size=4096
I (660) vfs_fat_spiflash: Mounting again
I (660) example: Opening file
I (910) example: File written
I (910) example: Reading file
I (920) example: Read from file: 'written using ESP-IDF v3.1-dev-171-gf9ad17eee-dirty'
I (920) example: Unmounting FAT filesystem
I (1000) example: Done

To erase the contents of wear levelling partition, run idf.py erase_flash command. Then upload the example again as described above.