bd4sad / small_modbus

small modbus

一个支持主机从机，modbus rtu，modbus tcp的多实例modbus库。

将modbus功能和操作系统数据端口分离，分为：

modbus核心（rtu、tcp），

modbus端口（rtthread device、rtthread sal socket、linux devfs 、linux socket、win32 device 、win32socket）基于libmodbus的前后端**，可以实现在rtthread，win32，linux多个平台运行。

开始上手:

git clone 下载源码，将 src目录的中所有.c文件和 inc目录添加到项目中

然后将test目录的

config_small_modbus.h //配置文件，用来使能small modbus功能

test_modbus_rtu_matser.c //modbus rtu 主机模式示例代码

test_modbus_rtu_slave.c //modbus rtu 从机模块示例代码

添加到项目中，并修改到适当的配置

修改config_small_modbus.h完成不同平台的适配

#ifndef __SMALL_MODBUS_PORT_H__
#define __SMALL_MODBUS_PORT_H__

/*
*RTTHREAD PORT
*/
#define SMALL_MODBUS_RTTHREAD 1
#define SMALL_MODBUS_RTTHREAD_USE_DEVICDE  1
#define SMALL_MODBUS_RTTHREAD_USE_SOCKET   0

#if SMALL_MODBUS_RTTHREAD
#include "small_modbus_port_rtthread.h"
#endif

/*
*LINUX PORT
*/
#define SMALL_MODBUS_LINUX 0
#if SMALL_MODBUS_LINUX
#include "small_modbus_port_linux.h"
#endif

/*
*WIN32 PORT  
*/
#define SMALL_MODBUS_WIN32 0
#if SMALL_MODBUS_WIN32
#include "small_modbus_port_win32.h"
#endif

#endif /* __SMALL_MODBUS_PORT_H__ */

通用函数：

int modbus_connect(small_modbus_t *smb);
int modbus_disconnect(small_modbus_t *smb);
int modbus_write(small_modbus_t *smb,uint8_t *data,uint16_t length);
int modbus_read(small_modbus_t *smb,uint8_t *data,uint16_t length);
int modbus_flush(small_modbus_t *smb);
int modbus_wait(small_modbus_t *smb,int timeout);
int modbus_error_recovery(small_modbus_t *smb);
int modbus_error_exit(small_modbus_t *smb,int code);

int modbus_set_frame_timeout(small_modbus_t *smb,int timeout_ms);
int modbus_set_byte_timeout(small_modbus_t *smb,int timeout_ms);
int modbus_set_slave(small_modbus_t *smb, int slave);
int modbus_set_debug(small_modbus_t *smb, int level);

主机端函数：

/* master start request */
int modbus_start_request(small_modbus_t *smb,uint8_t *request,int function,int addr,int num,void *write_data);
/* master wait for confirmation message */
int modbus_wait_confirm(small_modbus_t *smb,uint8_t *response);
/* master handle confirmation message */
int modbus_handle_confirm(small_modbus_t *smb,uint8_t *request,uint16_t request_len,uint8_t *response,uint16_t response_len,void *read_data);
/* master read */
int modbus_read_bits(small_modbus_t *smb, int addr, int num, uint8_t *read_data);
int modbus_read_input_bits(small_modbus_t *smb, int addr, int num, uint8_t *read_data);
int modbus_read_registers(small_modbus_t *smb, int addr, int num, uint16_t *read_data);
int modbus_read_input_registers(small_modbus_t *smb, int addr, int num, uint16_t *read_data);
/* master write */
int modbus_write_bit(small_modbus_t *smb, int addr, int write_status);
int modbus_write_register(small_modbus_t *smb, int addr, int write_value);
int modbus_write_bits(small_modbus_t *smb, int addr, int num,uint8_t *write_data);

从机端函数：

/* slave callback */
typedef int(*small_modbus_slave_callback_t)(small_modbus_t *smb,int function_code,int addr,int num,void *read_write_data);
/* slave mode api */
/* slave wait query data */
int modbus_slave_wait(small_modbus_t *smb,uint8_t *request,int32_t waittime);
/* slave handle query data for callback */
int modbus_slave_handle(small_modbus_t *smb,uint8_t *request,uint16_t request_len,small_modbus_slave_callback_t slave_callback);
/* slave wait and handle query for callback */
int modbus_slave_wait_handle(small_modbus_t *smb,small_modbus_slave_callback_t slave_callback,int32_t waittime);

rtthread平台接口函数：

/*
*modbus port rtdevice
*/
int modbus_port_rtdevice_init(small_modbus_port_rtdevice_t *port,const char *device_name);
small_modbus_port_rtdevice_t *modbus_port_rtdevice_create(const char *device_name);
small_modbus_port_rtdevice_t *modbus_port_rtdevice_get(small_modbus_t *smb);
int modbus_set_rts(small_modbus_t *smb,int (*rts_set)(int on));
int modbus_set_serial_config(small_modbus_t *smb,struct serial_configure *serial_config);
int modbus_set_oflag(small_modbus_t *smb,int oflag);
/*
*modbus port rtsocket
*/
int modbus_port_socket_init(small_modbus_port_rtsocket_t *port,char *hostname,char *hostport);
small_modbus_port_socket_t *modbus_port_rtsocket_create(char *hostname,char *hostport);
small_modbus_port_socket_t *modbus_port_rtsocket_get(small_modbus_t *smb);
/*
*modbus_init
*/
int modbus_init(small_modbus_t *smb,uint8_t core_type,void *port);
small_modbus_t *modbus_create(uint8_t core_type,void *port);

相关工具 ：

Modbus Poll

Modbus Slave