1. 用代码开发工具链驱动 STM32 硬件 SPI:先认清 AT45DB161D 的时序边界
拿 STM32 的硬件 SPI 去读写 AT45DB161D 这类 DataFlash,多数人以为难点在把 SPI 外设调通,实际出问题的地方几乎都落在指令时序和地址位段上。CubeMX 加 HAL 库这套代码开发工具能把初始化代码一键生成,也能让 HAL_SPI_Transmit 返回 HAL_OK,但它不会替你检查片选拉没拉、页地址有没有错位、忙等待够不够。下面就把这条链路完整拆开:在 CubeMX 里定 SPI 参数、用 GPIO 管片选、按 0x83 做页编程、按 0x03 做回读,最后用回读比对和波形把驱动验一遍。适合已经会在 STM32 上点灯、想把手里闲置的 SPI 外设真正接到存储芯片上的开发者。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 在 CubeMX 里把 SPI 参数定下来:模式、分频与片选归属
2.1 硬件 SPI 和软件模拟的取舍
这个项目里的数据量不大,一个页写也就几百字节,很多人第一反应是拿几个 GPIO 模拟 SPI 拉倒。短报文场景确实能跑,但一旦进到页编程,事情就变了:Buffer1 写完还要发 4 字节命令、等内部擦写完成、再回读校验,中间任何一个时序抖动都会让忙等待判断失准。软件模拟在每次循环里都要占 CPU,STM32 主频再高,批量写几十页的时候也会明显卡顿。
硬件 SPI 的形态就不一样了,移位由外设完成,CPU 只负责把数据丢进 HAL_SPI_Transmit。代价是引脚复用被定死、片选必须自己接管,而且调试时你没法像软件模拟那样在任意一位上打断点。AT45DB161D 的指令是 8 位对齐的,HAL_SPI_Transmit 和 HAL_SPI_Receive 正好按字节收发,所以用硬件 SPI 是更省心的路线。
提示:全双工模式在发命令的同时会把 MISO 上的数据一起收进 DR 寄存器,读完不取会溢出。发命令用
HAL_SPI_Transmit、收数据用HAL_SPI_Receive这种分开调用的写法,是为了让片选在两次调用之间保持低电平,不是随手写的。
2.2 CubeMX 里先定这六个参数
打开 CubeMX 的 SPI 配置页,参数项有一屏,真正影响能不能跑通的其实就六个。下面这张表里的取值是常见做法,最终以芯片手册的时序图为准,不要照抄。
| 配置项 | 常见做法 | 判断依据 |
|---|---|---|
| Mode | Master, Full-Duplex | 发命令和收数据要能同时进行,便于读状态 |
| Data Size | 8 bit | 指令、地址、数据都按字节下发 |
| CPOL / CPHA | 先 Mode 0,读不到再换 Mode 3 | 两种模式芯片一般都能吃,以手册时序图为准 |
| NSS | Software | 片选要跨越 Transmit / Receive 两次调用保持低电平 |
| Baud Rate Prescaler | 先大分频跑通,再逐级提 | 杜邦线飞线时高频容易出鬼影,先把链路跑稳 |
| First Bit | MSB | 指令字节高位先出 |
Mode 0 和 Mode 3 的差别在时钟空闲电平和采样沿。为什么先用 Mode 0?因为它对应 CPOL=0、CPHA=0,空闲低电平、第一个边沿采样,是多数 SPI 器件的默认姿态,先用它排除掉模式因素,读不通再切 Mode 3 对比一次。这一步不要跳过,我见过不少人直接按手册某个模式配完就跑,读回全 0xFF 之后又去改接线,把简单问题拖成了玄学。
分频也一样。CubeMX 里默认给的分频经常是 2 或 4,飞线一长,时钟沿上就有振铃,DataFlash 收到的命令字节就可能是错的。先在 32 分频甚至 64 分频下把页读写跑通,再把分频一档一档降下来,每一档都做一次回读比对,这样你才能知道这块板子能稳定跑在哪个速度上,而不是靠猜测判断。
2.3 片选为什么必须自己用 GPIO 管
看一段页写代码就会明白片选为什么要手动管:
c复制/* 片选统一收口,业务代码里只调宏,不直接写 HAL_GPIO_WritePin */
#define DF_CS_LOW() HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_RESET)
#define DF_CS_HIGH() HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_SET)
GPIOA 和 GPIO_PIN_4 是 CubeMX 里配成推挽输出的普通 GPIO,不是 SPI 的 NSS 引脚。为什么不用硬件 NSS?因为一条 DataFlash 指令是一个连续事务:片选拉低,发 4 字节命令,如果是读操作还要接着收数据,最后片选拉高。而 HAL_SPI_Transmit 和 HAL_SPI_Receive 是两次独立的函数调用,如果 NSS 交给硬件,HAL 在每次调用结束时可能把 NSS 抬起来,芯片看到片选中途变高,就把这次事务当成了两次不完整的命令。
用软件 NSS 加手动 GPIO,事务边界完全由你控制。这个细节在页写里还看不出问题,因为页写是发完命令就拉高;到了页读,收发两段必须共享同一个低电平窗口,硬件 NSS 就很容易翻车。所以配好 GPIO 之后,第一件事就是写这两个宏,后面所有函数都通过宏来碰片选,别在业务代码里散落 HAL_GPIO_WritePin。
2.4 上电先做一次空读自检
正式发指令之前,先做一次最笨的检查:片选拉低,连续发 4 个 0xFF,看 MISO 上回来什么。这一招能把接线问题和指令问题分开。
读回全 0x00,说明 MISO 被拉死在低电平,大概率是引脚配错或者器件没供电;读回全 0xFF,说明总线上没有器件应答,可能是片选没接对、SPI 模式不对,也可能是 MOSI 和 MISO 接反了。这两种现象对应的排查方向完全不同,先做空读能省掉后面一半的猜测。自检通过之后再进到指令层,心里就有底了。
3. 页写与缓冲区的代码开发工具实操:0x83 指令、忙等待与地址拆分
3.1 页写为什么要绕一圈走 Buffer1
DataFlash 的页编程不是把数据直接怼进主存储区,而是先写进芯片内部的 SRAM 缓冲区,再发一条“缓冲区到主存储”的指令,由芯片自己完成擦写。代码里 buffer1Write(0, data, len) 干的就是前半段,0x83 那条命令干的是后半段。
这么设计有它的道理:缓冲区可以反复改写,你先把整页数据凑齐、确认无误,再一次性提交,避免写一半发现数据不对又要擦除重来。代价是多一次忙等待,而且缓冲区是共享资源,写之前必须确认芯片不忙。这个流程决定了 pageWrite 的第一个动作一定是 waitReady(100),而不是直接发命令。
3.2 pageWrite 逐字节拆开看
c复制void pageWrite(uint16_t page, uint8_t* data, uint16_t len) {
waitReady(100); // 提交前先确认芯片空闲
buffer1Write(0, data, len); // 数据先进 Buffer1
uint8_t cmd[4];
cmd[0] = 0x83; // Buffer1 To Main Memory Page Program
cmd[1] = 0x00; // 保留位
cmd[2] = (uint8_t)((page >> 8) & 0x0F); // 页地址高4位(4096页用12位)
cmd[3] = (uint8_t)(page & 0xFF); // 页地址低8位
DF_CS_LOW();
HAL_SPI_Transmit(&spiHandle, cmd, 4, 100);
DF_CS_HIGH();
waitReady(100); // 等内部擦写完成,别急着发下一条
}
cmd[0] 是操作码,0x83 对应 Buffer1 到主存储的页编程。cmd[1] 是保留字节,填 0 即可。cmd[2] 和 cmd[3] 合起来是页地址,其中页地址一共 12 位,能寻址 4096 页,所以 cmd[2] 只取高 4 位并和 0x0F 相与,把上面多余的位截掉。这个掩码不能省,page 是 uint16_t,page >> 8 之后仍可能带进高位,不掩就会把脏数据写进命令字节。
HAL_SPI_Transmit 的最后一个参数 100 是超时时间,单位毫秒。发 4 个字节用 100ms 绰绰有余,但别把它当成“肯定不会超时”的保证,如果 SPI 外设被别的地方占着,或者中断里也在碰同一个句柄,这里就会返回 HAL_TIMEOUT。所以返回值该查还是要查。
两次 waitReady 的位置也有讲究。第一次在写缓冲区之前,防止缓冲区正在被上一次操作占用;第二次在命令下发之后,因为页编程是芯片内部完成的,命令发完不代表数据已经落盘,这时候如果紧接着读同一页,读到的可能是旧数据。
3.3 pageRead 的地址位段:最容易靠记忆写错的地方
c复制void pageRead(uint16_t page, uint16_t offset, uint8_t* buf, uint16_t len) {
waitReady(100);
uint8_t cmd[4];
cmd[0] = 0x03; // Read Main Memory
cmd[1] = (uint8_t)((page >> 8) & 0x0F);
cmd[2] = (uint8_t)(page & 0xFF);
cmd[3] = (uint8_t)(offset & 0xFF); // 页内偏移,9位时高1位在cmd[2]的低位
DF_CS_LOW();
HAL_SPI_Transmit(&spiHandle, cmd, 4, 100);
HAL_SPI_Receive(&spiHandle, buf, len, 100);
DF_CS_HIGH();
}
0x03 是主存储区读指令,后面跟 3 个字节地址,加上操作码一共 4 字节。问题就出在这 3 个地址字节上:页地址 12 位,页内偏移 9 位,合起来 21 位有效地址,要塞进 24 位里。怎么塞,取决于芯片手册的位图,不同的页大小配置下偏移位数还不一样。
看 cmd[3] 那行的注释:“页内偏移,9位时高1位在cmd[2]的低位”。可上一行 cmd[2] 已经被 page & 0xFF 占满了,偏移的最高位根本没地方放。这两行是互相矛盾的,说明这段代码是凭记忆拼出来的,注释写的时候自己也没想清楚。
怎么办?不要在这种地方猜。把手册里 0x03 和 0x83 的地址位图各抄一遍,画成一张表,把每一位对应到哪个字节的哪一位标清楚,再落成移位代码。下面这段是按“12 位页地址 + 9 位偏移”拼成 21 位连续地址的骨架,实际下发前必须对照手册确认字节顺序,读指令和写指令的地址布局不一定相同:
c复制/* 拼接骨架:先把手册位图抄成注释,再写移位,别反过来 */
/* 假设:21 位有效地址 = 页地址(12位) << 9 | 页内偏移(9位) */
uint32_t addr = ((uint32_t)page << 9) | (offset & 0x1FF);
cmd[1] = (uint8_t)((addr >> 16) & 0xFF);
cmd[2] = (uint8_t)((addr >> 8) & 0xFF);
cmd[3] = (uint8_t)(addr & 0xFF);
offset & 0x1FF 里的 0x1FF 就是 9 位掩码,作用是把偏移截到合法范围。如果实际页内偏移只有 8 位,这个掩码就得改成 0xFF,同时页地址的移位量也要跟着改成 8。位宽一变,整段移位全部要重算,这就是为什么不能背代码。
另外,pageRead 从任意字节位置开始连续读,地址递增到页尾之后会自动跳到下一页开头。这个特性在整页读的时候很方便,但如果你只想读本页最后几个字节,长度给多了就会把下一页的头也读进来,校验时对不上,还以为是写坏了。
3.4 waitReady 的超时给多少
waitReady(100) 里的 100 是超时计数,不是毫秒。它的实际时长取决于轮询粒度和主频,所以要按轮询次数来理解。页编程的典型耗时在毫秒级,给 100 次轮询在多数主频下够用,但如果你的轮询里塞了延时,实际等待就会被拉长,反过来如果轮询本身没有延时,100 次可能几微秒就跑完了,根本等不到芯片空闲。
我的做法是把忙等待写成带返回值的函数,超时就往上抛错误码,而不是在里面死等。死等的代码在实验室能跑,到了现场一旦芯片没响应,整个系统就卡在那里,连日志都打不出来,这种黑匣子现场最难查。
4. 避坑:SPI 读回全 0xFF、页地址错位与片选漏拉
4.1 读回全 0xFF:先分清是没应答还是模式不对
现象很直接:写完一页,回读整页全是 0xFF,换个页地址再读,还是 0xFF。
原因有两种,得先分开。一种是总线上根本没有器件应答,片选没接对、MOSI/MISO 接反、器件没供电都会这样;另一种是 SPI 模式不匹配,命令字节在错误的时钟沿被采样,芯片收到的是乱码,自然不回应。
解决顺序是先用 2.4 节的空读自检确认有没有应答,再切 Mode 0 和 Mode 3 各试一次。如果两种模式空读都正常、发指令就没反应,那就用逻辑分析仪抓一次片选和时钟,看命令字节发出去的时候片选是不是全程为低。这一步能直接把“接线问题”和“时序问题”切开。
4.2 页地址错位:凭记忆拆位段的代价
现象最阴:不报错,编译通过,写进去回读也有数据,但数据和写的不一样,或者换一页读出来是上一页的内容。
原因是地址位段拆错了,数据被写到了隔壁页甚至完全不相干的地址。页地址 12 位加页内偏移 9 位,共 21 位,塞进 3 个字节里,多出来的 3 位是补 0 还是留作别的用途,各家的定义不一样。3.3 节里那段互相矛盾的注释,就是这个问题。
解决只有一个办法:把手册的地址位图打印出来,对着每一位写移位,写完先用“写一页、读相邻三页”的方式验证。如果相邻页读出来是空的,只有目标页有数据,说明地址是对的;如果相邻页也有数据,说明位宽或者移位量错了。
4.3 忙等待缺失与片选时机
现象是连续写多页的时候,前几页正常,写到某一页开始丢数据,或者整批数据只成功了一部分。
原因通常是没等芯片空闲就发了下一条命令。页编程是芯片内部完成的,命令发完就返回,这时候发第二条命令,芯片正忙着,直接忽略。另一种情况是片选在两次 HAL_SPI 调用之间被抬高了,事务被截断,芯片把半条命令当成了完整命令。
解决办法是把 waitReady 放在每次提交前和提交后各一次,并且片选严格用宏包住整个事务。写循环的时候,宁可多等一次,也不要为了压时间把忙等待去掉。
4.4 跨页读的自动翻页
现象是读一页最后几十个字节做校验,总是对不上,把长度减到半页就正常。
原因是 0x03 指令连续读会在页尾自动跳到下一页开头,你给的长度超过了本页剩余空间,读回来的尾部就是下一页的数据。解决方式很简单:读之前算一下 offset + len 有没有超过页大小,超过了就拆成两次读,或者干脆整页读出来再按偏移取。
5. 用逻辑分析仪和回读比对做验证:把驱动从能跑变成可交付
驱动能读能写只是及格线,能证明它写对了才是可交付。我一般会加一个回读比对函数,写完立刻读回来逐字节比:
c复制/* 写完立刻回读比对,比出了问题再查省事得多 */
uint8_t verifyPage(uint16_t page, uint8_t* expect, uint16_t len) {
static uint8_t buf[512]; // 静态缓冲,避开大栈占用
if (len > sizeof(buf)) return 1; // 超出缓冲,改为分块校验
pageRead(page, 0, buf, len);
for (uint16_t i = 0; i < len; i++) {
if (buf[i] != expect[i]) return 2; // 返回非零即失败
}
return 0;
}
buf 用 static 是为了避免在栈上开 512 字节,中断嵌套深的时候容易爆栈。len 超过缓冲长度直接返回错误码,不要静默截断,截断之后比对通过的其实是一部分数据,比不校验更危险。返回值设计成 0 表示通过、非 0 表示失败,调用方只判非零就行,比返回布尔值更容易扩展错误类型。
5.1 波形和页号记录要一起看
逻辑分析仪抓的是片选、时钟、MOSI 三根线,重点看两个位置:片选拉低之后第一个时钟沿上 MOSI 是不是 0x83 或 0x03,以及片选拉高之前时钟是不是已经停了。前者能确认命令字节没被移位错,后者能确认事务边界干净。
光看波形还不够,页号要记下来。我习惯在比对失败时把页号和首个不一致的字节下标一起打出来,这样一眼就能看出是地址错位还是数据本身写错。地址错位通常表现为整页数据整体偏移或者落到相邻页,数据错则是个别字节对不上。
还有一个进阶技巧:把分频从低到高逐档跑一遍,每档写同一页、回读比对,记录哪一档开始失败。这个数据比任何“理论最高速率”都有用,因为它测的是你这块板子、这批飞线、这个布线下的真实边界。
那年我第一次调这块 DataFlash,就是栽在地址位段上。代码是照着记忆写的,编译一次过,跑起来也不报错,我拿回读数据一看有内容,就以为通了,直接往下写业务逻辑。等到联调的时候发现历史数据总是串页,回头查了整整两天,最后把手册的位图打印出来贴在显示器上,一位一位对,才发现偏移的高位放错了字节。从那以后我每次写存储驱动,都强制先把手册的地址位图抄成注释贴在函数头上,再写移位,回读比对也一定在第一次上板时就加进去,绝不拖到联调。希望这些内容能让你少走一遍我走过的弯路。
