ESP-IDF SPI Flash 可选特性指南：Auto Suspend、HPM、DPD、32-bit 地址与 OPI Flash 支持解析-北京尧图网络

ESP-IDF SPI Flash 可选特性指南Auto Suspend、HPM、DPD、32-bit 地址与 OPI Flash 支持解析【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idf本篇技术指南以 ESP-IDF 官方文档《Optional Features for Flash》为核心系统梳理 ESP32 系列芯片与各类 SPI NOR Flash 芯片之间的可选特性支持矩阵涵盖 Auto Suspend Resume、Flash Unique ID、QSPI 高性能模式HPM/HPM-DC、Deep Power-DownDPD、32-bit 地址以及 OPIOctalFlash 六大特性的原理、启用步骤、受支持芯片清单与限制条件。读完本文你将能够根据手头 ESP 芯片与 Flash 型号在menuconfig中正确开启并验证这些可选特性同时理解spi_flash组件底层驱动的实现方式。特性总览与使用前提ESP-IDF 的spi_flash组件负责外部 SPI Flash 的读、写、擦除与内存映射操作相关 API 与整体架构可参见 SPI Flash API 总览。其中一部分 Flash 特性并非在所有 ESP 芯片与 Flash 芯片上都可用官方文档 spi_flash_optional_feature.rst 汇总了这些可选特性Auto Suspend Resume自动挂起与恢复Flash Unique IDFlash 唯一 IDHigh Performance ModeQSPI Flash 高性能模式Deep Power-Down Mode深度掉电模式32-bit Address Support32 位地址支持OPI Flash SupportOctal 接口 Flash 支持使用上述任何可选特性之前需要同时满足三方面的前提ESP 芯片能力目标 ESP 芯片的 SoC 硬件如 MSPI 控制器、MMU需支持该特性ESP-IDF 版本所使用的 IDF 版本已实现对应驱动与配置项Flash 芯片能力产品中所用的 Flash 型号确实支持该特性并且通过了厂商确认。官方文档特别提醒两点若使用乐鑫官方模块/SiP需查阅其数据手册确认是否支持上述特性否则应联系乐鑫商务团队确认供货与支持情况若自行采购 Flash 芯片设计模块应联系 Flash 供应商确认特性支持并保证可持续供货。此外需要注意该文档仅表明ESP-IDF 代码已实现对某些 Flash 芯片特性的驱动支持它并不是乐鑫认证的稳定 Flash 芯片清单。自行搭建硬件时即便使用了本文列出的型号也必须自行验证 Flash 的可靠性。Auto Suspend Resume擦写期间保持缓存在线特性简介与支持矩阵Auto Suspend自动挂起特性允许在 Flash 执行较长时间的擦除SE、页编程PP或状态寄存器写入WRSR等操作时硬件自动发送挂起命令打断当前操作让 CPU 与 Cache 在有限时间内继续从 Flash/PSRAM 读取代码与数据操作完成后硬件再自动发送恢复命令继续原来的擦写流程。该特性支持除 ESP32 与 ESP32-S2 之外的所有乐鑫芯片。在支持该特性的芯片上官方文档列出的 Flash 型号包括XM25xxD 系列GD25QxxE 系列FM25Q32需要注意Auto Suspend 特性存在多项限制启用前务必阅读 auto_suspend.inc 中的详细说明。硬件与 Flash 前提条件auto_suspend.inc中强调使用该特性必须同时满足Flash 芯片具备 suspend/resume 能力MSPI 硬件支持自动挂起即硬件能自动发送挂起命令。在不受支持的芯片上使用挂起特性可能导致严重崩溃。软件实现层面Flash 至少要满足状态寄存器中的 SUS 位应位于 SR2 bit7 或 SR bit15挂起命令应为75H恢复命令应为7AHFlash 成功挂起后除正在擦除的扇区/块外其余地址均可正确读取此时可立即发送恢复命令Flash 成功恢复后可立即再次发送挂起命令。三种代码放置策略启用CONFIG_SPI_FLASH_AUTO_SUSPEND后Cache 在擦写期间保持使能禁用时则会被关闭。硬件负责 SPI0Cache 侧与 SPI1Flash 驱动侧之间的仲裁若 SPI1 操作很短如读操作CPU 与 Cache 会等待其完成若为擦除、页编程、状态寄存器写等长操作则触发自动挂起让 CPU 在受限时间内访问缓存与 Flash。这允许把部分代码/变量放在 Flash/PSRAM 而不是 IRAM/DRAM 中在 Flash 擦写期间依然可执行从而节省 IRAM/DRAM。文档将代码分为三类关键代码置于 IRAM/DRAM通常有高性能要求、与 Cache/Flash/PSRAM 相关或被频繁调用缓存代码置于 Flash/PSRAM性能要求较低或调用较少擦写期间可执行但有一定开销低优先级代码置于 Flash/PSRAM在擦写期间应被禁止执行——通过将任务优先级设为低于擦写任务来避免影响擦写。关于该特性的使用与响应时延还可参考示例工程system/flash_suspend。时序约束与tsus参数Auto Suspend 强依赖严格时序。文档明确指出它属于一种优化方案并非适用于所有场景——例如对实时性要求极高、或中断触发非常频繁如 LCD 刷屏、蓝牙、Wi-Fi的场景需要谨慎评估。两个关键时间值ISR 时间不能过长至少不应超过所设置的IWDT超时否则会显著拉长擦写完成时间ISR 间隔ISR 间隔 - ISR 时间这段时间内 SPI1 会发送恢复命令重启操作但恢复前需要tsus的准备时间典型值约40 µs。若 SPI1 来不及恢复操作而又有新的挂起命令到来会造成 CPU 饥饿可能触发TWDT。tsus值通常可在 Flash 数据手册的 AC CHARACTERISTICS 章节查到用户需要确保手册中的tsus不大于 Kconfig 中CONFIG_SPI_FLASH_SUSPEND_TSUS_VAL_US所配置的值。此外为避免 CPU 与 Cache 频繁访问 Flash 导致 MSPI 传输效率下降驱动内部设有锁SPI1 发送挂起命令后SPI0 接管内存 SPI 总线并持有锁直到锁延迟周期结束。高级挂起-恢复用法auto_suspend.inc在默认行为硬件自动挂起/恢复固定延时等待挂起生效之外还提供了两项进阶配置1. 通过 Flash 寄存器检测挂起是否生效默认情况下硬件发出挂起命令后按tsus固定等待。启用CONFIG_SPI_FLASH_AUTO_CHECK_SUSPEND_STATUS后硬件改为轮询 Flash 状态寄存器中的WIP位来判断挂起是否真正生效而非等待固定时间。由于实际挂起建立时间通常远短于数据手册给出的最大值此方式可显著降低挂起开销、提升性能。启用前务必确认所用 Flash 挂起后WIP位行为符合预期。2. 软件控制 Flash 恢复启用CONFIG_SPI_FLASH_SOFTWARE_RESUME后硬件自动恢复被禁用改为在 SPI1 等待空闲流程中由软件主动检查 Flash 挂起状态并调用驱动恢复接口。这样可避免高优先级任务/中断执行期间硬件反复发起挂起-恢复序列打断其连续性。该选项的约束仅支持单核场景需启用CONFIG_FREERTOS_UNICORE属于实验特性需先启用CONFIG_IDF_EXPERIMENTAL_FEATURES才可见提升中断响应连续性但会加长单次 Flash 操作的完成时间。相关 Kconfig 配置项在 components/spi_flash/Kconfig 中与 Auto Suspend 相关的配置包括CONFIG_SPI_FLASH_AUTO_SUSPEND主开关默认关闭n依赖SOC_SPI_MEM_SUPPORT_AUTO_SUSPEND且不使用 ROM 实现Kconfig 帮助文本同样提示仅对特定 Flash 与特定芯片支持OTA 前需确保 bootloader 也支持IDF v4.3 之后CONFIG_SPI_FLASH_SUSPEND_TSUS_VAL_UStsus值默认 50范围 20–100对应数据手册 AC 特性章节CONFIG_SPI_FLASH_SUSPEND_TRS_VAL_UStrs值恢复与下一次挂起之间的 CS 延迟默认 50范围 20–200部分高性能 Flash 允许小于手册给定值CONFIG_SPI_FLASH_AUTO_CHECK_SUSPEND_STATUS通过 WIP 位自动检测挂起状态默认关闭CONFIG_SPI_FLASH_SOFTWARE_RESUME软件控制恢复仅单核且需实验特性开关CONFIG_SPI_FLASH_DISABLE_SCHEDULER_IN_SUSPENDSPI1 操作进行时禁用任务调度器仅中断可触发挂起CONFIG_SPI_FLASH_PLACE_FUNCTIONS_IN_IRAM将 spi_flash 操作函数放入 IRAM默认开启关闭可节省约 10 KB IRAM视所用函数而定但注意CONFIG_SPI_FLASH_AUTO_SUSPEND未启用时不应关闭此选项否则会导致严重崩溃CONFIG_SPI_FLASH_FORCE_ENABLE_XMC_C_SUSPEND、CONFIG_SPI_FLASH_FORCE_ENABLE_C6_H2_SUSPEND针对特定系列 Flash/芯片的强制启用选项官方明确建议新用户不要开启涉及已知规格/缺陷限制。对应测试可参考components/spi_flash/test_apps/flash_suspend/下的 pytest_flash_auto_suspend.py 与相关 sdkconfig 文件。Flash Unique ID64 位设备唯一标识特性说明Flash Unique ID 特性在所有乐鑫芯片上都受支持。需要强调Unique ID 不是 Flash ID。Flash 为每个器件内置一个工厂烧写的 64 位只读唯一编号读取指令为4Bh。该 ID 可用于识别每一颗独立的 Flash 器件。并非所有 Flash 厂商都支持该特性若在不支持该特性的芯片上尝试读取唯一 ID行为是未定义的。官方文档列出的支持厂商ISSIGDTHFMWinbondXMCBOYA驱动层接口从源码结构看读取唯一 ID 的能力通过芯片驱动chip driver接口暴露。在 spi_flash_chip_driver.h 中定义有read_unique_id回调esp_err_t (*read_unique_id)(esp_flash_t *chip, uint64_t *flash_unique_id)并通过SPI_FLASH_CHIP_CAP_UNIQUE_IDBIT(2)能力位标记该驱动是否支持读取唯一 ID。各厂商芯片驱动如spi_flash_chip_issi.c、spi_flash_chip_gd.c、spi_flash_chip_th.c、spi_flash_chip_winbond.c、spi_flash_chip_mxic.c、spi_flash_chip_boya.c在components/spi_flash/目录下分别实现了对应的read_unique_id。QSPI Flash 高性能模式HPM 与 HPM-DC特性简介High Performance ModeHPM指 SPI1 与 Flash 芯片工作在高频率下。通常当 Flash 工作频率大于 80 MHz 时即认为处于 HPM。目前仅 ESP32-S3 支持该特性文档提到 ESP32-S2、ESP32-C3、ESP32-C6、ESP32-H2、ESP32-P4 未来可能加入支持。此章节仅针对 QSPI FlashOctal Flash 在 ESP 芯片上默认支持高性能模式见后文 OPI Flash 章节。不同 Flash 的 HPM 实现策略据官方文档典型 SPI Flash 的 HPM 存在多种策略部分芯片通过寄存器中的 dummy cycleDC位控制部分通过其他位如 HPM 位控制还有部分通过专用命令控制。策略差异要求驱动对每种芯片显式添加支持。从 spi_flash_hpm_enable.c 的源码可见驱动按策略维护了一张支持列表spi_flash_hpm_enable_list每种策略包含探测函数probe、需求检查函数requirement check、启用函数enable、HPF 状态检查函数check与 dummy 获取函数get dummy通过命令进入 HPM例如部分 GD 芯片发送A3HCMD_HPMEN命令使能 HPM启用后延时约 20 µsT(HPM)通过调整 dummy cycles 进入 HPMHPM-DC修改 SR3 中的 Dummy Cycle Bits如 DC[1:0][1,1] 或 bit3/bit4典型如 XMC 系列在 80 MHz 时 dummy 可能为 6120 MHz 时可能为 10通过写状态寄存器进入 HPM例如 ZB 芯片写 SR3 的 HPF 位bit5无需任何操作例如 GD25LQ255E 默认最高支持 133 MHz。需要指出spi_flash_enable_high_performance_mode()会在 Flash 运行频率高于 80 MHz 且芯片不在已知列表时打印警告若检查到芯片不支持该频率SPI_FLASH_HPM_BEYOND_LIMIT则返回失败。HPM-DC 与 DC Aware 的关系当 Flash 采用 DC 调整策略时软件复位后 Flash 会停留在 DC 值异于默认值的状态。应用中以调整 DC 来运行更高频率的 HPM 子模式称为HPM-DC。HPM-DC 需要 bootloader 使能DC Aware特性CONFIG_BOOTLOADER_FLASH_DC_AWARE否则不同的 DC 值会阻止二级 bootloader 在复位后被正常启动。启用 HPM 的步骤按官方文档启用 High Performance Mode 的流程为取消选择CONFIG_ESPTOOLPY_OCT_FLASH与CONFIG_ESPTOOLPY_FLASH_MODE_AUTO_DETECT。HPM 不用于 Octal Flash启用相关选项可能绕过 HPM 功能启用CONFIG_SPI_FLASH_HPM_ENA将 Flash 频率切换到 HPM 频率例如CONFIG_ESPTOOLPY_FLASHFREQ_120M正确选择 HPM-DC 配置位于CONFIG_SPI_FLASH_HPM_DC选项组下根据 bootloader 是否支持 DC Aware若 bootloader 支持 DC Aware选择CONFIG_SPI_FLASH_HPM_DC_AUTO可启用采用 DC 调整策略的 Flash 芯片若 bootloader 不支持 DC Aware选择CONFIG_SPI_FLASH_HPM_DC_DISABLE避免在非 DC-aware bootloader 下运行 HPM-DC 带来的后果但此时应避免使用采用 DC 调整策略的 Flash 型号清单见下文。判断 bootloader 是否支持 DC Aware新项目建议在 bootloader 菜单中启用CONFIG_BOOTLOADER_FLASH_DC_AWARE。注意该选项无法通过 OTA 修改因为支持位于 bootloader 中已有项目且希望应用侧通过 OTA 更新 HPM-DC 配置检查构建 bootloader 所用的 sdkconfig最新版本v4.4.7、v5.0.7、v5.1.4、v5.2 及以上若CONFIG_BOOTLOADER_FLASH_DC_AWARE被选中则 bootloader 支持 DC Aware其他版本v4.4.4–v4.4.6、v5.0–v5.0.6、v5.1–v5.1.3若CONFIG_ESPTOOLPY_FLASHFREQ_120M被选中则 bootloader 支持 DC Aware此时可再启用CONFIG_BOOTLOADER_FLASH_DC_AWARE加以确认虽然不会影响现场设备的 bootloaderv4.4.4 以下版本bootloader 不支持 DC Aware。Quad Flash HPM 支持清单无需 HPM-DC 的 Flash 芯片GD25Q64CID: 0xC84017GD25Q32CID: 0xC84016ZB25VQ32BID: 0x5E4016GD25LQ255EID: 0xC86019具备 HPM 但要求 bootloader 支持 DC Aware 的 Flash 芯片GD25Q64EID: 0xC84017GD25Q128EID: 0xC84018XM25QH64CID: 0x204017XM25QH128CID: 0x204018源码中 spi_flash_hpm_enable.c 的探测逻辑与上述清单对应例如 GD25Qxx 通过读 SFDP BYTE4 区分 C 系列0x0走命令方式与 E 系列0x6走 dummy 调整方式。此外 bootloader_flash_config_esp32s3.c 等芯片相关文件与components/spi_flash/esp32s3/Kconfig.flash_freq也与 120 MHz 频率及 HPM 配置联动测试配置可见components/spi_flash/test_apps/esp_flash/sdkconfig.ci.*120m*系列文件。SPI Flash 深度掉电模式Deep Power-DownDPD支持范围目前仅 ESP32-H21、ESP32-H4 以及 ESP32-P4版本低于 v3支持该特性其他 ESP32 系列芯片尚未支持。若有相关需求可向乐鑫官方提交请求。Deep Power-Down 模式是大多数 SPI Flash 芯片支持的省电模式。相比待机模式CS 保持有效DPD 模式下 Flash 功耗显著降低——通常电流可减少 10 µA 或更多。若计划使用定制的 SPI Flash 型号或使用其他 ESP32 系列芯片务必查阅对应 SPI Flash 数据手册或直接联系乐鑫。驱动实现从 spi_flash_dpd_enable.c 源码可见 DPD 的典型命令约定多数 Flash 发送B9H进入 DPD发送ABH退出 DPD部分 Flash 发送B9H进入 PDpower-down后再发送79H进入 UDPDultra-deep power-down退出时先发FFH退出 UDPD再发ABH退出 PD。驱动通过spi_flash_hal_enter_dpd_mode/spi_flash_hal_exit_dpd_mode进入/退出并分别依据CONFIG_ESP_SLEEP_SPI_FLASH_ENTER_DPD_MODE_DELAY与CONFIG_ESP_SLEEP_SPI_FLASH_EXIT_DPD_MODE_DELAY配置的延时未定义时使用默认安全值并打印警告等待进入/退出完成最终对外暴露spi_flash_enable_deep_power_down_mode(enable, wait_delay)接口。QSPI Flash 的 32 位地址支持特性简介该特性在所有乐鑫芯片上受支持对应用的限制见下文。此章节仅针对 QSPI FlashOctal Flash 的 32 位地址支持被视为 Octal Flash 支持的一部分。大多数 NOR Flash 使用 24 位地址可覆盖 16 MB 空间。但对于更大的存储通常 ≥ 32 MBFlash 需要使用 32 位地址访问高于 16 MB 的区域。由于 32 位地址命令因厂商而异驱动需要逐芯片支持。支持该特性的 Flash 芯片W25Q256GD25Q256XM25QH256D限制说明对于不支持 32 位 Cache 地址映射SOC_SPI_MEM_SUPPORT_CACHE_32BIT_ADDR_MAP的芯片高于 16 MB 的 Flash 部分只能用于数据存储例如文件系统。将数据/指令映射到 32 位物理地址空间以便 CPU 访问需要 MMU 支持而此类芯片不支持该能力。截至目前仅 ESP32-S3 与 ESP32-P4 支持。对于支持 32 位 Cache 地址映射的芯片默认情况下Quad Flash 高于 16 MB 的部分可用于数据存储如文件系统。若要完整支持 Quad Flash 16 MB 以上地址同时支持代码执行与数据访问可启用实验特性将以下选项设为yCONFIG_IDF_EXPERIMENTAL_FEATURESCONFIG_BOOTLOADER_CACHE_32BIT_ADDR_QUAD_FLASH该选项为实验特性并非在所有 Quad Flash 芯片上都能稳定使用如有疑问请联系乐鑫商务团队。对于 Octal Flash 芯片若启用CONFIG_ESPTOOLPY_OCT_FLASH该特性默认开启。OPIOctalFlash 支持特性简介OPI Flash 指支持 Octal 外设接口的 Flash 芯片具有八根 I/O 引脚。不同 Octal Flash 的配置与命令各不相同因此必须仔细核对支持清单。目前仅 ESP32-S3 支持该特性。关于如何为不同 Flash 与 PSRAM 组合配置menuconfig可参考官方文档中的 Flash/PSRAM 配置说明flash-psram-configuration。支持该特性的 Flash 芯片MX25UM25645GMX25UM12345G源码侧佐证OPI Flash 的驱动位于 spi_flash_chip_mxic_opi.c并在 spi_flash_chip_mxic.c 中与普通 QSPI 芯片驱动协同。Kconfig 中SPI_FLASH_HPM选项依赖!ESPTOOLPY_OCT_FLASH印证了 HPM 与 Octal Flash 互斥的设计CONFIG_SPI_FLASH_ROM_IMPL的说明也指出 ROM 实现从未支持 Octal Flash故启用 Octal Flash 时只能使用 ESP-IDF 驱动。总结选型与启用建议综合全文为你的产品启用 Flash 可选特性时可遵循以下决策路径确认 ESP 芯片支持范围Auto Suspend 覆盖除 ESP32/ESP32-S2 外全部芯片HPM 与 OPI 目前仅 ESP32-S3DPD 目前仅 ESP32-H21/ESP32-H4/ESP32-P4v332 位地址与 Unique ID 覆盖面最广核对 Flash 型号对照本文各节的支持清单如 HPM 的 Quad Flash 清单、32 位地址三款型号、OPI 两款型号并结合 Flash 数据手册确认命令集、寄存器位与tsus等时序参数在 menuconfig 中正确配置涉及CONFIG_SPI_FLASH_AUTO_SUSPEND、CONFIG_SPI_FLASH_HPM_ENA/CONFIG_SPI_FLASH_HPM_DC_AUTO/CONFIG_SPI_FLASH_HPM_DC_DISABLE、CONFIG_BOOTLOADER_FLASH_DC_AWARE、CONFIG_ESPTOOLPY_FLASHFREQ_120M、CONFIG_ESPTOOLPY_OCT_FLASH、CONFIG_BOOTLOADER_CACHE_32BIT_ADDR_QUAD_FLASH等选项注意 bootloader 联动HPM-DC 依赖 bootloader 的 DC AwareAuto Suspend 也要求 bootloader 版本支持IDF v4.3 之后且这些支持无法通过 OTA 改变需要提前规划充分验证不在支持清单内的 Flash 即便看起来应该能用也可能引发错误或崩溃务必按本文说明与数据手册进行可靠性验证必要时联系 Flash 供应商或乐鑫商务团队。相关深入阅读Auto Suspend 详细机制见 auto_suspend.incSPI1 总线并发约束见 spi_flash_concurrency.rst自定义 Flash 驱动开发见spi_flash_override_driver文档全部相关 Kconfig 选项定义位于 components/spi_flash/Kconfig。【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

ESP-IDF SPI Flash 可选特性指南：Auto Suspend、HPM、DPD、32-bit 地址与 OPI Flash 支持解析

相关推荐

Python爬虫气象数据实时发布系统：从采集到可视化全流程

gog YouTube 实战指南：在终端中用 gog 完成 YouTube 数据查询、订阅与播放列表管理

Flutter双端上架实战：iOS签名与Android渠道包全解析

更多资讯

大语言模型system prompt泄露原理与防御实战

Corsair You.com 插件解析：把 LLM 就绪的网页搜索接入你的 AI 应用

Zephyr 开发指南：emtrion emSBC-NEON-CM7 板卡支持与 STM32F769NI 实战

OpenVINO:开源AI推理优化与部署工具,PyTorch与ONNX模型本地高效运行指南

深度解析 cuda-samples 之 alignedTypes：结构体对齐如何决定 GPU 全局内存访问带宽

基于Flask+Vue3的二手书商城系统开发实践

今日更新

基于MATLAB的CRI显色指数计算：从SPD光谱到Ra的完整流程

JSP+Servlet+MySQL博客系统源码部署与优化全攻略

蜂窝调度算法 MATLAB 实现：比例公平、轮询与最大 C/I 对比

本周精选

AI驱动的自动化专利分析平台技术解析

LeetCode-Go 题解：1252. Cells with Odd Values in a Matrix（奇数值单元格计数）双解法剖析

在线答疑系统Java毕设实战：Spring Boot前后端分离与状态流转

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？