Libmodbus 源码分析：框架、数据结构与核心函数

第三部分：核心数据结构

4. 核心数据结构：struct _modbus

• 结构体定义：struct _modbus（别名 modbus_t）是连接信息档案袋。
• backend 指针：指向 modbus_backend_t 结构体，包含函数指针（如 send, receive, build_request_basis）。
• 设计模式：策略模式或插件架构。struct _modbus 是通用框架，backend 是具体实现插件。modbus_new_rtu 创建时，backend 被赋值为 RTU 后端函数集。上层代码调用 ctx->backend->send(...) 即可适配不同底层网络，实现解耦和复用。

结构体成员解析：

struct _modbus {
    int slave;              // 【从站地址】主站表示目标 ID，从站表示自身 ID。
    int s;                  // 【套接字/文件描述符】OS 级通信句柄。TCP 对应 socket，RTU 对应串口。
    int debug;              // 【调试开关】由 `modbus_set_debug` 设置。
    const modbus_backend_t *backend; // 【后端指针】灵魂所在，指向函数指针集合。
    void *backend_data;     // 【后端私有数据】给后端函数使用的数据（如 IP、串口参数）。
    // ... 超时时间等其他字段
};

第四部分：核心工作流程

5. 主站：发送请求与接收响应的流程

以 modbus_write_bit 为例：

1. 构建请求：ctx->backend->build_request_basis(...) 组装 ADU 报文至 req 缓冲区。
2. 发送报文：send_msg(ctx, req, req_length) 调用 backend->send 发送数据。
3. 接收响应：modbus_receive_msg(ctx, rsp, MSG_CONFIRMATION) 等待并接收数据。
4. 检查确认：check_confirmation(ctx, req, rsp, rc) 校验地址、功能码、CRC 等。
5. 返回结果：返回成功或失败状态。

流程总结：构建 -> 发送 -> 接收 -> 校验 -> 返回。

6. send_msg 函数详解

该函数连接通用逻辑与具体后端实现，处理调试输出和链接错误恢复。

static int send_msg(modbus_t *ctx, uint8_t *msg, int msg_length) {
    // 预处理（如 RTU 计算 CRC）
    msg_length = ctx->backend->send_msg_pre(msg, msg_length);
    
    // 调试输出
    if (ctx->debug) {
        for (i = 0; i < msg_length; i++) printf("[%.2X]", msg[i]);
    }
    
    // 循环发送直到成功（若启用错误恢复）
    do {
        rc = ctx->backend->send(ctx, msg, msg_length);
    } while (rc == -1 && (ctx->error_recovery & MODBUS_ERROR_RECOVERY_LINK));
    
    return rc;
}

7. 从站：请求处理循环

展示 Modbus 从站服务器的主循环：

• modbus_receive：读取完整 Modbus 请求 ADU。
• modbus_reply：核心处理函数。
  1. 解析请求报文（解包 ADU，获取功能码和地址）。
  2. 根据功能码操作 mb_mapping 内存映射表（模拟线圈、寄存器等区域）。
  3. 构建正常或异常响应报文。
  4. 调用 backend->send 发送响应。
• mb_mapping：用户创建并传递的数据结构，包含四大区域在内存中的实际数组。

for (;;) {
    do {
        rc = modbus_receive(ctx, query); // 接收请求
    } while (rc == 0); // 过滤非本从站请求
    
    rc = modbus_reply(ctx, query, rc, mb_mapping); // 处理并回复
    if (rc == -1) break; // 出错退出
}

第五部分：应用场景与总结

8. 实际应用场景

• 上位机：运行 libmodbus 编写的主站程序（电脑或工控机）。
• 通信链路：
  • RS-485 总线：通过 USB 转 485 或串口卡连接。
  • 以太网：支持 Modbus TCP 的设备直接接入网络。
• 从站设备：传感器、仪表、PLC 等，拥有唯一从站地址（1-247）。
• Libmodbus 的角色：上位机中负责与 Modbus 设备对话的通信引擎。

最终总结：Libmodbus 框架精要

1. 设计模式：前后端分离的插件式架构。
   • 前端 (API)：统一友好的接口（如 modbus_read_registers）。
   • 后端 (Backend)：RTU 和 TCP 实现，提供标准功能函数集。
   • 连接上下文 (modbus_t)：粘合剂，内部 backend 指针决定实际调用的后端函数。
2. 工作流程：
   • 主站：用户调用 API -> 库构建报文 -> 发送 -> 接收响应 -> 验证 -> 返回。
   • 从站：无限循环 -> 接收请求 -> 解析 -> 操作映射表 -> 构建响应 -> 发送。
3. 学习意义：
   • 理解工业通信字节流层面的工作细节。
   • 掌握抽象与接口编程典范（backend 指针设计）。
   • 提升调试能力（理解 debug 开关与报文打印机制）。