STM32 modbus

### STM32 Modbus 配置与编程示例

#### 一、Modbus RTU 协议简介
Modbus 是一种串行通讯协议，由 Modicon 公司于1979年发明。该协议支持典型的主/从模式通信，在工业自动化领域广泛应用。Modbus RTU 特别适合用于 RS-485 或者 RS-232 的物理层传输[^1]。

#### 二、STM32作为Modbus主设备的配置过程
为了使 STM32 成功工作在 Modbus 主站角色下，需完成如下几个方面的设置：

- **硬件准备**
- 使用RS485模块来构建半双工或全双工通信链路。
- 进行必要的电气连接，确保电源供应稳定以及信号线正确对接。

- **软件初始化**
- 初始化 UART 接口参数（波特率、停止位等），使之匹配目标从机的要求。
- 设置定时器或其他机制处理字符间超时检测功能。
- 实现 CRC 校验算法以保障数据完整性验证。

#### 三、编写程序向从设备发送请求命令
当一切准备工作完成后，就可以通过调用特定函数库中的 API 来发起读取或写入操作了。下面给出一段简单的 C 语言代码片段展示如何利用 HAL 库执行批量写入动作：

#include "stm32f1xx_hal.h"

// 假设已经定义好了相应的句柄 huart1 和其他必要变量...

void WriteMultipleCoils(uint16_t startAddr, uint16_t quantityOfOutputs, uint8_t *outputValue){
    MODBUS_TxRxStatusTypeDef status;
    uint8_t pdu[MODBUS_PDU_MAX_LENGTH];
  
    /* 构造 PDU */
    pdu[0] = (uint8_t)(startAddr >> 8);          // 起始地址高位字节
    pdu[1] = (uint8_t)startAddr;                 // 起始地址低位字节
    pdu[2] = (uint8_t)(quantityOfOutputs >> 8);  // 输出数量高位字节
    pdu[3] = (uint8_t)quantityOfOutputs;         // 输出数量低位字节
    pdu[4] = ((quantityOfOutputs + 7)/8);        // 字节数
    
    memcpy(&pdu[5], outputValue, pdu[4]);       // 复制实际的数据值
  
    /* 执行事务 */
    status = ModbusMaster_WriteMultipleCoils(huart1, SLAVE_ADDRESS, pdu);
}

上述例子展示了怎样封装一个用来修改远程 IO 设备状态的方法 `WriteMultipleCoils` ，它接受三个参数：起始寄存器地址、要改变的状态数目还有具体的数值列表[^2]。