做嵌入式这几年接触过的存储芯片不少但 DS2431 算是最特别的一颗。它只有两条引脚一条数据线一条地线靠着 OneWire 协议就能把 128 字节的数据稳稳存进去。前阵子做 STM32 项目需要在设备里保存校准参数和序列号选来选去最后用了它顺手把驱动完整写了一遍。这篇东西就是这段时间的实战记录从 OneWire 协议本身讲起一直写到 STM32 上的底层 GPIO 模拟时序和 DS2431 的读写流程。如果你正要给 STM32 项目加一颗 EEPROM或者刚接触 OneWire 协议、想知道它到底是怎么在一根线上完成双向通信的这篇文章应该能帮你省不少时间。1. 认识 DS2431一根数据线搞定的 EEPROM1.1 一颗“极简主义”的存储芯片DS2431 是 Maxim现在并入 Analog Devices出的 1-Wire EEPROM容量标称 1Kb也就是 1024 位换算过来是 128 字节用户存储区。这 128 字节被分成 4 个页每页 32 字节另外每页还配了 8 字节的状态区用于写保护之类的高级功能。存储空间虽然不大但这类芯片的定位本来就不是大容量存储而是存序列号、校准系数、设备配置这类对容量要求不高但必须掉电不丢的数据。它的核心卖点是接口极简。芯片只有 DQ 和 GND 两个引脚没有独立的电源脚供电靠的是数据线上的寄生供电机制。这意味着只要两根线就能完成供电、通信、存储三件事在空间受限、引脚紧张的小板子上非常友好。工作电压范围 2.8V 到 5.25V基本能覆盖常见的 3.3V 和 5V 系统数据手册标称写次数和保存时间都在 10 万次、10 年这个量级作为参数存储完全够用。我最初选它是因为板上实在挤不出 I2C 引脚了而 DS2431 只需要一个普通 GPIO 就能驱动。后来发现它的好处不止省引脚OneWire 总线天然支持多设备挂接理论上一条总线可以挂几十个 DS2431每个芯片有唯一的 64 位 ROM 序列号做设备识别非常方便。1.2 为什么用 OneWire 而不是 I2C 或 SPI嵌入式圈子里存参数首选几乎都是 I2C EEPROM比如 AT24C02、FM24CL64 之类。I2C 有成熟的标准库、HAL 库支持代码写起来轻松很多。那 DS2431 这种 OneWire 器件还有什么存在价值我自己的体会是OneWire 在三个场景下特别有优势。第一引脚占用最少一条线串起所有设备这在传感器节点、小型标签类产品上很吃香第二单总线组网时不需要片选线靠 ROM 序列号寻址多设备布线成本低第三OneWire 器件的时序标准是明确的只要严格按照手册时序去拉电平稳定性并不差而且总线驱动能力也没想象中那么脆弱。代价就是速度慢。OneWire 标准模式下通信速率也就 15kbps 左右远低于 I2C 的标准 100kbps更别提 SPI 了。另外时序调制方式是纯电平宽度控制对微控制器的微秒级延时精度要求比较高HAL_Delay 这种毫秒级延时根本不能用。这也是很多人第一次写 OneWire 驱动时卡壳的地方。2. OneWire 协议核心先把时序吃透OneWire 协议的本质就是靠一根线上的电平变化和延时宽度来传递信息。所有时隙由主机发起从机被动响应不存在从机主动说话的机制。理解这一点之后整个协议就没那么神秘了。2.1 复位和存在检测每次通信开始前主机必须先发送一个复位脉冲用来唤醒总线上所有从机设备并让它们回应一个存在脉冲表示“我在线上”。复位的时序是这样的主机先把总线拉低保持 480 微秒以上手册要求 480 到 960 微秒然后释放总线让上拉电阻把总线拉高。从机检测到这个长低电平后会等待 15 到 60 微秒然后自己把总线拉低持续 60 到 240 微秒作为存在脉冲。主机释放总线后需要在 60 到 240 微秒窗口内采样一次引脚电平。如果读到低电平说明总线上有设备响应如果读到高电平说明总线上没有设备或者设备处于异常状态。我习惯在释放总线后延时 70 微秒再采样这个点落在从机拉低窗口的中间位置比较稳。uint8_t OW_Reset(void) { uint8_t presence 0; OW_Pin_Low(); // 拉低总线 delay_us(500); // 复位脉冲480~960us OW_Pin_High(); // 释放总线 delay_us(70); // 等待从机响应 presence OW_Pin_Read() ? 0 : 1; // 低电平表示存在 delay_us(410); // 补齐整个复位时隙 return presence; }这里有个细节复位脉冲结束后要等满整个复位周期再执行后续时隙所以我额外延时了 410 微秒。很多人只拉低 480 微秒、释放后读一次就马上发命令虽然大多数情况下能工作但时序余量不足总线稍长或者有寄生电容时就容易出现偶发通信失败。2.2 写时隙和读时隙OneWire 的读写单位是“时隙”一个时隙传输一个 bit。所有时隙都由主机拉低总线开始区别在于拉低持续的时间以及之后的行为。写 1 的时序是主机拉低总线 1 到 15 微秒然后释放让总线恢复高电平直到时隙结束。从机在主机释放后的 15 到 60 微秒窗口内采样总线读到高就认为收到 1。写 0 的时序是主机拉低总线并保持 60 到 120 微秒然后再释放。从机在同一个采样窗口内读到低就认为收到 0。读时隙稍有不同。主机拉低总线至少 1 微秒后释放然后从机如果要想回传 0就会主动把总线拉低保持一段时间如果想回传 1就保持高电平。主机必须在拉低释放后的 15 微秒内完成采样我通常在释放后延时 6 到 8 微秒再读引脚这样既避开了总线翻转的毛刺又落在从机驱动的窗口内。写字节和读字节都是 LSB first也就是先传最低位。这是 OneWire 协议的老规矩写代码时千万别按习惯从高位开始第一次写驱动踩这个坑的人不少。2.3 OneWire 的命令结构一次完整的 OneWire 通信分为三段复位脉冲、ROM 命令、功能命令。ROM 命令用来选择总线上具体操作哪个设备功能命令才是器件自己的操作指令。ROM 命令一共有四条0x33 读 ROM、0x55 匹配 ROM、0xF0 搜索 ROM、0xCC 跳过 ROM。总线上只有一个设备时直接用跳过 ROM省去读序列号的步骤多设备时先用搜索 ROM 枚举所有设备序列号再用匹配 ROM 指定目标设备。DS2431 的功能命令不多最常用的就是读写存储器和通过暂存器写 EEPROM命令命令字说明写暂存器0x0F先将数据写入 8 字节暂存器不直接改 EEPROM读暂存器0xAA读回暂存器内容及状态字节用于校验复制暂存器0x55将暂存器数据复制到 EEPROM这才是真正的写入操作读存储器0xF0从指定地址连续读存储器内容搜索 ROM0xF0多设备枚举属于 ROM 命令段DS2431 的地址空间是 0x00 到 0xFF。0x00 到 0x7F 是用户存储区0x80 到 0xFF 是状态区。实际发指令时地址按两个字节发先发低字节 TA1再发高字节 TA2高字节只在访问状态区相关功能时用到。3. STM32 上的 OneWire 驱动实现有了协议层面的理解写 STM32 驱动就是体力活了。我用的是 STM32F103 配合 HAL 库GPIO 配置成开漏输出模式。如果你用的是其他型号或其他库思路完全一样无非就是 GPIO 读写函数换个名字。3.1 硬件连接和 GPIO 初始化OneWire 总线是漏极开路结构所以 STM32 这边必须用开漏输出模式外部接一个上拉电阻到 3.3V。上拉电阻推荐 4.7kΩ这个阻值在常见线长下能兼顾上升沿速度和驱动能力。走线很短时可以换成 2.2kΩ让上升沿更陡峭走线很长或者挂的设备多可以适当增大到 10kΩ但超过 10kΩ 后信号完整性会变差需要示波器确认波形。硬件上还有一个容易忽略的点DS2431 是寄生供电读操作时从总线上“偷电”维持内部逻辑。如果总线电容太大比如连接器线材很长读数据时电平可能拉不上去表现为读取随机数据或者偶发失败。实际项目里尽量缩短 DQ 走线必要时在靠近 MCU 引脚处加强上拉。GPIO 初始化很简单开漏输出模式初始化完成后默认输出高电平GPIO_InitTypeDef gpio {0}; __HAL_RCC_GPIOB_CLK_ENABLE(); gpio.Pin GPIO_PIN_0; gpio.Mode GPIO_MODE_OUTPUT_OD; gpio.Pull GPIO_NOPULL; gpio.Speed GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOB, gpio); HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, GPIO_PIN_SET);这里千万别配置成推挽输出。推挽输出虽然也能工作但当总线挂多个设备时多个从机同时拉低会产生冲突电流而且从根本上违背了漏极开路的组网设计问题很隐蔽。我的习惯是固定用开漏加外部上拉和 DS18B20、DHT11 这类器件统一处理。3.2 微秒级延时DWT 实现OneWire 时序动辄精确到微秒而 HAL_Delay 是毫秒级的所以必须自己实现微秒延时。方案有好几种最省事的是用中断定时器但全局只有一个定时器时不够用。我推荐用内核调试单元 DWT它内部有一个 CYCCNT 计数器每个内核时钟周期加一用它做延时不需要占用定时器资源精度也足够。void DWT_Delay_Init(void) { CoreDebug-DEMCR | CoreDebug_DEMCR_TRCENA_Msk; DWT-CYCCNT 0; DWT-CTRL | DWT_CTRL_CYCCNTENA_Msk; } void delay_us(uint32_t us) { uint32_t start DWT-CYCCNT; uint32_t ticks us * (SystemCoreClock / 1000000U); while ((DWT-CYCCNT - start) ticks); }这里的核心是DWT-CYCCNT - start这个差值运算即使计数器发生了回绕差值依然正确所以不用担心延时超过计数器溢出时间。注意 F103 的内核时钟是 72MHz如果你的系统主频不同SystemCoreClock会相应变化公式不用改。3.3 底层 OneWire 函数基于开漏 GPIO 和 DWT 延时底层函数一共就五个复位、写一位、读一位、写一字节、读一字节。代码看一遍就能理解但有几个细节值得说说。void OW_WriteBit(uint8_t bit) { if (bit) { OW_Pin_Low(); delay_us(6); OW_Pin_High(); delay_us(64); } else { OW_Pin_Low(); delay_us(60); OW_Pin_High(); delay_us(10); } } uint8_t OW_ReadBit(void) { uint8_t bit; OW_Pin_Low(); delay_us(6); OW_Pin_High(); delay_us(6); bit OW_Pin_Read(); delay_us(50); return bit ? 1 : 0; } void OW_WriteByte(uint8_t data) { for (uint8_t i 0; i 8; i) { OW_WriteBit(data 0x01); data 1; } } uint8_t OW_ReadByte(void) { uint8_t data 0; for (uint8_t i 0; i 8; i) { data 1; if (OW_ReadBit()) data | 0x80; } return data; }写 1 时隙时拉低时间我取了 6 微秒然后释放 64 微秒。6 微秒足够从机采样到起始边沿又不会接近 15 微秒上限。写 0 时隙时拉低 60 微秒后释放 10 微秒满足最低 60 微秒要求。读时隙采样点选了释放后 6 微秒这个窗口内从机已经稳定驱动总线信号不会出错。这些延时值不是拍脑袋写的是参考数据手册给出的窗口后取的中间值。实际使用中如果你的主频特别高、GPIO 翻转速度很快可能需要在时序函数里微调几个微秒但只要不接近上限一般都能正常工作。4. DS2431 读写流程与代码底层驱动有了剩下就是按手册把命令拼起来。这里必须强调一个重点DS2431 的 EEPROM 写入不是直接写地址就能完成的而是要走“写暂存器、读暂存器校验、复制暂存器”三步流程。我最初直接照搬 AT24C02 的思维写地址发数据结果怎么都写不进去后来翻了手册才算明白。4.1 读存储器最简单的一条路径先从最简单的读操作说起。读存储器命令是 0xF0后面跟目标地址TA1、TA2然后就可以连续读数据地址会自动递增读完 0xFF 后回卷到 0x00。uint8_t DS2431_ReadMemory(uint8_t addr, uint8_t *buf, uint16_t len) { if (OW_Reset() 0) return 0; OW_WriteByte(0xCC); // Skip ROM OW_WriteByte(0xF0); // Read Memory OW_WriteByte(addr); // TA1 OW_WriteByte(0x00); // TA2 for (uint16_t i 0; i len; i) buf[i] OW_ReadByte(); return 1; }这个函数看起来平平无奇但要注意两个坑。第一TA2 必须发送即使 DS2431 的地址空间只有 0x00 到 0xFF高字节直接填 0如果省略会导致后续数据错位。第二读操作不需要额外等待时间因为从机是被动回传每个 bit 都是跟着主机读时隙走的主程序直接读就行。4.2 通过暂存器写入三步流程DS2431 的写操作之所以特殊是因为它内部有一个 8 字节的暂存器所有写操作必须先往暂存器里放数据确认无误后再一次性复制到 EEPROM。这么做的好处是避免写入过程中途出错导致数据半新半旧代价就是流程多了一步。第一步发送写暂存器命令 0x0F后面跟目标地址和要写入的数据数据长度不能超过 8 字节。第二步可以发送读暂存器命令 0xAA把暂存器内容读回来和期望值比对确认数据传对了。第三步发送复制暂存器命令 0x55把暂存器里的内容真正烧进 EEPROM这一步完成后数据才会掉电不丢。uint8_t DS2431_WriteMemory(uint8_t addr, uint8_t *buf, uint8_t len) { if (len 0 || len 8) return 0; // 不允许跨 32 字节页边界 if ((addr 0x1F) len 32) return 0; // 第一步写暂存器 if (OW_Reset() 0) return 0; OW_WriteByte(0xCC); OW_WriteByte(0x0F); OW_WriteByte(addr); OW_WriteByte(0x00); for (uint8_t i 0; i len; i) OW_WriteByte(buf[i]); // 第二步读暂存器校验可选但推荐 uint8_t scratch[8] {0}; if (OW_Reset() 0) return 0; OW_WriteByte(0xCC); OW_WriteByte(0xAA); OW_WriteByte(addr); OW_WriteByte(0x00); for (uint8_t i 0; i 8; i) scratch[i] OW_ReadByte(); for (uint8_t i 0; i len; i) { if (scratch[i] ! buf[i]) return 0; } // 第三步复制暂存器到 EEPROM if (OW_Reset() 0) return 0; OW_WriteByte(0xCC); OW_WriteByte(0x55); OW_WriteByte(addr); OW_WriteByte(0x00); HAL_Delay(20); // 等待 EEPROM 写入完成保守值 return 1; }代码里的两个保护判断是我实际项目中加的。长度限制是因为暂存器只有 8 字节超了只能分多次写。跨页限制是因为 DS2431 的 Copy 操作是按页做的如果数据跨越了 32 字节页边界复制行为可能和预期不一致与其赌硬件行为不如在驱动层直接禁止。复制暂存器之后的等待时间有讲究。手册给出的典型 EEPROM 写时间大约在 10 毫秒左右我在这里延时 20 毫秒是为了留足余量。如果你的系统对时间敏感可以用手册建议的忙检测方式但需要示波器实际验证器件输出波形我对这块的做法是能固定延时就不做轮询简单可靠优先。4.3 CRC8 校验严谨场景的建议OneWire 协议里设备返回的数据经常带 CRC 校验DS2431 读暂存器时也会在末尾返回一个 CRC 字节。单设备、短总线、无人为干扰的应用场景下不校验也能跑但工业现场、长线、连接器接触不良的场景强烈建议校验。Maxim 的 OneWire CRC8 多项式是 x^8 x^5 x^4 1代码实现如下uint8_t OW_CRC8(uint8_t crc, uint8_t byte) { for (uint8_t i 0; i 8; i) { uint8_t mix (crc ^ byte) 0x01; crc 1; if (mix) crc ^ 0x8C; byte 1; } return crc; }校验逻辑是从 CRC 初值 0 开始依次对每个数据字节做crc OW_CRC8(crc, byte)最后得到的结果和协议返回的 CRC 字节比较相等说明数据传输无误。这个函数在以后写其他 OneWire 器件驱动时也能复用比如 DS18B20 温度传感器的 ROM 读取和暂存器读取用的都是同一个 CRC。5. 多设备寻址与写保护进阶用法单设备场景用 Skip ROM 就够了但 DS2431 真正的玩法是挂在一条总线上做多个身份标签这时候就要处理多设备寻址和写保护的问题。5.1 多设备搜索SEARCH ROM 的原理搜索 ROM 命令 0xF0 是 OneWire 协议里最有意思的部分。它的原理是逐位读取设备 ROM 序列号每一位读两次第一次读“该位为 0 的设备是否响应”第二次读“该位为 1 的设备是否响应”。如果两次结果反过来读位顺序多数代码里是先读一次得到该位值再读一次得到该位补值。根据两次读出的结果可以判断当前位上哪些设备是 0、哪些是 1、哪些位存在冲突。实际编码时逐位搜索、记录冲突位、回溯路径、终止条件整套逻辑不算简单。第一次写的时候我头都大了后来直接参考了 Maxim 官方应用笔记里的算法再改成 STM32 版本省了不少事。如果你不想深入研究也可以走个捷径每个 DS2431 出厂时 ROM 序列号是唯一的批量生产时先把每个设备的序列号读出来写进产品配置运行时直接用已知的序列号做匹配跳过搜索过程。5.2 写保护与状态区DS2431 每个页的 8 字节状态区主要用途就是配置写保护策略。状态区首字节是保护控制位不同的写入值决定该页是正常读写、可撤销保护还是永久锁定。这个特性在做防篡改、防误写设计时很有用比如把设备校准参数写在页 0写入后锁定页 0应用代码无论如何都改不掉。不过写保护这块我要泼一点冷水。DS2431 的保护机制细节和具体位定义在不同资料里写得比较绕而且写入保护位本身也是 EEPROM 操作受前面说的“0 不能直接改成 1”的限制。我的建议是如果你需要启用写保护先去官网把最新版数据手册下载下来找到 Memory Map 和 Protection 那一节对着手册的示例流程操作不要凭记忆写保护命令。驱动这边记住一个原则就行保护配置通过向对应页的状态区首字节写既定模式值实现具体模式值以手册为准。6. 常见问题与排查实录驱动写完不是结束调试才是最花时间的部分。下面这些坑我基本都踩过有些是第一次搞 OneWire 时留下的深刻教训。6.1 检测不到设备先查时序和硬件这是最常见的故障现象是OW_Reset()一直返回 0。排查顺序我建议是先量 DQ 引脚电压空闲时应该是高电平如果没有上拉电阻或者上拉电阻虚焊电平就是浮空的设备自然无法通信。再查地线DS2431 只有 DQ 和 GND 两根线GND 接触不良时存在脉冲会出现毛刺或者完全消失。硬件没问题后用示波器看复位波形。重点看主机拉低时间是不是够 480 微秒释放后 70 微秒左右有没有从机拉低的存在脉冲。如果波形宽度都对但存在脉冲没有大概率是主机拉低时间不够代码里的延时函数没有正确执行。很多新手从江科大的 STM32 教程入门习惯用 SysTick 写延时但 SysTick 如果被其他中断反复抢占延时就会忽长忽短OneWire 这种靠微秒精度吃饭的协议立刻就会出问题。我后来统一用了 DWT 延时再没出过这种幺蛾子。6.2 写进去回读不一致八成是流程问题写入后回读发现数据不对首先检查是不是走了完整的三步流程写暂存器、复制暂存器、等待完成。只执行写暂存器不执行复制数据永远只在 RAM 里掉电就没回读存储器自然是旧的。另外检查长度有没有超过 8 字节超过后多余的数据会写入下一个地址和预期完全对不上。还有一个很隐蔽的问题复制暂存器后的等待时间不够。EEPROM 写入需要时间如果延时不够就马上执行下一次复位可能打断内部写过程。我之前用 5 毫秒延时偶尔出现写入后立刻读取正常、断电重启后数据损坏的情况改成 20 毫秒后就稳定了。6.3 “0 改不回 1”DS2431 最容易被忽视的限制这个坑我必须单独拿出来说因为太多人栽在这里。DS2431 的 EEPROM 写入本质上是“与操作”新写入的数据要和已有数据做按位与结果再存回去。这意味着你只能把某个位从 1 改成 0不能从 0 改回 1。举个例子地址 0x00 存的是 0x7F二进制是 0111 1111。你想把它改成 0xFF也就是 1111 1111按正常理解应该没问题但实际写入后读回来还是 0x7F因为第 7 位本来就是 0新数据这里是 1按位与之后仍然是 0。这个特性在数据手册里叫 EPROM Emulation是设计上故意的目的就是让写入具备“只降不升”的单向性防止意外篡改。所以在应用层设计存储结构时要避开这个坑。比如状态标志位只在需要时置 0不依赖置 1 来清除状态版本号只增不减数据更新时写新的地址而不是原地覆盖。如果你的应用确实需要把已经写 0 的位恢复成 1只能换地址存储或者换一颗真正的 I2C EEPROM别在 DS2431 上硬怼。6.4 时序被中断打断导致的偶发失败OneWire 的时隙都是微秒级的一旦在关键的读写窗口内被高优先级中断打断时序就废了。表现就是数据随机出错、偶尔某一次读写失败、复现困难。排查这种问题最简单的方法是把 OneWire 通信过程放进临界区关中断通信完成后再打开。__disable_irq(); DS2431_ReadMemory(addr, buf, len); __enable_irq();一次读 128 字节的时间也就是几毫秒关中断造成的影响微乎其微。如果系统里有关键中断不能长时间屏蔽可以改用定时器输入捕获模式来实现 OneWire 时序利用定时器硬件来保证时隙精度不过代码复杂度会高不少。我的做法是先用临界区方案保证稳定性如果有极端实时性要求再重构定时器版本。现象可能原因解决办法检测不到设备上拉电阻缺失、地线虚接补上拉电阻检查焊接复现性通信失败时序被中断打断通信期间关中断写入后数据不变只写了暂存器没复制补 Copy Scratchpad 步骤写入后掉电丢失复制后等待不足等待时间加长到 20ms0 位改不回 1DS2431 AND 写入机制应用层设计时避开原地改 17. 一点经验之谈DS2431 这颗芯片在主流开发者眼里不算热门网上资料也不如 AT24C02 丰富但真正用起来会发现它很适合做单总线小容量存储的场景。这次写完驱动我最大的感触是协议类芯片的开发硬啃手册永远比抄代码靠谱。手册里每个时序窗口、每个命令响应都有明确描述照着时序图写代码一次通过的概率很高反过来先抄代码再猜时序出了问题会非常痛苦。另外一个建议是如果你的项目里 Keil5 工程环境还没配好先把 STM32 的基础环境理顺GPIO 驱动和调试器正常了再碰这类时序敏感的器件。芯片包安装、ST-Link 驱动这类环境问题虽然不复杂但它们没搞定的时候你很难静下心排查协议问题。我自己习惯把底层 OneWire 驱动单独抽成一个模块不依赖具体项目以后遇到 DS18B20、DS2432 这些 OneWire 器件都能直接复用省下的调试时间非常可观。最后再分享一个小细节批量使用 DS2431 时最好在产线测试阶段就把每个芯片的 ROM 序列号读出来和 PCB 槽位做绑定。虽然多设备搜索理论上可以自动枚举但实际产线上一个贴歪的器件就可能让搜索算法跑飞。提前绑定序列号运行时用匹配 ROM 直接寻址既省时间又稳。这算是我在这个项目里学到的最实用的一个经验了。