合宙DTU资料中心

一、DTU 常见问题

1.1、 DTU版本默认上电是透传模式还是非透传模式，两个模式间如何转换?

答：默认只配置了串口115200,8位数据模式，1个停止位，无校验，通道默认关闭。
1.2、是否有可能让在第一次去连接server时上报自己ID(可以自定义)功能?

答：支持自定义，详见“配置保存指令”的register字段。
1.3、在非透传模式报文也是发的AT命令格式吗?

答：不用AT,非透传模式参考指令“多通道通信报文
1.4、恢复默认设置有条件吗？比如低电平保持多长时间？上电前拉低?

答：拉低25mS以上即可，不需要上电前拉低。使用云参数的话，基本上不会用到这个脚
1.5、心跳包是否支持自定义，有没有长度限制？

答：心跳包支持自定义，默认是字符串“ping”,长度最大1460字节
1.6、是否可以指定透传模式下每次上报添加ID

答: 支持,详见“配置保存指令”的plate字段。
1.7、如果连上server后MCU如何知道已经连上？会不会有字符串提示?

答：连上server后，透传模式下相当于一条网线，不会有字符提示，MCU不用去维护DTU的状态。
1.8、可否设置如果一定时间内收不到server的心跳包，dtu自动掉电重连?

答：内部有自动重连，开关飞行模式，重启模式，线程守护来保证DTU的网络链接正常，用户不需要干预。
1.9、是否支持定时采集功能?

答：支持，以后升级会逐渐支持更多的RTU的功能，比如定时采集，定时任务预置指令采集等。
1.10、如何知道是SIM卡是否欠费，是否连上服务器?

答：有两个办法：看指示灯，心跳灯（100ms亮，1900毫秒灭表示脸上服务器），快闪通常表示卡不良或欠费，慢闪表示GSM正常但是网络附着不成功。读取RDY信号（net ready信号），高电平是服务器链接成功，低电平是未连接。
1.11、串口是否支持流量控制？

答：支持，在保存参数配置的“flow"参数设置每分钟最大流量值,如果流量超过，则数据丢弃。
1.12、是否发送完成返回标志给MCU？

答：支持,在MCU控制模式的时候，发送数据成功后会返回"SEND_OK"给MCU,方便MCU关闭模块。
1.13、网络是否连接能不能通知MCU？

答：支持 AIR202U的RDY信号--第6脚(GPIO_3)上电输出低电平，网络链接成功后输出高电平。 AIR720 的RDY信号--第5脚（GPIO_65）上电输出低电平，网络链接成功后输出高电平。
1.14、定时采集功能支持透传和非透传模式吗？

答：定时采集功能只有透传模式才能支持，支持串口1和2单独设置。

二、DTU功能说明

AIR202U 是上海合宙出品的一款功能强大使用极其简单的DTU模块，借助不到10条交互指令，就可以实现绝大部分物联网的通讯需求，极大简化用户开发物联网产品的步骤，大幅度减少开发时间

[x] 支持 MQTT/TCP/UDP 双通道透传（串口1和串口2分别对应两个透传通道）
[x] 支持 MQTT/TCP/UDP 透传模式添加 IMEI 设备识别码(15个字节)
[x] 支持 MQTT/TCP/UDP 多通道传输模式（非透传模式）
[x] 支持数据中心服务器设置，最多支持7个通道，每个通道可以任意指定串口（1,2）和协议
[x] 支持 Luat云批量初始化配置，实现全自动无人操作自动配置DTU
[x] 支持 Luat云远程升级固件，也就是FOAT功能，可以满足用户在某些新增功能需求的时候免现场维护
[x] 支持透传/非透传模式软件恢复出厂默认值
[x] 支持硬件恢复出厂默认值
[x] 支持 NET 指示灯，方便用户显示各种工作状态
[x] 支持登陆上传DTU模块状态，方便用户获得模块信息以及登陆鉴权
[x] 支持 DTU配置程序读取
[x] 支持 HTTP 的GET 和 POST 请求方法
[x] 支持获取网络时间
[x] 支持获取基站定位返回的当前模块坐标

四、发送数据说明

4.1、透传通道报文

直接发送即可,串口1对应通道ID1，串口2对应通道ID2

4.2、多通道通信报文

cmd ："send,id,data"
code："send,1,data"

字段	值	含义
send	send	发送数据的标志位
id	1-7	通信使用的通道ID,串口通道会自动和对应的通道捆绑
data	string	要上传的串口数据

4.3、单次 HTTP 指令

cmd："http,method,url,timeout,body,type,basic"
code："http,get,www.openluat.com,30"

字段	值	含义
HTTP	http	通信方式http
METHOD	get-post	提交请求的方法
URL	域名/参数	HTTP请求的地址和参数,参数需要自己urlencode处理
TIEMOUT	30	HTTP请求最长等待时间,超过这个时间,HTTP将返回
BODY	string	get或者post提交的body内容，只能是字符串
TYPE	1,2,3	body的提交类型，1是urlencode,2是json，3是stream
BASIC	usr:pwd	HTTP的BASIC验证,注意账号密码之间用:连接
HEAD	string	自定义head部分, urlencode后的字符串

返回: HTTP服务器返回的正文(body)透传该指令串口

4.4、单次 SOCKET 指令

cmd："tcp,host,port,ssl,timeout,data"
code："tcp,180.97.80.55,12415,nossl,30,1122334455667788"

字段	值	含义
PROT	TCP\|DUP	通信协议,必填TCP或者UDP
HOST	域名\|IP	SOCKET服务器地址
PORT	1-65535	SOCKET服务器端口号
SSL	ssl	是否ssl端口,默认空
TIMEOUT	30	SOCKET服务器超时断开时间,单位秒
DATA	string	发给SOCKET服务器的数据

返回数据到对应串口:

数据发送成功返回: "SEND_OK\r\n"

数据发送失败返回: "SEND_ERR\r\n"

数据接收成功返回: 透传服务器返回的数据

4.5、恢复出厂默认值指令

- demo："+++"
重启模块并恢复出厂默认值
当串口配置错误的时候，可以用另外一个串口配置,也可以云端配置

4.6、读取DTU的参数配置

demo："config,readconfig"
demo : "config,readconfig,1234567890"

五、API 指令功能说明：

5.1、基站定位功能：

发送："rrpc,getlocation"
返回："rrpc,location,lat,lng"
失败： ”ERROR"

5.2、实时基站定位功能

发送："rrpc,getreallocation"
返回："rrpc,getreallocation,lat,lng"
失败： ”rrpc,getreallocation,error"

5.3、NTP 对时功能

此功能远程不可用

发送： "rrpc,gettime"
返回： "rrpc,nettime,year,month,day,hour,min,sec"
失败： “rrpc,nettime,error"

5.4、获取IMEI

发送： "rrpc,getimei"
返回: "rrpc,getimei,123456789012345"
失败: "ERROR"

5.5、获取ICCID

发送： "rrpc,geticcid"
返回： "rrpc,geticcid,1234567890123456789"
失败： "ERROR"

5.6、获取CSQ

发送： "rrpc,getcsq"
返回： "rrpc,getcsq,17"
失败： "ERROR"

5,7、获取ADC的值

发送： "rrpc,getadc,id"
例子： "rrpc,getadc,0"
返回： "rrpc,getadc,1848"
失败： "ERROR"

5.8、获取GPIO的值

发送： "rrpc,getpio,pin"
例子： "rrpc,getpio,8"
返回： "rrpc,getpio8,1"
失败： "ERROR"
可用 GPIO 见手册底部GPIO列表

5.9、设置GPIO的值

发送： "rrpc,setpio,pin,val"
例子： "rrpc,setpio,8,1"
返回： "OK"
失败： "ERROR"
可用 GPIO 见手册底部GPIO列表

5.10、远程编程指令下发

发送： "rrpc,function,cmdString"
例子： "rrpc,function,print(1) return 'ok'"
返回： "rrpc,function,'ok"
失败：返回错误代码

5.11、远程获取I2C温湿度传感器数据

发送： "rrpc,getSensor,addr"
例子： "rrpc,getam2320" 或 "rrpc,getam2320,0x5C"
例子： "rrpc,getsht" 或 "rrpc,getsht,0x40"
返回： "rrpc,getam2320,25.3,64.1"
注意：780e系列不支持该指令

5.12、远程唤醒GPS

发送： "rrpc,gps_wakeup"
返回： "rrpc,gps_wakeup,OK"

5.13、远程获取GPS设备信息

发送： "rrpc,gps_getsta,format"
例子： "rrpc,gps_getsta,json" 或 "rrpc,gps_getsta,hex"
返回： "rrpc,gps_getsta,{"sta":[true,false,false,false,false,false,65535,4113,15]}"

5.14、远程获取GPS定位信息

发送： "rrpc,getSensor,format"
例子： "rrpc,gps_getmsg,json" 或 "rrpc,gps_getmsg,hex"
返回： "rrpc, gps_getmsg, {"msg":[true,1547272715,1136036500,348579350,133,42,1,43,4]}"

5.15、远程重启模块

发送： "rrpc,reboot"

5.16、远程更新参数

发送： "rrpc,upconfig"
返回： "rrpc,upconfig,OK"

5.17、获取固件版本

发送： "rrpc,getver"
返回： "rrpc,getver,1.5.3"

5.18、获取项目名称

发送： "rrpc,getproject"
返回： "rrpc,getproject,DTU-AIR720-MODUL"

5.19、获取VBATT电压

发送： "rrpc,getvbatt"
返回： "rrpc,getvbatt,4200"

5.20、播放TTS语音

发送： "rrpc,tts_play,gb2312,继电器被打开请注意安全, 7"
返回： "rrpc,tts_play,OK"
注意：gb2312可选utf8,要播放的语音不能包含","(半角逗号),7可选1-7(TTS音量),780e系列不支持该指令

5.21、查询与服务器的链接状态

发送： "rrpc,netstatus"
返回1： "rrpc,netstatus,RDY"
返回2： "rrpc,netstatus,NORDY"
注释：返回1 表示与服务器连接成功，返回2表示与服务器连接断开

5.22、获取固件完整版本号(固件名称)

发送： "rrpc,getfwver"
返回： "rrpc,getver,iRTU_1.8.16_Luat_V0032_ASR1802_FLOAT_720"

5.23、获取当前4G网络状态

发送： "rrpc,getnetmode"
返回： "rrpc,getnetmode,"
返回值解释：
0：未注册
1：2G GSM网络
2：2.5G EDGE数据网络
3：3G TD网络
4：4G LTE网络
5：3G WCDMA网络

EC618和EC718的返回内容为： - 0：未注册 - 1：网络已注册 - 2：正在搜网中 - 3：网络注册被拒绝

5.24、查询与多个服务器的链接状态

发送 "rrpc,netstatus,1"
返回1： "rrpc,netstatus,RDY"
返回2： "rrpc,netstatus,NORDY"

5.25、查询当前设备SN号

发送： "rrpc,getSN"
返回： "rrpc,getSN,123"
返回值解释： 123为设备的SN号

5.26、设置SN号

发送： "rrpc,setSN"
返回： "OK"
返回值解释：

5.27、关闭GPS

发送： "rrpc,gps_close"
返回："rrpc,gps_close,ok"
返回值解释：

5.28、设置RNDIS状态

发送： "rrpc,setRNDIS,1"
1是打开，0是关闭
返回："OK"
返回值解释：
注意：780e系列不支持该命令

5.29、设置守护机制状态

发送： "rrpc,setchannel,1,2,3,4,5,6,7"
需要守护几路就填几路，守护全部可以直接rrpc,setchannel,all
返回："rrpc,setchannel,OK"
返回值解释：

5.30、切换SIM卡

发送： "rrpc,simcross,1"
SIM卡为0就填0为1就填1，填2自动切换，该命令重启生效
返回："rrpc,setchannel,OK"
返回值解释：OK为正常，error为错误

5.31、发送短信

发送： "rrpc,sms_send,你好"
输入内容是发送信息内容
返回："ok"
返回值解释：ok为接收到串口指令返回的内容，后续信息发送成功会返回sms,ok，失败返回sms,error
注意：780e系列不支持该命令

5.32、关闭i2c

发送： "rrpc,iic_close,1"
1是i2c的接口id
返回："iic_close,ok,1"
返回值解释：ok为正常，error为错误
注意：780e系列不支持该命令

5.32、打开i2c

发送： "rrpc,iic_open,1,10000,0,1,1"
内容解释：1：i2c接口id,10000:时钟频率,0:可选,i2c外设地址,1:可选自定义波特率开关 0/1-关闭/开启,1：双字节寄存器配置开关 0/1-关闭/开启
返回："iic_open,ok,1"
返回值解释：ok为正常，error为错误
注意：780e系列不支持该命令

六、自动采集任务可用API

6.1、Luat API

参考 https://doc.openluat.com/wiki/21?wiki_page_id=2068

6.2、create库API

6.2.1、实时查询基站定位

local lat,lng = create.getRealLocation()

6.2.2、获取纬度

local lat = create.getLat()

6.2.3、获取经度

local lng = create.getLng()

6.2.4、获取ADC的电压值

local val = create.getADC(adcid)

6.3、tracker库的api

6.3.1、获取GPS的设备信息

local str = tracker.locateMessage(format)
format 为“json” or "hex"

6.3.2、获取GPS设备信息

local str = tracker.deviceMessage(format)
format 为“json” or "hex"

七、Luat云功能说明

地址：http://dtu.openluat.com
借助Luat云可以实现远程FOTA和自动参数配置，用户无需用上位机配置程序来逐个配置DTU，此方式可以极大减少人工费用和时间。使用远程固件更新和远程参数下发需要用户注册Luat云,用户注册自己的IMEI到云端，指定不同的IMEI到对应的参数版本，DTU模块自动请求参数并保存到到DTU模块中存储。
远程固件更新
远程参数下发

八、硬件说明

8.1、Air202/208/800 硬件说明

8.1.1、AIR202-GPIO

看门狗：
WDI —— 10脚 ( GPIO_31 )
RWD —— 11脚 ( GPIO_30 )
NET_LED：
NET_LED —— 13脚 ( GPIO_33 )
重置参数：
RSP —— 12 脚（GPIO_29)
网络连接通知：
RDY —— 6脚（GPIO_3）

8.1.2、485 控制脚 (UART1)

RXD —— 9脚 (GPIO_0)
TXD —— 8脚 (GPIO_1)
DIR —— 7脚 (GPIO_2)

8.2、AIR720(S)/H/D/M/T/U 硬件说明

8.2.1、AIR720-GPIO

NET_LED：
NET_LED —— PIN6 ( GPIO_64 )
重置参数：
RSP —— PIN4（GPIO_68）
网络连接通知：
RDY —— PIN5 （GPIO_65）

780E-GPIO

NET_LED：
NET_LED —— 16脚 ( GPIO_27 )
重置参数：
RSP —— 78 脚（GPIO_28)
网络连接通知：
RDY —— 25脚（GPIO_26）

8.2.2、 TTL 输出脚

UART1_RXD —— PIN11 （GPIO_51）
UART1_TXD —— PIN12 （GPIO_52）
UART2_RXD —— PIN68 （GPIO_57）
UART2_TXD —— PIN67 （GPIO_58）

780E:TTL 输出脚

UART1_RXD —— PIN17 （GPIO_18）
UART1_TXD —— PIN18 （GPIO_19）
UART2_RXD —— PIN28 （GPIO_10）
UART2_TXD —— PIN29 （GPIO_11）

8.2.3、 485 控制脚

UART1_DIR —— PIN13 （GPIO_23） -- 720
UART1_DIR —— PIN13 （GPIO_61） -- 720S

UART2_DIR —— PIN64 （GPIO_59）-- 720
UART2_DIR —— PIN64 （GPIO_31）-- 720S

8.3 720U/724U（RDA8910）硬件说明

8.3.1、AIR720u-GPIO

NET_LED：
NET_LED —— ( GPIO_01 )
重置参数：
RSP —— （GPIO_3）
网络连接通知：
RDY —— （GPIO_04）

8.3.2、 TTL 输出脚

UART1_RXD 
UART1_TXD
UART2_RXD 
UART2_TXD

8.3.3、 485 控制脚

UART1_DIR ——  （GPIO_18）
UART2_DIR ——  （GPIO_23）

8.4、 LED 闪烁规则

100ms 闪烁 —— 注册GSM
500ms 闪烁 —— 附着GPRS
100ms 亮, 1900ms 灭 —— 已连接到服务器

九、附表可远程控制GPIO表

9.1、Air202表

PIN	GPIO	PIN	GPIO
29	GPIO_6	5	GPIO_12
30	GPIO_7	11	GPIO_30
3	GPIO_8	10	GPIO_31
2	GPIO_10	4	GPIO_11

9.2、Air800表

PIN	GPIO	PIN	GPIO
4	GPIO_6	21	GPIO_11
3	GPIO_7	22	GPIO_12
19	GPIO_8	28	GPIO_31
20	GPIO_10	27	GPIO_30
18	GPIO_9	29	GPIO_29
17	GPIO_13	41	GPIO_18
37	GPIO_14	47	GPIO_34
38	GPIO_15	40	GPIO_17
39	GPIO_16

9.3、Air720系列表

PIN	GPIO	PIN	GPIO
26	pio26	23	pio70
25	pio27	29	pio71
24	pio28	28	pio72
39	pio33	33	pio73
40	pio34	32	pio74
38	pio35	30	pio75
37	pio36	31	pio76
65	pio55	66	pio77
62	pio56	63	pio78
1	pio62	61	pio79
2	pio63	113	pio80
115	pio69	114	pio81

9.3、Air 724表

PIN	GPIO	PIN	GPIO
52	GPIO9	43	GPIO13
54	GPIO10	32	GPIO14(I2C_SCL)
53	GPIO12	31	GPIO15(I2C_SDA)
50	GPIO17	38	GPIO18
37	GPIO19

Air780系列表

PIN	GPIO	PIN	GPIO
49	pio1	107	pio21
21	pio2	19	pio22
54	pio3	99	pio23
80	pio4	20	pio24
81	pio5	106	pio25
55	pio6	25	pio26
56	pio7	16	pio27
52	pio8	78	pio28
50	pio9	30	pio29
22	pio16	31	pio30
23	pio17	32	pio31
102	pio20