简介面向STM32平台的CS1238/CS1237 ADC驱动包用于解决嵌入式系统中高精度、低功耗模拟信号采集问题。CS1238是CS1237的升级版本作为十二位逐次逼近型ADC支持多输入通道以及单次转换、连续转换等工作模式驱动源码已按通用底层接口重构便于在不同STM32系列间移植调整寄存器映射与时钟配置即可。压缩包共两个文件仅两KB其中CS123X.c负责ADC初始化、采样率设置、转换启动、结果读取及GPIO、中断或DMA资源对接CS123X.h则提供配置结构体、枚举类型与函数接口原型方便直接调用。目前已有两千三百八十人学习下载适合正在基于STM32开发数据采集、仪器仪表或工业监控系统的中初级工程师函数分工明确可快速完成采样与数据解析并预留中断服务函数入口便于实时读取转换结果。1. 为什么一颗24位ADC会在I2C上翻车先把CS1238驱动这件事说透手里一块板子主控是STM32外接一颗CS1238上电后读回来的数据不是满量程0x7FFFFF就是在那几个大数附近乱跳排除接线和供电之后问题几乎都出在驱动实现上。CS1238是一颗24位Sigma-Delta ADCI2C接口内置PGA可编程增益常用于称重、压力、应变片这类小信号采集场景。它和普通I2C从机最大的区别在于没有寄存器地址这个概念数据交互靠的是命令帧加24位原始数据而且数据有效的确认机制藏在第25个时钟沿上。很多习惯读AT24C02、读MPU6050的开发者第一次写这颗芯片的驱动都会在时序细节上卡住。这篇笔记围绕「STM32 CS1238驱动」展开从协议层讲到GPIO模拟I2C的具体代码再到补码转换、滤波和排错目标是让新手照着就能把数据读稳让熟手也能避开几个容易忽略的坑。不管你是做电子秤、工业变送器还是电池监测只要主控是STM32、前端是CS1238这套驱动框架都能直接搬。2. 读时序比寄存器重要CS1238的设备地址、命令帧与第25个时钟应答2.1 ADDR引脚决定设备地址0x75 还是 0x76CS1238的I2C地址不是固定死的由芯片的ADDR引脚电平决定。ADDR接GND时7位设备地址是0x75ADDR接VDD时7位地址是0x76。换算成I2C总线上实际发送的字节写操作是0x751即0xEA读操作是0x751再置1即0xEB。注意这里用的是7位地址左移不是某些驱动里直接写0xD0那种8位地址写错一位整个总线都无应答。#define CS1238_ADDR_7BIT 0x75u /* ADDR接GND时 */ #define CS1238_ADDR_WRITE ((CS1238_ADDR_7BIT 1) | 0u) #define CS1238_ADDR_READ ((CS1238_ADDR_7BIT 1) | 1u)同一个I2C总线上最多挂两片CS1238一片ADDR接GND一片接VDD地址正好错开。如果你的板子上有多片CS1238先用万用表量一下ADDR引脚电平再确定地址宏不要凭印象写死。地址配置错误最常见的现象是I2C总线一直收到NACK读出来的数据全是0xFF。ADDR引脚还有个容易忽视的点它内部有弱上下拉或者没有内部偏置取决于批次。如果ADDR悬空地址可能漂移导致设备时好时坏。我一般会在ADDR引脚外部加一个10k电阻到GND或VDD把电平固定住这样量产的板子才不会出现一部分能读、一部分读不到的玄学问题。2.2 帧结构不要和普通I2C从机混为一谈CS1238的I2C交互分两种写配置和读数据。写配置时主机发出START、设备地址加写位随后发送一个8位配置字节配置字节包含通道选择、输出速率和PGA设置从机应答后主机发STOP。整个过程没有寄存器地址偏移量这个概念不要用「先写寄存器地址再写数据」的老套路去驱动它那样从机永远不会正确应答。读数据时主机发START、设备地址加读位然后连续读24个bitMSB在前。重点来了第24个bit读完之后主机还要再产生第25个SCL时钟在这个时钟的高电平期间释放SDA总线从机会主动拉低SDA表示数据有效。如果第25个时钟时SDA是高电平说明本次读取的数据失败应当丢弃。这颗芯片内部带了CRC校验失败帧直接弃掉比事后滤波靠谱得多。/* 读数据时序伪代码 */ START(); write_byte(CS1238_ADDR_READ); /* 从机ACK */ for (i 0; i 24; i) { data (data 1) | read_sda(); pulse_scl(); } release_sda(); /* 主机释放SDA */ pulse_scl(); /* 第25个时钟 */ if (read_sda() 0) { /* 从机拉低 数据有效 */ } else { /* SDA高 CRC错误丢弃 */ }这个第25个时钟是CS1238驱动最容易踩坑的地方。很多例程只数24个时钟就结束了也不检查应答读回来的数据偶尔对偶尔不对还以为是电源噪声。实际上丢掉第25个时钟的检查等于把芯片自带的校验机制浪费掉了数据出错时你根本不知道只能在应用层做各种诡异补偿。2.3 为什么我不用STM32硬件I2C而是GPIO模拟STM32的硬件I2C外设功能上完全支持标准I2C时序但CS1238的交互模式是「命令式」的主机要精确控制第25个时钟的时序还要在特定时刻释放SDA观察从机电平硬件I2C在NACK策略、时钟延展和错误标志处理上绕来绕去出了问题很难排查。相比之下GPIO模拟I2C的时序完全由代码掌控出现问题可以直接用逻辑分析仪对照波形定位到是哪一条语句造成的不合规电平跳变。GPIO模拟的另一个优势是引脚自由任意两个普通IO口就能扩展一路CS1238。硬件I2C往往被挂在固定的I2C1/I2C2引脚上PCB布局受限。做小批量产品或样机调试时GPIO模拟方案改板成本低代码可移植性也高。代价是CPU占用稍高但对于10SPS到640SPS的采样率来说这点占用完全可以接受。#define CS1238_SCL_HIGH() HAL_GPIO_WritePin(SCL_PORT, SCL_PIN, GPIO_PIN_SET) #define CS1238_SCL_LOW() HAL_GPIO_WritePin(SCL_PORT, SCL_PIN, GPIO_PIN_RESET) #define CS1238_SDA_HIGH() HAL_GPIO_WritePin(SDA_PORT, SDA_PIN, GPIO_PIN_SET) #define CS1238_SDA_LOW() HAL_GPIO_WritePin(SDA_PORT, SDA_PIN, GPIO_PIN_RESET) #define CS1238_SDA_READ() HAL_GPIO_ReadPin(SDA_PORT, SDA_PIN)SDA引脚必须配置为开漏输出加上拉电阻不能是推挽输出。推挽模式下主机主动拉高SDA时从机无法把总线拉低表达应答整个通信直接失效。这个细节在纯软件模拟时特别容易被忽略因为你单测主机发送时波形看着是对的一旦从机参与应答就出问题。3. 用GPIO模拟I2C把驱动跑通引脚初始化、写配置与24位读取代码拆解3.1 引脚宏与底层延时先保证时序可调GPIO模拟I2C的时序核心是延时控制。CS1238的标准I2C速率通常在100kHz到400kHz之间我习惯把SCL半周期设定在5到10微秒对应50kHz到100kHz稳定性优先。延时函数用简单的循环计数实现不要在模拟时序里调用依赖操作系统的延时避免任务调度打断导致SCL高电平时间不稳定。static void cs1238_delay_us(uint32_t us) { /* 简易忙等延时实际延时量需按主频微调 */ for (volatile uint32_t i 0; i us * 8; i) { __NOP(); } }初始化时SCL和SDA先设置为开漏输出初始电平都拉高让总线处于空闲状态。有些时候上电后总线被外部设备拉低卡死我初始化后会额外做一次总线恢复连续翻转9个SCL时钟同时让SDA保持高把卡在中间状态的从机状态机复位。这比重新上下电要快得多也适合程序异常复位后自动恢复现场。void cs1238_gpio_init(void) { GPIO_InitTypeDef gpio {0}; __HAL_RCC_GPIOB_CLK_ENABLE(); gpio.Mode GPIO_MODE_OUTPUT_OD; /* 开漏输出 */ gpio.Pull GPIO_PULLUP; /* 内部上拉 */ gpio.Speed GPIO_SPEED_FREQ_HIGH; gpio.Pin SCL_PIN | SDA_PIN; HAL_GPIO_Init(SCL_PORT, gpio); CS1238_SCL_HIGH(); CS1238_SDA_HIGH(); }开漏输出加内部上拉的组合在大多数3.3V供电场景下够用。如果I2C线上还挂了其他设备或者线长超过20厘米建议在外部加2.2k到4.7k的上拉电阻。内部上拉一般在40k到60k之间对于长线来说是偏弱的SDA低电平可能达不到从机识别阈值导致偶发通信失败。3.2 写配置寄存器通道、速率、PGA的bit位怎么摆CS1238的配置字是单个8位字节bit7为写标志固定为1bit6和bit5保留写0bit4和bit3选择通道bit2和bit1选择输出速率bit0选择PGA增益。通道选择上00对应AIN1输入01对应AIN2输入10对应内部温度传感器11对应电源电压检测。速率选择上00是10SPS01是30SPS10是60SPS11是640SPS。PGA为0时增益1倍为1时增益2倍。#define CS1238_CMD_WRITE (0x80u) #define CS1238_CH_AIN1 (0x00u 3) /* AIN1输入 */ #define CS1238_CH_AIN2 (0x01u 3) /* AIN2输入 */ #define CS1238_CH_TEMP (0x02u 3) /* 内部温度 */ #define CS1238_CH_POWER (0x03u 3) /* 电源检测 */ #define CS1238_RATE_10HZ (0x00u 1) #define CS1238_RATE_30HZ (0x01u 1) #define CS1238_RATE_60HZ (0x02u 1) #define CS1238_RATE_640HZ (0x03u 1) #define CS1238_PGA_1 (0x00u) #define CS1238_PGA_2 (0x01u) uint8_t cfg CS1238_CMD_WRITE | CS1238_CH_AIN1 | CS1238_RATE_10HZ | CS1238_PGA_1;注意不同批次或不同封装的芯片寄存器布局可能有差异。我写驱动时会把这段宏集中放在文件头部并标注「按手头手册版本配置」量产前对照你的芯片手册重新核对一遍不要直接抄网上的例程。PGA增益档位多的时候比如需要4倍、8倍、16倍配置字的bit位会变化务必以手册里的寄存器描述为准。写配置时序代码很简单START后发地址写位再发配置字节等从机ACK后STOP最后加2到5毫秒延时让芯片内部完成配置。这个延时不能省配置后立即读数据大概率读到的是切换前的旧通道数据。void cs1238_write_config(uint8_t cfg) { cs1238_i2c_start(); if (cs1238_i2c_write_byte(CS1238_ADDR_WRITE) 0) { cs1238_i2c_write_byte(cfg); } cs1238_i2c_stop(); cs1238_delay_us(2000); }3.3 读24位原始值第25个时钟才是数据有效的关键读数据是CS1238驱动最核心的部分函数要完成START、发送读地址、读24位、检查第25个时钟应答这几步。每一次SCL时钟沿都要先拉高再拉低保证电平稳定时间充足。24个数据位里每一位都在SCL高电平期间读取SDA电平读到的数据依次移入int32_t变量注意左移时要防止符号位污染。int32_t cs1238_read_raw(void) { int32_t raw 0; uint8_t i; cs1238_i2c_start(); if (!cs1238_i2c_write_byte(CS1238_ADDR_READ)) { cs1238_i2c_stop(); return 0x7FFFFF; /* 返回满量程表示错误 */ } for (i 0; i 24; i) { raw 1; if (CS1238_SDA_READ()) { raw | 1; } CS1238_SCL_HIGH(); cs1238_delay_us(5); CS1238_SCL_LOW(); cs1238_delay_us(5); } /* 第25个时钟从机拉低SDA表示数据有效 */ CS1238_SDA_HIGH(); /* 开漏模式下释放总线 */ CS1238_SCL_HIGH(); cs1238_delay_us(5); if (CS1238_SDA_READ()) { raw 0x7FFFFF; /* SDA为高数据校验失败 */ } CS1238_SCL_LOW(); cs1238_i2c_stop(); return raw; }这个函数里发送读地址后的应答检查也不能省。如果地址不对或从机不在总线上write_byte函数内部会发现SDA没被拉低此时立即STOP返回避免后续读时钟打到一个不存在的设备上。错误返回值用0x7FFFFF而不是0是因为0是一个合法读数用满量程值做错误标记更容易在调试时被发现。3.4 串起来上电初始化与主循环采集流程标准的上电流程是初始化GPIO、恢复总线、写一次配置、延时等待稳定、丢弃第一次转换结果、开始正常读取。第一次读取的数据在芯片刚上电时往往不准因为内部数字滤波器和PGA还没稳定丢弃一拍是成本最低的做法。void cs1238_init(void) { cs1238_gpio_init(); cs1238_bus_recover(); /* 9个SCL时钟恢复总线 */ cs1238_write_config(CS1238_CMD_WRITE | CS1238_CH_AIN1 | CS1238_RATE_10HZ | CS1238_PGA_1); cs1238_delay_us(50000); /* 50ms等待稳定 */ (void)cs1238_read_raw(); /* 丢弃第一次 */ }主循环里读取、转换、处理三步分清楚。读原始值后先判断错误标记再转有符号数最后换算物理量。不要在主循环里频繁写配置配置字只在初始化或切换通道时写一次否则会影响采集连续性。4. 把原始读数换成真实电压补码转换、标定与软件滤波4.1 24位补码转有符号数别把负电压读成巨大正数CS1238的转换结果以24位补码形式输出最高位是符号位。直接把raw当作正数用负电压读数会变成接近0x800000的大正数换算出来的电压完全错误。转换方法很简单如果raw的第23位为1用raw减去0x1000000得到负数否则保持不变。这一步必须在滤波之前做否则平均滤波会把正负值混在一起。int32_t cs1238_to_signed(int32_t raw) { if (raw 0x800000) { return raw - 0x1000000; /* 24位补码转有符号 */ } return raw; }一个典型场景是电桥传感器零点时输出可能是微负电压采集回来后显示成几百万的LSB。转成有符号数后零点附近的读数才符合直觉后续标定零点偏移才有意义。我见过有人跳过这一步直接在无符号域做零点校准结果正负不对称校准曲线始终是个折线怎么调都调不平。4.2 从LSB到物理量参考电压、PGA与满量程的关系CS1238是比例式ADC满量程输入电压对应参考电压除以PGA增益。如果参考电压直接取VDD那么电压计算公式是实际电压等于有符号读数除以满量程值再乘以VDD再除以PGA。满量程值这里要注意24位有符号数的正满量程是0x7FFFFF即8388607负满量程是-8388608计算时按8388608作为基准比较对称。float cs1238_to_voltage(int32_t signed_raw, float vref, uint16_t pga) { float lsb vref / (float)pga / 8388608.0f; return (float)signed_raw * lsb; }PGA增益对分辨率的影响很大。同样的参考电压3.3VPGA为1时每个LSB对应约0.39微伏PGA为2时约0.2微伏。小信号场景下提高PGA是提升有效分辨率的直接手段但PGA越高输入端的噪声和失调也越明显。实际操作中如果传感器输出范围允许优先把PGA调高再用软件滤波压低噪声。参考电压的选择要注意如果VDD是开关电源供电纹波会直接耦合进转换结果这种场景下建议给VDD加RC滤波或者改用外部精密基准源。比例式ADC的好处是传感器电桥的供电和参考电压用同一个VDD时电桥的比率输出天然抵消了电源波动这也就是称重仪表里常说的ratiometric测量。4.3 滑动均值滤波10SPS下的去抖实践CS1238在10SPS输出速率下每个转换结果间隔100毫秒。如果单次读数直接用于显示或控制跳动会很明显。滑动均值滤波是嵌入式里性价比最高的方案存储N个最近采样值每次更新时剔除最旧的一个相加后求平均。N取值在4到16之间N越大越平滑但响应越慢。#define FILTER_N 8 static int32_t s_buf[FILTER_N]; static uint8_t s_idx 0; static int32_t s_sum 0; int32_t cs1238_filter(int32_t new_val) { s_sum - s_buf[s_idx]; s_buf[s_idx] new_val; s_sum new_val; s_idx (s_idx 1) % FILTER_N; return s_sum / FILTER_N; }这个滤波器的坑在于如果通道切换或量程跳变旧数据要立刻清空否则平均值里残留着上一个通道的读数过渡过程会拉长。我一般会在切换通道后把s_buf全部清零再填充新通道的数据。另外滤波窗口内的数据要做溢出保护加法和默认int32_t足够存8个24位数据但如果你把N加到64以上就要考虑s_sum的类型了。5. CS1238驱动避坑指南5个让数据乱跳的常见问题与排查顺序5.1 上电就读永远返回0x7FFFFF现象是CS1238上电后无论怎么读数据都是满量程0x7FFFFF或者偶尔正常偶尔满量程。原因是芯片上电后需要稳定时间内部PGA和数字滤波器未就绪加上I2C总线上可能存在残留电平第一次读操作本身就失败了。解决方法是上电后延时50毫秒以上先做一次总线恢复再丢弃第一次转换结果。如果问题依旧用逻辑分析仪看第25个时钟确认从机有没有拉低SDA。5.2 数据跳动超出预期甚至达到几十个LSB现象是电源和接线都没问题但滤波后数据仍然跳动。原因往往是参考电压VDD的纹波太大或者PGA增益较高时输入端的走线拾取了噪声。解决方法是在VDD引脚和AVDD引脚附近加10uF和0.1uF去耦电容传感器信号线尽量短且等长必要时在ADC输入端加RC低通滤波。另外检查一下PGA增益是否设置过高信号接近满量程时噪声会成倍放大适当降低增益再放大后续信号反而更稳。5.3 切换通道后前几次读数不准现象是从AIN1切到AIN2后前两三个转换结果明显偏离正常值。原因是CS1238内部数字滤波器需要几个转换周期才能收敛到新通道的输入电平这个现象在Sigma-Delta ADC上很常见不是芯片坏了。解决方法是写配置后丢弃前2到3次转换结果或者利用配置写完后延时几毫秒再开始读。不要在应用里用切换后第一个数据做控制判断。5.4 SDA总线被拉死程序复位后通信恢复不了现象是程序跑一段时间后I2C通信完全卡死复位主控也无效必须重新上下电。原因是某个时刻通信中断在中间状态从机还在等待剩余的SCL时钟而主机已经放弃总线了。SDA被从机拉低不放后续所有START信号都无法产生。解决方法是每次初始化时执行总线恢复函数连续发9个SCL时钟让从机状态机复位。我习惯在每次写失败或读失败后也调一次总线恢复把异常状态尽早清掉。void cs1238_bus_recover(void) { uint8_t i; CS1238_SDA_HIGH(); for (i 0; i 9; i) { CS1238_SCL_HIGH(); cs1238_delay_us(10); CS1238_SCL_LOW(); cs1238_delay_us(10); } }5.5 硬件I2C读出的数据偶发错位或丢字节现象是使用STM32硬件I2C外设时读取结果偶尔整体偏移一位或数据错乱。原因是硬件I2C在从机时钟延展、NACK自动处理上的行为不完全可控当CS1238在第25个时钟上拉低SDA时硬件外设可能把它误判为总线冲突。解决方法是切换到GPIO模拟I2C或者如果用硬件I2C必须仔细配置NACK生成时机和时钟延展超时。我做项目时默认用GPIO模拟省去这类排查时间。6. 进阶降低MCU占用、多片级联与采集日志回归6.1 把采集搬进定时器中断重入问题怎么处理当CS1238的采样率提升到640SPS主循环轮询可能会拖慢其他任务。可以把读取操作放进定时器中断里根据输出速率设置定时器触发周期。中断里的读取要保证原子性中断函数里不要调用HAL_Delay这类阻塞延时改用自旋计数。主循环和应用代码通过一个全局变量拿最新结果读取该变量时关闭中断或使用volatile修饰。volatile int32_t g_cs1238_raw 0; void TIMER_IRQHandler(void) { int32_t raw cs1238_read_raw(); if (raw ! 0x7FFFFF) { g_cs1238_raw cs1238_to_signed(raw); } }重入问题在于如果中断里正在做I2C时序外部又来一个更高优先级中断时序会被打断。所以定时器中断优先级不要设太高或者确保I2C读期间不被更高级的中断抢占。GPIO模拟I2C最怕的就是时序被割裂SCL高低电平时间忽长忽短偶尔能从机通信失败。6.2 同一条总线上挂多个CS1238多片级联时每片CS1238的ADDR引脚分别接GND和VDD最多两片。如果超过两片需要额外用GPIO做片选模拟类似SPI的片选行为需要访问哪片就先把它的ADDR引脚拉到位再发送对应地址。这种方式简单可靠代价是切换地址引脚后要重新写配置和等待稳定。我做过一个四通道采集方案两片CS1238加一个GPIO切换ADDR电平实测切换时间在几毫秒级别对10SPS的应用完全够用。切通道的规则是拉高或拉低ADDR、延时1毫秒、写配置、丢弃两个转换结果、开始读取。把这个流程封装成一个函数应用层不感知具体硬件细节。6.3 用采集日志做回归验证驱动写完不是跑通就结束了。我会在调试阶段把原始读数、有符号转换值、电压值和时间戳一起打印出来连续采集几百个点用串口助手存成文本看数据分布是否合理。这个习惯在改配置、换通道、调滤波参数时特别有用能快速发现参数改动带来的副作用而不是凭感觉判断数据「好像正常了」。printf(%08lX %ld %d.%06ld\r\n, (unsigned long)raw, (long)signed_val, (int)voltage_mv / 1000, (long)voltage_mv % 1000);保存日志后用表格软件拉出最大值、最小值和标准差就能量化评估滤波效果和噪声水平。我踩过的最大一个坑是改了滤波窗口后肉眼看数据很平滑但拉标准差一算实际噪声反而更大通过日志回归才发现了均值滤波引入的量化残留。CS1238这颗芯片本身不难难在把时序细节做扎实。每次拿到新板子我先用GPIO模拟I2C把原始读数和第25个时钟应答确认清楚再去优化速度和功耗这个顺序从来没让我走弯路。希望这篇笔记能帮你少调几天I2C时序。本文还有配套的精品资源点击获取