1. 项目背景与核心价值
在工业自动化领域，Modbus协议作为最广泛应用的串行通信标准之一，其开源实现FreeModbus凭借轻量级和可移植性深受开发者青睐。而STM8S系列作为STMicroelectronics推出的高性价比8位MCU，在成本敏感型设备中占据重要市场。将FreeModbus移植到STM8S平台，相当于为价值3美元的MCU赋予了工业级通信能力——这正是我在去年为某智能电表项目解决的实际需求。
传统方案中，开发者往往选择STM32等32位MCU运行Modbus协议栈，但在温控器、IO模块等简单设备上存在资源浪费。通过本移植方案，可在仅8KB Flash和1KB RAM的STM8S003F3上实现完整的RTU模式通信，BOM成本降低40%以上。实测表明，移植后的协议栈在9600bps波特率下，报文响应时间稳定在5ms以内，完全满足Classic Modbus应用场景。
2. 移植环境准备
2.1 硬件选型要点
推荐使用STM8S003F3P6作为基础平台，其关键参数如下：
- 16MHz HSI时钟频率
- 8KB Flash存储器
- 1KB RAM
- 128B EEPROM
- 2个UART接口（需使用UART1实现Modbus）
注意：避免选择STM8S105系列等带CAN控制器的型号，其UART1与CAN引脚复用可能导致通信异常。我在初期测试中就曾因此浪费两天排查时间。
2.2 开发工具链配置
采用IAR for STM8 3.11作为开发环境，其配置要点包括：
- 在Project > Options > General Options中：
- Target选择STM8S003
- Data model选择Small（指针16位）
- 在C/C++ Compiler > Preprocessor添加宏定义：
c复制
USE_STDPERIPH_DRIVER, STM8S003 - 在Linker > Config中勾选"Override default"并指定
lnkstm8s003f3.icf文件
3. FreeModbus源码适配
3.1 协议栈裁剪策略
原始FreeModbus 1.5包含的功能模块如下表所示：
| 模块名称 | 占用Flash | 必需性评估 |
|---|---|---|
| mb.c (核心层) | 3.2KB | 必须保留 |
| port (硬件抽象层) | 1.1KB | 必须保留 |
| rtu (传输层) | 2.4KB | 必须保留 |
| ascii (传输层) | 2.7KB | 可裁剪 |
| tcp (传输层) | 4.5KB | 必须裁剪 |
| functions (功能码) | 可变 | 按需选择 |
建议保留的基础功能码：
- 0x01 (读线圈)
- 0x03 (读保持寄存器)
- 0x06 (写单寄存器)
- 0x10 (写多寄存器)
3.2 关键移植文件修改
3.2.1 portserial.c实现
UART驱动需要重写以下关键函数：
c复制void vMBPortSerialEnable( BOOL xRxEnable, BOOL xTxEnable ) {
if( xRxEnable ) {
UART1->CR2 |= UART1_CR2_REN; // 使能接收
UART1->CR2 |= UART1_CR2_RIEN; // 使能接收中断
} else {
UART1->CR2 &= ~UART1_CR2_REN;
}
if( xTxEnable ) {
UART1->CR2 |= UART1_CR2_TEN; // 使能发送
} else {
UART1->CR2 &= ~UART1_CR2_TEN;
}
}
3.2.2 porttimer.c配置
STM8S的TIM4定时器配置示例：
c复制BOOL xMBPortTimersInit( USHORT usTim1Timerout50us ) {
CLK->PCKENR1 |= CLK_PCKENR1_TIM4; // 使能TIM4时钟
TIM4->PSCR = 0x07; // 预分频128，16MHz/128=125kHz
TIM4->ARR = usTim1Timerout50us * 6; // 125kHz/6≈20.83kHz(48us)
TIM4->IER |= TIM4_IER_UIE; // 使能更新中断
return TRUE;
}
4. 硬件接口实现细节
4.1 RS485电路设计要点
推荐使用SP3485作为收发器芯片，其典型电路连接方式：
- DE/RE控制线连接STM8S的PB5引脚
- 在发送前需置高DE/RE电平：
c复制void vMBPortSerialPutByte( CHAR ucByte ) { GPIOB->ODR |= GPIO_PIN_5; // 使能发送 UART1->DR = ucByte; while( !(UART1->SR & UART1_SR_TC) ); GPIOB->ODR &= ~GPIO_PIN_5; // 恢复接收 } - 在PCB布局时，A/B线需加120Ω终端电阻，且走线长度不超过15cm
4.2 抗干扰设计实践
在工业现场应用中，必须采取以下措施：
- 电源隔离：采用B0505S-1W模块实现3.3V电源隔离
- 信号隔离：添加ADuM1201数字隔离器
- TVS保护：在A/B线对地接SM712双向TVS管
- 软件滤波：在串口中断中增加以下校验逻辑
c复制if( UART1->SR & UART1_SR_OR ) { UART1->SR &= ~UART1_SR_OR; // 清除溢出标志 xMBPortSerialPoll(); // 重置接收状态 }
5. 协议栈优化技巧
5.1 内存占用优化
通过以下方法可将RAM占用从800B降至600B：
- 修改
mbconfig.h中的设置：c复制#define MB_FUNC_HANDLERS_MAX ( 4 ) // 仅支持4个功能码 #define MB_REG_HOLDING_NREGS ( 32 ) // 保持寄存器数量减半 - 使用
__eeprom关键字将部分配置参数存入EEPROM：c复制__eeprom uint16_t usDeviceAddress = 0x01;
5.2 响应速度提升方案
通过中断优先级调整可提升实时性：
- 在
stm8s_it.c中设置中断优先级：c复制void TIM4_UPD_OVF_IRQHandler() __interrupt(23) { TIM4->SR1 &= ~TIM4_SR1_UIF; pxMBPortCBTimerExpired(); } - 在初始化时配置中断优先级：
c复制
ITC_SetSoftwarePriority(ITC_IRQ_UART1_RX, ITC_PRIORITYLEVEL_2); ITC_SetSoftwarePriority(ITC_IRQ_TIM4_OVF, ITC_PRIORITYLEVEL_1);
6. 测试验证方法
6.1 功能测试流程
使用Modbus Poll工具测试时，建议按以下顺序验证：
- 设备地址测试：发送01 03 00 00 00 01 CRC，确认返回正确地址
- 寄存器读写测试：
- 先写入06功能码：01 06 00 00 12 34 CRC
- 再读取03功能码：01 03 00 00 00 01 CRC
- 异常码测试：发送非法功能码01 05 00 00 00 01 CRC，应返回01 85 02 CRC
6.2 压力测试方案
使用Python脚本模拟主站持续通信：
python复制import serial
import time
ser = serial.Serial('COM3', 9600, timeout=0.1)
for i in range(1000):
req = bytes.fromhex(f"01 03 00 00 00 02 {crc16_modbus('010300000002'):04X}")
ser.write(req)
res = ser.read(7)
if len(res) !=7 or res[0] != 0x01:
print(f"Error at {i}th request")
break
time.sleep(0.01)
7. 典型问题排查
7.1 通信超时问题
现象：主站接收超时，从站无响应
排查步骤：
- 用示波器测量A/B线差分信号，确认波形幅值在1.5V-5V之间
- 检查UART初始化参数是否匹配：
c复制UART1->BRR2 = 0x03; UART1->BRR1 = 0x68; // 9600bps @16MHz - 确认RS485方向控制信号时序，发送完成后应有至少1ms的切换延迟
7.2 数据校验错误
现象：主站收到异常响应数据
解决方案：
- 在
xMBRTUReceiveFSM函数中添加调试输出，打印原始接收数据 - 检查定时器3.5字符间隔时间计算是否正确：
c复制#define MB_T35_BAUD_9600 ( 4 ) // 3.5 * 11 / 9600 ≈ 4ms - 确认硬件滤波电容未导致信号边沿畸变（建议值10-100pF）