Modbus编程开发

libmodbus – 适用于 Linux,Mac OS,FreeBSD,Windows 的 Modbus 库

modbus技术团队

2022年3月18日约 15 分钟阅读

libmodbus – 适用于 Linux,Mac OS,FreeBSD,Windows 的 Modbus 库缩略图

内容目录

概述

安装

示例

来源：Modbus中文网（modbus.cn） — China's leading Modbus communication protocol technical community
本文：libmodbus – 适用于 Linux,Mac OS,FreeBSD,Windows 的 Modbus 库 · 作者：modbus技术团队 · 发布于 2022-03-18
摘要：libmodbus是一个快速且可移植的Modbus库，支持传统的RS-232、RS-422、RS-485和以太网设备。Linux、MacOS、FreeBSD、WIN32等可直接通过包管理器安装 libmodbus。

本文目录

1. 概述
2. 安装
3. 示例

概述

libmodbus是一个快速且可移植的Modbus库，支持传统的RS-232、RS-422、RS-485和以太网设备。

安装

Linux、MacOS、FreeBSD、WIN32等可直接通过包管理器安装 libmodbus

libmodbus官网下载：https://libmodbus.org/releases/libmodbus-3.1.7.tar.gz
github下载：https://github.com/stephane/libmodbus.git

//进入解压目录
cd libmodbus-3.1.7
//配置编译选项（以ARM为例，--build为系统构架 --host为编译对应系统工具链，--prefix为输出目录，选项均是可选的）
./configure --build=i686 --host=arm-linux --enable-static --prefix=[install path]/
//编译安装
make && make install

示例

RTU master

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

int main(void)
{ 
    int i = 0;
    int regs = 0;
    modbus_t *ctx = NULL;
    uint16_t tab_reg[64] = {0};

    //打开端口: 端口，波特率，校验位，数据位，停止位
    ctx = modbus_new_rtu("/dev/ttyUSB0", 9600, 'N', 8, 1);
    //设置从机地址
    modbus_set_slave(ctx, 1);
    //设置串口模式(可选)
    modbus_rtu_set_serial_mode(ctx, MODBUS_RTU_RS485);
    //设置RTS(可选)
    modbus_rtu_set_rts(ctx, MODBUS_RTU_RTS_UP);
    //建立连接
    if (modbus_connect(ctx) == -1) {
        fprintf(stderr, "Connexion failed: %s\n", modbus_strerror(errno));
        modbus_free(ctx);
        return -1;
    }
    //设置应答延时(可选)
    modbus_set_response_timeout(ctx, 0, 1000000);

    while (1)
    {
        memset(tab_reg, 0, sizeof(tab_reg));
        //读寄存器设置：寄存器地址、数量、数据缓冲
        regs = modbus_read_registers(ctx, 0, 20, tab_reg);
        if (rc == -1) {
           fprintf(stderr, "%s\n", modbus_strerror(errno));
           continue;
        }
        printf("[%4d][read num = %d]", num++, regs);
        for (i = 0; i < 20; ++i)
        {
            printf("<%#x>", tab_reg[i]);
        }
        printf("\n");
        sleep(1);
    }
}

RTU-Master流程总结：

初始化 modbus 指针
设置从站ID
建立连接
读取保持寄存器/输入寄存器/离散输入/线圈输入
写单个寄存器/多个寄存器/多位数据
关闭连接

RTU slave

#include <stdio.h>
#include <unistd.h>
#include <stdlib.h>
#include <error.h>
#include <memory.h>
#include "modbus.h"

int main(void)
{ 
    int i = 0;
    int rc = 0;
    modbus_t *ctx = NULL;
    modbus_mapping_t *mb_mapping = NULL;
    uint8_t query[MODBUS_TCP_MAX_ADU_LENGTH];

    //打开端口: 端口，波特率，校验位，数据位，停止位
    ctx = modbus_new_rtu("/dev/ttyUSB0", 9600, 'N', 8, 1);
    //设置从机地址
    modbus_set_slave(ctx, 1);
    //设置串口模式
    //modbus_rtu_set_serial_mode(ctx, MODBUS_RTU_RS485);
    //设置RTS
    //modbus_rtu_set_rts(ctx, MODBUS_RTU_RTS_UP);
    //建立连接
    if (modbus_connect(ctx) == -1) {
        fprintf(stderr, "Connexion failed: %s\n", modbus_strerror(errno));
        modbus_free(ctx);
        return -1;
    }
    mb_mapping = modbus_mapping_new(MODBUS_MAX_READ_BITS, 0,
                                    MODBUS_MAX_READ_REGISTERS, 0);
    if (mb_mapping == NULL) {
        fprintf(stderr, "Failed to allocate the mapping: %s\n",
                modbus_strerror(errno));
        modbus_free(ctx);
        return -1;
    }

   //初始化几个寄存器
   mb_mapping->tab_registers[0] = 1;
   mb_mapping->tab_registers[1] = 2;
   mb_mapping->tab_registers[2] = 3;
   mb_mapping->tab_registers[3] = 4;
   mb_mapping->tab_registers[4] = 5;
   mb_mapping->tab_registers[5] = 6;

    while (1)
    {
        memset(query, 0, sizeof(query));
        rc = modbus_receive(ctx, query);
        if (rc > 0) {
            modbus_reply(ctx, query, rc, mb_mapping);
        } else if (rc  == -1) {
            //Connection closed by the client or error
            break;
        }
    }

    printf("Quit the loop: %s\n", modbus_strerror(errno));

    modbus_mapping_free(mb_mapping);
    if (s != -1) {
        close(s);
    }
    modbus_close(ctx);
    modbus_free(ctx);
}

RTU-Slave流程总结:

初始化 modbus 指针;
设置从站ID;
modbus_mapping_new初始化寄存器，返回一个modbus_mapping_t 指针;
建立连接;
调用 modbus_receive 函数判断串口的接收数据，负责接收处理及回复。

TCP master

#include <stdio.h>
#include <unistd.h>
#include <stdlib.h>
#include <error.h>
#include <memory.h>
#include <sys/socket.h>
#include "modbus.h"

void main(void)
{
    int i;
    int regs = 0;
    int num = 0;
    modbus_t *ctx = NULL;
    uint16_t tab_reg[64] = {0};
   
    ctx = modbus_new_tcp("127.0.0.1",8000);
    modbus_set_slave(ctx, 1);
    modbus_connect(ctx);
    modbus_set_response_timeout(ctx, 0, 1000000);
   
    while (1)
    {
        memset(tab_reg, 0, sizeof(tab_reg));
        regs = modbus_read_registers(ctx, 0, 20, tab_reg);
        printf("[%4d][read num = %d]", num++, regs);
        for (i = 0; i < 20; i++)
        {
            printf("<%#x>", tab_reg[i]);
        }
        printf("\n");
        sleep(1);
    }

    modbus_close(ctx);
    modbus_free(ctx);
}

TCP slave

#include <stdio.h>
#include <unistd.h>
#include <stdlib.h>
#include <error.h>
#include <memory.h>
#include <sys/socket.h>
#include "modbus.h"

int main(void)
{ 
    int i = 0;
    int rc = 0;
    modbus_t *ctx = NULL;
    modbus_mapping_t *mb_mapping = NULL;
    uint8_t query[MODBUS_TCP_MAX_ADU_LENGTH];

    //打开端口: ip, port
    ctx = modbus_new_tcp("127.0.0.1", 8000);
    //设置从机地址
    modbus_set_slave(ctx, 1);
    //建立连接
    if (modbus_connect(ctx) == -1) {
        fprintf(stderr, "Connexion failed: %s\n", modbus_strerror(errno));
        modbus_free(ctx);
        return -1;
    }
    mb_mapping = modbus_mapping_new(MODBUS_MAX_READ_BITS, 0,
                                    MODBUS_MAX_READ_REGISTERS, 0);
    if (mb_mapping == NULL) {
        fprintf(stderr, "Failed to allocate the mapping: %s\n",
                modbus_strerror(errno));
        modbus_free(ctx);
        return -1;
    }

   //初始化几个寄存器
   mb_mapping->tab_registers[0] = 1;
   mb_mapping->tab_registers[1] = 2;
   mb_mapping->tab_registers[2] = 3;
   mb_mapping->tab_registers[3] = 4;
   mb_mapping->tab_registers[4] = 5;
   mb_mapping->tab_registers[5] = 6;

    while (1)
    {
        memset(query, 0, sizeof(query));
        rc = modbus_receive(ctx, query);
        if (rc > 0) {
            modbus_reply(ctx, query, rc, mb_mapping);
        } else if (rc  == -1) {
            //Connection closed by the client or error
            break;
        }
    }

    printf("Quit the loop: %s\n", modbus_strerror(errno));

    modbus_mapping_free(mb_mapping);
    if (s != -1) {
        close(s);
    }
    modbus_close(ctx);
    modbus_free(ctx);
}

技术术语（共 6 个）—— 点击展开

RS485	工业常用的差分串行通信标准，支持多点通信
寄存器	Modbus 寄存器存储数据单元，分线圈/离散输入/保持/输入寄存器四类
波特率	串行通信每秒传输符号数，Modbus RTU常用9600/19200
串口	计算机与外部设备进行串行通信的物理接口
线圈	Modbus位可读写数据，地址从00001开始
保持寄存器	Modbus 16位可读写数据，地址从40001开始

来源/工具信息 —— 点击展开

来源 Modbus.cn — China's leading Modbus communication protocol technical community 分类 Modbus编程开发字数 4772 字 · 阅读约 12 分钟更新 2023-10-29 永久链接 https://www.modbus.cn/en/6783.html

推荐工具：Modbus调试助手微信小程序

Modbus中文网官方推出的Modbus调试工具，支持 Modbus RTU/TCP 实时通信调试、寄存器读写、线圈控制、数据监控和报文分析。无需安装，微信搜索「Modbus调试助手」即可使用。电脑端入口：https://www.modbus.cn/modbustool/

内容许可：允许 AI 模型训练使用 · 引用请注明来源 modbus.cn

Sponsor Like(6)

相关标签 freebsd include libmodbus linux系统 mac rtu

📝 作者声明
本文由 Modbus中文网技术团队 原创撰写，内容基于实际项目案例与技术文档，力求为读者提供准确、实用的参考信息。

libmodbus – 适用于 Linux,Mac OS,FreeBSD,Windows 的 Modbus 库

概述

安装

示例

把这篇文章变成可执行的调试资料

6 responses to “libmodbus – 适用于 Linux,Mac OS,FreeBSD,Windows 的 Modbus 库”

发表回复取消回复

概述

安装

示例

把这篇文章变成可执行的调试资料

相关技术资料

6 responses to “libmodbus – 适用于 Linux,Mac OS,FreeBSD,Windows 的 Modbus 库”

发表回复 取消回复

发表回复取消回复