esp-idf/examples/storage/ext_flash_fatfs
Michael (XIAO Xufeng) f7be540222 ci: partially enable example build for esp32c2 2022-06-02 14:17:31 +08:00
..
main fatfs: add new ESP32 targets to external flash example 2022-05-12 18:57:10 +00:00
CMakeLists.txt tools: Increase the minimal supported CMake version to 3.16 2022-06-01 06:35:02 +00:00
README.md ci: partially enable example build for esp32c2 2022-06-02 14:17:31 +08:00
example_test.py test: update example and unit tests with new import roles: 2019-12-07 10:34:54 +08:00

README.md

Supported Targets ESP32 ESP32-S2 ESP32-S3 ESP32-C3

FAT FS on External Flash example

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

This example is similar to the wear levelling example, except that it uses an external SPI Flash chip. This can be useful if you need to add more storage to a module with only 4 MB flash size.

The flow of the example is as follows:

  1. Initialize the SPI bus and configure the pins. In this example, VSPI peripheral is used. The pins chosen in this example correspond to IOMUX pins for the VSPI peripheral. If the pin assignment is changed, SPI driver will instead connect the peripheral to the pins using the GPIO Matrix.

  2. Initialize the SPI flash chip. This involves creating a run-time object which describes the flash chip (esp_flash_t), probing the flash chip, and configuring it for the selected read mode. By default this example uses DIO mode, which only requires 4 pins (MOSI, MISO, SCLK, CS) but we strongly recommand to connect (or pull-up) the WP and HD pins. For modes such as QIO and QOUT, additional pins (WP/DQ2, HD/DQ3) must be connected.

  3. Register the entire area of the Flash chip as a partition (esp_partition_t). This allows other components (FATFS, SPIFFS, NVS, etc) to use the storage provided by the external flash chip.

  4. Do some read and write operations using C standard library functions: create a file, write to it, open it for reading, print the contents to the console.

How to use example

Hardware required

This example needs an SPI NOR Flash chip connected to the ESP32. The SPI Flash chip must have 3.3V logic levels. The example has been tested with Winbond W25Q32 SPI Flash chip.

Use the following pin assignments:

Pin assigments

The GPIO pin numbers used to connect an external SPI flash chip can be customized.

In this example it can be done in source code by changing C defines under Pin mapping comment at the top of the file.

The table below shows the default pin assignments.

SPI bus signal SPI Flash pin ESP32 pin ESP32S2 pin ESP32S3 pin ESP32C3 pin
MOSI DI GPIO23 GPIO11 GPIO11 GPIO7
MISO DO GPIO19 GPIO13 GPIO13 GPIO2
SCLK CLK GPIO18 GPIO12 GPIO12 GPIO6
CS CMD GPIO5 GPIO10 GPIO10 GPIO10
WP WP GPIO22 GPIO14 GPIO14 GPIO5
HD HOLD GPIO21 GPIO9 GPIO9 GPIO4
GND GND GND GND GND
VCC VCC VCC VCC VCC

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 (328) example: Initializing external SPI Flash
I (338) example: Pin assignments:
I (338) example: MOSI: 23   MISO: 19   SCLK: 18   CS:  5
I (348) spi_flash: detected chip: generic
I (348) spi_flash: flash io: dio
I (348) example: Initialized external Flash, size=4096 KB, ID=0xef4016
I (358) example: Adding external Flash as a partition, label="storage", size=4096 KB
I (368) example: Mounting FAT filesystem
I (378) example: FAT FS: 4024 kB total, 4020 kB free
I (378) example: Opening file
I (958) example: File written
I (958) example: Reading file
I (958) example: Read from file: 'Written using ESP-IDF v4.0-dev-1301-g0a1160468'