指令功能
指令分为本地串口指令和网络指令
1.本地配置端口
各模块支持端口如下:
模块类别 |
串口1 |
串口2 |
串口3 |
USB |
备注 |
202/202S/208/800/800S/800HS |
|
|
|
|
|
720D/720H/720G |
|
|
|
|
|
720SH/720SG |
|
|
|
|
|
724UG/722UG |
支持 |
支持 |
支持 |
支持 |
|
722CG |
|
|
|
|
|
2.配置说明
- 注意:所有串口指令返回结果都带"\r\n"
- 网络守护逻辑:
- 开机2分钟内不能联网重启
- 联网成功后90秒内不能连接服务器开关飞行模式
- 网络正常,服务器连接失败5分钟重启
- 网络断开5分钟不能恢复自动重启
- 网络正常,连接服务器失败重试间隔指数延长
- 1s,2s,4s,8s.........512s 重复
2.1 串口配置命令
- demo:"config,8,1,115200,8,2,0"
字段 |
值 |
含义 |
config |
config |
配置指令标识 |
id |
8 |
通道编号8表示设置串口配置参数 |
uartid |
1-2 |
串口id,1是串口1,2是串口2 |
baud |
1200-921600 |
1200,2400,4800,9600,14400,19200,28800,38400,57600,115200,230400,460800,921600 |
datbits |
7-8 |
数据位,支持7或8,默认是8 |
parity |
0-1-2 |
校验位,0是uart.PAR_EVEN,1是uart.PAR_ODD,2是uart.PAR_NONE |
stopbits |
0-2 |
停止位,0是1个停止位,2是2个停止位 |
485DIR |
pio0-pio128, |
可选p0-p128,disable禁止485DIR,默认空,使用默认的485方向脚 |
2.2 用户预定义电话和短信
- demo:"config,9,13211111111,10,SMS_UPDATE"
字段 |
值 |
含义 |
config |
config |
配置指令标识 |
id |
9 |
通道编号9表示设置用户预置号码参数 |
number |
电话 |
用户预置的电话号码白名单 |
delay |
1-100 |
白名单的振铃延时,其他电话立刻挂断 |
smsword |
string |
短信更新参数的预定义字符串,默认是"SMS_UPDATE" |
2.3 设置APN
字段 |
值 |
含义 |
config |
config |
配置指令标识 |
id |
a |
通道编号a表示设置用户手工设置APN |
name |
cmiot |
APN 名称 |
user |
string |
用户名,没有留空 |
password |
string |
密码,没有留空 |
2.4 自动采集任务
提示:HEX指令和function函数可以同时配置比如cmd1是HEX指令,cmd2就是function指令。
- HEX指令
demo : "config,b,1000,01 03 00 2A 3B 00 2C FF,01 03 00 2A 3B 00 2C FF"
字段 |
值 |
含义 |
config |
config |
配置指令标识 |
id |
B |
通道编号B表示配置自动采集任务 |
waitRevc |
1-2000 |
单位ms,发送指令后最长等待设备超时 |
cmd1 |
指令/函数 |
HexString 指令,例如 01 03 00 2A 3B 00 2C FF |
cmdN |
指令/函数 |
HexString 指令,例如 01 03 00 2A 3B 00 2C FF |
- 在function指令
demo: "config,b,1000,function return "200,ad0,ad," .. create.getADC(0) end"
字段 |
值 |
含义 |
config |
config |
配置指令标识 |
id |
B |
通道编号B表示配置自动采集任务 |
waitRevc |
1-2000 |
单位ms,发送指令后最长等待设备超时 |
fun1 |
用户函数 |
function return "200,ad0,ad," .. create.getADC(0) end |
funN |
用户函数 |
function return "402," .. create.getLat() .. "" .. create.getLng() end |
-
提示:
- 函数需要用function 开头,用end结尾,用来区别HEX指令。用串口写入该配置参数的时候,注意函数中的分号要转义处理。
- 函数结尾return返回的数据会被发往用户配置的服务器,用户可以自定义通信报文协议。
- 如果函数需要写入数据到串口,直接调在函数调用“uart.write(uid,str)” 类似的Luat-API。
2.5 数据流模板
-
说明此功能暂时仅支持JSON格式参数一次导入。 upprot是上传通道关键字,值是个数组,数组下标1-7代表1-7通道。 dwprot是下发通道关键字, 值的含义同上。
-
视频地址: https://www.bilibili.com/video/av41012302/?p=22
"upprot": ["function \n local str = ...\n local dat, result, errinfo = json.decode(str)\n local tmp = {}\n for i = 1, #t.sta do\n tmp[\"val\" .. i] = dat.sta[i]\n end\n return json.encode(tmp)\nend", "", "", "", "", "", ""], "dwprot": ["", "", "", "", "", "", ""],
2.6 用户自定义GPIO
- demo: "config,pins,pio33,pio3,pio29"
字段 |
值 |
含义 |
config |
config |
配置指令标识 |
id |
pins |
通道编号pins表示配置GPIO |
netled |
pio0-pio128 |
网络指示灯GPIO编号,例如GPIO_33 就填pio33,默认空,下同 |
netdrdy |
pio0-pio128 |
网络是否准备好GPIO编号 |
RSTCNF |
pio0-pio128 |
复位DTU参数的GPIO编号 |
2.7 启用GPS功能
-
GPS功能目前支持Air530/800 /801/868 以及相应的开发板。
-
启用GPS功能会占用1个串口,另外一个串口依旧可以配置DTU的各种功能
-
GPS 报文JSON定义
-
信息 = [是否有效,时间戳,经度,纬度,海拔,方位角,速度,载噪比,定位卫星]
-
设备 = [是否打开,震动,开锁,点火,充电,剪线,外电电压,电池电压,GPRS信号值]
1 {"msg":[true,1547272725,1136037366,348581216,114,354,1,43,4]}
2 {"sta":[true,false,false,false,false,false,65535,4101,11]}
[AA 01 5C399812 43B68DF6 14C6ED60 0016 001E 0F 32 0E]
* [设备 |是否打开|震动|开锁|点火|充电|剪线|外电电压|电池电压|GPRS信号值]
- [ 1B | 1B | 1B | 1B| 1B | 1B| 1B |4B |2B |1B ] = 13 byte
[55 00 00 00 00 00 00 00006A10 1011 15]
2.7.1 GPS 的GPIO配置
- demo: "config, gps, pio, pio8 ,pio9, pio10, 0, 16"
字段 |
值 |
含义 |
config |
config |
配置指令标识 |
id |
gps |
通道编号gps表示配置gps |
type |
pio |
GPS 的配置 GPIO 的标志位 |
netdrdy |
pio0-pio128 |
GPS 定位成功指示灯 GPIO 编号,例如 GPIO_3 就填 pio3,下同 |
vib |
pio0-pio128 |
振动传感器信号输入GPIO编号 |
acc |
pio0-pio128 |
ACC开锁信号输入GPIO编号注意ACC信号电压很高要用分压电阻 |
chg |
pio0-pio128 |
内置锂电池充电状态输入GPIO编号,可为空 |
adc |
0 or 1 |
检测VCC的ADC通道编号,默认0 |
ratio |
1-50 |
VCC/1.8V + 1的值,是值ADC采集电压和VCC实际电压的比值 |
2.7.2 GPS 的报文配置
- demo: "config, gps, fun, 2, 115200, 0, 5, 1, json, 100, ; ,60"
字段 |
值 |
含义 |
config |
config |
配置指令标识 |
id |
gps |
通道编号gps表示配置gps |
type |
fun |
GPS 的配置 fun参数 的标志位 |
串口ID |
1 or 2 |
GPS 启用的串口波特率,注意不要和socket通道同时启用 |
波特率 |
115200 |
9600-115200,注意和模块的GPS实际波特率一致 |
功耗模式 |
0 or 2 or 8 |
GPS工作模式: 正常,低功耗,低功耗跟踪模式 |
采集间隔 |
1-600 |
单位秒,多久采集并记录一次GPS报文 |
采集方式 |
0 or 1 |
0 布防采集(触发上报),1持续采集 |
报文格式 |
json or hex |
设备信息和GPS定位信息上报的报文格式,支持JSON和HEX |
缓冲发送 |
0 - 1000 |
0 表示不缓冲,采集后立刻上报,其他表示先加入缓冲区,然后1次上报 |
分隔符 |
除,外的可见字符 |
启用缓冲发送,用来分割报文的标记 |
状态间隔 |
0-1440 |
单位分钟,设备信息报文上报频率,0为不上报 |
上报通道 |
上报网络通道 |
捆绑用于GPS上报的网络通道id,串口和GPS可以公用1个socket/mqtt/http 通道 |
2.8 SOCKET通道配置指令
- demo:"config,1,tcp,ping,300,180.97.81.180,57826,1"
字段 |
值 |
含义 |
config |
config |
配置指令标识 |
id |
1-7 |
通道编号1-7,表示创建通信的通道 |
协议 |
tcp-udp |
TCP协议或UDP协议 |
ping |
字符串 |
用户自定义的心跳包,只支持数字和字母,建议2-4个字节 |
keepAlive |
60-600 |
链接超时最大时间单位秒,默认300秒 |
address |
地址或域名 |
socket的地址或域名 |
port |
1-65536 |
socket服务器的端口号 |
uid |
1-2 |
TCP通道捆绑的串口ID |
gap |
1-65535 |
自动采集间隔时长,单位秒。不用该功能填0或空 |
samp |
1-15 |
自动采集采样时长,单位秒。不用该功能填0或空 |
taskTimer |
60-2147483647 |
自动定时采集任务间隔时间,单位秒。不用就填空 |
SSL |
ssl |
启用填ssl,不启用留空 |
2.9 MQTT通道配置指令
- demo:"config,1,mqtt,30,1800,180.97.80.55,1883,,,1,/company/service/,/company/device/,0,1,1"
字段 |
值 |
含义 |
config |
config |
配置指令标识 |
id |
1-7 |
通道编号1-7,表示创建通信的通道 |
协议 |
mqtt |
表示MQTT协议 |
keepAlive |
300 |
MQTT心跳包的间隔单位秒,默认300 |
taskTimer |
60-2147483647 |
自动定时采集任务间隔时间,单位秒。,默认1800秒 |
address |
IP地址或域名 |
MQTT的地址或域名 |
port |
1-65536 |
socket服务器的端口号 |
usr |
login |
MQTT的登陆账号默认"" |
pwd |
login |
MQTT的登陆密码默认"" |
cleanSession |
0-1 |
MQTT是否保存会话标志位,0持久会话,1离线自动销毁 |
sub |
/company/service/ |
订阅消息主题, |
pub |
/company/device/ |
发布消息主题, |
qos |
0-2 |
MQTT的QOS级别,默认0 |
retain |
0-1 |
MQTT的publish参数retain,默认0 |
uid |
1-2 |
MQTT通道捆绑的串口ID |
clentID |
string |
自定义客户端ID,使用IMEI做客户端ID此处留空 |
samp |
"" or 1 |
留空主题自动添加IMEI, 1为不添加IMEI |
transport |
tcp / tcp_ssl |
传输模式,可选tcp或者tcp_ssl |
will |
字符串 |
遗嘱的主题 |
* MQTT 订阅主题说明: |
|
|
- 单个订阅主题 -- /company/device
- 单个订阅主题带QOS -- /company/device;1
- 多个订阅主题带QOS -- /company/device;0;/company/imcp;1
- MQTT 发布主题说明:
- 单个发布主题 -- /company/service
- 单个发布主推带QOS -- /company/service;1
- 发布多个主题带QOS -- /company/service;0;/company/imcp;1
-
多个主题需要编写数据流模板,数据流模板return 数据,主题编号(下标),强烈建议看演示视频,地址:https://www.bilibili.com/video/av41012302/?p=15
-
MQTT 主题的IMEI说明:
- samp 为 “” 或者nil(空) 时(参数意义见上表):
- 默认添加/IMEI为主题结尾,格式为 “用户主题/imei“
- 发布主题和订阅主题都会自动添加/IMEI,系统会自动替换为15位的IMEI字符串
-
samp 为 1 时(参数意义见上表):
- 发布和订阅主题自动替换主题中的/imei/ 为模块的实际imei
- 如果主题中不包含/imei/则不替换
-
订阅主题带QOS(包括多个订阅), 自动替换主题中的/imei/ 为模块的实际imei,与samp的值无关
2.10 oneNET配置
2.10.1 DTU协议
*demo:
"config,1,onenet,dtu,ping,60,183.230.40.40,1811,RD7hbCxD6pr3t0vj,200652,sample,1"
字段 |
值 |
含义 |
config |
config |
配置指令标识 |
id |
1-7 |
通道编号1-7,表示创建通信的通道 |
云名称 |
onenet |
OneNET 云名称 |
协议 |
dtu |
子协议 |
ping |
0x0000 |
用户自定义的心跳包,只支持数字和字母,建议2-4个字节 |
keepAlive |
60-600 |
链接超时最大时间单位秒,默认300秒 |
address |
dtu.heclouds.com |
OneNET的DTU模式的地址或域名 |
port |
1811 |
OneNET的DTU模式的服务器的端口号 |
code |
RD7hbCxD6pr3t0vj |
OneNET产品下设备i的正式环境注册码 |
pid |
200652 |
OneNET 产品ID |
script |
sample |
OneNET 数据流解析脚本 |
uid |
1-2 |
TCP通道捆绑的串口ID |
2.10.2 MQTT协议
- demo:
"config,1,onenet,mqtt,300,300,mqtt.heclouds.com,6002,WWNqBU2EztYUlj2a,200032,3,1,0,0,1"
字段 |
值 |
含义 |
config |
config |
配置指令标识 |
id |
1-7 |
通道编号1-7,表示创建通信的通道 |
云名称 |
onenet |
OneNET 云名称 |
协议 |
mqtt |
子协议 |
keepAlive |
60-600 |
链接超时最大时间单位秒,默认300秒 |
taskTimer |
60-2147483647 |
自动定时采集任务间隔时间,单位秒。默认1800秒 |
address |
mqtt.heclouds.com |
OneNET的MQTT服务器地址或域名 |
port |
6002 |
OneNET的MQTT服务器的端口号 |
code |
RD7hbCxD6pr3t0vj |
OneNET产品下设备i的正式环境注册码 |
pid |
200652 |
OneNET 产品ID |
mode |
1,3,4 |
OneNET 数据流解析格式,只支持1,3,4 |
cleanSession |
0-1 |
MQTT是否保存会话标志位,0持久会话,1离线自动销毁 |
qos |
0-2 |
MQTT的QOS级别,默认0 |
retain |
0-1 |
MQTT的publish参数retain,默认0 |
uid |
1-2 |
TCP通道捆绑的串口ID |
2.10.3MODBUS协议
- demo :
"config,1,onenet,modbus,120,hU6avtHWfytfxO=i7C269OPs6K8=,200652,1"
字段 |
值 |
含义 |
config |
config |
配置指令标识 |
id |
1-7 |
通道编号1-7,表示创建通信的通道 |
云名称 |
onenet |
OneNET 云名称 |
协议 |
modbus |
子协议 |
keepAlive |
60-600 |
链接超时最大时间单位秒,默认300秒 |
key |
hU6avtHWfytfxO=i7C269OPs6K8= |
产品的Master-APIkey |
pid |
200652 |
OneNET 产品ID |
uid |
1-2 |
TCP通道捆绑的串口ID |
2.11 阿里云配置
参考 实例-阿里云
2.12 百度云配置
参考 实例-百度云
2.13 腾讯云接入
暂时参考 这里,部分参数位置可能不太一样,需要用户自行在腾讯云文档内搜索
2.14、HTTP 接入(无状态)
demo:"config,1,txiot,300,1800,ap-guangzhou,ProductID,SecretID,SecretKey,sub,pub,1,0,1"
字段 |
值 |
含义 |
config |
config |
配置指令标识 |
id |
1-7 |
通道编号1-7,表示创建通信的通道 |
协议 |
HTTP |
HTTP 协议名称 |
UID |
1-2 |
HTTP 通道捆绑的串口 ID: |
地址 |
URL |
HTTP的URL地址 https://www.123.com:7000/index.asp?xxx=yyy |
超时 |
1-60 |
单位秒,HTTP请求后等待服务器返回挂断的最长时间 |
提交类型 |
body|param |
提交的内容是添加到paramers还是打包成body? |
编码类型 |
1|2|3 |
1-urlencode, 2-json, 3-stream |
验证 |
usr:pwd |
HTTP的BASIC验证,注意账号密码之间用 : 连接 |
请求头部 |
string |
HTTP请求报文头部字符串 |
打印code |
0-1 |
是否打印HTTP返回的code,1-打印,其他不打印 |
打印head |
0-1 |
是否打印HTTP返回的head,1-打印,其他不打印 |
打印body |
0-1 |
是否打印HTTP返回的body,1-打印,其他不打印 |
说明: HTTP 通道用法和SOCKET一样,支持透传和非透传模式,发送内容打包成标准http请求,返回内容为code,head,body ,根据配置决定是否往串口打印输出.
2.15 配置保存指令
- demo:"config,0,1,0,0,0,100,0,1,500,normal,1234567890,50,1"
字段 |
值 |
含义 |
config |
config |
配置文件标识 |
id |
0 |
通道编号0表示存储配置 |
透传模式 |
0-1 |
1表示透传,0单片机控制(发送完成返回"SEND_OK") |
身份 |
0-1 |
透传模式下是否加设备识别码imei,0表示不加,1表示加 |
报文转换 |
0-1 |
是否将下发和上传的报文进行转换(bin <--> hex),0不转换,1转换 |
登陆报文 |
0-2,string |
是否发送注册报文,0不发送,1发送JSON注册报文{"csq":rssi,"imei":imei,"iccid":iccid,"ver":Version},2发送HEX报文"131234512345",填字符串为用户自定义注册包 |
参数版本 |
1-n |
参数版本号,如果启用远程参数,注意本地配置和远程配置的版本号要一致 |
串口流控 |
0-n |
每分钟最大串口流量(Byte),超过设定字节关闭串口,0为不启用 |
自动更新 |
0-1 |
是否启用FOTA自动更新,1是启用,0是禁用。默认0 |
串口分帧 |
10-2000 |
单位ms,默认50ms,串口接收数据最大等待超时时长 |
电源模式 |
normal |
电源模式切换,"normal"为正常功耗,"energy"为低功耗模式(外设关闭,降频联网) |
密码 |
string |
用户读写配置的密码,默认无密码。约定字符为数字,字母,_ |
网络分帧 |
10-2000 |
单位ms,默认50ms,串口接收数据最大等待超时时长恢复出厂默认值指令 |
日志 |
0-1 |
值为1的时候输出日志,其他值不输出日志 |
2.16、预警配置指令
"warn": {
"adc0": [1, "127", 1, "3900", "10", "BBBBBBBBBBBBBBBB", "1", "1", "100", 1, 1, 1],
"adc1": [],
"vbatt": [],
"gpio": [ ["pio1", 1, 1, "AAAAAAAAAAAAAAAA", "1", 1, 1, 1] ]
}
字段 |
值 |
含义 |
warn |
warn |
预警字段的JSON部分 |
adc0 |
adc0 |
ADC0 窗口预警部分, JSON 数组 |
adc1 |
adc1 |
ADC0 窗口预警部分, JSON 数组 |
vbatt |
数组 |
VBATT窗口预警部分, JSON 数组 |
gpio |
二维数组 |
支持多个 GPIO 上下沿中断触发警报 |
2.17 恢复出厂默认值指令
2.18 硬件恢复出厂默认值
- AIR202 拉低模块的PIN12(GPIO_29)脚为低电平,DTU重启并恢复出厂默认值
- AIR720 拉低模块的PIN4 (GPIO_68)脚为低电平,DTU重启并恢复出厂默认值
2.19、读取DTU的参数配置
- demo:"config,readconfig"
- demo : "config,readconfig,1234567890"
2.20、写入DTU的参数配置
- demo: "config,writeconfig,{
"fota": 0,
"uartReadTime": 25,
"flow": "",
"paramver": 1,
"pwrmod": "normal",
"password": "",
"passon": 1,
"plate": 0,
"reg": 0,
"convert": 0,
"uconf": [
[1, "115200", 8, 2, 0],
[]
],
"conf": [
["mqtt", 300, 1800, "180.97.80.55", "1883", "", "", 1, "/server", "/device", 0, 0, 1, "", "1"],
[],
[],
[],
[],
[],
[]
],
"preset": {
"number": "",
"delay": "",
"smsword": ""
},
"apn": ["", "", ""],
"cmds": [
["1000", "00 AA BB CC DD EE FF 11 22 33 44 55 00", "00 AA BB CC DD EE FF 11 22 33 44 55 11", "00 AA BB CC DD EE FF 11 22 33 44 55 22", "00 AA BB CC DD EE FF 11 22 33 44 55 33", "00 AA BB CC DD EE FF 11 22 33 44 55 44", "00 AA BB CC DD EE FF 11 22 33 44 55 55", "00 AA BB CC DD EE FF 11 22 33 44 55 66", "00 AA BB CC DD EE FF 11 22 33 44 55 77"],
[]
],
"param_ver": 20,
"source": "web"
}"
3.发送数据说明
3.1 透传通道报文
- 直接发送即可,串口1对应通道ID1,串口2对应通道ID2
3.2 多通道通信报文
- cmd :"send,id,data"
- code:"send,1,data"
字段 |
值 |
含义 |
send |
send |
发送数据的标志位 |
id |
1-7 |
通信使用的通道ID,串口通道会自动和对应的通道捆绑 |
data |
string |
要上传的串口数据 |
3.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)透传该指令串口
3.4 单次 SOCKET 指令
- cmd :"tcp,host,port,ssl,timeout,data"
- code:"tcp,180.97.80.55,12415,nossl,30,1122334455667788"
字段 |
值 |
含义 |
PROT |
TCP |
DUP |
HOST |
域名 |
IP |
PORT |
1-65535 |
SOCKET服务器端口号 |
SSL |
ssl |
是否ssl端口,默认空 |
TIMEOUT |
30 |
SOCKET服务器超时断开时间,单位秒 |
DATA |
string |
发给SOCKET服务器的数据 |
返回数据到对应串口:数据发送成功返回: "SEND_OK\r\n"数据发送失败返回: "SEND_ERR\r\n"数据接收成功返回: 透传服务器返回的数据
4.API指令功能说明
4.1 基站定位功能
指令 |
返回值 |
失败返回值 |
rrpc,getlocation |
rrpc,location,lat,lng |
ERROR |
4.2 实时基站定位功能
指令 |
返回值 |
失败返回值 |
rrpc,getreallocation |
rrpc,getreallocation,lat,lng |
rrpc,getreallocation,error |
4.3 NTP 对时功能(此功能远程不可用)
指令 |
返回值 |
失败返回值 |
rrpc,gettime |
rrpc,nettime,year,month,day,hour,min,sec |
rrpc,nettime,error |
4.4 获取IMEI
指令 |
返回值 |
失败返回值 |
rrpc,getimei |
rrpc,getimei,123456789012345 |
ERROR |
4.5 获取ICCID
指令 |
返回值 |
失败返回值 |
rrpc,geticcid |
rrpc,geticcid,1234567890123456789 |
ERROR |
4.6 获取CSQ
指令 |
返回值 |
失败返回值 |
rrpc,getcsq |
rrpc,getcsq,17 |
ERROR |
4.7 获取ADC的值
指令 |
返回值 |
失败返回值 |
例子 |
rrpc,getadc,id |
rrpc,getadc,1848 |
ERROR |
rrpc,getadc,0 |
4.8 获取GPIO的值
指令 |
返回值 |
失败返回值 |
例子 |
rrpc,getpio,pin |
rrpc,getpio8,1 |
ERROR |
rrpc,getpio,8 |
4.9 设置GPIO的值
指令 |
返回值 |
失败返回值 |
例子 |
rrpc,setpio,pin,va |
OK |
ERROR |
rrpc,setpio,8,1 |
4.10 远程编程指令下发
指令 |
返回值 |
失败返回值 |
例子 |
rrpc,function,cmdString |
rrpc,function,'ok |
返回错误代码 |
rrpc,function,print(1) return 'ok' |
4.11 远程获取I2C温湿度传感器数据
指令 |
返回值 |
失败返回值 |
例子 |
rrpc,getSensor,addr |
rrpc,getam2320,25.3,64.1 |
\ |
rrpc,getam2320 |
4.12 远程唤醒GPS
指令 |
返回值 |
失败返回值 |
rrpc,gps_wakeup |
rrpc,gps_wakeup,OK |
\ |
4.13 远程获取GPS设备信息
指令 |
返回值 |
失败返回值 |
例子 |
rrpc,gps_getsta,format |
rrpc,gps_getsta,{"sta":[true,false,false,false,false,false,65535,4113,15]} |
\ |
rrpc,gps_getsta,json |
4.14 远程获取GPS定位信息
指令 |
返回值 |
失败返回值 |
例子 |
rrpc,getSensor,format |
rrpc, gps_getmsg, |
|
rrpc,gps_getmsg,json |
4.15 远程重启模块
指令 |
返回值 |
失败返回值 |
rrpc,reboot |
\ |
\ |
4.16 远程更新参数
指令 |
返回值 |
失败返回值 |
rrpc,upconfifig |
rrpc,upconfifig,OK |
\ |
4.17 获取固件版本
指令 |
返回值 |
失败返回值 |
rrpc,getver |
rrpc,getver,1.5.3 |
\ |
4.18 获取项目名称
指令 |
返回值 |
失败返回值 |
rrpc,getproject |
rrpc,getproject,DTU-AIR720-MODUL |
\ |
4.19 获取VBATT电压
指令 |
返回值 |
失败返回值 |
rrpc,getvbatt |
rrpc,getvbatt,4200 |
\ |
4.20 播放TTS语音
指令 |
返回值 |
失败返回值 |
注意 |
rrpc,tts_play,gb2312,继电器被打开 请注意安全, 7 |
rrpc,tts_play,OK |
\ |
gb2312可选utf8,要播放的语音不能包含","(半角逗号),7可选1-7(TTS音量) |
4.21 查询与服务器的链接状态
指令 |
返回值1 |
返回值2 |
注释 |
rrpc,netstatus |
rrpc,netstatus,RDY |
rrpc,netstatus,NORDY |
返回1 表示与服务器连接成功,返回2表示与服务器连接断开 |
4.22 获取固件完整版本号(固件名称)
指令 |
返回值 |
失败返回值 |
rrpc,getfwver |
rrpc,getver,iRTU_1.8.16_Luat_V0032_ASR1802_FLOAT_720 |
\ |
4.23 获取当前4G网络状态
指令 |
返回值 |
返回值解释 |
rrpc,getnetmode |
rrpc,getnetmode |
0:未注册 1:2G GSM网络 2:2.5G EDGE数据网络 3:3G TD网络 4:4G LTE网络 5:3G WCDMA网络 |
5.自动采集任务可用API
5.1实时查询基站定位
指令 |
local lat,lng = create.getRealLocation() |
5.2 获取纬度
指令 |
local lat = create.getLat() |
5.3 获取经度
指令 |
local lng = create.getLng() |
5.4 获取ADC的电压值
指令 |
local val = create.getADC(adcid) |
5.5 获取GPS的设备信息
指令 |
local str = tracker.locateMessage(format)(format 为“json” or "hex") |
5.6 获取GPS设备信息
指令 |
local str = tracker.deviceMessage(format)(format 为“json” or "hex") |