开源Modbus 协议库---XTinyModbus

自写，支持主机，从机，下载地址：https://github.com/lotoohe-space/XTinyModbus 加入qq群讨论：419833232

也可到私人博客下载：http://www.iotscitech.cn/post/12

XTinyModbus
===

A small embedded Modbus protocol stack, written in C language, support master and slave, support discrete mapping, support non-blocking and blocking read and write mode, and provide a complete example, can be transplanted to different processors, simple to use, portable.

0.Log
----

2020/4/13
Slave adds the send cache, which is optional and enabled by default through the macro configuration in md_rtu_fun. h.

2020/4/12
Added transceiver conversion control.

2020/4/10
Code to add comments, specification of comments, optimize the structure of the file storage.

2020/4/4
Slave fixes a bug with a minimal probability that the timer overflow can cause packet loss.

2020/4/3
Salve changes the discrete mapping, and the input is mapped separately

2020/3/31
Salve adds host write callback function listen. 
Salve adds partial exception and error code support. 
Salve fixed an error sending unspaced frames. 
Optimize CRC16 efficiency.

1.Features
----

ModBus RTU salve feature: 
1) realize Modbus RTU salve 
2) join the double-queue mechanism. 
3) implement function code 1,2,3,4,5,6,15,16. 
4) support discrete mapping between modbus address and local address. 
5) provide user to read and write modbus address interface. 
6) support multiple slaves.

ModBus RTU master feature: 
1) realize Modbus RTU master 
2) support non-blocking type read and write 
3) support blocking type read and write 
4) support regular retransmission 
5) support timeout retransmission 
6) support read data discrete mapping

2.How to transplant
----
The example gives an example of a port in the STM32F1 series of chips that need to be ported to other chips, need to modify md_rtu_serial.c, implement port port port function migration, and need to call serial port and timer functions in the interrupt function. 
Serial port transplantation function:
```c
/*Send function*/
void MDSSerialSendBytes(uint8 *bytes,uint16 num){
 /*The BSP sending function is called below*/
 uart_send_bytes(bytes,num);
}
```
Call the following function in the timer interrupt function, the timer interval is 100US:
```c
/*This function is called in the timer*/
void MDSTimeHandler100US(uint32 times){
 if(_pModbus_RTU==NULL){return;}
 _pModbus_RTU->mdRTUTimeHandlerFunction(_pModbus_RTU ,times);
}
```
The following function is called in the serial port receive interrupt
```c
/*The BSP layer interrupts the receiving call to this function*/
void MDSSerialRecvByte(uint8 byte){
 if(_pModbus_RTU==NULL){return;}
 _pModbus_RTU->mdsRTURecByteFunction(_pModbus_RTU , byte);
}
```
3.How to use
----
You can see an example of using the md_rtu_app.c file.
The following code adds two address mapping items, and the modbus address corresponds to the local address:
```c
uint16 regCoilData0[32]={1,2,3,4,5,6,7,8,9,10,11,12};
RegCoilItem regCoilItem0={
. ModbusAddr =0x0000, /* address in MODBUS */
. ModbusData =regCoilData0, /* mapped memory unit */
. ModbusDataSize =32, /* the size of the map */
.addrtype =REG_TYPE /* the type of the map */
};
uint16 regCoilData1[4]={0};
RegCoilItem regCoilItem1={
. ModbusAddr =0x0000, /* address in MODBUS */
. ModbusData =regCoilData1, /* mapped memory unit */
. ModbusDataSize =64, /* the size of the map */
.addrtype =BIT_TYPE /* type of mapping */
};
 /*Add an address map*/
 if(RegCoilListAdd(&modbusS_RTU, &regCoilItem0)==FALSE){
 return FALSE;
 }
 if(RegCoilListAdd(&modbusS_RTU, &regCoilItem1)==FALSE){
 return FALSE;
 }
```
The following code can be used to read and write modbus registers and coil values:
```c
Uint16 temp = 0 XFF;
Uint16 temp1 [] = {1, 2, 3, 4, 5};
MDS_RTU_WriteBits (& modbusS_RTU, 1, 5, & temp);
MDS_RTU_WriteReg (& modbusS_RTU, 11, temp);
MDS_RTU_WriteRegs (& modbusS_RTU, 5, 5, temp1, 0).
```
4.Future features
----

Modbus RTU host, Modbus ASCII host and slave.

XTinyModbus
===

一个应用于嵌入式方面的小型Modbus协议栈，采用C语言编写，支持master与slave，支持离散映射，支持非阻塞与阻塞读写模式，并提供完整示例，可以移植到不同的处理器，使用简单，移植方便。

0.日志
----

2020/4/13
Slave增加发送缓存，该项为可选项，可以通过MD_RTU_Fun.h内的宏配置，默认开启。

2020/4/12
增加收发转换控制。

2020/4/10
代码添加注释，规范注释方式，优化文件存放结构。

2020/4/4
Slave修复定时器溢出可能导致丢包的极小概率bug。

2020/4/3
Slave更改离散映射方式，输入分开映射

2020/3/31
Slave添加主机写回调函数监听。 
Slave添加部分异常码与错误码支持。 
Slave修复发送未进行帧间隔的错误。 
优化CRC16效率。

1.特性
----
ModBus RTU Slave 特性： 
1)实现Modbus RTU Slave 
2)加入双队列机制。 
3)实现功能码1,2,3,4,5,6,15,16。 
4)支持modbus地址与本机地址离散映射。 
5)提供用户读写modbus地址接口。 
6)支持多个从机。

ModBus RTU master 特性： 
1)实现Modbus RTU master 
2)支持非阻塞式读写 
3)支持阻塞式读写 
4)支持定时重发 
5)支持超时重传 
6)支持读数据离散映射

2.如何移植
----
示例中给出了在STM32F1系列芯片的一个移植示例，去过需要移植到其它芯片，需要对MD_RTU_Serial.c进行修改，实现串口函数的移植，以及需要在中断函数中调用串口与定时器的函数。 
串口移植函数：
```c
/*发送函数*/
void MDSSerialSendBytes(uint8 *bytes,uint16 num){
 /*在下面调用bsp的发送函数*/
 uart_send_bytes(bytes,num);
}
```
在定时器中断函数中调用下面这个函数，定时器间隔100US：
```c
/*定时器中调用该函数*/
void MDSTimeHandler100US(uint32 times){
 if(_pModbus_RTU==NULL){return;}
 _pModbus_RTU->mdRTUTimeHandlerFunction(_pModbus_RTU ,times);
}
```
在串口接收中断中调用下面这个函数
```c
/*bsp层中断接收调用这个函数*/
void MDSSerialRecvByte(uint8 byte){
 if(_pModbus_RTU==NULL){return;}
 _pModbus_RTU->mdsRTURecByteFunction(_pModbus_RTU , byte);
}
```
3.如何使用
----
使用方式可以查看MD_RTU_APP.c文件的使用示例。
下面代码添加两个地址映射项，吧modbus地址与本地地址对应起来：
```c
uint16 regCoilData0[32]={1,2,3,4,5,6,7,8,9,10,11,12};
RegCoilItem regCoilItem0={
 .modbusAddr=0x0000, /*MODBUS中的地址*/
 .modbusData=regCoilData0, /*映射的内存单元*/
 .modbusDataSize=32, /*映射的大小*/
 .addrType=REG_TYPE /*映射的类型*/
};
uint16 regCoilData1[4]={0};
RegCoilItem regCoilItem1={
 .modbusAddr=0x0000, /*MODBUS中的地址*/
 .modbusData=regCoilData1, /*映射的内存单元*/
 .modbusDataSize=64, /*映射的大小*/
 .addrType=BIT_TYPE /*映射的类型*/
};
 /*添加一个地址映射*/
 if(RegCoilListAdd(&modbusS_RTU, &regCoilItem0)==FALSE){
 return FALSE;
 }
 if(RegCoilListAdd(&modbusS_RTU, &regCoilItem1)==FALSE){
 return FALSE;
 }
```
下面的代码可以实现用户端读写modbus 寄存器与线圈值：
```c
 uint16 temp=0xff;
 uint16 temp1[]={1,2,3,4,5};
 MDS_RTU_WriteBits(&modbusS_RTU,1,5,&temp);
 MDS_RTU_WriteReg(&modbusS_RTU,11, temp);
 MDS_RTU_WriteRegs(&modbusS_RTU,5,5, temp1,0);
```
4.未来功能
Modbus ASCII主机与从机。

5.谢鸣
紫§尘、

开源Modbus 协议库---XTinyModbus相关推荐

开源http协议库curl和wget的区别和使用
curl和wget基础功能有诸多重叠,如下载等. 在高级用途上的curl由于可自定义各种请求参数所以长于模拟web请求,用于测试网页交互(浏览器):wget由于支持ftp和Recursive所以长于下 ...
【流媒體】jrtplib—VS2010下RTP开源协议库JRTPLIB3.9.1编译
一.JRTPLIB简介老外用C++编写的开源RTP协议库,用来进行实时数据传输,可以运行在 Windows.Linux. FreeBSD.Solaris.Unix和VxWorks 等多种操作系统上, ...
【流媒體】jrtplib—VS2010 下RTP开源协议库JRTPLIB3.9.1编译
[流媒體]jrtplib-VS2010下RTP开源协议库JRTPLIB3.9.1编译 SkySeraph Apr 7th 2012 Email:skyseraph00@163.com 一.JRTPLI ...
今晚19:00，淘宝自研标准化协议库XQUIC开源直播！
今晚19:00-20:00,淘系技术视频号. XQUIC项目负责人喵吉与你详聊开源背后的故事. 开源地址:https://github.com/alibaba/xquic XQUIC介绍 XQUIC ...
配置开源安卓QQ协议库Mirai
博客和更新地址:配置开源安卓QQ协议库Mirai 前言因为经常配置Mirai,每次手动输入命令有些麻烦,所以记录一下配置过程. 配置JDK Debian系: apt install openjdk- ...
Modbus协议概念最详细介绍
★ 一文认识Modbus协议: " 1 什么是Modbus? 2 主从模式 3 协议的分类 3.1 Modbus ASCII 3.2 Modbus RTU 3.3 Modbus TCP 3. ...
C#实现Modbus协议与PLC通信
项目需要用C#写一个上位机,用Modbus/TCP协议与PLC通信,控制伺服电机的启停.转速等.D:\Code\C#\ConsoleApp1 1. 获取PLC的IP地址待续... 2. " ...
嵌入式相关开源项目、库、资料------持续更新中
学习初期最难找的就是找学习资料了,本贴精心汇总了一些嵌入式相关资源,包括但不限于编程语言.单片机.开源项目.物联网.操作系统.Linux.计算机等资源,并且在不断地更新中,致力于打造全网最全的嵌入式资 ...
wpf项目源代码_C# WPF开源控件库：MahApps.Metro
C# WPF开源控件库:MahApps.Metro ❝ 其实站长很久之前就知道这个开源WPF控件库了,只是一直欣赏不了这种风格,但也star了该项目.每次浏览该仓库时,发现star越来越多,也看到很多 ...

开源Modbus 协议库---XTinyModbus

开源Modbus 协议库---XTinyModbus相关推荐

最新文章

热门文章