×

iot-modbus物联网通讯协议

消耗积分:2 | 格式:zip | 大小:2.44 MB | 2022-04-20

李晓鹏

分享资料个

授权协议 Apache
开发语言 Java
操作系统 跨平台
软件类型 开源软件
所属分类 其他开源物联网

软件简介

iot-modbus 是一个物联网通讯协议。

  • 基础架构采用Spring Boot2.x + Netty4.X + Maven3.6.x
  • 日志采用 logback。
  • 使用 netty 通讯实现 java 控制智能设备。
  • 支持COM(串口)和TCP协议,支持服务端和客户端两种模式。
  • 同时支持设备组多台设备高并发通讯。
  • 采用工厂设计模式,代码采用继承和重写的方式实现高度封装,可作为SDK提供封装的接口,让具体的业务开发人员无需关心通讯协议的底层实现,直接调用接口即可使用。
  • 实现了心跳、背光灯、扫码、刷卡、指静脉、温湿度和门锁(支持多锁)、LCD显示屏等指令控制、、三色报警灯控制。
  • 代码注释丰富,包括上传和下发指令调用例子,非常容易上手。

版本说明

  1. V1.0.0版本仅支持TCP服务端通讯模式;
  2. V2.0.0版本支持TCP服务端和客户端两种模式,客户端模式还增加了心跳重连机制。
  3. V3.0.0版本支持COM(串口)和TCP协议,增加logback日志按文件大小和时间切割输出。
  4. V3.1.0版本代码优化,抽取公共模块子工程。
  5. V3.2.0版本TCP通讯增加支持LCD显示屏控制指令,支持批量控制LCD显示屏。
  6. V3.2.1版本串口通讯增加支持LCD显示屏控制指令,支持批量控制LCD显示屏。
  7. V3.2.2版本串口通讯接收指令数据拆包处理代码优化,网口通讯增加支持三色报警灯控制指令。
  8. V3.2.3版本串口通讯增加支持三色报警灯控制指令,串口通讯接收指令数据拆包处理代码优化。
  9. V3.2.4版本使用netty集成Rxtx对串口数据进行数据拆包处理,并且对指静脉指令进行优化。

安装教程

1.  系统Windows7以上;
2.  安装Jdk1.8以上;
2.  安装Maven3.6以上;
3.  代码以Maven工程导入Eclipse或Idea。

使用说明

  1. 工程结构说明:
  • iot-modbus //物联网通讯父工程
  • ├── doc //文档管理
  • ├── iot-modbus-client //netty通讯客户端
  • ├── iot-modbus-common //公共模块子工程
  • ├── iot-modbus-netty //netty通讯子工程
  • ├── iot-modbus-serialport //串口通讯子工程
  • ├── iot-modbus-server //netty通讯服务端
  • ├── iot-modbus-test //使用样例子工程
  • └── tools //通讯指令调试工具
  1. 配置文件查看iot-modbus-test子工程resources目录下的application.yml文件;
  2. 启动文件查看iot-modbus-test子工程App.java文件;
  3. 服务启动后,服务端端口默认为:8080,netty通讯端口默认为:4000;
  4. 通讯指令调试工具,查看tools目录下的NetAssist.exe;
  5. 通讯指令采用Hex编码(十六进制);
  6. 串口通讯依赖文件查看doc/serialport目录,Windows环境下rxtxParallel.dll和rxtxSerial.dll文件拷贝到JDK安装的bin目录下,Linux环境将librxtxParallel.so和librxtxSerial.so文件拷贝到JDK安装的bin目录下;
  7. postman指令下发样例请查看doc/postman/通讯指令下发.postman_collection.json文件,包括门锁(单锁/多锁)、扫码、背光灯、LCD显示屏灯、三色报警灯指令。

指令格式

1.  以心跳指令(7E 04 00 BE 01 00 00 74 77 7F)作为样例说明,下标从0开始;
2.  第0位为起始符,长度固定占1个字节,固定格式:7E;
3.  第1、2位为数据长度,计算方法是从命令符到数据位(即:从3位到指令长度-3位),长度固定占2个字节,例如:04 00,表示长度为4;
4.  第3位为指令符,长度固定占1个字节,例如:BE,表示心跳指令;
5.  第4位为设备号,长度固定占1个字节,例如:01,表示设备号为1;
6.  第5位为层地址,长度固定占1个字节,例如:00,表示设备所有的层不执行;
7.  第6位为槽地址,长度固定占1个字节,例如:00,表示设备所有的槽不执行;
8.  指令长度-3位到-2位为校验位,采用CRC16_MODBUS(长度,命令,地址,数据)校验,例如:74 77,详细查看:ModbusCrc16Utils.java工具类;
9.  末位为结束符,长度固定占1个字节,固定格式:7F。

通讯指令

1.  心跳上传指令
- iot-modbus作为服务端,通过心跳来维持通讯,启动服务端后,打开NetAssist.exe指令调试工具,先往服务端发送心跳指令;
- 硬件往服务端发送:7E 04 00 BE 01 00 00 74 77 7F ,为必要指令。
2.  背光灯上传指令
- 硬件往服务端发送:7E 05 00 88 01 00 00 00 AF E3 7F 
3.  扫码指令下发
- 服务端往硬件下发:7E 05 00 08 01 00 00 01 6F FD 7F 
- 第7位为数据位,长度固定占1个字节,例如:01,表示开开启扫码头。
4.  扫码指令上传
- 硬件往服务端发送:7E 24 00 8F 01 00 00 03 45 30 30 34 30 31 30 38 32 38 30 32 41 36 39 33 0D 02 00 00 01 02 13 73 02 00 00 01 02 13 73 9B 79 7F
- 数据为:03 45 30 30 34 30 31 30 38 32 38 30 32 41 36 39 33 0D 02 00 00 01 02 13 73 02 00 00 01 02 13 73为条码信息。
5.  刷卡指令上传
- 硬件往服务端发送:7E 08 00 84 01 00 00 86 14 AE 02 7C 53 7F 
- 数据位:86 14 AE 02为卡号信息。
6.  单开锁下发指令
- 服务端往硬件下发:7E 05 00 03 01 00 00 01 CA 3C 7F
- 第7位为数据位,长度固定占1个字节,例如:01,表示开1号锁。
7.  多开锁下发指令
- 服务端往硬件下发:7E 08 00 03 FF FF FF 01 00 02 01 7F B0 7F 
- FF FF FF为指令做兼容填补位,后面 01 00 02 01是数据位,其中:01表示1号锁,00表示上锁;02表示2号锁,01表示开锁。
8.  锁状态上传指令
- 硬件往服务端发送:7E 0D 00 83 01 00 00 FF FF FF 01 00 05 02 00 01 EE 99 7F 
- FF FF FF为指令做兼容填补位,后面 01 00 05 02 00 01是数据位,其中:01表示1号锁,00表示上锁,05表示传感器状态码;02表示2号锁,00表示上锁,01表示传感器状态码。

  1. 指静脉和温湿度指令(不作说明,详细查看代码);
  2. LCD显示屏批量控制下发指令(不作说明,详细查看代码);
  3. 三色报警灯控制下发指令(不作说明,详细查看代码)。

开源项目

- gitee地址:https://gitee.com/takeoff/iot-modbus

- github地址:https://github.com/luorongxi/iot-modbus

 

声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉

评论(0)
发评论

下载排行榜

全部0条评论

快来发表一下你的评论吧 !

'+ '

'+ '

'+ ''+ '
'+ ''+ ''+ '
'+ ''+ '' ); $.get('/article/vipdownload/aid/'+webid,function(data){ if(data.code ==5){ $(pop_this).attr('href',"/login/index.html"); return false } if(data.code == 2){ //跳转到VIP升级页面 window.location.href="//m.obk20.com/vip/index?aid=" + webid return false } //是会员 if (data.code > 0) { $('body').append(htmlSetNormalDownload); var getWidth=$("#poplayer").width(); $("#poplayer").css("margin-left","-"+getWidth/2+"px"); $('#tips').html(data.msg) $('.download_confirm').click(function(){ $('#dialog').remove(); }) } else { var down_url = $('#vipdownload').attr('data-url'); isBindAnalysisForm(pop_this, down_url, 1) } }); }); //是否开通VIP $.get('/article/vipdownload/aid/'+webid,function(data){ if(data.code == 2 || data.code ==5){ //跳转到VIP升级页面 $('#vipdownload>span').text("开通VIP 免费下载") return false }else{ // 待续费 if(data.code == 3) { vipExpiredInfo.ifVipExpired = true vipExpiredInfo.vipExpiredDate = data.data.endoftime } $('#vipdownload .icon-vip-tips').remove() $('#vipdownload>span').text("VIP免积分下载") } }); }).on("click",".download_cancel",function(){ $('#dialog').remove(); }) var setWeixinShare={};//定义默认的微信分享信息,页面如果要自定义分享,直接更改此变量即可 if(window.navigator.userAgent.toLowerCase().match(/MicroMessenger/i) == 'micromessenger'){ var d={ title:'iot-modbus物联网通讯协议',//标题 desc:$('[name=description]').attr("content"), //描述 imgUrl:'https://'+location.host+'/static/images/ele-logo.png',// 分享图标,默认是logo link:'',//链接 type:'',// 分享类型,music、video或link,不填默认为link dataUrl:'',//如果type是music或video,则要提供数据链接,默认为空 success:'', // 用户确认分享后执行的回调函数 cancel:''// 用户取消分享后执行的回调函数 } setWeixinShare=$.extend(d,setWeixinShare); $.ajax({ url:"//www.obk20.com/app/wechat/index.php?s=Home/ShareConfig/index", data:"share_url="+encodeURIComponent(location.href)+"&format=jsonp&domain=m", type:'get', dataType:'jsonp', success:function(res){ if(res.status!="successed"){ return false; } $.getScript('https://res.wx.qq.com/open/js/jweixin-1.0.0.js',function(result,status){ if(status!="success"){ return false; } var getWxCfg=res.data; wx.config({ //debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以在pc端打开,参数信息会通过log打出,仅在pc端时才会打印。 appId:getWxCfg.appId, // 必填,公众号的唯一标识 timestamp:getWxCfg.timestamp, // 必填,生成签名的时间戳 nonceStr:getWxCfg.nonceStr, // 必填,生成签名的随机串 signature:getWxCfg.signature,// 必填,签名,见附录1 jsApiList:['onMenuShareTimeline','onMenuShareAppMessage','onMenuShareQQ','onMenuShareWeibo','onMenuShareQZone'] // 必填,需要使用的JS接口列表,所有JS接口列表见附录2 }); wx.ready(function(){ //获取“分享到朋友圈”按钮点击状态及自定义分享内容接口 wx.onMenuShareTimeline({ title: setWeixinShare.title, // 分享标题 link: setWeixinShare.link, // 分享链接 imgUrl: setWeixinShare.imgUrl, // 分享图标 success: function () { setWeixinShare.success; // 用户确认分享后执行的回调函数 }, cancel: function () { setWeixinShare.cancel; // 用户取消分享后执行的回调函数 } }); //获取“分享给朋友”按钮点击状态及自定义分享内容接口 wx.onMenuShareAppMessage({ title: setWeixinShare.title, // 分享标题 desc: setWeixinShare.desc, // 分享描述 link: setWeixinShare.link, // 分享链接 imgUrl: setWeixinShare.imgUrl, // 分享图标 type: setWeixinShare.type, // 分享类型,music、video或link,不填默认为link dataUrl: setWeixinShare.dataUrl, // 如果type是music或video,则要提供数据链接,默认为空 success: function () { setWeixinShare.success; // 用户确认分享后执行的回调函数 }, cancel: function () { setWeixinShare.cancel; // 用户取消分享后执行的回调函数 } }); //获取“分享到QQ”按钮点击状态及自定义分享内容接口 wx.onMenuShareQQ({ title: setWeixinShare.title, // 分享标题 desc: setWeixinShare.desc, // 分享描述 link: setWeixinShare.link, // 分享链接 imgUrl: setWeixinShare.imgUrl, // 分享图标 success: function () { setWeixinShare.success; // 用户确认分享后执行的回调函数 }, cancel: function () { setWeixinShare.cancel; // 用户取消分享后执行的回调函数 } }); //获取“分享到腾讯微博”按钮点击状态及自定义分享内容接口 wx.onMenuShareWeibo({ title: setWeixinShare.title, // 分享标题 desc: setWeixinShare.desc, // 分享描述 link: setWeixinShare.link, // 分享链接 imgUrl: setWeixinShare.imgUrl, // 分享图标 success: function () { setWeixinShare.success; // 用户确认分享后执行的回调函数 }, cancel: function () { setWeixinShare.cancel; // 用户取消分享后执行的回调函数 } }); //获取“分享到QQ空间”按钮点击状态及自定义分享内容接口 wx.onMenuShareQZone({ title: setWeixinShare.title, // 分享标题 desc: setWeixinShare.desc, // 分享描述 link: setWeixinShare.link, // 分享链接 imgUrl: setWeixinShare.imgUrl, // 分享图标 success: function () { setWeixinShare.success; // 用户确认分享后执行的回调函数 }, cancel: function () { setWeixinShare.cancel; // 用户取消分享后执行的回调函数 } }); }); }); } }); } function openX_ad(posterid, htmlid, width, height) { if ($(htmlid).length > 0) { var randomnumber = Math.random(); var now_url = encodeURIComponent(window.location.href); var ga = document.createElement('iframe'); ga.src = 'https://www1.elecfans.com/www/delivery/myafr.php?target=_blank&cb=' + randomnumber + '&zoneid=' + posterid+'&prefer='+now_url; ga.width = width; ga.height = height; ga.frameBorder = 0; ga.scrolling = 'no'; var s = $(htmlid).append(ga); } } openX_ad(828, '#berry-300', 300, 250);