Modbus 개발 클래스 라이브러리: 개발 효율성과 품질을 향상시킵니다!

2.4 modbus-version.h - 버전信息

modbus-version.h包含库的버전信息，用于编译时버전检测：

#include <modbus-version.h>

// 버전宏定义
#define LIBMODBUS_VERSION_MAJOR 3
#define LIBMODBUS_VERSION_MINOR 1
#define LIBMODBUS_VERSION_MICRO 6
#define LIBMODBUS_VERSION "3.1.6"

// 运行时获取버전
const char *version = modbus_version();
printf("libmodbus버전：%s\n", version);

2.5 modbus.lib / libmodbus.so - 库文件

• Linux：libmodbus.so（动态库）、libmodbus.a（静态库）
• Windows：modbus.lib（导入库）、modbus.dll（动态链接库）
• Mac OS：libmodbus.dylib（动态库）

三、编译安装方法

3.1 Linux编译安装

# 下载源码
wget https://github.com/stephane/libmodbus/archive/v3.1.6.tar.gz
tar xzf v3.1.6.tar.gz
cd libmodbus-3.1.6

# 编译安装
./autogen.sh
./configure --prefix=/usr/local
make
sudo make install

# 설정库路径
echo "/usr/local/lib" | sudo tee /etc/ld.so.conf.d/libmodbus.conf
sudo ldconfig

# 验证安装
pkg-config --modversion libmodbus
# 출력：3.1.6

3.2 Windows编译安装

• 方法一：使用预编译的2진수包，从官网下载modbus-3.1.6_*.zip
• 方法二：使用MSYS2/MinGW编译：pacman -S mingw-w64-x86_64-libmodbus
• 方法三：使用vcpkg：vcpkg install libmodbus

3.3 编译매개변수

# GCC编译예제
gcc -o modbus_demo modbus_demo.c `pkg-config --cflags --libs libmodbus`

# CMakeLists.txt예제
find_package(PkgConfig REQUIRED)
pkg_check_modules(LIBMODBUS REQUIRED libmodbus)

add_executable(modbus_demo modbus_demo.c)
target_include_directories(modbus_demo PRIVATE ${LIBMODBUS_INCLUDE_DIRS})
target_link_libraries(modbus_demo ${LIBMODBUS_LIBRARIES})

四、核心API函数详解

4.1 연결管理函数

4.2 读操作函数

// 读코일（기능 코드01）
int modbus_read_bits(modbus_t *ctx, int addr, int nb, uint8_t *dest);

// 读이산 입력（기능 코드02）
int modbus_read_input_bits(modbus_t *ctx, int addr, int nb, uint8_t *dest);

// 读유지 레지스터（기능 코드03）
int modbus_read_registers(modbus_t *ctx, int addr, int nb, uint16_t *dest);

// 读입력 레지스터（기능 코드04）
int modbus_read_input_registers(modbus_t *ctx, int addr, int nb, uint16_t *dest);

// 使用예제
uint16_t regs[10];
int rc = modbus_read_registers(ctx, 0, 10, regs);
if (rc == -1) {
    fprintf(stderr, "읽기失败：%s\n", modbus_strerror(errno));
}

4.3 写操作函数

// 写单个코일（기능 코드05）
int modbus_write_bit(modbus_t *ctx, int addr, int status);

// 写单个레지스터（기능 코드06）
int modbus_write_register(modbus_t *ctx, int addr, int value);

// 写多个코일（기능 코드15）
int modbus_write_bits(modbus_t *ctx, int addr, int nb, const uint8_t *데이터);

// 写多个레지스터（기능 코드16）
int modbus_write_registers(modbus_t *ctx, int addr, int nb, const uint16_t *데이터);

// 使用예제
modbus_write_bit(ctx, 0, TRUE);       // 吸合第1路릴레이
modbus_write_register(ctx, 0, 1234);  // 쓰기레지스터

uint16_t values[3] = {100, 200, 300};
modbus_write_registers(ctx, 0, 3, values); // 批量쓰기

4.4 데이터转换函数

// 浮点数转换（IEEE 754）
float modbus_get_float(const uint16_t *src);
void modbus_set_float(float f, uint16_t *dest);

// 32位整数转换
uint32_t modbus_get_int32(const uint16_t *src);
void modbus_set_int32(uint32_t value, uint16_t *dest);

// 使用예제
uint16_t regs[2];
modbus_read_registers(ctx, 10, 2, regs);
float temp = modbus_get_float(regs);
printf("온도：%.2f℃\n", temp);

// 쓰기浮点数
uint16_t write_regs[2];
modbus_set_float(25.5, write_regs);
modbus_write_registers(ctx, 10, 2, write_regs);

五、完整적용예제

5.1 TCP클라이언트예제

#include <stdio.h>
#include <stdlib.h>
#include <modbus.h>

int main(int argc, char *argv[]) {
    modbus_t *ctx;
    uint16_t regs[32];
    uint8_t bits[32];
    int rc;

    // 创建TCP上下文
    ctx = modbus_new_tcp("192.168.1.100", 502);
    if (ctx == NULL) {
        fprintf(stderr, "创建上下文失败\n");
        return -1;
    }

    // 设置디버깅모드（可选）
    modbus_set_debug(ctx, TRUE);

    // 设置슬레이브 주소
    modbus_set_slave(ctx, 1);

    // 设置超时
    modbus_set_response_timeout(ctx, 1, 0);

    // 建立연결
    if (modbus_connect(ctx) == -1) {
        fprintf(stderr, "연결失败：%s\n", modbus_strerror(errno));
        modbus_free(ctx);
        return -1;
    }

    printf("연결成功!\n");

    // 읽기8路릴레이状态
    rc = modbus_read_bits(ctx, 0, 8, bits);
    if (rc != -1) {
        printf("릴레이状态：");
        for (int i = 0; i < 8; i++) {
            printf("%d ", bits[i]);
        }
        printf("\n");
    }

    // 읽기10个유지 레지스터
    rc = modbus_read_registers(ctx, 0, 10, regs);
    if (rc != -1) {
        printf("유지 레지스터：");
        for (int i = 0; i < 10; i++) {
            printf("%d ", regs[i]);
        }
        printf("\n");
    }

    // 控制第1路릴레이吸合
    modbus_write_bit(ctx, 0, TRUE);
    printf("第1路릴레이已吸合\n");

    // 닫기연결
    modbus_close(ctx);
    modbus_free(ctx);

    return 0;
}

5.2 RTU슬레이브예제

#include <stdio.h>
#include <modbus.h>
#include <modbus-rtu.h>

#define NB_COILS 16
#define NB_REGISTERS 10

int main() {
    modbus_t *ctx;
    modbus_mapping_t *mb_mapping;
    uint8_t query[MODBUS_TCP_MAX_ADU_LENGTH];
    int rc;

    // 创建RTU上下文
    ctx = modbus_new_rtu("/dev/ttyUSB0", 9600, 'N', 8, 1);
    modbus_set_slave(ctx, 1);
    modbus_rtu_set_serial_mode(ctx, MODBUS_RTU_RS485);
    modbus_connect(ctx);

    // 创建데이터映射
    mb_mapping = modbus_mapping_new(
        NB_COILS,      // 코일 수량
        NB_COILS,      // 이산 입력数量
        NB_REGISTERS,  // 保持레지스터 수량
        NB_REGISTERS   // 입력레지스터 수량
    );

    // 初始化一些데이터
    mb_mapping->tab_registers[0] = 100;  // 온도值
    mb_mapping->tab_registers[1] = 50;   // 湿度值

    printf("Modbus RTU슬레이브已启动，주소：1\n");

    // 主循环
    while (1) {
        rc = modbus_receive(ctx, query);
        if (rc > 0) {
            modbus_reply(ctx, query, rc, mb_mapping);
        } else if (rc == -1) {
            // 연결断开或错误
            break;
        }
    }

    modbus_mapping_free(mb_mapping);
    modbus_close(ctx);
    modbus_free(ctx);
    return 0;
}

일반적인 문제 및 솔루 션

• 연결超时
• 시리얼 포트权限不足
• CRC 검증错误
• RS485收发전환문제
• 읽기데이터异常
• 多线程冲突
• 编译找不到头文件

다른 Mod bus 개발 라이 브 러 리 추천

lib mod bus 는 C / C ++ 개발 자에게 선호 되는 Mod bus 라이 브 러 리 이며 , 안정 적인 성 능 과 풍부한 기능 으로 산업 제어 분야에서 널리 사용됩니다 .이 문서 에서 설명 하는 코 드는 직접 컴 파 일 하여 실행 할 수 있으며 , 실제 프로젝트에 통합 하기 전에 테스트 환경에서 통신 을 검 증 하는 것이 좋습니다 .