1.关于手册

1.1.略缩词介绍

1.2.命名规则

瞬锐智控IO控制器设备的命名规则如下表：

1.3.本手册适用型号

除特殊说明，本手册所有介绍的功能均适用型号如下表所示

不同型号的设备在硬件参数上有所差别，软件功能上完全一样，本手册的案例以 SC-NI 8822为例进行说明，其他型号的设备用法完全一样，本手册适用型号如下表：

1.4.硬件准备

(1)USB转RS485调试器（或者其他可以实现UART转RS485的通信转换器），购买渠道：

https://item.taobao.com/item.htm?ft=t&id=1055269224154

(2)12V 1A电源适配器（或者其他符合8~36V的直流电源），购买渠道：

https://item.taobao.com/item.htm?ft=t&id=1055270916598

(3) IO控制器SC-NI XXXX全系列购买渠道：

https://item.taobao.com/item.htm?ft=t&id=1093450112708

1.5.资料下载

(1)上位机软件，下载链接：

https://doc.shunrui.cn/doc/8/

(2)USB转RS485调试器驱动程序，下载链接：

https://doc.shunrui.cn/doc/22/

2.前期准备

2.1.硬件准备

升级固件需准备以下硬件：

(1)12V电源适配器 1个。

(2)UART转RS485转换器一个（带A、B线）。

(3)RS485接口SC-NI型号IO控制器 1台（SC-NI 8822为例）。

注：本产品采用宽电压直流8~36V供电，整机功率小于4瓦。建议使用DC12/24V 1A的电源适配器给设备供电。

2.2.硬件连接

(1)SC-NI系列电源和通讯接线端子定义如下表：

(2)根据上表，按对应关系接入电源线和RS485通讯线。

2.3.通信连接

设备出厂默认串口通信参数如下，首次通讯请按下表配置串口参数：

(1)连接RS485并确认串口号：

本次演示采用USB转RS485通信转换器进行演示，将485通信接口A信号连接设备RS485-A端子，B信号连接设备RS485-B端子，正常情况下调试器GND信号可以不与设备“GND端子”相接，如果现场RS485总线干扰较大，通信不稳定也可以考虑接上。

将USB转RS485调试器插入电脑USB接口，打开“设备管理器”并记录串口对应的COM序号，本演示串口号为图示“COM3”。

(2)供电并查看工作是否正常：接通电源适配电源给设备供电，等待设备正常运行，设备正常运行时运行灯会按照亮400毫秒、灭400毫秒的频率闪烁。

(3)运行上位机并打开串口：运行上位机“瞬锐LTE 网络IO控制器设置软件”，在右上角“通信参数”处选择“设备管理器”端口号的串口号，其它参数保持和下图一致，点击“打开”按钮。

备注：点击后如“打开”按钮左侧的圆圈不由灰色变为蓝色或上位机右下角提示“串口打开失败”时，请关闭其它占用该串口的软件或者重启电脑。

(4)通过上位机软件查看设备系统参数：

点击上位机左侧“设备系统参数”导航条，再在中间区域“设备系统参数”下方点击“读取设备系统参数”按钮。上位机右侧“日志”栏会展示和设备交互指令，待设备正确回应后会在中间状态栏展示窗口展示“设备型号”“软硬件版本”“设备SN编码”等信息。

2.4.获取通信参数

在遗忘从机地址或串口参数时，可以通过特殊上电启动方式获取关键参数。

(1)将设备关电，通过USB转RS485调试器将设备和电脑直连。上位机软件“电脑通信参数”配置230400波特率、8位数据位、1停止位、无检验位，去掉右侧“日志”侧边栏“Hex”勾选。

(2)按住复位按钮不松开，给设备接入供电电源，等待5秒左右待收到如下图的数据日志时松开复位按钮。

(3)如上图所示，电脑串口收到了“设备名称”、“RS485口参数”和“从机地址”一共三个关键参数。

3.上位机配置MQTT通信

本产品支持1路MQTT连接，默认接入瞬锐公有云，可配置为接入客户私有云平台。当接入私有云时MQTT支持3路订阅和发布。每路会话都可以配置为Modbus模式、JSON解析模式以及Modbus TCP转RTU模式。每路会话都支持QOS值独立配置，支持注册包和心跳包，支持遗嘱消息。

3.1.瞬锐公有云

(1)点击上位机左侧“MQTT参数”导航条。

(2)可以看到“MQTT云服务”默认为“瞬锐公有云”，如果设备已连接至互联网，连接标志圆点为绿色。

(3)瞬锐云工作在MQTT通信独占模式下，请不要修改任何MQTT参数。

(4)在个人电脑端使用浏览器访问“瞬锐云”官方网站“https://cloud.shunrui.cn”。

(5)在“瞬锐云”官方网站注册个人账号并登录系统。

(6)点击“添加设备”按钮，在弹出“添加设备”对话框中输入设备SN号（SN号可在产品外壳标签上查看），点击“查询设备”按钮。

(7)确认无误后点击“确认添加”按钮完成设备添加。

(8)关闭“添加设备”对话框。

(9)在刚刚添加的设备标签上点击“监控”按钮，系统弹出“设备监控页面”对话框。

(10)“设备监控页面”对话框可以查看DI和AI采集值以及控制DO和AO。

(11)关闭“设备监控页面”对话框。

(12)在刚刚添加的设备标签上点击“数据”按钮，系统弹出设备详细配置对话框，默认激活“设备信息”标签页，在此标签页下可以查看“设备序列号”、“设备Modbus地址”、“设备软件版本”以及“设备硬件版本”等信息，同时也可以对一些系统级参数进行修改。

(13)点击“4G信息”标签页，在此标签页下可以查看系统蜂窝网络信息也可对网络参数进行修改。

(14)依次点击“串口信息”、“DI信息”“DO信息”“AI信息”“AO信息”标签页，查看各类实时信息以及对相关配置进行修改。

3.2.代理子设备接入瞬锐云

本章节以SC-RI 8822为例介绍使用联网产品代理RS485型IO控制器（子设备）接入瞬锐云，前提是需要保持子设备Modbus从机地址和联网型产品不能相同。

(1)使用拨码开关或上位机将SC-RI 8822设备从机地址改为1(0x01)。

(2)使用导线将RS485型子设备和联网型设备RS485接口连接上，给两台设备上电。

(3)在个人电脑端使用浏览器访问“瞬锐云”官方网站“https://cloud.shunrui.cn”。

(4)在“瞬锐云”官方网站注册个人账号并登录系统。

(5)点击“添加设备”按钮，在弹出“添加设备”对话框中输入子设备SN号（SN号可在产品外壳标签上查看），点击“查询设备”按钮。

(6)确认无误后点击“确认添加”按钮完成设备添加。

(7)点击“编辑”按钮。

(8)修改“设备名称”为“SC-RI 8822”，修改“设备地址”为“1”。

(9)选择正确的联网型产品为其代理设备，点击“确定”按钮。

(10)在刚刚添加的设备标签上点击“监控”按钮，系统弹出“设备监控页面”对话框。

(11)“设备监控页面”对话框可以查看DI和AI采集值以及控制DO和AO。

(12)关闭“设备监控页面”对话框。

(13)在刚刚添加的设备标签上点击“数据”按钮，系统弹出设备详细配置对话框，默认激活“设备信息”标签页，在此标签页下可以查看“设备序列号”、“设备Modbus地址”、“设备软件版本”以及“设备硬件版本”等信息，同时也可以对一些系统级参数进行修改。

(14)依次点击“串口信息”、“DI信息”“DO信息”“AI信息”“AO信息”标签页，查看各类实时信息以及对相关配置进行修改。

3.3.MQTT通信

(1)点击上位机左侧“MQTT参数”导航条。

(2)修改“MQTT云服务”为“私有云”。

(3)客户端ID”为设备唯一识别码，为方便演示此处修改“客户端ID类型”为“SN”。

(4)填写“服务器地址”为“broker.emqx.io”，注意此服务器提供公益测试服务，请勿用于生产环境。

(5)填写“服务器端口”为“1883”。

(6)在“主题 1”区域选择“Topic1模式”为“Modbus模式”。

(7)填写“订阅Topic”内容为“dev_1785226211_Modbus_req”，1785226211为自定义主题识别码，注意根据实际情况修改。

(8)填写“发布Topic”内容为“dev_1785226211_Modbus_res”，1785226211为自定义主题识别码，注意根据实际情况修改。

(9)在“主题 2”区域选择“Topic2模式”为“JSON解析模式”。

(10)填写“订阅Topic”内容为“dev_1785226211_json_req”，1785226211为自定义主题识别码，注意根据实际情况修改。

(11)填写“发布Topic”内容为“dev_1785226211_json_res”，1785226211为自定义主题识别码，注意根据实际情况修改。

(12)在“主题 3”区域选择“Topic3模式”为“Modbus TCP<-->RTU”。

(13)在“映射串口”右侧勾选“Uart1”单选框激活选中状态。

(14)填写“订阅Topic”内容为“dev_1785226211_tcprtu_req”，1785226211为自定义主题识别码，注意根据实际情况修改。

(15)填写“发布Topic”内容为“dev_1785226211_tcprtu_res”，1785226211为自定义主题识别码，注意根据实际情况修改。

(16)填写“遗嘱Topic”内容为“dev_1785226211_will_msg”，1785226211为自定义主题识别码，注意根据实际情况修改。

(17)在“遗嘱”区域勾选“遗嘱使能”单选框，激活选中状态。

(18)填写“遗嘱长度”内容“6”，点击“遗嘱内容格式”右侧“HEX”单选框，去掉选中状态。

(19)填写“遗嘱内容”为“Byebye”。

(20)点击“保存MQTT参数”按钮。

(21)请重启设备以便配置生效。

(22)在电脑上安装MQTT测试工具MQTTX并打开软件，点击“新建连接”。

(23)在“名称”栏输入“emqx”。

(24)在“服务器地址”栏输入“broker.emqx.io”。

(25)在“端口”栏输入“1883”。

(26)“Client ID”栏软件会自动生成随机字符串。

(27)点击“连接”按钮。

(28)点击“添加订阅”按钮。

(29)在“Topic”栏输入“dev_1785226211_Modbus_res”，此处需和设备主题1发布Topic相同。

(30)点击“确定”按钮。

(31)选择“接收数据格式”为“HEX”。

(32)选择“发送数据格式”为“HEX”。

(33)在发送区“Topic”栏输入“dev_1785226211_Modbus_req”，此处需和设备主题1订阅Topic相同。

(34)在发送数据内容栏输入“30 05 00 00 FF 00 88 1B”。

(35)点击“发送”图标。

(36)设备第一个DO继电器会吸合，同时dev_1785226211_Modbus_res主题能收到设备的Modbus回应数据。

(37)点击“添加订阅”按钮。

(38)在“Topic”栏输入“dev_1785226211_json_res”，此处需和设备主题2发布Topic相同。

(39)点击“确定”按钮。

(40)选择“接收数据格式”为“JSON”。

(41)选择“发送数据格式”为“JSON”。

(42)在发送区“Topic”栏输入“dev_1785226211_json_req”，此处需和设备主题2订阅Topic相同。

(43)在发送数据内容栏输入{"cmd":"set","id":0,"sn":"2607071821","ts":1748928000,"ver":"1.0","data":{"do":{"DO1":0}}},注意SN字段需要用设备真实SN替换。

(44)点击“发送”图标。

(45)刚刚打开的设备第一个DO继电器会断开，同时dev_1785226211_json_res主题能收到设备的JSON回应数据。

(46)在设备RS485接口上接上1台支持DO输出的RS485型IO控制器，配置其从机地址为1并重启生效配置。

(47)点击“添加订阅”按钮。

(48)在“Topic”栏输入“dev_1785226211_tcprtu_res”，此处需和设备主题3发布Topic相同。

(49)点击“确定”按钮。

(50)选择“接收数据格式”为“HEX”。

(51)选择“发送数据格式”为“HEX”。

(52)在发送区“Topic”栏输入“dev_1785226211_tcprtu_req”，此处需和设备主题3订阅Topic相同。

(53)在发送数据内容栏输入“00 04 00 00 00 06 01 05 00 00 FF 00”。

(54)点击“发送”图标。

(55)下挂设备第一个DO继电器会吸合，同时在dev_1785226211_tcprtu_res主题上能收到联网设备将Modbus RTU数据转换成Modbus TCP格式的回应帧。

(56)点击“添加订阅”按钮。

(57)在“Topic”栏输入“dev_1785226211_will_msg”，此处需和设备遗嘱Topic相同。

(58)点击“确定”按钮。

(59)选择“接收数据格式”为“Plaintext”。

(60)将设备断电，等待1分钟左右。

(61)可在dev_1785226211_will_msg主题上收到遗嘱消息“Byebye”。

4.串口助手配置MQTT通信

(1)Modbus-RTU通信的帧结构。

(2)Modbus-RTU功能码说明。

(3)MQTT相关寄存器。

4.1.瞬锐公有云

(1)“MQTT云服务”默认为“瞬锐公有云”，可配置瞬锐公有云、瞬锐私有云、客户是有云。

(2)配置“MQTT云服务”为“瞬锐公有云”

请求帧：30 06 06 5A 00 00 AD 70

配置数据0x0000表示瞬觅云，MQTT功能独占。

回应帧：30 06 06 5A 00 00 AD 70

(3)配置完成后，在个人电脑端使用浏览器访问“瞬锐云”官方网站“https://cloud.shunrui.cn”。

(4)登录网站后，配置方式根据上面2.2章节步骤连接即可。

4.2.客户私有云

(1)配置“MQTT云服务”为“客户私有云”

请求帧：30 06 06 5A 00 02 2C B1

配置数据0x0000表示瞬觅云，MQTT功能独占。

回应帧：30 06 06 5A 00 02 2C B1

(2)“服务器地址”为“broker.emqx.io”。

[ASCII]broker.emqx.io ⇄[HEX]62 72 6F 6B 65 72 2E 65 6D 71 78 2E 69 6F

请求帧：30 10 06 5B 00 07 0E 62 72 6F 6B 65 72 2E 65 6D 71 78 2E 69 6F E4 6E

回应帧：30 10 06 5B 00 07 F4 B1

(3)配置“服务器端口”为“1883”。

请求帧：30 06 06 7B 07 5B BE B1

配置数据0x075B十进制表示1883。

回应帧：30 06 06 7B 07 5B BE B1

(4)配置“客户端ID类型”为“SN”

请求帧：30 06 06 7C 00 01 8D 7B

配置数据0x0001十进制表示“客户端ID类型”配置为“SN。

回应帧：30 06 06 7C 00 01 8D 7B

(5)配置“Topic1模式”为“Modbus模式”。

请求帧：30 06 06 B4 00 00 CD 45

配置数据0x0000表示Modbus模式。

回应帧：30 06 06 B4 00 00 CD 45

(6)配置“订阅Topic”内容为“dev_1785226211_Modbus_req”，1785226211为自定义主题识别码，注意根据实际情况修改。

[ASCII]dev_1785226211_Modbus_req ⇄[HEX]64 65 76 5F 31 37 38 35 32 32 36 32 31 31 5F 4D 6F 64 62 75 73 5F 72 65 71

请求帧：30 10 06 B6 00 0D 1A 64 65 76 5F 31 37 38 35 32 32 36 32 31 31 5F 4D 6F 64 62 75 73 5F 72 65 71 00 A4 7A

回应帧：30 10 06 B6 00 0D E4 83

(7)填写“发布Topic”内容为“dev_1785226211_Modbus_res”，1785226211为自定义主题识别码，注意根据实际情况修改。

[ASCII]dev_1785226211_Modbus_res ⇄[HEX]64 65 76 5F 31 37 38 35 32 32 36 32 31 31 5F 4D 6F 64 62 75 73 5F 72 65 73

请求帧：30 10 06 CB 00 0D 1A 64 65 76 5F 31 37 38 35 32 32 36 32 31 31 5F 4D 6F 64 62 75 73 5F 72 65 73 00 F9 4A

回应帧：30 10 06 CB 00 0D 74 9B

(8)配置Topic2模式”为“JSON解析模式”。

请求帧：30 06 06 E0 00 01 4D 55

配置数据0x0001表示JSON解析模式。

回应帧：30 06 06 E0 00 01 4D 55

(9)填写“订阅Topic2”内容为“dev_1785226211_json_req”，1785226211为自定义主题识别码，注意根据实际情况修改。

[ASCII]dev_1785226211_json_req ⇄[HEX]64 65 76 5F 31 37 38 35 32 32 36 32 31 31 5F 6A 73 6F 6E 5F 72 65 71

请求帧：30 10 06 E2 00 0C 18 64 65 76 5F 31 37 38 35 32 32 36 32 31 31 5F 6A 73 6F 6E 5F 72 65 71 00 35 E3

回应帧：30 10 06 E2 00 0C 64 93

(10)填写“发布Topic2”内容为“dev_1785226211_json_res”，1785226211为自定义主题识别码，注意根据实际情况修改。

[ASCII]dev_1785226211_json_res ⇄[HEX]64 65 76 5F 31 37 38 35 32 32 36 32 31 31 5F 6A 73 6F 6E 5F 72 65 73

请求帧：30 10 06 F7 00 0C 18 64 65 76 5F 31 37 38 35 32 32 36 32 31 31 5F 6A 73 6F 6E 5F 72 65 73 00 13 03

回应帧：30 10 06 F7 00 0C 75 57

(11)配置“Topic3模式”为“Modbus TCP<-->RTU”。

请求帧：30 06 07 0C 00 02 CD 5D

配置数据0x0021表示Modbus TCP转Modbus RTU。

回应帧：30 06 07 0C 00 02 CD 5D

(12)配置“订阅Topic3”内容为“dev_1785226211_tcprtu_req”，1785226211为自定义主题识别码，注意根据实际情况修改。

[ASCII]dev_1785226211_tcprtu_req ⇄[HEX]64 65 76 5F 31 37 38 35 32 32 36 32 31 31 5F 74 63 70 72 74 75 5F 72 65 71

请求帧：30 10 07 0E 00 0D 1A 64 65 76 5F 31 37 38 35 32 32 36 32 31 31 5F 74 63 70 72 74 75 5F 72 65 71 00 00 B3

回应帧：30 10 07 0E 00 0D 65 5A

(13)填写“发布Topic3”内容为“dev_1785226211_tcprtu_res”，1785226211为自定义主题识别码，注意根据实际情况修改。

[ASCII]dev_1785226211_tcprtu_req ⇄[HEX]64 65 76 5F 31 37 38 35 32 32 36 32 31 31 5F 74 63 70 72 74 75 5F 72 65 73

请求帧：30 10 07 23 00 0D 1A 64 65 76 5F 31 37 38 35 32 32 36 32 31 31 5F 74 63 70 72 74 75 5F 72 65 73 00 31 83

回应帧：30 10 07 23 00 0D F5 53

5.版本记录

资料获取

资料平台:doc.shunrui.cn

邮 箱:support@shunrui.cn

电 话:17786086105

商务合作

邮 箱:sales@shunrui.cn

投诉与建议

邮 箱:suggestion@shunrui.cn