2019-09-06 07:12:36 -04:00
|
|
|
|
存储 API
|
|
|
|
|
|
***********
|
|
|
|
|
|
|
|
|
|
|
|
:link_to_translation:`en:[English]`
|
|
|
|
|
|
|
2023-10-13 15:55:41 -04:00
|
|
|
|
本节提供高层次的存储 API 的参考文档。这些 API 基于如 SPI flash、SD/MMC 等低层次驱动。
|
2022-11-23 03:48:17 -05:00
|
|
|
|
|
2023-10-13 15:55:41 -04:00
|
|
|
|
- :doc:`分区表 API <partition>` 基于 :doc:`/api-guides/partition-tables` ，允许以块为单位访问 SPI flash。
|
|
|
|
|
|
- :doc:`非易失性存储库 (NVS) <nvs_flash>` 在 SPI NOR flash 上实现了一个有容错性，和磨损均衡功能的键值对存储。
|
2023-09-13 22:37:29 -04:00
|
|
|
|
- :doc:`虚拟文件系统 (VFS) <vfs>` 库提供了一个用于注册文件系统驱动的接口。SPIFFS、FAT 以及多种其他的文件系统库都基于 VFS。
|
2023-10-13 15:55:41 -04:00
|
|
|
|
- :doc:`SPIFFS <spiffs>` 是一个专为 SPI NOR flash 优化的磨损均衡的文件系统，非常适用于小分区和低吞吐率的应用。
|
|
|
|
|
|
- :doc:`FAT <fatfs>` 是一个可用于 SPI flash 或者 SD/MMC 存储卡的标准文件系统。
|
|
|
|
|
|
- :doc:`磨损均衡 <wear-levelling>` 库实现了一个适用于 SPI NOR flash 的 flash 翻译层 (FTL)，用于 flash 中 FAT 分区的容器。
|
2022-11-23 03:48:17 -05:00
|
|
|
|
|
|
|
|
|
|
.. note::
|
2023-07-18 05:16:41 -04:00
|
|
|
|
|
2023-10-13 15:55:41 -04:00
|
|
|
|
建议使用高层次的 API（``esp_partition`` 或者文件系统）而非低层次驱动 API 去访问 SPI NOR flash。
|
2022-11-23 03:48:17 -05:00
|
|
|
|
|
2023-10-13 15:55:41 -04:00
|
|
|
|
由于 NOR flash 和乐鑫硬件的一些限制，访问主 flash 会影响各个系统的性能。关于这些限制的更多信息，参见 :doc:`/api-reference/peripherals/spi_flash/index`。
|
2023-01-29 06:29:58 -05:00
|
|
|
|
|
2019-09-06 07:12:36 -04:00
|
|
|
|
.. toctree::
|
|
|
|
|
|
:maxdepth: 1
|
|
|
|
|
|
|
2021-12-30 05:50:55 -05:00
|
|
|
|
fatfs
|
|
|
|
|
|
mass_mfg.rst
|
|
|
|
|
|
nvs_flash
|
2023-04-18 08:39:38 -04:00
|
|
|
|
nvs_encryption
|
2021-12-30 05:50:55 -05:00
|
|
|
|
nvs_partition_gen.rst
|
2022-04-14 06:08:26 -04:00
|
|
|
|
nvs_partition_parse.rst
|
2021-12-30 05:50:55 -05:00
|
|
|
|
sdmmc
|
2022-11-23 03:48:17 -05:00
|
|
|
|
partition
|
2021-12-30 05:50:55 -05:00
|
|
|
|
spiffs
|
|
|
|
|
|
vfs
|
|
|
|
|
|
wear-levelling
|
2021-09-03 04:06:02 -04:00
|
|
|
|
|
2021-12-30 05:50:55 -05:00
|
|
|
|
此部分 API 代码示例存放在 ESP-IDF 示例项目的 :example:`storage` 目录下。
|
