尧图网页设计 
拿到STM32H7S78-DK这块板子我最先折腾的不是那个600MHz的M7核而是板上那颗MX66UW1G45G外部Flash。这颗128MB1Gbit的八线NOR Flash挂在XSPI接口上能存代码、能XIP直读还能当大容量数据盘用算是一块板子上最有分量的存储资源。问题在于XSPI这个外设和以前的QUADSPI/OCTOSPI虽然长得像但寄存器、命令流程和初始化逻辑都不一样直接套老代码十有八九要翻车。这篇文章就围绕MX66UW1G45G在STM32H7S78-DK上的XSPI配置把硬件连接、时钟、时序参数、擦写流程、内存映射以及常见坑一次讲完适合刚从H7/H7A3转到H7S系列或者第一次接触xSPI NOR Flash的人参考。1. 先把硬件底细摸清楚MX66UW1G45G与H7S78-DK的XSPI通路1.1 这颗Flash是什么定位MX66UW1G45G是Macronix旺宏推出的1.8V供电、1Gbit也就是128MB容量的xSPI NOR Flash。它与我们常用的4线QSPI Flash比如W25Q128这类最大的不同在于支持8线并行传输也就是Octal接口。配合DTR双沿采样之后理论带宽可以拉得很高轻松支持代码直接映射执行XIP能胜任从外部Flash启动系统、存放UI资源或固件升级备份这类场景。从设计定位来看这颗Flash就是奔着大容量代码存储 直接执行去的。128MB容量对于MCU项目来说相当宽裕跑个轻量级OS加一堆图标字库完全够用。8线接口除了速度快还有一层好处引脚数量相对于并行NOR少很多但吞吐量接近对H7S这种封装紧凑、接口高度集成的MCU来说这是很合适的搭配。1.2 为什么是XSPI而不是QSPI/OSPISTM32H7S78这颗芯片在存储接口上最直观的体现就是XSPI外设。在更早的H7/H7A3/H7B0上同类的八线接口叫OCTOSPI再往前是QUADSPI只支持4线。H7S系列直接换成了符合JEDEC xSPI标准的XSPI控制器命令结构更规范还支持SFDP自动探测、双bank交叉访问等特性。对开发者来说最大的感受就是初始化寄存器更规整但代价是HAL库函数名和配置参数全变了老的OCTOSPI代码不能直接抄。实际项目中如果只是存点小配置4线QSPI完全够用但如果要放固件、要做到从外部Flash启动八线Flash的连续读取性能就很值了。这也是ST把这颗MX66UW1G45G放到评估板上的原因——它能把H7S的XSPI能力完整暴露出来让我们在量产设计前就能把性能摸透。1.3 板级连接与地址映射在STM32H7S78-DK上MX66UW1G45G是直接焊在板上、挂在XSPI1接口上的。硬件上连接了完整的8根数据线DQ0-DQ7、CLK、CS#以及DQS信号用于DTR模式下的数据选通。所有信号都在1.8V电平域所以千万不要在3.3V逻辑下直接量或飞线容易把Flash搞坏。这一点很多新手容易忽略拿着3.3V的逻辑分析仪探头就去抓波形结果要么波形畸形要么直接把Flash引脚搞出问题。从MCU视角看XSPI1配置成内存映射模式后Flash内容会出现在0x90000000附近的映射区CPU可以直接像读普通内存一样读Flash。是否从这颗Flash启动则由板上的BOOT/BSEL配置决定。简单说地址映射是软件能不能用的前提而启动配置是上电后MCU把什么当作代码源的问题两者别混在一起。2. 配置前的关键功课时钟、引脚与XSPI模式选择2.1 时钟树怎么给XSPI喂时钟H7S的XSPI1时钟源一般在CubeMX里从PLL2或PLL3派生再经过分频得到Flash接口时钟。MX66UW1G45G的数据手册标称最高可以跑到几百MHz的读时钟但我不建议一上来就跑最高频。调试阶段先把XSPI时钟压到100MHz左右把命令通路走通、读ID确认无误后再慢慢往上提。为什么要先降频因为XSPI调试时一旦读ID失败很难分清是GPIO没配好、命令格式错误还是时序不够。用低频把问题面缩窄能省下大量时间。我当时就是在PLL3P上倒腾半天最后发现根因在dummy cycles而不是频率。先把简单变量固定住后面提频才有依据。2.2 GPIO复用与引脚检查CubeMX里使能XSPI1后引脚会自动分配到对应的AF复用位置但有两个点容易忽略。一是DQS引脚在DTR模式下是必须连的如果没有接DQS要么关掉DQS功能要么在XSPI配置里选择由内部产生DQS二是有些IO默认带内部上拉/下拉如果CS#被拉错电平Flash会一直处于disabled状态命令发过去根本没反应。板上MX66UW1G45G的引脚连接在评估板原理图里都有检查时可以对照CubeMX生成的GPIO配置表确认CLK、CS#、DQ0-DQ7、DQS都处于复用模式而不是普通输入输出。这个检查只要一次能省掉后面大量为什么读不到ID的困惑。我习惯把CubeMX的引脚配置截图存档后面画PCB或者接线时直接对照比翻原理图快。2.3 决定用哪种模式内存映射还是间接模式XSPI有两条使用路径间接模式Indirect Mode和内存映射模式Memory Mapped Mode。间接模式下MCU通过发送命令、地址、数据的序列来操作Flash适合做擦除、编程、读ID、读状态寄存器这些控制类操作也是调试阶段的主力。内存映射模式则是把Flash当作一段可直接访问的地址空间MCU读某个地址时XSPI外设自动产生读取命令序列对CPU来讲完全是透明的适合执行代码、读取资源文件。实际项目里两者是配合使用的上电或固件更新时用间接模式擦写Flash正常运行后切到内存映射模式读取。搞清这个关系后续配置就不会一头雾水。我在给客户做方案评估时经常看到有人把这两个模式混为一谈结果在内存映射模式下尝试通过指针写Flash写得半死没反应其实方向就错了。3. 核心配置实操从CubeMX到代码落地3.1 CubeMX里的XSPI外设配置在STM32CubeMX中选择STM32H7S78-DK使能XSPI1后主要配置项如下表配置项推荐值说明ClockPrescaler2分频系数决定XSPI输出时钟为内核时钟的1/2MemoryTypeXSPI_OPI 或 XSPI_OPI_DTR先选普通OPI稳定后再切DTRMemorySize0x8000000128MB容量部分版本填地址位数27ChipSelectHighTime5个周期需满足Flash要求的CS释放时间FifoThreshold4字节中断/轮询模式下FIFO阈值InterfaceModeSDR先DTR模式配合DQS留到后期开ClockModemode 0与Flash默认CPOL/CPHA匹配这个配置只是外设层面。真正和Flash打交道时还需要通过命令结构体告诉XSPI每条指令的参数比如这是读ID还是擦除地址几字节dummy cycles几个。这些参数在上面的表格里看不到最容易踩坑。特别是MemorySize这个字段它在不同HAL版本里含义不一样有的版本填字节数有的版本填地址位数弄错了轻则映射范围不对重则直接hardfault。3.2 Flash时序参数计算dummy cycle、CS high time等时序参数是配置XSPI的灵魂。MX66UW1G45G的数据手册里会有各个模式下的tDummy假周期和tCSH片选高电平时间等参数。计算方法是拿这些时间值除以实际XSPI时钟周期tCK向上取整到整数周期。举个例子假设XSPI时钟为100MHztCK10ns。手册规定某个Octal DTR读取命令需要至少60ns的dummy时间那么dummy cycles就是60/106个周期。而CS高电平时间如果要求不少于45ns那么XSPI里就要配置成至少5个周期50ns。这块的参数不要凭感觉拍先用SDR模式、1-1-1命令跑通再逐项降低dummy cycles去测稳定性。我见过不少工程师在dummy cycles上偷懒从网上随便抄一个值填进去结果读ID能过但读到一半数据错位。原因就是dummy cycles没算准导致Flash提前把数据放到总线上或者放晚了整体时序就乱了。所以这个环节还是老老实实对照手册算一遍。3.3 初始化代码复位、读ID、确认连接CubeMX生成初始化后第一步不要急着擦写先复位Flash并用9F命令读JEDEC ID确认链路通了。代码框架大致如下/* 复位Flash */ XSPI_CommandTypeDef cmd {0}; cmd.Opcode 0x66; cmd.InstructionMode XSPI_INSTRUCTION_1_LINE; cmd.AddressMode XSPI_ADDRESS_NONE; cmd.DataMode XSPI_DATA_NONE; HAL_XSPI_Command(hxspi1, cmd, HAL_MAX_DELAY); cmd.Opcode 0x99; HAL_XSPI_Command(hxspi1, cmd, HAL_MAX_DELAY); /* 读ID9F */ cmd.Opcode 0x9F; cmd.InstructionMode XSPI_INSTRUCTION_1_LINE; cmd.AddressMode XSPI_ADDRESS_NONE; cmd.DataMode XSPI_DATA_1_LINE; cmd.DataLength 3; HAL_XSPI_Command(hxspi1, cmd, HAL_MAX_DELAY); uint8_t id[3] {0}; HAL_XSPI_Receive(hxspi1, id, 3, HAL_MAX_DELAY); printf(Flash ID: %02X %02X %02X\r\n, id[0], id[1], id[2]);如果打印出来的第一个字节是0xC2Macronix厂商ID说明XSPI通路、GPIO、时钟基本没大问题。那种一上来就开DTR、直接映射地址读数据的做法一旦失败就无从排起所以我强烈建议按这个顺序来。有一次我在一个新板子上死活读不到ID最后发现是复位命令没发Flash停在未知状态很多命令不响应。把复位加上去世界就清净了。3.4 擦除与编程间接模式的完整流程擦写NOR Flash的铁律是写之前必须先擦擦除的最小单位是扇区而且擦 STM32H7S78-DK XSPI配置指南：MX66UW1G45G外部Flash实战
拿到STM32H7S78-DK这块板子我最先折腾的不是那个600MHz的M7核而是板上那颗MX66UW1G45G外部Flash。这颗128MB1Gbit的八线NOR Flash挂在XSPI接口上能存代码、能XIP直读还能当大容量数据盘用算是一块板子上最有分量的存储资源。问题在于XSPI这个外设和以前的QUADSPI/OCTOSPI虽然长得像但寄存器、命令流程和初始化逻辑都不一样直接套老代码十有八九要翻车。这篇文章就围绕MX66UW1G45G在STM32H7S78-DK上的XSPI配置把硬件连接、时钟、时序参数、擦写流程、内存映射以及常见坑一次讲完适合刚从H7/H7A3转到H7S系列或者第一次接触xSPI NOR Flash的人参考。1. 先把硬件底细摸清楚MX66UW1G45G与H7S78-DK的XSPI通路1.1 这颗Flash是什么定位MX66UW1G45G是Macronix旺宏推出的1.8V供电、1Gbit也就是128MB容量的xSPI NOR Flash。它与我们常用的4线QSPI Flash比如W25Q128这类最大的不同在于支持8线并行传输也就是Octal接口。配合DTR双沿采样之后理论带宽可以拉得很高轻松支持代码直接映射执行XIP能胜任从外部Flash启动系统、存放UI资源或固件升级备份这类场景。从设计定位来看这颗Flash就是奔着大容量代码存储 直接执行去的。128MB容量对于MCU项目来说相当宽裕跑个轻量级OS加一堆图标字库完全够用。8线接口除了速度快还有一层好处引脚数量相对于并行NOR少很多但吞吐量接近对H7S这种封装紧凑、接口高度集成的MCU来说这是很合适的搭配。1.2 为什么是XSPI而不是QSPI/OSPISTM32H7S78这颗芯片在存储接口上最直观的体现就是XSPI外设。在更早的H7/H7A3/H7B0上同类的八线接口叫OCTOSPI再往前是QUADSPI只支持4线。H7S系列直接换成了符合JEDEC xSPI标准的XSPI控制器命令结构更规范还支持SFDP自动探测、双bank交叉访问等特性。对开发者来说最大的感受就是初始化寄存器更规整但代价是HAL库函数名和配置参数全变了老的OCTOSPI代码不能直接抄。实际项目中如果只是存点小配置4线QSPI完全够用但如果要放固件、要做到从外部Flash启动八线Flash的连续读取性能就很值了。这也是ST把这颗MX66UW1G45G放到评估板上的原因——它能把H7S的XSPI能力完整暴露出来让我们在量产设计前就能把性能摸透。1.3 板级连接与地址映射在STM32H7S78-DK上MX66UW1G45G是直接焊在板上、挂在XSPI1接口上的。硬件上连接了完整的8根数据线DQ0-DQ7、CLK、CS#以及DQS信号用于DTR模式下的数据选通。所有信号都在1.8V电平域所以千万不要在3.3V逻辑下直接量或飞线容易把Flash搞坏。这一点很多新手容易忽略拿着3.3V的逻辑分析仪探头就去抓波形结果要么波形畸形要么直接把Flash引脚搞出问题。从MCU视角看XSPI1配置成内存映射模式后Flash内容会出现在0x90000000附近的映射区CPU可以直接像读普通内存一样读Flash。是否从这颗Flash启动则由板上的BOOT/BSEL配置决定。简单说地址映射是软件能不能用的前提而启动配置是上电后MCU把什么当作代码源的问题两者别混在一起。2. 配置前的关键功课时钟、引脚与XSPI模式选择2.1 时钟树怎么给XSPI喂时钟H7S的XSPI1时钟源一般在CubeMX里从PLL2或PLL3派生再经过分频得到Flash接口时钟。MX66UW1G45G的数据手册标称最高可以跑到几百MHz的读时钟但我不建议一上来就跑最高频。调试阶段先把XSPI时钟压到100MHz左右把命令通路走通、读ID确认无误后再慢慢往上提。为什么要先降频因为XSPI调试时一旦读ID失败很难分清是GPIO没配好、命令格式错误还是时序不够。用低频把问题面缩窄能省下大量时间。我当时就是在PLL3P上倒腾半天最后发现根因在dummy cycles而不是频率。先把简单变量固定住后面提频才有依据。2.2 GPIO复用与引脚检查CubeMX里使能XSPI1后引脚会自动分配到对应的AF复用位置但有两个点容易忽略。一是DQS引脚在DTR模式下是必须连的如果没有接DQS要么关掉DQS功能要么在XSPI配置里选择由内部产生DQS二是有些IO默认带内部上拉/下拉如果CS#被拉错电平Flash会一直处于disabled状态命令发过去根本没反应。板上MX66UW1G45G的引脚连接在评估板原理图里都有检查时可以对照CubeMX生成的GPIO配置表确认CLK、CS#、DQ0-DQ7、DQS都处于复用模式而不是普通输入输出。这个检查只要一次能省掉后面大量为什么读不到ID的困惑。我习惯把CubeMX的引脚配置截图存档后面画PCB或者接线时直接对照比翻原理图快。2.3 决定用哪种模式内存映射还是间接模式XSPI有两条使用路径间接模式Indirect Mode和内存映射模式Memory Mapped Mode。间接模式下MCU通过发送命令、地址、数据的序列来操作Flash适合做擦除、编程、读ID、读状态寄存器这些控制类操作也是调试阶段的主力。内存映射模式则是把Flash当作一段可直接访问的地址空间MCU读某个地址时XSPI外设自动产生读取命令序列对CPU来讲完全是透明的适合执行代码、读取资源文件。实际项目里两者是配合使用的上电或固件更新时用间接模式擦写Flash正常运行后切到内存映射模式读取。搞清这个关系后续配置就不会一头雾水。我在给客户做方案评估时经常看到有人把这两个模式混为一谈结果在内存映射模式下尝试通过指针写Flash写得半死没反应其实方向就错了。3. 核心配置实操从CubeMX到代码落地3.1 CubeMX里的XSPI外设配置在STM32CubeMX中选择STM32H7S78-DK使能XSPI1后主要配置项如下表配置项推荐值说明ClockPrescaler2分频系数决定XSPI输出时钟为内核时钟的1/2MemoryTypeXSPI_OPI 或 XSPI_OPI_DTR先选普通OPI稳定后再切DTRMemorySize0x8000000128MB容量部分版本填地址位数27ChipSelectHighTime5个周期需满足Flash要求的CS释放时间FifoThreshold4字节中断/轮询模式下FIFO阈值InterfaceModeSDR先DTR模式配合DQS留到后期开ClockModemode 0与Flash默认CPOL/CPHA匹配这个配置只是外设层面。真正和Flash打交道时还需要通过命令结构体告诉XSPI每条指令的参数比如这是读ID还是擦除地址几字节dummy cycles几个。这些参数在上面的表格里看不到最容易踩坑。特别是MemorySize这个字段它在不同HAL版本里含义不一样有的版本填字节数有的版本填地址位数弄错了轻则映射范围不对重则直接hardfault。3.2 Flash时序参数计算dummy cycle、CS high time等时序参数是配置XSPI的灵魂。MX66UW1G45G的数据手册里会有各个模式下的tDummy假周期和tCSH片选高电平时间等参数。计算方法是拿这些时间值除以实际XSPI时钟周期tCK向上取整到整数周期。举个例子假设XSPI时钟为100MHztCK10ns。手册规定某个Octal DTR读取命令需要至少60ns的dummy时间那么dummy cycles就是60/106个周期。而CS高电平时间如果要求不少于45ns那么XSPI里就要配置成至少5个周期50ns。这块的参数不要凭感觉拍先用SDR模式、1-1-1命令跑通再逐项降低dummy cycles去测稳定性。我见过不少工程师在dummy cycles上偷懒从网上随便抄一个值填进去结果读ID能过但读到一半数据错位。原因就是dummy cycles没算准导致Flash提前把数据放到总线上或者放晚了整体时序就乱了。所以这个环节还是老老实实对照手册算一遍。3.3 初始化代码复位、读ID、确认连接CubeMX生成初始化后第一步不要急着擦写先复位Flash并用9F命令读JEDEC ID确认链路通了。代码框架大致如下/* 复位Flash */ XSPI_CommandTypeDef cmd {0}; cmd.Opcode 0x66; cmd.InstructionMode XSPI_INSTRUCTION_1_LINE; cmd.AddressMode XSPI_ADDRESS_NONE; cmd.DataMode XSPI_DATA_NONE; HAL_XSPI_Command(hxspi1, cmd, HAL_MAX_DELAY); cmd.Opcode 0x99; HAL_XSPI_Command(hxspi1, cmd, HAL_MAX_DELAY); /* 读ID9F */ cmd.Opcode 0x9F; cmd.InstructionMode XSPI_INSTRUCTION_1_LINE; cmd.AddressMode XSPI_ADDRESS_NONE; cmd.DataMode XSPI_DATA_1_LINE; cmd.DataLength 3; HAL_XSPI_Command(hxspi1, cmd, HAL_MAX_DELAY); uint8_t id[3] {0}; HAL_XSPI_Receive(hxspi1, id, 3, HAL_MAX_DELAY); printf(Flash ID: %02X %02X %02X\r\n, id[0], id[1], id[2]);如果打印出来的第一个字节是0xC2Macronix厂商ID说明XSPI通路、GPIO、时钟基本没大问题。那种一上来就开DTR、直接映射地址读数据的做法一旦失败就无从排起所以我强烈建议按这个顺序来。有一次我在一个新板子上死活读不到ID最后发现是复位命令没发Flash停在未知状态很多命令不响应。把复位加上去世界就清净了。3.4 擦除与编程间接模式的完整流程擦写NOR Flash的铁律是写之前必须先擦擦除的最小单位是扇区而且擦