DTU固件云配置

# DTU云配置

# 云配置先导说明：

- 1.  登录云配置平台[dtu.iffiot.com](https://dtu.iffiot.com/)
- 2.  在设备列表里看到设备编号（没有的话联系厂家）
- 3.  在分组管理的“默认分组”设置参数后，设备上电会自动更新参数（设备在分组里）
- （如果只有一个项目，那就直接用“默认分组”）
- （DTU重启一次或24小时会自动更新参数）
- 4.  多项目时，新建分组，设备分配到新分组，同一分组参数可以**关键字****区**分设备
- 5.  收到后建议用我们的临时TCP测试服务器跑通一次（[tcp.iffiot.com](http://tcp.iffiot.com/)）

（MQTT参数比多容易搞错，建议先用TCP测试数据收发都正常）

![配图1](https://docs.iffiot.com/media/202611/dtu/img0.png)

# **概述**

DTU透传固件,方便可以在零开发的情况下，实现上电自动进入纯透传，快速和服务器双向通讯。

支持的网络协议有TCP/UDP，http, MQTT、阿里云、ONENET、腾讯IOT；

有自动采集任务，能定时向串口发送设定数据；

带边缘计算和二次开发功能。

DTU固件能够自动维护网络，保证永久在线，有成熟的离线重连机制。用户MCU只需要专注于逻辑，通过模块实现透传功能，把数据上传到服务器。

复杂任务可以通过数据流或脚本任务来实现；

**(备注：我司DTU有两种模组型号，型号A是合宙780E,支持文档全部功能；型号B是中移ML307功能有简化，支持1路TCP、MQTT、ONENET，支持1条自动采集指令）**

# **1. DTU云配置的优点：**

传统DTU配置方法是用本地串口工具配置，DTU设备通过USB转换线插到电脑，一个一个的配置，还要拆装设备，这种配置参数的方法效率非常低，耗时耗力；并且DTU一定要在身边才能配置；

既然DTU本身是能联网的设备，为什么不直接通过网络就快速的、批量的、远程的配置呢？云配置就很好的解决了这些问题；

## **1.1云配置优点：**

**1)参数的批量配置**

同一个分组的设备，其参数全部相同，可以同时对几百上千的设备批量设置，节省时间。

**2)随时动态修改参数**

当设备部署后，如果参数需要修改，可以在平台上直接配置参数，不需要到部署地方去。如果DTU在身边，上电重启会立即更新参数；如果设备在远方，24小时后会自动更新参数；

**3)设备参数的集中管理、不同客户不同分组**

全部的设备都在同一个平台上，通过不同的分组名称，对应不同的客户，方便管理；

**4)设备参数的可追溯管理**

平台设置的设备参数都会保存，并且可以导出，需要查看的时候可以随时查看。

## **1.2 ****串口****配置：****(ML307-DC不支持）**

如需传统方式的**用电脑485线本地配置**（配置方法一致），请下载配置软件：

1.单机版本：[DTUConfig_v2单机版本-电脑有网.zip](https://pan.baidu.com/s/1jDwmIq5pr15CdjZoY0OAVQ?pwd=uyrn)       提取码: uyrn

2.WEB串口版本的串口配置工具：[DTU串口配置指令-780E](https://docs.qq.com/markdown/DZUpUa1d5WUFpU1hM)

![配图2](https://docs.iffiot.com/media/202611/dtu/img1.png)

## **1.3 SIM卡要求说明：**

1)  普通物联网卡：可以任何IP，我们默认的就是普通卡；

2)  定向卡：有限制IP ，需要提前向卡商登记白名单;

除了自己的服务器IP外，一定要绑定云配置IP：**124.220.57.183**

3)  VPN专网卡：不适用web服务器配置（特殊行业）

说明：不同卡成本和特性不一样，所以运营商分出不同类型卡

# **2.云配置使用流程**

## **2.1 ****帐号注册：**

![配图3](https://docs.iffiot.com/media/202611/dtu/img2.png)

新用户先注册平台账号。手机号为账号唯一识别码，密码请妥善保管。注册帐号网站只是注册时用，后续参数配置都用云配置平台，上面注册平台注册的账号密码，在云配置平台登录；

**(建议用自已手机号当账号和密码，不容易忘记）**

云参数配置平台：[https://dtu.iffiot.com/#/](https://dtu.iffiot.com/#/)

**手机端：**[https://dtu.iffiot.com/phone](https://dtu.iffiot.com/phone)

**(手机端因为屏幕限制功能少点多，适合外出临时使用）**

## **2.2 ****添加设备编号到帐号**

**用户登录后可以点设备列表界面的“****批量转移归属****”来添加设备IMEI号；**

![配图4](https://docs.iffiot.com/media/202611/dtu/img3.png)

如果添加不成功，联系销售给您把设备添加到你的账号

## **2.3 创建分组**

创建新的分组，可以配置串口波特率，通讯协议等内容，保存参数

## **2.4 分组添加**

一个分组下的设备，参数全部相同，包括产品型号。

但每个设备可以用IMEI自动区分

## **2.5 设置参数**

编辑分组，保存参数即可，注意每次保存都会导致参数变化，设备就会自动更新。如果你只是浏览参数而没有修改，建议不要点击保存，直接返回。

## **2.6 设备更新参数**

重启设备(断电重启)或者24小时后，如果服务器有参数更新，设备会自动更新设置的参数，如果无更新，不做任何处理。

## **2.7 ****确认****参数更新**

通过看“最近上线时间”来判定参数是否更新

# **3.****参数****云配置详细说明**

## **3.1创建新组**

新分配的账户有个默认分组，所有先是在默认分组的，同一个组的设备的参数都相同。

（但登录包和心跳包可以通过关键字设置让每个不同）

## **3.2 添加配设备**

新设备用户可以自己到“批量转移归属”来添加到自己帐号；

![配图5](https://docs.iffiot.com/media/202611/dtu/img4.png)

如果不成功需要联系销售，提供你的注册帐号和设备IMEI号分配到你的账户才能看到对应的设备；然后自己根据逻辑把设备分配到某一组。

## **3.3 配置参数**

进入参数配置，当配置好参数后，点击保存，确认保存后，就修改了参数。注意任何确认保存都会修改服务器参数，导致DTU重新更新参数。如果您只是浏览参数，就不要点击保存直接返回即可。当保存参数退出后，就可以看到分组的参数版本变化了，并且提示没有更新的设备数量。

**（备注：****demo和未分组 不要用，新建分组再用）**

**分组和配置**：不同客户的网络参数不同，对应不同分组；

## **3.4 设备更新参数**

确认设备能正常联网后(NETLED慢闪)，重启设备，设备就会自动更新参数。然后再设备管理-\>设备列表里面查看更新结果。当分组参数版本等于设备参数版本时表示设备参数更新成功。设备信息不会自动刷新，可以点击查找或者F5更新界面。

如果设备已经部署出去，就需要想办法让设备重启或者再分组管理-\>基本参数-\>设置分组参数更新为自动更新，就会24小时自动请求一次服务器。请求一次，如果服务器没更新参数会使用少量的请求流量，大概200多Byte。

# **4.**** ** **参数配置项含义**

## **4.1、基本参数**

| 名称 | 说明 |
| --- | --- |
| 模式 | 透传模式：上电透传，免开发实现透传的方式，发送到服务器 |
| 是否加设备识别码 | 加：所有数据前面都会加IMEI号；否则不加IMEI号 |
| 报文转换 | 默认不转换 |
| 首次登陆发送注册信息 | 按提示选择，如果是连接ONENET一定要选择“不发” 自定义：可以是字符串， 也可以是DTU的IMEI号或卡号或截取IMEI几位数等（看手册5.1） |
| 配置密码 | 如果设置了密码，当下一次设置的时候必须输入同样的密码才能设置，否者只 能本地复位模组参数。同时本地串口必须验证密码后才能读取参数，可以防止非法访问设备的参数 |
| 网络分帧时间 | 网络数据分包超时时间，当2个字节的数据间隔大于这个时间后，将发送给串口 |
| 串口分帧超时 | 串口数据分包超时时间，当2个字节的数据间隔大于这个时间后，将发送给服务 器 |

## **4.2、串口参数**

## **4.3 网络通道参数**

网络通道参数，每个通道表示一个连接，有多少个通道就最多可以连接多少个服务器。设置DTU连接服务器的通信协议和对应的参数，分别支持TCP、UDP、MQTT、ONENET、阿里云、百度云，腾讯云；

### **4.3.1、TCP/UDP参数**

| 名称 | 说明 |
| --- | --- |
| 是否启用 | 是否启动本通道 |
| 协议 | TCP 或 UDP |
| 心跳包 | 可以是字符串，自定义 也可以是DTU的IMEI号或卡号或截取IMEI几位数等（需要联系销售技术） |
| TCP通道捆绑的串口ID | MDP724A（导轨DTU)：232或TTL 选择“1”；485口选择“2” |
| 被动上报间隔 | 空 |
| 被动采集间隔 | 空 |
| 自动任务间隔时间 | 对应“自动采集任务”栏里的“自动采集任务“的间隔时间； **（在TCP/MQTT/ONENET都支持自动任务功能）** |
| SSL | SSL安全认证，一般都不启动，除非一些特殊的应用； |

TCP的测试服务器：[http://tcp.minyee.com/](http://tcp.minyee.com/)

### **4.3.****3**** ****MQTT协议****配置**

MQT的测试服务器：[http://mqtt.xnkiot.com/](http://mqtt.xnkiot.com/)

## **4.4 ****自动采集任务**

自动任务，是在DTU内保存对外轮询的命令，当设置命令后DTU就会按照间隔自动发送数据给串口。当收到串口数据后，又自动发送到服务器。特别适合一些MODBUS协议的仪表，减少服务器的工作量；

**（在TCP/MQTT/ONENET都支持自动任务功能）**

| 名称 | 说明 |
| --- | --- |
| 采集等待 | 是两条指令之间的时间 |
| Cmd1 | 直接输入查询的指令，HEX格式01 03 02 00 01 0A FF（字符串也先转成HEX) |
| Cmd2 | 直接输入查询的指令，HEX格式 |

自动任务间隔时间也要设置：在“网络通道参数”的“SOCKET”里：

## **4.4 GPIO:一般不启用**

**4.5 GPS：无GPS不启用**

## **4.6 数据流**

数据流是也是边缘计算的一种简单应用；可以对数据直接做运算处理；

(上图中数据流模板功能是：在原串口接收的数据最后面加卡号和信号强度）

## **4.7 预警信息：一般不启用**

## **4.8 任务**

一般不启用，在DTU里运行脚本程序，相当于编程，是做边缘计算的，可以用一些定制化的应用场景；

备注：关于“数据流”和“任务”都是本DTU的高级应用，是边缘计算的一种形式，可以在DTU里运行脚本程序，在一些特殊定制化场景下使用；

（此功能需谨慎使用，如果任务代码出错DTU必须返厂重新烧录固件）

# **5.**** ** **云配置典型案例**

## **5.1**** ** **TCP协议，连接成功和每次数据头都加IMEI号：**

连接成功发送一次注册包（登录包），注册包的内容是模块的IMEI号；并且每次数据头都加IMEI号，配置截图如下；

其中注册信息要选自定义，后面填 |imei|

![配图6](https://docs.iffiot.com/media/202611/dtu/img5.png)

自定义登录包、心跳包可以用的特殊指令：

`|imei|` `|muid|` `|imsi|` `|iccid|` `|csq|` `|hadr|`

## **5.2**** ** **注册包如果只取****IMEI其中几位怎么实现：**

有些因为平台方面的原因，注册包长度不能是15位，只是IMEI号其中几位，这时要在自定义里填写特殊LUA脚本;比如取注册包是IMEI后12位，在自定义填如下脚本代码：

1.模组是Air780的方法：function return misc.getImei():sub(4,15) end

2.模组是ML307的方法： |imei12|

## **5.3 心跳包/注册包16进制说明**

心跳包如果是ASCII直接输入英语数字就行，如果是16进制，则以“0x”开头，如“0xAA22BB”

注册包16进制：

心跳包16进制：

## **5.3**** ** **连接Onenet自动新增设备**

设备网络通道是连接ONENET时，设备上电会自动在ONENET平台上注册新设备，不用人为新增设备；自动注册的设备的鉴权信息是：IMEI号+串口通道号；既用串口1时，是IMEI+1；如果选用串口2，是IMEI+2；设备ID是ONENET随机生成的；

**注意：连接ONENET时“基本参数”里的首次登陆注册信息要选择“不发”**

## **5.4**** ** **MQTT协议透传数据**

用EMQX搭建自己的MQTT服务器，可以按以下配置：

配置对应的串口时，用串口调试软件和MQTT.fx软件结果测试如下：

MQTT.fx发布对应主题的数据给DTU串口2：

DTU串口2发布数据给MQTT.fx订阅的主题：

## **5.5**** ** **MQTT协议连接巴法云**

对于没有自己MQTT服务器的用户，可以用巴法云测试MQTT协议，巴法云是一个免费的MQTT服务器，具体MQTT如何连接[请看官网手册](https://cloud.bemfa.com/docs/)，云配置截图如下：

# **6 串口及服务器特殊指令**

特殊指令可以通过**服务器向DTU下发** 或 **串口向DTU发送**；具体功能看以下指令：（在TCP、ONENET、MQTT协议下指令都有效）

**6.****1、基站定位功能：****(ML307-DC也支持）**

发送："rrpc,getlocation"

返回："rrpc,location,lat,lng"

失败： ”ERROR"

## **6.****2、实时基站定位功能**

发送："rrpc,getreallocation"

返回："rrpc,getreallocation,lat,lng"

失败："rrpc,getreallocation,error"

**6.****3、NTP 对时功能：**

此功能远程不可用

发送： "rrpc,gettime"

返回： "rrpc,nettime,year,month,day,hour,min,sec"

失败： “rrpc,nettime,error"

## **6.****4、获取IMEI ****(ML307-DC也支持）**** **

发送： "rrpc,getimei"

返回:  "rrpc,getimei,123456789012345"

失败:  "ERROR"

## **6****.5、获取ICCID ****(ML307-DC也支持）**** **

发送： "rrpc,geticcid"

返回： "rrpc,geticcid,1234567890123456789"

失败： "ERROR"

## **6.****6、获取****信号强度****CSQ ****(ML307-DC也支持）**** **

发送： "rrpc,getcsq"

返回： "rrpc,getcsq,17"

失败： "ERROR"

## **6.7****、获取ADC的值****（引脚未引出）**** **

发送： "rrpc,getadc,id"

例子： "rrpc,getadc,0"

返回： "rrpc,getadc,1848"

失败： "ERROR"

## **6****.8、获取GPIO的值**

发送： "rrpc,getpio,pin"

例子： "rrpc,getpio,8"

返回： "rrpc,getpio8,1"

失败： "ERROR"

可用 GPIO 见手册底部GPIO列表

## **6.****9、设置GPIO的值**

发送： "rrpc,setpio,pin,val"

例子： "rrpc,setpio,8,1"

返回： "OK"

失败： "ERROR"

可用 GPIO 见手册底部GPIO列表

## **6.****1****0****、远程重启模块 ****(ML307-DC也支持）**** **

发送： "rrpc,reboot"

## **6.****1****1****、远程更新参数**

发送： "rrpc,upconfig"

返回： "rrpc,upconfig,OK"

## **6.12、发短信**

发送：rrpc,function,sms.send("13567729235", "011,收到请回复!")

返回：return 'ok'

其中：13567729235换成目录号码；

"011,收到请回复!" 换成自己的短信内容；

![配图7](https://docs.iffiot.com/media/202611/dtu/img6.png)

## **6.13、查连接状态**

发送：rrpc,netstatus

回复：rrpc,netstatus,NORDY //连接成功是RDY，不成功是NORDY

# **7、电表行业专用指令**

针对电表行业，在登录包或心跳包里，填特殊关键字，上电会先主动读电表号并上报（电表要645-2007协议）

`|hadr|` 是表号倒序（HEX格式）

`|zadr|` 是表号正序（HEX格式）

`|sadr|` 是表号正序（string格式）（就是电表外壳打印的电表号）

`|fadr|` 是表号倒序（string格式）

备注：可以和|imei|、|iccid|、|csq|这几个特殊关键字组合用

生产检测：配置了表号关键字，模组上电读到表号并连网，CK灯从闪烁 变成长亮，生产人员只要看灯长亮，就可认为合格（硬件焊接和网络都测试通过），

售后：配置平台上的“hadr”会显示表号；可以电表号、模组编号和卡号可以相互反查，便于售后