4. 寄存器与数据模型

Modbus 协议之所以在工业现场长盛不衰，核心在于它定义了一套清晰、稳定的数据模型。无论是串行链路（RTU/ASCII）还是 TCP/IP 网络，所有通信最终都归结为对四种基本数据对象的读写操作。理解这四种对象的地址映射规则以及数据字节序（Byte Order）的处理，是移植协议栈时最容易被忽视却又最容易埋下隐患的环节。本章将深入剖析 Modbus 数据模型的底层逻辑，并结合实际移植场景，给出可落地的地址规划与字节序转换方案。

4.1 四种数据对象的本质与地址空间划分

4.1.1 核心原理：从物理 I/O 到逻辑地址

Modbus 的数据模型并非凭空定义，而是源自 PLC 的 I/O 映像区设计。四种对象分别对应不同的物理或逻辑信号类型：线圈（Coil）对应数字量输出，如继电器、接触器、指示灯；离散输入（Discrete Input）对应数字量输入，如限位开关、按钮；保持寄存器（Holding Register）对应可读写的模拟量参数，如设定温度、PID 系数、运行模式；输入寄存器（Input Register）对应只读的模拟量采集值，如温度传感器读数、电压采样值。

在协议栈内部，这四种对象被映射到不同的地址区间。传统 PLC 使用 5 位十进制地址（如 40001），而 Modbus 协议数据单元（PDU）中实际传输的是 16 位十六进制偏移地址（0x0000~0xFFFF）。移植时必须建立两张表：一张是“PLC 地址 ↔ 协议地址”的转换表，另一张是“协议地址 ↔ 内存变量指针”的映射表。

4.1.2 判断方法：如何确定地址映射的偏移量

在移植协议栈时，最常见的错误是混淆 PLC 地址与协议地址。例如，上位机软件组态时填写“40001”，协议栈收到的 PDU 地址却是 0x0000。正确的处理方式是：协议栈内部统一使用 0x0000 起始的偏移地址，仅在应用层接口处做一次“PLC 地址 → 偏移地址”的转换。转换公式为：offset = plc_address - base_number，其中 base_number 分别为 1（线圈）、10001（离散输入）、30001（输入寄存器）、40001（保持寄存器）。

例如，若上位机请求读取保持寄存器地址 40010，则协议栈解析出的 PDU 地址为 0x0009（即 40010 - 40001 = 9）。在实现时，建议在协议栈的寄存器回调函数中直接使用偏移地址访问内存数组，避免每次通信都做减法运算。

4.1.3 案例拆解：一个温控设备的地址规划

假设我们要移植 Modbus 协议栈到一个温控器产品，硬件上有 2 路继电器输出、2 路开关量输入、1 路 PT100 温度采集、1 路 4-20mA 电流输出。合理的地址规划如下：

• 线圈（0x0000~0x0001）：0x0000 对应继电器 1，0x0001 对应继电器 2，支持功能码 01/05/15。
• 离散输入（0x0000~0x0001）：0x0000 对应外部急停信号，0x0001 对应门禁开关。
• 输入寄存器（0x0000~0x0001）：0x0000 存放 PT100 温度值（放大 10 倍，单位 0.1℃），0x0001 存放 4-20mA 电流采样值（放大 100 倍，单位 0.01mA）。
• 保持寄存器（0x0000~0x0004）：0x0000 为温度设定值（0.1℃），0x0001 为回差（0.1℃），0x0002 为控制模式（0=加热，1=制冷），0x0003 为报警上限，0x0004 为报警下限。

在协议栈的初始化函数中，我们需要为每个数据对象分配内存数组，并注册读写回调。例如：

// 伪代码示例
uint8_t coil_buffer[2];          // 2 个线圈
uint8_t discrete_buffer[2];      // 2 个离散输入
uint16_t input_reg_buffer[2];    // 2 个输入寄存器
uint16_t holding_reg_buffer[5];  // 5 个保持寄存器

void modbus_init(void) {
    modbus_register_area(MODBUS_AREA_COIL, coil_buffer, 2);
    modbus_register_area(MODBUS_AREA_DISCRETE, discrete_buffer, 2);
    modbus_register_area(MODBUS_AREA_INPUT_REG, input_reg_buffer, 2);
    modbus_register_area(MODBUS_AREA_HOLDING_REG, holding_reg_buffer, 5);
}

这样，当上位机发送“读保持寄存器 0x0000 起始 2 个寄存器”时，协议栈直接访问 holding_reg_buffer[0] 和 holding_reg_buffer[1]，无需额外地址转换。

4.1.4 常见误区与复盘

• 误区一：将 PLC 地址直接作为数组下标。例如用 40001 直接索引数组，导致越界或浪费内存。
• 误区二：忽略离散输入和输入寄存器的只读属性。若协议栈允许上位机写入这些区域，可能导致数据被意外篡改。
• 误区三：线圈和离散输入使用字节数组存储，但 Modbus 协议中位操作是按位寻址的。需要实现位读取/写入函数，而不是直接操作字节。

复盘建议：在协议栈移植完成后，编写一个地址映射自检程序，遍历所有合法地址，模拟读写操作，验证回调函数是否正确响应。尤其注意边界地址（如 0x0000 和 0xFFFF）的处理。

4.2 数据字节序（Byte Order）处理

4.2.1 核心原理：大端 vs 小端

Modbus 协议规定，所有 16 位寄存器数据在传输时高字节在前（Big-Endian）。例如，寄存器值 0x1234 在报文中的字节顺序为 0x12, 0x34。然而，绝大多数 MCU（如 STM32、ARM Cortex-M 系列）默认采用小端模式（Little-Endian），即内存中低地址存放低字节。这意味着，如果直接将内存中的 uint16_t 变量通过串口发送，字节顺序将是 0x34, 0x12，与协议要求相反。

对于 32 位数据（如 float、int32_t），情况更为复杂。Modbus 协议本身没有规定 32 位数据的寄存器组合顺序，常见的约定有四种：ABCD（大端顺序，高字在前）、CDAB（小端顺序，低字在前）、BADC（字节交换）、DCBA（全反转）。在工业现场，最常用的是 ABCD 和 CDAB 两种。例如，一个 float 变量 1.5f 在内存中（小端 MCU）的字节为 0x00 0x00 0xC0 0x3F，若按 ABCD 顺序发送，则寄存器 1 为 0x3FC0，寄存器 2 为 0x0000；若按 CDAB 顺序，则寄存器 1 为 0x0000，寄存器 2 为 0x3FC0。

4.2.2 判断方法：如何确定当前系统的字节序

在移植协议栈时，首先需要判断目标 MCU 的字节序。可以通过一个简单的联合体（union）测试：

#include <stdint.h>
typedef union {
    uint16_t u16;
    uint8_t bytes[2];
} endian_test_t;

int is_little_endian(void) {
    endian_test_t t;
    t.u16 = 0x1234;
    return (t.bytes[0] == 0x34); // 小端返回 1
}

如果确认是小端 MCU，则需要在协议栈的收发缓冲区中做字节交换。推荐的做法是：在协议栈内部统一使用大端序处理，即接收报文时，将字节流转换为小端内存值；发送报文时，将内存值转换为大端字节流。这样应用层代码无需关心字节序问题。

4.2.3 案例拆解：浮点数的寄存器映射

假设一个变频器通过 Modbus 上报运行频率，数据类型为 float（32 位），上位机期望按 ABCD 顺序读取。在协议栈的保持寄存器回调中，我们需要将 float 拆分为两个 uint16_t 寄存器。以下是 STM32 上的实现示例：

// 将 float 写入两个保持寄存器（ABCD 顺序）
void float_to_registers(float value, uint16_t *reg_high, uint16_t *reg_low) {
    uint8_t bytes[4];
    memcpy(bytes, &value, 4); // 获取内存中的原始字节（小端）
    // ABCD 顺序：高字在前，高字节在前
    *reg_high = ((uint16_t)bytes[3] << 8) | bytes[2]; // 高 16 位
    *reg_low  = ((uint16_t)bytes[1] << 8) | bytes[0]; // 低 16 位
}

// 从两个寄存器恢复 float（ABCD 顺序）
float registers_to_float(uint16_t reg_high, uint16_t reg_low) {
    uint8_t bytes[4];
    bytes[3] = (reg_high >> 8) & 0xFF;
    bytes[2] = reg_high & 0xFF;
    bytes[1] = (reg_low >> 8) & 0xFF;
    bytes[0] = reg_low & 0xFF;
    float value;
    memcpy(&value, bytes, 4);
    return value;
}

如果上位机使用 CDAB 顺序，则只需调整字节索引即可。建议在协议栈配置头文件中定义一个宏，例如：

#define FLOAT_REG_ORDER_ABCD  0
#define FLOAT_REG_ORDER_CDAB  1
#define FLOAT_REG_ORDER FLOAT_REG_ORDER_ABCD

这样在移植到不同上位机平台时，只需修改宏定义，无需改动核心代码。

4.2.4 常见误区与总结

• 误区一：认为所有 MCU 都是小端。实际上，部分 Cortex-M3 内核支持字节序重映射，但默认仍为小端。若使用外部存储控制器（FSMC）访问大端外设，需特别注意。
• 误区二：在中断服务函数中直接进行字节序转换，导致中断响应时间过长。建议在 DMA 传输完成后再统一处理。
• 误区三：忽略 32 位数据的对齐问题。某些 MCU 对未对齐的 32 位访问会触发 HardFault，使用 memcpy 可以避免此问题。

总结复盘：字节序处理的核心原则是“协议栈内部统一，应用层透明”。在移植时，建议编写独立的字节序转换模块（如 byteorder.c），提供 htobe16、betoh16、htobe32、betoh32 等函数，并针对不同平台提供优化实现（如使用汇编指令或编译器内建函数）。