Visual Studio 中基于 libmodbus 的 C++ Modbus RTU 主站示例

代码详解：

• 步骤 1-4：初始化上下文、设置参数、连接串口（标准流程）
• 步骤 5：无限轮询读取保持寄存器（功能码 03），每秒一次
• 信号处理：Ctrl+C 优雅退出（避免资源泄漏）
• 错误处理：每步检查 rc == -1，并打印 modbus_strerror(errno)
• 兼容 Windows：使用 Sleep()，signal() 处理中断

步骤 3: 在 VS 中编译运行

1. 新建 VS C++ 项目（Console App）
2. 添加源文件：modbus_rtu_master.cpp
3. 项目属性：
   • C/C++ > General > Additional Include Directories: libmodbus 头文件路径
   • Linker > General > Additional Library Directories: libmodbus.lib 路径
   • Linker > Input > Additional Dependencies: libmodbus.lib; ws2_32.lib
4. Build > Build Solution
5. Run（F5）：观察控制台输出

预期输出：

连接成功：COM3 @ 115200 baud 读取成功 (10 个寄存器): 寄存器 00: 123 (0x007B) ... (根据从站数据)

步骤 4: 测试代码

单元测试（使用 Google Test，VS 集成简单）：

1. 安装 Google Test（NuGet 或源码）
2. 新建测试项目，添加 test_modbus.cpp

// test_modbus.cpp
#include <gtest/gtest.h>
#include <modbus.h>

TEST(ModbusTest, CreateRtuContext){
    modbus_t *ctx = modbus_new_rtu("COM3", 115200, 'N', 8, 1);
    ASSERT_NE(ctx, nullptr);
    modbus_free(ctx);
}

TEST(ModbusTest, ConnectFailInvalidPort){
    modbus_t *ctx = modbus_new_rtu("INVALID", 9600, 'N', 8, 1);
    ASSERT_EQ(modbus_connect(ctx), -1);
    ASSERT_EQ(errno, ERROR_PATH_NOT_FOUND); // Windows 错误码
    modbus_free(ctx);
}

TEST(ModbusTest, ReadRegisters){
    modbus_t *ctx = modbus_new_rtu("COM3", 115200, 'N', 8, 1);
    modbus_set_slave(ctx, 1);
    modbus_connect(ctx);
    uint16_t regs[2];
    int rc = modbus_read_registers(ctx, 0, 2, regs);
    ASSERT_GE(rc, 0); // 成功读取 >=0
    modbus_close(ctx);
    modbus_free(ctx);
}

int main(int argc, char** argv){
    ::testing::InitGoogleTest(&argc, argv);
    return RUN_ALL_TESTS();
}

运行：

• VS 测试浏览器运行所有测试
• 预期：所有通过（需真实串口设备）

集成测试：

• 用串口助手发送数据，验证程序接收
• 或用 pymodbus 模拟从站

步骤 5: 常见问题与调试

• 打开失败：检查端口是否占用（设备管理器）、权限（管理员运行 VS）
• 读写失败：确认波特率匹配、从站 ID 正确
• 超时：增加 modbus_set_response_timeout
• 调试：VS 附加进程调试、printf 日志、modbus_strerror

以下是一个完整的 Modbus TCP 主站 Demo，使用 C++ 实现，基于 libmodbus 库（目前最成熟、性能最好的 C/C++ Modbus 开源库）。代码包含：

• 连接 Modbus TCP 从站
• 读取保持寄存器（Holding Registers，功能码 03）
• 写入单个寄存器（功能码 06）
• 错误处理与重试
• 完整中文注释
• 测试用例（单元测试 + 集成测试）

1. 环境准备

推荐方式：使用 vcpkg 安装 libmodbus（最简单）

# 安装 vcpkg（如果没有）
git clone https://github.com/microsoft/vcpkg
cd vcpkg
.ootstrap-vcpkg.bat
# 安装 libmodbus（64 位 Windows）
.ootstrap-vcpkg.bat
.ootstrap-vcpkg.bat # 修正为实际命令
.ootstrap-vcpkg.bat

注：实际命令应为 .ootstrap-vcpkg.bat 后接 .ootstrap-vcpkg.bat 或直接 .ootstrap-vcpkg.bat 然后 .ootstrap-vcpkg.bat。此处保留原文逻辑但修正格式。

项目配置（Visual Studio）：

• 新建 C++ 控制台项目
• 项目属性 → C/C++ → 常规 → 附加包含目录：$(VCPKG_ROOT)\installed\x64-windows\include
• 链接器 → 常规 → 附加库目录：$(VCPKG_ROOT)\installed\x64-windows\lib
• 链接器 → 输入 → 附加依赖项：libmodbus.lib;ws2_32.lib

2. 完整 Demo 代码（modbus_tcp_master.cpp）

// modbus_tcp_master.cpp
// 功能：Modbus TCP 主站示例 - 连接从站、读写寄存器、错误重试
// 使用 libmodbus 库（vcpkg 安装）
// 编译：VS 2022 + C++17
#include <modbus.h>
#include <stdio.h>
#include <errno.h>
#include <string.h>
#include <windows.h> // Sleep
#include <signal.h> // Ctrl+C 处理

// 配置参数（根据实际从站修改）
#define SERVER_IP "192.168.1.100" // 从站 IP 地址
#define SERVER_PORT 502 // Modbus TCP 默认端口
#define SLAVE_ID 1 // 从站单元标识（Unit ID），通常为 1
#define REG_READ_ADDR 0 // 读取起始寄存器地址
#define REG_READ_COUNT 10 // 读取寄存器数量
#define REG_WRITE_ADDR 100 // 写入寄存器地址
#define REG_WRITE_VALUE 12345 // 要写入的值
#define TIMEOUT_SEC 2 // 响应超时秒
#define TIMEOUT_USEC 0 // 微秒
#define MAX_RETRIES 3 // 最大重试次数
#define POLL_INTERVAL 1000 // 轮询间隔 ms

volatile sig_atomic_t running = 1; // 运行标志（Ctrl+C 退出）

// Ctrl+C 信号处理
void signal_handler(int sig) {
    running = 0;
    printf("\n收到中断信号，程序退出...\n");
}

int main() {
    modbus_t *ctx = NULL;
    uint16_t regs[REG_READ_COUNT];
    int rc;

    // 注册 Ctrl+C 信号
    signal(SIGINT, signal_handler);
    printf("Modbus TCP 主站启动...\n");
    printf("目标从站：%s:%d Unit ID: %d\n", SERVER_IP, SERVER_PORT, SLAVE_ID);

    // 1. 创建 Modbus TCP 上下文
    ctx = modbus_new_tcp(SERVER_IP, SERVER_PORT);
    if(ctx == NULL){
        fprintf(stderr,"创建上下文失败：%s\n",modbus_strerror(errno));
        return 1;
    }

    // 2. 设置从站 ID（Unit ID）
    modbus_set_slave(ctx, SLAVE_ID);

    // 3. 设置超时（非常重要，避免卡死）
    modbus_set_response_timeout(ctx, TIMEOUT_SEC, TIMEOUT_USEC);

    // 4. 连接从站
    if(modbus_connect(ctx)==-1){
        fprintf(stderr,"连接失败：%s\n",modbus_strerror(errno));
        modbus_free(ctx);
        return 1;
    }
    printf("连接成功！开始轮询...\n\n");

    // 5. 主循环：读取 + 写入 + 显示
    int loop_count = 0;
    while(running){
        loop_count++;
        printf("=== 第 %d 次轮询 ===\n", loop_count);

        // ----------------------
        // 读取保持寄存器（功能码 03）
        // ----------------------
        int retries = MAX_RETRIES;
        rc = -1;
        while(retries-->0 && rc == -1){
            rc = modbus_read_registers(ctx, REG_READ_ADDR, REG_READ_COUNT, regs);
            if(rc == -1){
                fprintf(stderr,"读取失败 (剩余重试 %d): %s\n", retries,modbus_strerror(errno));
                Sleep(500); // 重试间隔
            }
        }
        if(rc > 0){
            printf("读取成功 (%d 个寄存器):\n", rc);
            for(int i = 0; i < rc; i++){
                printf(" 寄存器 %03d: %5u (0x%04X)\n", REG_READ_ADDR + i, regs[i], regs[i]);
            }
        }else{
            printf("读取失败，已重试 %d 次\n", MAX_RETRIES);
        }

        // ----------------------
        // 写入单个寄存器（功能码 06）
        // ----------------------
        rc = modbus_write_register(ctx, REG_WRITE_ADDR, REG_WRITE_VALUE);
        if(rc == 1){
            printf("写入成功：寄存器 %d = %d\n", REG_WRITE_ADDR, REG_WRITE_VALUE);
        }else{
            fprintf(stderr,"写入失败：%s\n",modbus_strerror(errno));
        }
        printf("\n");
        Sleep(POLL_INTERVAL);
    }

    // 6. 清理资源
    modbus_close(ctx);
    modbus_free(ctx);
    printf("程序正常退出。\n");
    return 0;
}

编译与运行（Visual Studio 2022）

1. 新建 C++ 控制台项目
2. 添加源文件：modbus_rtu_master.cpp（或改名）
3. 项目属性配置：
   • C/C++ → 常规 → 附加包含目录：$(VCPKG_ROOT)\installed\x64-windows\include
   • 链接器 → 常规 → 附加库目录：$(VCPKG_ROOT)\installed\x64-windows\lib
   • 链接器 → 输入 → 附加依赖项：libmodbus.lib;ws2_32.lib
4. 生成 → 生成解决方案（Release / Debug）
5. 运行（F5）

预期输出（假设从站正常响应）：

Modbus TCP 主站启动...
目标从站：192.168.1.100:502 Unit ID: 1
连接成功！开始轮询...
=== 第 1 次轮询 ===
读取成功 (10 个寄存器):
寄存器 000: 123 (0x007B)
寄存器 001: 456 (0x01C8)
...
写入成功：寄存器 100 = 12345
=== 第 2 次轮询 ===
...

测试用例（集成测试 + 单元测试）

测试 1：连接与读取（手动集成测试）

1. 使用 Modbus Poll 或 Modbus Slave 软件模拟从站：
   • IP: 192.168.1.100
   • 端口：502
   • 从站 ID: 1
   • 寄存器 0~9 填入测试值（如 100, 200, …）
2. 运行 Demo，观察控制台是否正确打印寄存器值
3. 断开从站网络 → 观察重试与错误日志

测试 2：单元测试（Google Test）

test_modbus.cpp（需安装 Google Test via NuGet）

#include <gtest/gtest.h>
#include <modbus.h>

TEST(ModbusTcpTest, CreateContext){
    modbus_t *ctx = modbus_new_tcp("127.0.0.1", 502);
    ASSERT_NE(ctx, nullptr);
    modbus_free(ctx);
}

TEST(ModbusTcpTest, ConnectFailInvalidIP){
    modbus_t *ctx = modbus_new_tcp("invalid.ip", 502);
    ASSERT_EQ(modbus_connect(ctx), -1);
    ASSERT_EQ(errno, EHOSTUNREACH); // 或其他网络错误
    modbus_free(ctx);
}

int main(int argc, char** argv){
    ::testing::InitGoogleTest(&argc, argv);
    return RUN_ALL_TESTS();
}

运行：VS 测试浏览器 → 运行所有测试

常见问题与解决（Windows 环境）

扩展建议（半导体测试机场景）

• 多从站轮询：循环 modbus_set_slave(ctx, id) + 读取
• 数据解析：将寄存器值转为浮点数（IEEE 754）
• 阈值报警：读取后判断电压 > 3.6V → 打印报警
• 日志：使用 spdlog 或简单文件记录
• 多线程：采集用线程，UI 用 Qt 主线程