# iot-modbus
#### 介绍 基于物联网通信协议的物联网通信协议netty框架，支持COM（串口）和TCP协议支持服务端和客户端两种模式Java控制智能设备，支持设备组多台设备高并发通信。采用工厂设计模式，代码通过继承和重写实现高度包装，可用作SDK提供包装接口，使具体业务开发人员可直接调用接口，无需担心通信协议的底层实现。心跳、背光、扫码、刷卡、指静脉、温湿度和门锁(支持多锁)LCD控制显示屏等指令，控制三色报警灯。代码注释丰富，包括上传和发布指令调用例，非常容易启动。
#### 版本说明 1. V1.0.0版本仅支持TCP服务端通信模式； 2. V2.0.0版本支持TCP两种模式：服务端和客户端，客户端模式还增加了心跳重连机制。 3. V3.0.0版本支持COM（串口）和TCP协议，增加logback根据文件的大小和时间时间切割输出。 4. V3.1.优化版本代码，提取公共模块子工程。 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对串口数据进行数据拆包处理，。
#### 软件架构 说明软件架构 采用基础结构Spring Boot2.x Netty4.X Maven3.6.x，日志采用logback。
#### 安装教程
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 ////信指令调试工具 2. 查看配置文件iot-modbus-test子工程resources目录下的application.yml文件； 3. 查看启动文件iot-modbus-test子工程App.java文件； 4. 服务启动后，服务端口默认为：8080，网口通信端口默认为：4000，串口通信默认为：COM1； 5. 通信指令调试工具，TCP使用通信模式tools目录下的NetAssist.exe，串口使用通信模式tools目录下的UartAssist.exe； 6. 采用通信指令Hex编码(十六进制)； 7. 串口通信依赖文件查看doc/serialport目录，Windows环境下rxtxParallel.dll和rxtxSerial.dll文件拷贝到JDK安装的bin目录下，Linux环境将librxtxParallel.so和librxtxSerial.so文件拷贝到JDK安装的bin目录下； 8. 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 表示长度为4； 4. 第三个是指令符，长度固定占1个字节，例如：BE，表示心跳指令； 5. 四是设备号，长度固定占1字节，如01，表示设备号为1； 6. 第五个是层地址，长度固定占1个字节，如00，表示设备所有层不执行； 7. 第六个是槽地址，长度固定占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 - 第七位是数据位，长度固定占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 - 第七位是数据位，长度固定占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是传感器状态码。 9. 指静脉和温湿度指令(不作说明，详细查看代码)； 10. LCD批量控制显示屏发布指令(不作说明，详细查看代码)； 11. 三色报警灯控制发发指令(不作说明，详细查看代码)。
#### gitee地址 - 下载地址：https://gitee.com/takeoff/iot-modbus