ModbusSlave实战手记：一个嵌入式工程师的从机落地笔记
上周调试一台基于STM32F407的温湿度采集节点时，我第三次拔掉RS-485总线——PLC主站读出来的温度值在42°C和19660°C之间疯狂跳变。示波器上看着干净的差分波形，逻辑分析仪里CRC校验也全绿，但Modbus响应帧就是时不时多出一个字节。最后发现，是T3.5静默定时器被SysTick中断干扰了30μs，导致一帧未收完就被误判为结束，下帧头字节混进了上帧数据区。
这种“协议看起来没问题、波形看起来没问题、结果就是不对”的问题，在Modbus从机开发中太典型了。而ModbusSlave这个库，恰恰是在无数个类似深夜调试后沉淀下来的轻量级解法。它不是教科书里的理想模型，而是一套带着焊锡味、示波器痕迹和复位按钮温度的真实工具链。
它到底轻在哪？别被“单文件”骗了
很多人第一次看到ModbusSlave的README里写着“single header + source”，就以为只是把函数塞进一个.c里。其实它的“轻”，是五层减法的结果：
| 减法层级 | 做了什么 | 工程意义 |
|---|---|---|
| 协议层减法 | 只实现0x01/0x03/0x06/0x10四个功能码，砍掉诊断、文件传输等工业现场根本不用的指令 | 代码体积压到1.8KB，ROM占用不到6KB |
| 内存模型减法 | 所有缓冲区静态分配，无malloc；寄存器区由用户定义结构体，协议栈不碰g_dev内存布局 | 避免裸机环境堆碎片，RTOS下也不用担心内存泄漏 |
| 依赖减法 | 不调用HAL_UART_Receive_IT()这类HAL函数，只接收uint8_t *buf, size_t len, void (*rx_callback)()这样的原始接口 | 能跑在标准外设库、LL驱动、甚至自研UART驱动上 |
| 状态管理减法 | 没有MODBUS_STATE_WAITING_FOR_FRAME这类枚举状态；用slave->rx_state（0/1/2）配合rx_timeout_ms两个变量搞定全部超时逻辑 | 状态机分支少，中断服务程序ISR执行时间稳定在12μs以内（F4@168MHz） |
| 调试减法 | modbus_slave_set_log_hook()不打印完整帧，只输出[RX] ADDR=1 FC=03 START=0 CO |
