STM32实现4-20mA转换板测试：外部中断与状态机校准实战

简介：面向工业自动化领域需要实现4-20mA电流环输出的开发者，STM32输出4-20mA电流信号测试代码V0.003是一套可直接使用的参考工程。代码基于STM32标准外设库，完整覆盖外部中断触发、DAC输出映射、主循环控制、故障检测与保护，并针对电阻分压、参考电压设置、量程线性校准提供了相应处理，帮助理解数字量到4-20mA模拟电流的完整转换流程。压缩包采用RAR格式，大小4.01MB，共241个文件，除大量.h/.c源程序外，还包含.o/.crf编译中间文件、Keil工程文件（.uvproj、.uvoptx）、链接映射.map与Hex烧录文件等，可在MDK中直接打开编译、仿真和下载调试，便于动手验证。该项目已被528人学习，具备一定参考价值，适合4-20mA转换板调试、STM32 D/A外设学习、产品原型验证以及嵌入式课程设计等场景。

1. 4-20mA转换板测试代码到底该测什么

拿到一块4-20mA转换板，最直接的测试办法是写个循环把DAC寄存器填满，再看电流表有没有跟着动。但这种做法在STM32驱动下往往得到误导性结论：DAC寄存器有值，电流却一直锁在4mA，或者调到20mA时满度偏了十几个百分点。标题里的V0.003说明这套测试代码已经迭代到第三版，V0.003解决的不是“能不能出电流”，而是把输出链路的零点和满度、PWM/DAC转换、外部中断触发的量程切换，做成一套按按钮就能重复执行的测试流程。本文围绕STM32的PWM加DAC两条路径，讲清4-20mA输出链路的原理、外部中断在测试代码里怎么用、状态机怎么组织，最后给出一组可以直接抄的校准和验证做法。适合正在做4-20mA变送器、PLC输出模块或压力/温度变送器节点测试的嵌入式工程师。这一版代码把中断、定时器、DAC和串口调度放在一起，重点解决手动测试时“按一下切换一个电流值”的稳定性问题。

2. 外部中断在4-20mA转换板测试里扮演什么角色

2.1 外部中断不是用来产生电流的，而是用来推进测试状态

很多新手拿外部中断去直接控制DAC输出，按下按键就改一次占空比，这种做法在测试代码里非常不可靠。4-20mA是缓变信号，但外部中断进来的时候，主循环可能正在做ADC采样或者刷新OLED，如果中断服务函数里直接调用HAL_TIM_SetCompare，PWM占空比会立即变化，但电流环路的运放建立需要时间，结果就是电流表读数还没稳定，代码已经跑到下一个状态。V0.003里外部中断的职责只有两个：置位状态切换请求标志，以及记录一次边沿事件的时间戳。具体电流值的计算、DAC写入、串口打印全部放在主循环里做。这样中断服务函数保持在微秒级，不会影响PWM输出和ADC采样的时序。这是测试代码和产品代码的一个明显差异：产品代码里外部中断可能承担紧急保护，测试代码里它只是一个“人肉触发信号源”。理解这一点，后面配置参数才不会盲目照搬。

2.2 用STM32的EXTI线配置外部中断：下降沿加内部上拉

常见的测试板会留一个按键接口，按下时拉低电平，所以用下降沿触发比较合适。以STM32F103系列为例，PB0可以映射到EXTI0。初始化代码如下：

static void EXTI_Key_Init(void) { GPIO_InitTypeDef gpio = {0}; __HAL_RCC_GPIOB_CLK_ENABLE(); __HAL_RCC_SYSCFG_CLK_ENABLE(); gpio.Pin = GPIO_PIN_0; gpio.Mode = GPIO_MODE_IT_FALLING; // 下降沿触发 gpio.Pull = GPIO_PULLUP; // 外部按键接GND，平时为高 HAL_GPIO_Init(GPIOB, &gpio); HAL_NVIC_SetPriority(EXTI0_IRQn, 2, 0); HAL_NVIC_EnableIRQ(EXTI0_IRQn); }

这段代码用HAL库初始化PB0为外部中断输入。GPIO_MODE_IT_FALLING表示只在电平从高到低跳变时触发一次中断，适合机械按键或外部数字触发信号；GPIO_PULLUP保证引脚悬空时读到确定的高电平，避免用手触摸或信号线松动时产生随机边沿。中断优先级设置为2，这里有一个细节：如果PWM定时器中断也在用，外部中断优先级不要高于定时器中断，否则频繁按键会导致PWM周期抖动。回调函数里只做标志位置位：

volatile uint8_t test_step_request = 0; void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin) { if (GPIO_Pin == GPIO_PIN_0) { test_step_request = 1; // 主循环轮询此标志 } }

这样设计的原因是HAL_GPIO_EXTI_Callback执行在中断上下文，如果在这里采样ADC、计算校准系数或者操作I2C读EEPROM，中断会占用几十微秒，对4-20mA这种模拟输出影响不大，但会阻塞其他更高优先级的中断响应。主循环里检测到test_step_request后清标志并切换测试档位，整个流程是异步的。

2.3 防抖与长按复位的取舍

机械按键在按下和释放瞬间会产生多个脉冲，如果外部中断设置为下降沿触发，一次按键可能触发多次进入回调。测试代码里最简单的处理是等主循环处理完一次切换后加50ms延时，忽略期间的所有中断请求。更稳的做法是记录上次触发时间：

void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin) { uint32_t now = HAL_GetTick(); if (GPIO_Pin == GPIO_PIN_0 && (now - last_exti_time) > 60) // 60ms消抖 { last_exti_time = now; test_step_request = 1; } }

这里last_exti_time要定义为static uint32_t。消抖窗口取60到100ms都可以，太短无法过滤机械开关的毛刺，太长则连按两次会丢失一次状态切换。测试场景下这个参数可以放宽到100ms，因为4-20mA档位切换本身也不需要高频率。长按复位的逻辑可以放在主循环里：检测到按键释放后测量高电平持续时长，超过1.5秒则复位到初始4mA档位。但这也是一个容易踩坑的点，V0.003的做法是按钮每按一下只在4mA、8mA、12mA、16mA、20mA五个档位间顺序切换，长按复位功能默认关闭，避免测试过程中误触导致状态错乱。

3. STM32输出4-20mA电流信号的两种实现路径

3.1 从DAC电压到4-20mA电流环的输出链路

STM32内部DAC输出的是电压，范围通常是0到3.3V，无法直接驱动4-20mA电流环。转换板上的核心电路是电压转电流的V/I变换电路，常见结构是运放加三极管或MOSFET加采样电阻。测试代码里只需要关心一个映射关系：DAC输出0到3.3V电压，经过转换板后对应0到20mA或4到20mA电流。两种映射对应完全不同的软件逻辑。如果硬件电路设计成0V输入时输出4mA，那么软件计算时就要在DAC值上叠加一个“零点偏置”；反过来，如果电路在0V时输出0mA，但需要4mA作为量程零点，那么软件要保证DAC输出永远不会低于对应4mA的电压。搜“4-20ma转0-3v电路”能找到很多反向变换的参考图，反向变换是把250欧姆采样电阻上的1到5V电压衰减到0到3.3V供ADC读取，转换板测试代码里经常需要同时存在这两种转换逻辑，输出给执行器的是4-20mA，从外部读取回来的反馈信号也要转成电压进ADC。所以测试代码里至少应该有两个独立的换算函数，一个做电压到电流的输出映射，一个做电流到电压的反馈映射，不能用同一个系数。

3.2 用定时器PWM模拟DAC输出

测试板上不一定都带了STM32DAC芯片，很多低成本转换板直接用定时器PWM加RC滤波产生直流电压。这样省掉一路DAC，但牺牲了纹波性能和分辨率。以STM32的TIM3为例，输出20kHz的PWM，占空比由比较寄存器控制，RC滤波后得到直流电压：

void PWM_DAC_Init(void) { TIM_OC_InitTypeDef oc = {0}; __HAL_RCC_TIM3_CLK_ENABLE(); htim3.Instance = TIM3; htim3.Init.Prescaler = 17; // 72MHz / (17+1) = 4MHz htim3.Init.Period = 199; // 重装值200，输出频率 4MHz/200 = 20kHz htim3.Init.CounterMode = TIM_COUNTERMODE_UP; HAL_TIM_PWM_Init(&htim3); oc.OCMode = TIM_OCMODE_PWM1; oc.Pulse = 0; oc.OCPolarity = TIM_OCPOLARITY_HIGH; HAL_TIM_PWM_ConfigChannel(&htim3, &oc, TIM_CHANNEL_1); HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1); }

Prescaler为17，Period为199，组合出来的PWM频率是20kHz，超过了人耳可听范围，也不会和电源纹波产生明显拍频。RC滤波的截止频率需要远低于20kHz才能把纹波抑制到可以接受的水平，典型参数是10k欧姆电阻加1uF电容，截止频率约16Hz，此时20kHz的纹波被衰减到不到1mV。如果RC截止频率太高，纹波会直接叠加到电流环路上，测出来就是4-20mA信号上有一个固定频率的小锯齿波，万用表直流档看不出，但示波器电流探头一看就暴露。

占空比到目标电流的换算方式要写清晰：

uint32_t current_to_pwm_duty(float current_mA) { float voltage_ref = (current_mA - 4.0f) / 16.0f * 3.3f; // 4mA对应0V，20mA对应3.3V float duty = voltage_ref / 3.3f * 200.0f; return (uint32_t)(duty + 0.5f); // 四舍五入 }

这个函数假设转换板的V/I电路在0V输入时输出4mA。如果硬件是0V对应0mA，那公式要改成voltage_ref = current_mA / 20.0f * 3.3f，同时软件必须主动避开小于4mA的DAC值，否则可能输出0mA导致接收端判断为断线。计算完成后用__HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, duty)写入比较寄存器。占空比的数学分辨率是1/200，对应电流分辨率约为0.08mA，实际上RC滤波后有效值大约只有8到9位精度，测试代码里不要盯着0.1mA以下的变化做判断。

3.3 DAC直连输出与PWM路径的差异

如果转换板上集成了STM32的DAC外设，优先用DAC而不是PWM。DAC是真正的12位电压输出，分辨率大约是0.8mV，换算成4-20mA电流约为0.004mA的步进，几乎可以忽略。DAC的更新需要一条语句：设定通道、写数据寄存器、软件触发转换：

uint32_t current_to_dac_value(float current_mA) { float voltage_ref = (current_mA - 4.0f) / 16.0f * 3.3f; uint32_t dac = (uint32_t)(voltage_ref / 3.3f * 4095.0f); if (dac > 4095) dac = 4095; return dac; } void dac_set_current(float current_mA) { uint32_t dac_value = current_to_dac_value(current_mA); __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, PWM_DAC_INIT_DISABLED); // 占位，避免误写 (void)htim3; // 实际项目中此处应调用 DAC 通道写入函数 // 例如 HAL_DAC_SetValue(&hdac, DAC_CHANNEL_1, DAC_ALIGN_12B_R, dac_value); }

上面代码里特意留了一个占位，因为很多测试板不用DAC时，PWM路径仍然在工作，代码里不能同时把两套输出模块都启动。两套路径同时使能的情况下，电流输出等于两个信号源叠加，测试结果必然错误。V0.003的做法是编译期宏开关，#define OUTPUT_MODE_PWM和#define OUTPUT_MODE_DAC二选一，运行时只初始化选择的路径。还有一个容易忽略的问题：STM32的DAC在上电复位后输出值是0，如果V/I电路是0V对应4mA，那上电瞬间会输出4mA，正常；如果V/I电路是0V对应0mA，则输出0mA，接收端会报断线。因此测试代码初始化时必须在main函数最早阶段就把DAC设到4mA对应的值，而不是等外设初始化完成后再设。这个问题在V0.003的commit记录里被反复提到，核心原因就是初始化顺序。

4. V0.003测试代码的状态机：校准、量程切换与边界检查

4.1 测试状态机与外部中断的联动

V0.003把测试流程组织成一个线性状态机，外部中断每触发一次，就向状态机投递一个“切换到下一档”的事件。状态定义从4mA开始，依次经过8mA、12mA、16mA、20mA，再回到4mA，形成循环。结构体里记录当前档位、目标电流、实际ADC回读值和错误码：

typedef enum { TEST_STEP_4MA, TEST_STEP_8MA, TEST_STEP_12MA, TEST_STEP_16MA, TEST_STEP_20MA, TEST_STEP_NUM } TestStep_t; typedef struct { TestStep_t step; float target_mA; float current_readback_mA; uint8_t fault_code; } TestState_t;

主循环里检测到test_step_request标志后，先完成当前档位的回读和记录，再切换到下一档并写入新的DAC或PWM值：

void test_state_machine_run(TestState_t *state) { if (test_step_request) { test_step_request = 0; adc_measure_and_store(state); // 记录切换前电流 state->step = (TestStep_t)((state->step + 1) % TEST_STEP_NUM); dac_set_current(step_to_current_mA(state->step)); HAL_Delay(50); // 等待运放和RC建立 adc_measure_and_store(state); // 记录切换后电流 debug_print_state(state); } }

切换前后各采样一次电流，这个设计很关键。切换前的采样用于验证上一档的输出是否维持在目标误差范围内；切换后的采样用于确认当前链路是否真的建立到目标电流。如果两个采样结果都正常，才算是完整通过一档测试。如果用万用表外部测量，切换前后各读一次的意义不大，但代码里保留双采样可以对后续自动测试提供历史数据。HAL_Delay(50)的50ms取决于V/I电路的建立时间，RC滤波截止频率低到16Hz时，建立到99%需要大约10个时间常数，约1秒，所以50ms可能不够。V0.003实际是把延迟参数提取成了宏，硬件带有快速运放时设50ms，带简单RC滤波时设300ms。

4.2 零点和满度双点校准

测试代码里最核心的算法就是两点校准。先让DAC输出对应4mA的值，用万用表读回实际电流，再让DAC输出对应20mA的值，读回实际电流，就可以计算线性校正系数。转换板上的运放存在失调电压和增益误差，两个点校准后中间档位可以做到0.1%左右的精度。算法如下：

typedef struct { float k; // 电流到电压的斜率，单位 V/mA float b; // 4mA时的电压偏置，单位 V float output_offset; // 输出链路零偏，单位 mA } CalibParam_t; void calibrate_two_point(CalibParam_t *calib, float v_low, float v_high) { calib->k = (v_high - v_low) / (20.0f - 4.0f); calib->b = v_low - calib->k * 4.0f; calib->output_offset = 0.0f; } float current_from_voltage(float voltage, const CalibParam_t *calib) { return (voltage - calib->b) / calib->k; }

校准过程中最大的坑是万用表串联在电流回路里时，表的输入阻抗会分压。4-20mA电流环通常由外部24V供电，回路里串入一只万用表电流档，表的内阻一般在10欧姆到100欧姆之间，20mA时表上的压降可以达到0.2到2V。如果外部供电电压余量不足，转换板输出电压接近饱和，电流可能达不到20mA。测试代码里判断饱和的方法是把实际回读电压和DAC设定电压对比，如果两者差超过某个阈值，报一个过载错误：

#define OVERSHOOT_FAULT_THRESHOLD_MV 250 if (dac_set_voltage_mV - adc_readback_mV > OVERSHOOT_FAULT_THRESHOLD_MV) { state->fault_code = 0x51; // 输出级饱和 }

4.3 调试输出与常见故障码表

状态机每切换一次，串口就输出一行调试信息，包含当前档位、设定电流、回读电流、误差百分比和故障码。串口配置为115200-8-N-1。输出格式用CSV样式，方便直接复制到Excel或Python脚本里做记录：

故障码的设计要覆盖测试中常见的四类问题。0x00表示正常。0x51对应输出饱和，前面已经说过。0x52对应回路电压跌落，当ADC回读到电源电压低于设定阈值时触发，通常原因是外部供电能力不足或回路中有额外负载。0x53对应电流建立超时，写入DAC后等待了最大建立时间，回读电流仍没有进入目标值正负0.5%窗口。0x54对应外部中断误触发，两次中断间隔小于消抖窗口，代码认为按键存在机械抖动或外部干扰，这类故障码不阻塞测试，只是记录事件。调试时把故障码打印成十六进制，方便和示波器截图对照。实际项目中曾遇到0x52和0x51同时出现的场景，看起来像是饱和，但实际上是供电线太细导致负载调整率差，输出电流加大时电源电压被拉低，把故障码分开定义才能从日志里区分这两种情况。V0.003里还加了一条规则：任何故障码非0x00，状态机锁定在当前档位，必须长按按键超过2秒才能复位。这是为了防止测试人员在故障状态下反复切换档位，掩盖真正的问题。

5. 用外部中断做自动档位校准时的三个验证技巧

5.1 验证中断触发与电流建立的时序窗口

手动测试时按一下按键等读数稳定，看不出问题。自动跑一遍五档循环会发现一个现象：电流还没稳定，状态机就已经切到下一档了。验证方法是在串口输出里同时打印“切换请求时间戳”和“电流建立完成时间戳”，两者之差就是要调整的间隔。可以关闭消抖后连续快速按两次按键，观察两次切换的时间间隔是否小于PWM滤波的建立时间，如果小于，说明需要把消抖窗口加大，或者把状态机里的HAL_Delay调大。这个验证技巧本质上是把外部中断当作一个定时触发源，用代码里的时间戳做量化，比用示波器探头夹在按键两端更直接。

5.2 验证20mA满度时的回路压降余量

调整到20mA档后，用万用表量转换板的供电端电压，再量V/I电路输出端对地电压，两者相减就是调整管上承担的压力。正常情况下降压至少要有2V以上，否则运放进入非线性区，电流会被“顶死”在某个值。测试代码里加一个专门诊断模式：在20mA档把PWM占空比提高10%，看电流是否有反应，如果有，说明余量充足；如果没反应，说明已经饱和。这个操作要放在代码的隐藏接口里，避免测试人员误触发。V0.003的处理方式是连续五次快速按外部中断按键进入诊断模式，这个交互方式不需要额外硬件。

5.3 用串口回读校准系数的可重复性

校准完成后把CalibParam_t结构体的四个浮点数通过串口打印出来，连续校准三次，对比三次结果。如果三次校准的k值差异超过0.5%，说明校准时的万用表读数不稳定或回路供电波动太大，需要先解决硬件问题再继续测试。另一个更严格的验证是：校准后回到4mA档，记录回读电流，然后断电重新上电，回到4mA档，再记录一次。两次差异如果超过0.1mA，说明校准系数没有正确存入非易失存储，或者上电时DAC初始化顺序不对。排查顺序是先看代码里校准系数是否在初始化后被覆盖，再看DAC寄存器是否被其他外设意外修改。最后一步是用示波器电流探头抓切换瞬间的波形，正常情况应该是平滑爬升或下降，如果看到阶梯状波形，说明PWM占空比更新和电流环路建立之间缺少平滑过渡逻辑，考虑在状态机切换时用斜坡函数逐步逼近目标值而不是一步到位。

本文还有配套的精品资源，点击获取