命令功耗测试

ASRMicroelectronicsConfidential1/32密级状态:绝密()秘密(√)内部资料(√)公开()文档编号:(芯片型号)–ASR6501/ASR6502(英文、数字)ASR6501/ASR6502ATCommandIntroduction文件状态:[√]正在修改[]正式发布当前版本:V4.
3作者:QipanLi启动日期:2018-6-19审核:完成日期:2019-07-01翱捷科技(上海)有限公司ASRMicroelectronicsCo.
,LtdASRMicroelectronicsConfidential2/32(版本所有,翻版必究)版本历史版本号修改日期作者修改说明V1.
12018.
06.
21QipanLiInitialVersionV2.
02018.
07.
20QipanLiAddATcommandsV3.
02018.
08.
24RuilinHaoUpdateV3.
12018.
09.
29RuilinHaoUpdateV4.
02018.
11.
14RuilinHao增加部分AT命令V4.
22019.
03.
05RuilinHao修正部分AT命令V4.
32019.
07.
01AoYe修正部分AT命令ASRMicroelectronicsConfidential3/32TableofContents1范围52术语、定义和缩略语.
52.
1术语和定义52.
1.
1LoRa52.
1.
2LoRaWAN52.
2缩略语53概述54AT指令语法.
65LORAAT指令.
75.
1命令分类75.
1.
1通用命令总览75.
1.
2网络相关参数配置命令总览85.
1.
3控制和状态命令总览85.
1.
4数据收发命令总览85.
1.
5MAC配置命令总览.
85.
1.
6其他命令总览95.
1.
7私有命令总览95.
2AT命令格式95.
2.
1读取厂家标识+CGMI95.
2.
2读取模组标识+CGMM.
105.
2.
3读取版本标识+CGMR.
105.
2.
4读取产品序列号标识+CGSN105.
2.
5设置波特率+CGBR115.
2.
6设置Join方式+CJOINMODE.
115.
2.
7设置DevEUI+CDEVEUI115.
2.
8设置AppEUI+CAPPEUI125.
2.
9设置AppKey+CAPPKEY.
125.
2.
10设置DevAddr+CDEVADDR125.
2.
11设置AppSKey+CAPPSKEY.
135.
2.
12设置NwkSKey+CNWKSKEY.
135.
2.
13设置频段掩码+CFREQBANDMASK.
135.
2.
14设置上下行同异频+CULDLMODE.
145.
2.
15设置工作模式+CWORKMODE145.
2.
16设置Class+CCLASS155.
2.
17查询设备电量等级+CBL165.
2.
18查询设备当前状态+CSTATUS.
165.
2.
19设置Join+CJOIN165.
2.
20发送接收数据+DTRX.
17ASRMicroelectronicsConfidential4/325.
2.
21接收数据+DRX.
195.
2.
22设置上行传输类型+CCONFIRM.
195.
2.
23设置上行数据端口号+CAPPPORT.
205.
2.
24设置通信速率+CDATARATE.
205.
2.
25查询信道信号强度+CRSSI.
215.
2.
26设置发送次数+CNBTRIALS.
215.
2.
27设置上报模式+CRM.
225.
2.
28设置发送功率+CTXP.
225.
2.
29验证网络连接+CLINKCHECK235.
2.
30使能ADR+CADR245.
2.
31设置接收窗口参数+CRXP.
245.
2.
32设置发收时延+CRX1DELAY.
245.
2.
33保存MAC参数设置+CSAVE255.
2.
34恢复MAC默认参数+CRESTORE.
255.
2.
35PingSlotInfo请求+CPINGSLOTINFOREQ.
255.
2.
36增加组播地址+CADDMUTICAST.
265.
2.
37删除组播地址+CDELMUTICAST.
265.
2.
38查询组播数量+CNUMMUTICAST.
275.
2.
39重启模组+IREBOOT.
275.
2.
40设置日志等级+ILOGLVL285.
2.
41加密设备秘钥+CKEYSPROTECT.
285.
2.
42使能低功耗+CLPM.
285.
2.
43低功耗测试命令+CSLEEP.
295.
2.
44低功耗测试命令+CMCU.
295.
2.
45低功耗测试命令+CSTDBY.
305.
2.
46测试命令+CRXS.
305.
2.
47测试命令+CRX.
315.
2.
48测试命令+CTX.
315.
2.
49测试命令+CTXCW.
31ASRMicroelectronicsConfidential5/321范围本标准规定了物联网领域LoRa模组通信的AT指令集.
本标准适用于对LoRa模组的配置、操作、数据收发等.
2术语、定义和缩略语2.
1术语和定义2.
1.
1LoRaLoRa是LPWAN通讯技术中的一种,是Semtech公司采用和推广的基于扩频技术的超远距离无线传输方案.
LoRa主要ISMbrand是在全球免费频段:433MHz、470MHz、868MHz、915MHz等.
特点:低功耗、远距离、低成本.
2.
1.
2LoRaWANLoRa联盟是2015年3月Semtech牵头成立的开放的、非盈利的组织.
联盟发布一个基于开源的MAC层协议的低功耗广域网标准:LoRaWAN协议标准.
网络拓扑:星形结构网络构成:LoRa模块、网关(Gateway或称基站)、Server(包括NetworkServer,Networkcontrol,ApplicationServer).
LoRaWAN把LoRa模块分为A/B/C三类.
2.
2缩略语下列缩略语适用于本文件.
缩略语英文全称中文全称MCUMicrocontrollerUnit微控制单元TATerminalAdaptor终端适配器TETerminalEquipment终端设备3概述终端设备(TE,TerminalEquipment)可通过发送本标准所述的AT命令控制移动终端(MT,MobileTerminal)功能及相关网络业务.
终端适配器(TA,TerminalAdaptor)完成终端设备与移动设备之间的命令及消息适配功能.
终端设备(TE)、终端适配器(TA)及移动终端(MT)的物理实现可以是下列情况:TE、TA和MT是三个独立的实体;TE是独立的实体,TA集成在MT内部;MT是独立的实体,TA集成在TE内部;TE、TA和MT集成为一个实体.
在本规范中,TE认为是物联网设备的MCU模块,TA集成在MT内部,认为是通信模块.
通信模块指LoRa通信模块.
终端设备(TE)、终端适配器(TA)及移动终端(MT)的系统结构及之间建立关联的基本流程如图1所示.
终端设备及适配器间接口可使用串口线缆、红外等方式.
ASRMicroelectronicsConfidential6/32图1系统结构图根据图1所示,MCU模块与通信模块共同集成于物联网设备,MCU通过AT命令与TA实现通信,从而控制MT实现物联网设备与云端的交互.
由于物联网设备与云端的交互是通过LoRa来进行,因此在本规范中,通过对标准的AT指令进行扩展,实现支持LoRa指令等,从而实现物联网设备与云端的消息交互.
4AT指令语法AT指令采用基于ASCII码的命令行,命令格式如下:请求消息格式为:AT+[OP][para-1,para-2,……para-n]表格1AT请求消息格式域说明AT+命令消息前缀CMD指令字符串Op指令操作符.
可以是以下内容:"=":表示参数设置.
"":表示查询参数的当前值.
"":表示执行指令.
"=":表示查询设置指令的参数.
para-1,para-2,……para-n表示设置的参数值,或者是指定要查询的参数\r回车结束符,ASCII码为0x0D回应消息格式为:[+CMD:][para-1,para-2,……para-n]或者:或者上述两者都有.
表格2AT回应消息格式域说明\n换行符,ASCII码为0x0A+CMD相应的指令字符串para-1,para-2,……para-n相应的参数字符串STATUS指令执行状态.
可以是以下内容:"OK":表示指令执行成功.
"ERROR":表示指令执行失败.
ASRMicroelectronicsConfidential7/32"+CMEERROR:":表示指令执行失败,并返回相应的错误代码.
注::表示必须包含的内容.
[]:表示可选的内容.
\r:回车结束符,ASCII码为0x0D\n:换行符,ASCII码为0x0A.
例如,查询MQTT的连接模式,发送指令为:AT+IMQTTMODE\r回复的消息为:\r\n+IMQTTMODE:1\r\n\r\nOK\r\n下文中为了便于阅读,将\r\n隐藏.
串口的参数配置:波特率115200,数据位8,停止位1,校验位0.
当前命令支持回显,暂时不支持回格(BackSpace),暂时不支持回翻历史命令.
5LoRaAT指令5.
1命令分类LoRa的AT指令分类如下:表格3LoRa的AT指令分类分类描述备注通用命令厂商标识,模组标识,版本标识,产品序列号标识;Generalcommands.
网络相关参数配置命令频段掩码,多播地址,同频/异频,设备DevEUI;Networkrelatedparametersconfigcommands控制和状态命令发起Join,工作模式,Class,Batterycapacity,模组状态;NodecontrolandstatuscommandsMAC配置命令LoRaWAN协议中MAC指令相关;MACconfigcommands数据收发命令数据收发;Datacommands其他命令日志等级,重启模组,恢复出厂设置;厂商私有命令LoRa厂商私有指令;Manufactureprivatecommands5.
1.
1通用命令总览表格4LoRaWAN的通用指令集命令描述实现方式AT+CGMI读取厂家标识(manufactureridentification)可选AT+CGMM读取模组标识(modelidentification)可选AT+CGMR读取版本标识(revisionidentification)可选ASRMicroelectronicsConfidential8/32AT+CGSN读取产品序列号标识(productserialnumberidentification)可选AT+CGBR设置UART的波特率(baudrateonUARTinterface)可选5.
1.
2网络相关参数配置命令总览表格5LoRaWAN的网络相关参数配置指令集命令描述实现方式AT+CJOINMODE设置读取Join模式(OTAA,ABP)必选AT+CDEVEUI设置读取DevEUI(OTAA入网时)必选AT+CAPPEUI设置读取AppEUI(OTAA入网时)必选AT+CAPPKEY设置读取AppKey(OTAA入网时)必选AT+CDEVADDR设置读取DevAddr(ABP入网时)必选AT+CAPPSKEY设置读取AppSkey(ABP入网时)必选AT+CNWKSKEY设置读取NwkSkey(ABP入网时)必选AT+CFREQBANDMASK设置读取频点掩码(FreqBandMask)必选AT+CULDLMODE设置读取Ul/Dl模式(同频或者异频)必选AT+CADDMUTICAST增加一个组播地址可选AT+CDELMUTICAST删除一个组播地址可选AT+CNUMMUTICAST查询组播数目可选5.
1.
3控制和状态命令总览表格6LoRaWAN的控制和状态指令集命令描述实现方式AT+CWORKMODE设置读取工作模式(正常工作模式)必选AT+CCLASS设置读取class类型(ClassA/B/C)必选AT+CBL读取电量等级可选AT+CSTATUS读取节点状态必选AT+CJOIN发起OTAA入网必选AT+CPINGSLOTINFOREQ发起pingslotinforequest可选5.
1.
4数据收发命令总览表格7LoRaWAN的数据收发指令集命令描述实现方式AT+DTRX发送接收数据帧必选AT+DRX从Rxbuffer获取最新接收到的数据,并清空Rxbuffer必选5.
1.
5MAC配置命令总览表格8LoRaWAN的MAC配置指令集命令描述实现方式AT+CCONFIRM设置读取发送消息的类型(confirm或者unconfirm)必选AT+CAPPPORT设置读取应用层Port必选AT+CDATARATE设置读取数据速率必选ASRMicroelectronicsConfidential9/325.
1.
6其他命令总览表格9其他AT指令集命令描述实现方式AT+IREBOOT重启通信模组可选AT+ILOGLVL设置日志等级可选5.
1.
7私有命令总览表格10私有AT指令集命令描述实现方式AT+CLPM使能低功耗命令AT+CKEYSPROTECT设备秘钥加密命令AT+CSLEEP低功耗测试命令AT+CMCU低功耗测试命令AT+CSTDBY低功耗测试命令AT+CRXSLORA测试命令AT+CRXLORA测试命令AT+CTXLORA测试命令AT+CTXCWLORA测试命令5.
2AT命令格式5.
2.
1读取厂家标识+CGMI表格11读取厂家标识命令类型命令格式响应查询命令AT+CGMI+CGMI=OK参数说明:厂家标识返回值说明AT+CRSSI获取信道的RSSI值必选AT+CNBTRIALS设置读取NbTrans参数必选AT+CRM设置读取上报模式必选AT+CTXP设置读取发送功率必选AT+CLINKCHECK使能Linkcheck必选AT+CADR使能或关闭ADR必选AT+CRXP设置读取接收窗口参数必选AT+CRX1DELAY设置读取TX和RX1的时延必选AT+CSAVE保存配置必选AT+CRESTORE恢复默认配置必选ASRMicroelectronicsConfidential10/32示例AT+CGMI+CGMI=ASROK注意事项5.
2.
2读取模组标识+CGMM表格12读取模组标识命令类型命令格式响应查询命令AT+CGMM+CGMM=OK参数说明:模组标识返回值说明示例AT+CGMM+CGMM=6501OK注意事项5.
2.
3读取版本标识+CGMR表格13读取版本标识命令类型命令格式响应查询命令AT+CGMR+CGMR=OK参数说明:版本标识返回值说明示例AT+CGMR+CGMR=v4.
2OK注意事项5.
2.
4读取产品序列号标识+CGSN表格14读取版本标识命令类型命令格式响应查询命令AT+CGSN+CGMR=OK参数说明:产品序列号标识返回值说明示例AT+CGSN+CGSN=0539349E00032523OKASRMicroelectronicsConfidential11/32注意事项5.
2.
5设置波特率+CGBR表格15读取版本标识命令类型命令格式响应查询命令AT+CGBR+CGBR=OK设置命令AT+CGBR=OK参数说明:波特率返回值说明示例AT+CGBR=9600OK注意事项5.
2.
6设置Join方式+CJOINMODE表格16设置Join方式命令类型命令格式响应测试命令AT+CJOINMODE=+CJOINMODE:"mode"OK查询命令AT+CJOINMODE+CJOINMODE:OK执行命令AT+CJOINMODE=OK或者+CMEERROR:参数说明:节点Join方式,如下.
0:OTAA1:ABP:error代码.
返回值说明示例AT+CJOINMODE=0OK注意事项默认采用OTAA方式;如果需要采用ABP入网方式,请在发送数据之前使用该指令设置.
5.
2.
7设置DevEUI+CDEVEUI表格17查询DevEUI命令类型命令格式响应测试命令AT+CDEVEUI=+CDEVEUI=查询命令AT+CDEVEUI+CDEVEUI:OK执行命令AT+CDEVEUI=OK或者ASRMicroelectronicsConfidential12/32+CMEERROR:参数说明:节点DevEUI返回值说明示例AT+CDEVEUI+CDEVEUI=AABBCCDD00112233OK注意事项设置或者读取DevEUI,返回Y1Y2…Y8,16进制格式,取值8字节.
5.
2.
8设置AppEUI+CAPPEUI表格18设置AppEUI命令类型命令格式响应测试命令AT+CAPPEUI=+CAPPEUI=查询命令AT+CAPPEUI+CAPPEUI:OK执行命令AT+CAPPEUI=OK或者+CMEERROR:参数说明:节点AppEUI:error代码.
返回值说明示例AT+CAPPEUI=AABBCCDD00112233OK注意事项OTAA时使用,设置或读取AppEUI,返回Y1Y2…Y8,16进制格式,取值8字节.
5.
2.
9设置AppKey+CAPPKEY表格19设置AppKey命令类型命令格式响应测试命令AT+CAPPKEY=+CAPPKEY=查询命令AT+CAPPKEY+CAPPKEY:OK执行命令AT+CAPPKEY=OK或者+CMEERROR:参数说明:节点AppKey:error代码.
返回值说明示例AT+CAPPKEY=AABBCCDD00112233AABBCCDD00112233OK注意事项OTAA时使用,设置或读取AppKey,返回Y1Y2…Y16,16进制格式,取值16字节.
5.
2.
10设置DevAddr+CDEVADDR表格20设置DevAddr命令类型命令格式响应测试命令AT+CDEVADDR=+CDEVADDR=ASRMicroelectronicsConfidential13/32查询命令AT+CDEVADDR+CDEVADDR:OK执行命令AT+CDEVADDR=OK或者+CMEERROR:参数说明:节点DevAddr:error代码.
返回值说明示例AT+CDEVADDR=00112233OK注意事项ABP时使用,设置或读取DevAddr,返回Y1Y2…Y4,16进制格式,取值4字节.
5.
2.
11设置AppSKey+CAPPSKEY表格21设置AppSKey命令类型命令格式响应测试命令AT+CAPPSKEY=+CAPPSKEY=查询命令AT+CAPPSKEY+CAPPSKEY:OK执行命令AT+CAPPSKEY=OK或者+CMEERROR:参数说明:节点AppSKey:error代码.
返回值说明示例AT+CAPPSKEY=AABBCCDD00112233AABBCCDD00112233OK注意事项ABP时使用,设置或读取AppSKey,返回Y1Y2…Y16,16进制格式,取值16字节.
5.
2.
12设置NwkSKey+CNWKSKEY表格22设置NwkSKey命令类型命令格式响应测试命令AT+CNWKSKEY=+CNWKSKEY=查询命令AT+CNWKSKEY+CNWKSKEY:OK执行命令AT+CNWKSKEY=OK或者+CMEERROR:参数说明:节点NwkSKey:error代码.
返回值说明示例AT+CNWKSKEY=AABBCCDD00112233AABBCCDD00112233OK注意事项ABP时使用,设置或读取NwkSKey,返回Y1Y2…Y16,16进制格式,取值16字节.
5.
2.
13设置频段掩码+CFREQBANDMASK表格23设置频段掩码ASRMicroelectronicsConfidential14/32命令类型命令格式响应测试命令AT+CFREQBANDMASK=+CFREQBANDMASK:"mask"OK查询命令AT+CFREQBANDMASK+CFREQBANDMASK:OK执行命令AT+CFREQBANDMASK=OK或者+CMEERROR:参数说明:网络可能工作的频点掩码,16bit对应16个频组,详见LoRaWAN接入规范.
如:0-7频道,对应掩码为0001,8-15频道对应掩码为0002,依次类推.
具体频道对应的频率需查看region协议,如0-7频道在CN470中对应为:470.
3MHz,470.
5MHz,470.
7MHz,470.
9MHz,471.
1MHz,471.
3MHz,471.
5MHz,471.
7MHz.
:error代码.
返回值说明示例AT+CFREQBANDMASK=0001OK注意事项在Join之前需要设置.
5.
2.
14设置上下行同异频+CULDLMODE表格24设置上下行同异频命令类型命令格式响应测试命令AT+CULDLMODE=+CULDLMODE:"mode"OK查询命令AT+CULDLMODE+CULDLMODE:OK执行命令AT+CULDLMODE=OK或者+CMEERROR:参数说明:如下.
1:同频模式2:异频模式:error代码.
返回值说明示例AT+CULDLMODE=2OK注意事项在Join之前需要设置.
(SDK3.
0及以前版本,因为linkwan对异频节点的DEVEUI有要求,所以会出现设置异频模式失败的问题,在SDK4.
0以后解除了此限制)5.
2.
15设置工作模式+CWORKMODE表格25设置工作模式命令类型命令格式响应测试命令AT+CWORKMODE=+CWORKMODE:"mode"OKASRMicroelectronicsConfidential15/32查询命令AT+CWORKMODE+CWORKMODE:OK执行命令AT+CWORKMODE=OK或者+CMEERROR:参数说明:如下.
2:正常工作模式:error代码.
返回值说明示例AT+CWORKMODE=2OK注意事项在Join之前需要设置,默认为正常工作模式.
目前仅支持正常工作模式5.
2.
16设置Class+CCLASS表格26设置Class命令类型命令格式响应测试命令AT+CCLASS=+CCLASS:"class","branch","para1","para2","para3","para4"OK查询命令AT+CCLASS+CCLASS:OK执行命令AT+CCLASS=,[branch],[para1],[para2],[para3],[para4]OK或者+CMEERROR:参数说明:如下.
0:classA1:classB2:classC根据不同设备类型,有以下可选参数:若class=1,且branch=0,则只有para1参数,用于设置Pingslotperiodicity,范围0~7,对应的实际周期时间是0.
96*2^periodicity秒;若class=1,且branch=1,则:para1设置beacon频点,单位为Hz;para2设置beaconDataRate,para3设置ping频点,单位为Hz;para4设置pingDataRate.
每个参数的取值范围详见LoRaWAN接入规范.
:error代码.
返回值说明示例AT+CCLASS=2OK注意事项在Join之前需要设置,默认为ClassA.
ASRMicroelectronicsConfidential16/325.
2.
17查询设备电量等级+CBL表格27查询设备电量等级命令类型命令格式响应测试命令AT+CBL=+CBL:"value"OK查询命令AT+CBL+CBL:OK参数说明:节点电量等级,范围参照LoRaWAN协议定义.
返回值说明示例AT+CBL+CBL=100OK注意事项查询设备电量等级.
5.
2.
18查询设备当前状态+CSTATUS表格28查询设备当前状态命令类型命令格式响应测试命令AT+CSTATUS=+CSTATUS:"status"OK查询命令AT+CSTATUS+CSTATUS:OK参数说明:定义如下.
当前上行结果00–无数据操作01–数据发送中02–数据发送失败03–数据发送成功04–JOIN成功(仅出现在首次JOIN过程中)05–JOIN失败(仅出现在首次JOIN过程中)06–网络可能异常(LinkCheck结果)07–发送数据成功,无下行08–发送数据成功,有下行返回值说明示例AT+CSTATUS+CSTATUS=03OK注意事项查询设备当前状态.
5.
2.
19设置Join+CJOIN表格29设置Join命令类型命令格式响应测试命令AT+CJOIN=+CJOIN:,[ParaTag2],…[ParaTag4]ASRMicroelectronicsConfidential17/32OK查询命令AT+CJOIN+CJOIN:,[ParaValue2],…[ParaValue4]OK执行命令AT+CJOIN=,[ParaValue2],…[ParaValue4]OK或者+CMEERROR:如果输入合法,首先返回OK,然后启动自动鉴权,返回鉴权结果.
+CJOIN:OK鉴权成功+CJOIN:FAIL鉴权失败参数说明,[ParaTag2],……[ParaTag4]:鉴权参数1,2,……4的名称;[ParaValue1],[ParaValue2],……[ParaValue4]:鉴权参数1,2,……4的参数值;ParaTag1表示执行JOIN操作,ParaTag1取值范围:0–停止JOIN1–启动JOIN,重新开启一次JOIN过程.
对于使能热启动的模块,执行该操作会清除保存的JOIN上下文参数.
ParaTag2表示是否使能自动JOIN功能.
出厂值为1,ParaTag2取值范围:0–关闭自动JOIN1–自动JOIN.
模块进入透传模式后,自动启动JOIN.
ParaTag3表示JOIN周期,X3取值范围:7~255,单位为s.
出厂缺省值:8.
ParaTag4表示JOIN最大尝试次数,ParaTag4取值范围:1~256.
详见接入规范.
:error代码.
返回值说明示例AT+CJOIN=1,0,10,8(设置JOIN参数:关闭自动JOIN,JOIN周期为10s,最大尝试次数8次)OK+CJOIN:OK注意事项5.
2.
20发送接收数据+DTRX表格30发送接收数据命令类型命令格式响应测试命令AT+DTRX=+DTRX:[confirm],[nbtrials],,OK执行命令AT+DTRX=[confirm],[nbtrials],,OK+SEND:TX_LENOK+SENT:TX_CNTOK+RECV:TYPE,PORT,LEN,DATA或者ERR+SEND:ERR_NUMERR+SENT:TX_CNT或者+CMEERROR:ASRMicroelectronicsConfidential18/32参数说明confirm和nbtrials参见相应的AT指令,只对本次发送有效,可选.
Length:表示字符串的个数;最大值详见接入规范;不同速率下允许传输的字节长度不同(详见LoRaWan协议规定),0表示发送空数据包.
Payload:16进制(2个字符表示1个数);返回值:1,如何判断数据发送是否成功Confirm类型数据:每次发送一帧数据后,都应该有相应的应答消息.
当模块超时未接收到应答消息,若未达到最大次数则会再次重试,直到达到最大次数都未接收到下行消息,即为失败,并输出ERR+SENT消息.
在此期间,若接收到应答消息传输结束,即为成功,并输出OK+SEND,OK+SENT和OK+RECV消息.
Unconfirm类型数据:发送数据后不会请求下行应答,每次传输结束都会返回OK+SEND,OK+SENT消息.
如果收到了下行数据就再发送OK+RECV消息.
2,数据发送状态提示OK+SEND:TX_LEN表示数据发送请求成功,TX_LEN:1Byte,发送的数据长度OK+SENT:TX_CNT表示数据发送成功,TX_CNT:1Byte,数据发送次数.
ERR+SEND:ERR_NUM表示数据发送请求失败,原因由ERR_NUM表示.
ERR_NUM:1Byte,0-未入网1-通信忙,发送请求失败2-数据长度超过当前可发送长度,仅发送MAC命令ERR+SENT:TX_CNT表示数据发送失败,传输次数达到最大次数,TX_CNT:1Byte,数据发送次数.
OK+RECV:TYPE,PORT,LEN,DATA数据接收成功(接收到应答消息或主动下行数据)TYPE:1Byte,下行传输类型Bit0:0-unconfirm,1-confirmBit1:0-非ACK,1-ACKBit2:0-未携带,1-携带,指示下行数据中是否携带LINK命令应答Bit3:0-未携带,1-携带,指示下行数据中是否携带TIME命令应答,只有当该位为1时才意味着时间同步成功Bit4~Bit7:默认0,保留PORT:1Byte,下行传输端口LEN:1Byte,下行数据长度DATA:nByte,下行数据,当LEN=0时,此字段不存在.
:error代码.
返回值说明示例AT+DTRX=1,2,5,0123456789OK+SEND:05OK+SENT:01ASRMicroelectronicsConfidential19/32OK+RECV:02,01,00表示confirm数据发送成功,服务端收到的有效数据应为"0x010x230x450x670x89",并收到了下行确认.
注意事项先入网,后发送数据.
5.
2.
21接收数据+DRX表格31接收数据命令类型命令格式响应测试命令AT+DRX=+DRX:,OK查询命令AT+DRX+DRX:,OK或者+CMEERROR:参数说明返回值:Length:0表示空数据包;Payload:16进制字符串数据;OK:接收数据包无异常;:error代码.
返回值说明示例AT+DRXOK注意事项从接收buffer接收数据包,并清空接收buffer;5.
2.
22设置上行传输类型+CCONFIRM表格32设置上行传输类型命令类型命令格式响应测试命令AT+CCONFIRM=+CCONFIRM:"value"OK查询命令AT+CCONFIRM+CCONFIRM:OK执行命令AT+CCONFIRM=OK或者+CMEERROR:参数说明:如下.
0:UnConfirmedupmessage1:Confirmedupmessage:error代码.
返回值说明示例AT+CCONFIRM=1OK注意事项在发送数据之前需要设置.
ASRMicroelectronicsConfidential20/325.
2.
23设置上行数据端口号+CAPPPORT表格33设置上行数据端口号命令类型命令格式响应测试命令AT+CAPPPORT=+CAPPPORT:"value"OK查询命令AT+CAPPPORT+CAPPPORT:OK执行命令AT+CAPPPORT=OK或者+CMEERROR:参数说明:如下.
所使用port,数据格式为10进制,出厂值为10.
取值范围:1~223;注1:Port:0x00是LoRaWAN的MAC命令:error代码.
返回值说明示例AT+CAPPPORT=10OK注意事项在发送数据之前需要设置.
5.
2.
24设置通信速率+CDATARATE表格34设置通信速率命令类型命令格式响应测试命令AT+CDATARATE=+CDATARATE:"value"OK查询命令AT+CDATARATE+CDATARATE:OK执行命令AT+CDATARATE=OK或者+CMEERROR:参数说明:如下.
速率值,出厂值为3,取值范围:0-SF12,BW1251-SF11,BW1252-SF10,BW1253-SF9,BW1254-SF8,BW1255-SF7,BW125:error代码.
返回值说明示例AT+CDATARATE=1OK注意事项在发送数据之前需要设置.
ASRMicroelectronicsConfidential21/32因为默认使能ADR,所以无法改变DATARATE,如需更改DATARATE,请先执行AT+CADR=0.
5.
2.
25查询信道信号强度+CRSSI表格35查询信道信号强度命令类型命令格式响应测试命令AT+CRSSI=+CRSSIOK查询命令AT+CRSSIFREQBANDIDX+CRSSI:0:1:…15:OK参数说明:表示频段的编号,从0开始,1A2组编号为1.
返回一个频段内8个信道的RSSI.
返回值说明示例AT+CRSSI1+CRSSI:0:-1571:-1572:-1573:-1574:-1575:-1576:-1577:-157OK注意事项5.
2.
26设置发送次数+CNBTRIALS表格36设置发送次数命令类型命令格式响应测试命令AT+CNBTRIALS=+CNBTRIALS:"MType","value"OK查询命令AT+CNBTRIALS+CNBTRIALS:,OK执行命令AT+CNBTRIALS=,OK或者+CMEERROR:参数说明:0:unconfirm包,1:confirm包.
:为最大发送次数,取值范围:1~15.
默认值详见接入规范.
:error代码.
返回值说明ASRMicroelectronicsConfidential22/32示例AT+CNBTRIALS=1,2OK注意事项在发送数据之前需要设置.
5.
2.
27设置上报模式+CRM表格37设置上报模式命令类型命令格式响应测试命令AT+CRM=+CRM:"reportMode","reportInterval"OK查询命令AT+CRM+CTXP:,[reportInterval]OK执行命令AT+CTXP=,[reportInterval]OK或者+CMEERROR:参数说明此指令主要用于测试用途.
:0-非周期上报数据;1-周期上报数据;:此参数只在周期上报数据时才有.
周期上报数据的时间间隔,单位:s.
对于不同的DR,允许的最小周期都是不同的,采用周期等级定义,如下表.
速率\周期(s)\等级LV1LV2DR0150300DR175150DR23570DR31530DR41020DR5510:error代码.
返回值说明示例AT+CRM=1,10OK注意事项在发送数据之前需要设置.
5.
2.
28设置发送功率+CTXP表格38设置发送功率命令类型命令格式响应测试命令AT+CTXP=+CTXP:"value"OK查询命令AT+CTXP+CTXP:OK执行命令AT+CTXP=OKASRMicroelectronicsConfidential23/32或者+CMEERROR:参数说明:为发送功率大小,出厂值为0,实际取值范围与具体产品型号有关,CN470A的取值范围:0-17dBm1-15dBm2-13dBm3-11dBm4-9dBm5-7dBm6-5dBm7-3dBm:error代码.
返回值说明示例AT+CTXP=1OK注意事项在发送数据之前需要设置.
5.
2.
29验证网络连接+CLINKCHECK表格39验证网络连接命令类型命令格式响应测试命令AT+CLINKCHECK=+CLINKCHECK:"value"OK执行命令AT+CLINKCHECK=OK或者+CMEERROR:参数说明:为LinkCheck使能控制0–不使能LinkCheck1–执行一次LinkCheck2-模块自动在每次上行数据包中携带linkcheck命令.
返回OK,设置成功.
若X1=1,等待一段时间后,会返回第二条响应信息,格式如下:+CLINKCHECK:Y0,Y1,Y2,Y3,Y4YO表示LinkCheck结果:0-表示本次LinkCheck执行成功非0-表示本次LinkCheck执行失败Y1为DemodMarginY2为NbGatewaysY3为本次下行的RSSIY4为本次下行的SNR:error代码.
返回值说明示例AT+CLINKCHECK=1OK+CLINKCHECK:0,0,1,-68,8ASRMicroelectronicsConfidential24/32注意事项在发送数据之前需要设置.
5.
2.
30使能ADR+CADR表格40使能ADR命令类型命令格式响应测试命令AT+CADR=+CADR:"value"OK查询命令AT+CADR+CADR:OK执行命令AT+CADR=OK或者+CMEERROR:参数说明:如下.
ADR使能控制,出厂值为10-ADR不使能1-ADR使能:error代码.
返回值说明示例AT+CADR=1OK注意事项在发送数据之前需要设置.
默认开启ADR.
5.
2.
31设置接收窗口参数+CRXP表格41设置接收窗口参数命令类型命令格式响应测试命令AT+CRXP=+CRXP:"RX1DRoffest","RX2DataRate","RX2Frequency"OK查询命令AT+CRXP+CRXP:,,OK执行命令AT+CRXP=,,OK或者+CMEERROR:参数说明,,详见LoRaWAN协议.
:error代码.
返回值说明示例AT+CRXP=1,1,471000000OK注意事项在发送数据之前需要设置.
不设置用默认值.
5.
2.
32设置发收时延+CRX1DELAY表格42设置Rx1时延命令类型命令格式响应测试命令AT+CRX1DELAY=+CRX1DELAY:"Delay"ASRMicroelectronicsConfidential25/32OK查询命令AT+CRX1DELAY+CRX1DELAY:OK执行命令AT+CRX1DELAY=OK或者+CMEERROR:参数说明Delay:发送后多久打开RX1窗口,单位:s;:error代码.
返回值说明示例AT+CRX1DELAY=2OK注意事项设置发送后多久打开RX1窗口,在发送数据之前设置.
不设置时为协议默认值.
5.
2.
33保存MAC参数设置+CSAVE表格43保存MAC参数设置命令类型命令格式响应测试命令AT+CSAVE=+CSAVEOK执行命令AT+CSAVEOK或者+CMEERROR:参数说明该命令保存配置参数到EERPOM/FLASH中,重启后模块将使用新的MAC配置参数进行网络初始化与运行.
:error代码.
返回值说明示例AT+CSAVEOK注意事项在发送数据之前需要保存.
5.
2.
34恢复MAC默认参数+CRESTORE表格44恢复MAC默认参数命令类型命令格式响应测试命令AT+CRESTORE=+CRESTOREOK执行命令AT+CRESTOREOK或者+CMEERROR:参数说明该命令恢复MAC默认配置参数到EERPOM/FLASH中.
:error代码.
返回值说明示例AT+CRESTOREOK注意事项在发送数据之前需要保存.
5.
2.
35PingSlotInfo请求+CPINGSLOTINFOREQ表格45PingSlotInfo请求ASRMicroelectronicsConfidential26/32命令类型命令格式响应测试命令AT+CPINGSLOTINFOREQ=+CPINGSLOTINFOREQ:OK查询命令AT+CPINGSLOTINFOREQ+CPINGSLOTINFOREQ:OK执行命令AT+CPINGSLOTINFOREQ=OK或者+CMEERROR:参数说明periodicity:pingslot周期参数:error代码.
返回值说明示例AT+CPINGSLOTINFOREQ=3OK注意事项ClassB专用指令5.
2.
36增加组播地址+CADDMUTICAST表格46增加组播地址命令类型命令格式响应测试命令AT+CADDMUTICAST=+CADDMUTICAST:"DevAddr","AppSKey","NwkSKey","Periodicity","Datarate"OK执行命令AT+CADDMUTICAST=,,,[Periodicity],[Datarate]OK或者+CMEERROR:参数说明DevAddr:组播地址AppSKey:组播应用会话秘钥NwkSKey:组播网络会话秘钥Periodicity:pingslot周期参数Datarate:数据速率:error代码.
返回值说明示例AT+CADDMUTICAST=67678d5e,5ac8eb2016f11f19ad19d7f530592c44,59543069010279fa7317f85f47c46926,2,2OK注意事项请在JOIN前设置5.
2.
37删除组播地址+CDELMUTICAST表格47删除组播地址命令类型命令格式响应测试命令AT+CDELMUTICAST=+CDELMUTICAST:"DevAddr"OK执行命令AT+CDELMUTICAST=OK或者+CMEERROR:ASRMicroelectronicsConfidential27/32参数说明DevAddr:组播地址:error代码.
返回值说明示例AT+CDELMUTICAST=67678d5eOK注意事项5.
2.
38查询组播数量+CNUMMUTICAST表格48查询组播数量命令类型命令格式响应测试命令AT+CNUMMUTICAST=+CNUMMUTICAST:"number"OK查询命令AT+CNUMMUTICAST+CNUMMUTICAST:OK参数说明返回值说明示例AT+CNUMMUTICAST+CNUMMUTICAST:0OK注意事项5.
2.
39重启模组+IREBOOT表格49重启模组命令类型命令格式响应测试命令AT+IREBOOT=+IREBOOT:"Mode"OK执行命令AT+IREBOOT=OK或者+CMEERROR:参数说明:重启模式;0:立即重启通信模组.
1:等待通信模组内当前正在发送的无线帧完成后再重启.
7:重启进入bootloader:error代码.
返回值说明示例AT+IREBOOT=1OK注意事项通信模组收到该指令后,回复OK后,重启通信模组.
重启完成之前,不再接收任何后续的AT指令.
ASRMicroelectronicsConfidential28/325.
2.
40设置日志等级+ILOGLVL表格50设置日志等级命令类型命令格式响应测试命令AT+ILOGLVL=+ILOGLVL:"level"OK查询命令AT+ILOGLVL+ILOGLVL:OK执行命令AT+ILOGLVL=OK或者+CMEERROR:参数说明:日志等级;0:禁止日志信息.
1~5:使能日志信息,数字越大,日志信息越详细.
:error代码.
返回值说明示例AT+ILOGLVL=1OK注意事项5.
2.
41加密设备秘钥+CKEYSPROTECT表格51设置NwkSKey命令类型命令格式响应测试命令AT+CKEYSPROTECT=+CKEYSPROTECT=OK查询命令AT+CKEYSPROTECT+CKEYSPROTECT:OK执行命令AT+CKEYSPROTECT=OK或者+CMEERROR:参数说明:节点保护秘钥:error代码.
返回值说明示例AT+CKEYSPROTECT=AABBCCDD00112233AABBCCDD00112233OK注意事项使用此命令后,设备三元组信息将被加密存储,只能读取密文,并且无法再修改.
5.
2.
42使能低功耗+CLPM表格52设置NwkSKey命令类型命令格式响应测试命令AT+CLPM=+CLPM:"Mode"OK执行命令AT+CLPM=OK或者+CMEERROR:ASRMicroelectronicsConfidential29/32参数说明:低功耗模式1:设备进入低功耗:error代码.
返回值说明示例AT+CLPM=1OK注意事项因为40kbps以上传输时,UART起始部分字节可能传输错误,AT+CLPM=0可能被识别错误而返回"+CMEERROR",建议使用"000000000D0A"(16进制)进行唤醒5.
2.
43低功耗测试命令+CSLEEP表格53+CSLEEP命令类型命令格式响应测试命令AT+CSLEEP=+CSLEEP=OK执行命令AT+CSLEEP=OK或者+CMEERROR:参数说明该命令执行进入DeepSleep操作Sleep_mode共有三种类型0–进入DeepSleep模式,并于10s后由Timer唤醒1–进入DeepSleep模式,并由set_b管脚拉高唤醒2–进入DeepSleep模式,并由UART唤醒,用户敲入任意键:error代码.
返回值说明示例AT+CSLEEP=0deepsleep10000ms!
=0+CSLEEPOK注意事项5.
2.
44低功耗测试命令+CMCU表格54+CMCU命令类型命令格式响应测试命令AT+CMCU=+CMCU=OK执行命令AT+CMCU=OK或者+CMEERROR:参数说明该命令执行MCU测试操作mcu_mode共有三种类型0–仅关闭SX12621–MCU,watchdog,Timer工作返回值说明ASRMicroelectronicsConfidential30/322–MCU,watchdog,Timer工作,系统进入DeepSleep模式并由set_b唤醒3–每隔15s进入DeepSleep模式:error代码.
示例AT+CMCU=0OK注意事项5.
2.
45低功耗测试命令+CSTDBY表格55+CSTDBY命令类型命令格式响应测试命令AT+CSTDBY=+CRXC=OK执行命令AT+CSTDBY=OK或者+CMEERROR:参数说明该命令执行使SX1262进入standbymode,MCU进入DeepSleep状态,并由UART唤醒0–代表STDBY_RC模式1–代表STDBY_XOSC模式:error代码.
返回值说明示例AT+CSTDBY=0deepsleepwaitforuart.
.
.
注意事项5.
2.
46测试命令+CRXS表格56+CRXS命令类型命令格式响应测试命令AT+CRXS=+CRXS:"Frequency","DataRate","CodeRate","ldo"OK执行命令AT+CRXS=,,,OK或者+CMEERROR:参数说明该命令主要用于灵敏度测试Freq:150000000-960000000Data_rate共有6个级别,分别是DR0~DR5,对应展频因子SF12~SF7.
Code_rate:1-4,其中1对应4/5,2对应4/6,3对应4/7,4对应4/8ldo:1:开启低速率优化,0:关闭低速率优化:error代码.
返回值说明示例AT+CRXS=470000000,0,1,0starttorecvpackage(freq:470000000,dr:0,cr:1,ldo:0)ASRMicroelectronicsConfidential31/325.
2.
47测试命令+CRX表格57+CRX命令类型命令格式响应测试命令AT+CRX=+CRX:"Frequency","DataRate"OK执行命令AT+CRX=,OK或者+CMEERROR:参数说明该命令执行进入RX持续接收模式操作Freq:150000000-960000000Data_rate共有6个级别,分别是DR0~DR5,对应展频因子SF12~SF7.
:error代码.
返回值说明示例AT+CRX=470000000,0starttorecvpackage(freq:470000000,dr:0)注意事项键入CRX测试命令,为保持测试,系统进入死循环,重启开启下一次测试.
5.
2.
48测试命令+CTX表格58+CTX命令类型命令格式响应测试命令AT+CTX=+CTX:"Frequency","DataRate","TxPower","TxLen"OK执行命令AT+CTX=,,,OK或者+CMEERROR:参数说明该命令执行进入定时1S循环发送模式Freq:150000000-960000000Data_rate共有6个级别,分别是DR0~DR5,对应展频因子SF12~SF7.
pwr是SX1262的发射功率,分别是0~22.
len是发送报文长度.
:error代码.
返回值说明示例AT+CTX=470000000,0,22,5starttotxdata(freq:470000000,dr:0,power:22):1注意事项键入CTX测试命令,为保持测试,系统进入死循环,重启开启下一次测试.
5.
2.
49测试命令+CTXCW表格59+CTXCW命令类型命令格式响应测试命令AT+CTXCW=+CTXCW:"Frequency","TxPower","PaOpt"OK执行命令AT+CTXCW=,,OK或者ASRMicroelectronicsConfidential32/32+CMEERROR:参数说明该命令执行进入TX持续发送模式操作Freq:150000000-960000000pwr是SX1262的发射功率,分别是0~22.
opt是SX1262的PAOptimalsetting,取值0-3,默认值为0.
对应关系如下:0:[0x04,0x07,0x00,0x01],1:[0x03,0x05,0x00,0x01],2:[0x02,0x03,0x00,0x01],3:[0x02,0x02,0x00,0x01].
具体可参考sx1262数据手册"PAOptimalSettings"部分:error代码.
返回值说明示例AT+CTXCW=470000000,22Starttotxcw(freq:470000000,power:22db,opt:0)AT+CTXCW=470000000,22,2Starttotxcw(freq:470000000,power:22db,opt:2)注意事项键入CTXCW测试命令,为保持测试,系统进入死循环,重启开启下一次测试.