2024年2月24日发(作者:漆若翠)
V1.0
LoRa模块RAK811 LoRa模块AT命令手册
注:本文档适用于固件版本为V3.0.0.13.T3及以上。
V1.0
V1.0
目录
LoRa模块RAK811 LoRa模块AT命令手册 ....................................................................... 1
1 概述 ............................................................................................................................... 5
1.1 AT命令接口 ....................................................................................................... 5
1.2 AT命令语法 ....................................................................................................... 5
1.3 EEROR CODE表 .............................................................................................. 6
2 通用类AT ...................................................................................................................... 9
2.1 at+version .......................................................................................................... 9
2.2 at+help ............................................................................................................... 9
2.3 at+set_config=device:restart ........................................................................... 11
2.4 at+set_config=device:boot .............................................................................. 11
2.5 at+run ............................................................................................................... 12
2.6 at+set_config=device:sleep:
2.7 at+get_config=device:status ............................................................................ 13
3 接口类AT .................................................................................................................... 14
3.1 at+set_config=device:uart:
3.2 at+set_config=device:uart_mode:
3.3 at+send=uart:
3.4 at+get_config=device:gpio:
3.5 at+set_config=device:gpio:
3.6 at+get_config=device:adc:
4 LoRa类AT ................................................................................................................. 18
4.1 at+join .............................................................................................................. 18
4.2 at+send=lora:
4.3 at+set_config=lora:region:
4.4 at+get_config=lora:channel ............................................................................. 20
4.5 at+set_config=lora:ch_mask:
4.6 at+set_config=lora:dev_eui:
4.7 at+set_config=lora:app_eui:
4.8 at+set_config=lora:app_key:
4.9 at+set_config=lora:dev_addr:
4.10 at+set_config=lora:apps_key:
4.11 at+set_config=lora:nwks_key:
4.12 at+set_config=lora:join_mode:
4.13 at+set_config=lora:work_mode:
4.14 at+set_config=lora:class:
4.15 at+set_config=lora:confirm:
4.16 at+set_config=lora:dr:
4.17 at+set_config=lora:tx_power:
4.18 at+set_config=lora:adr:
4.19 at+get_config=lora:status ................................................................................ 28
4.20 at+set_config=lorap2p:
4.21 at+set_config=lorap2p:transfer_mode:
4.22 at+send=lorap2p: ................................................................................. 30
5 附录一 :各Region的DataRate列表 ...................................................................... 31
5.1 EU868/EU433/AS923 ...................................................................................... 31
5.2 31
5.3 US915 .............................................................................................................. 31
5.4 AU915 .............................................................................................................. 32
5.5 IN865 ............................................................................................................... 32
6 附录二 :各Region的TX power列表 ...................................................................... 33
6.1 EU868 .............................................................................................................. 33
6.2 US915 .............................................................................................................. 33
6.3 AU915 .............................................................................................................. 33
V1.0
7
8
6.4 KR920 .............................................................................................................. 34
6.5 AS923 .............................................................................................................. 34
6.6 IN865 ............................................................................................................... 34
6.7 CN470 .............................................................................................................. 35
6.8 EU433 .............................................................................................................. 35
附录三 :各Region的最大发送负载列表 .................................................................. 37
7.1 EU868 .............................................................................................................. 37
7.2 US915 .............................................................................................................. 37
7.3 AU915 .............................................................................................................. 38
7.4 KR920 .............................................................................................................. 38
7.5 AS923 .............................................................................................................. 39
7.6 IN865 ............................................................................................................... 39
7.7 CN470 .............................................................................................................. 39
7.8 EU433 .............................................................................................................. 40
附录四:LoRa模块RAK811模块的管脚说明 ............................................................ 41
V1.0
1 概述
1.1 AT命令接口
LoRa模块RAK811的AT命令接口为UART1。波特率默认为115200,数据位8比特,停止位1比特,无校验。
LoRa模块RAK811可用的UART为UART1和UART3,其中UART1为模块上的PIN6(TX1)和PIN7(RX1),UART3(默认波特率为9600)为模块上的PIN25(TX3)和PIN26(RX3),详细的模块管脚定义,请查看本文中的附录四。
1.2 AT命令语法
指令输入:
AT指令字符串长度最大限制为255个字符(包括”rn”)。
命令必须以 “at” 开头, 以
AT命令根据操作方式可分为:
读指令 – 读取设备的配置或状态,一般格式为:at+get_config=
写指令 – 写入/修改设备配置,一般格式为:at+set_config=
其它指令 - 还有一些指令,既不是读指令,也不是写指令,如LoRa发送数据的指令为at+send=lora:
V1.0
特殊指令 – 有一个指令比较特殊:UART有两种模式,AT配置模式和透传模式。从透传模式切换为AT配置模式时,需要输入的指令是”+++”,且不包含”rn”的结束符。
指令应答:
指令应答格式通常为
① 指令配置成功时:
OK [information]rn
都以“OK ”开头,读指令会有information为获取的信息说明,写指令没有information信息。
一些特殊指令会触发module重启,比如“at+set_config=device:restart”,这些特殊的指令在具体的AT指令介绍中会有说明,此类指令以“Initialization OK rn”结束,格式如下:
[information]rn
Initialization OK rn
② 指令配置不成功时:
ERROR:
都以“ERROR:”开头,后跟error code,详见下一章节《ERROR CODE表》。
1.3 EEROR CODE表
code> 1 含义 This is an unsupported AT command. 不支持此AT命令 2 There is an invalid parameter in AT command. AT命令中包含无效的参数或参数格式不对 3 There is an error when reading or writing flash. 读/写flash出错 4 There is an error when reading or writing through IIC. V1.0 读/写IIC出错 5 There is an error when sending through UART. 通过UART发送数据出错 41 The BLE works in an invalid state, so that it can’t be operated. BLE当前工作在无效状态,无法操作。 80 The LoRa is busy, so that it can’t do more things now. LoRa网络正忙,无法进行其它操作。 81 LoRa service is unknown. LoRa服务出现未知错误 82 The LoRa parameters are invalid. LoRa参数无效 83 The LoRa frequency is invalid. LoRa频段无效 84 The LoRa datarate(DR) is invalid. LoRa DR无效 85 The LoRa frequency and datarate are invalid. LoRa 频段和DR均无效 86 The device hasn’t joined a LoRa network. 该设备尚未加入LoRa网络 87 The length of the packet is too long, so that it can’t be sent out over LoRa. 数据包长度过长,无法通过LoRa发送。 88 Service is closed by server. 服务已被Server远程关闭。 89 This is an unsupported region. 不支持该region。 90 duty cycle is restricted 由于Duty cycle的限制,当前不能使用网络。 91 92 There is no valid channel can be found. no free channel found V1.0 没有空闲的通道(只在AS923和KR920存在) 93 status is error 请求网络未按照规则执行完成就会返回该error. 94 LoRa transmiting timeout. LoRa传输超时 95 LoRa receiving in RX1 timeout. LoRa的RX1接收超时 96 LoRa receiving in RX2 timeout. LoRa的RX2接收超时 97 There is an error when receiving in RX1. RX1接收时发生错误 98 There is an error when receiving in RX2. RX2接收时发生错误 99 LoRa join failed. LoRa入网失败 100 downlink repeated 下行计数器重复,下发的数据存疑,服务器和节点靠两个计数器同步,这个下行计数器异常,说明网络处理有异常。 A frame with an invalid downlink counter was received. The downlink counter of the frame was equal to the local copy of the downlink counter of the node 101 payload size error with transmit DR. 当前的负载大小与当前的DR设定不匹配。 102 There are too many downlink frames lost. 丢失的下行数据过多 103 address fail 收到数据了,但是校验地址不对,不是给这个设备的数据. 104 There is an error when verifying the MIC. MIC校验出错 V1.0 2 通用类AT 2.1 at+version 本指令用于读取当前固件的版本号。(如果在boot模式下使用,则用于读取当前bootloader的版本号) 操作 读 参数:无 Example: at+versionrn OK V3.0.0.13.H.T2 指令 at+version 应答 OK <版本号> 2.2 at+help 本指令用户获取当前固件所支持的所有AT命令。 操作 读 参数:无 Example: at+helprn OK Device AT commands: 指令 at+help 应答 OK V1.0 at+version at+help at+run at+set_config=device:restart at+set_config=device:sleep:X at+set_config=device:boot at+get_config=device:status at+set_config=device:uart:X:Y at+set_config=device:uart_mode:X:Y at+send=uart:X:YYY at+set_config=device:gpio:X:Y at+get_config=device:gpio:X at+get_config=device:adc:X LoRaWAM AT commands: at+join at+send=lora:X:YYY at+set_config=lora:region:XXX at+get_config=lora:channel at+set_config=lora:dev_eui:XXXX at+set_config=lora:app_eui:XXXX at+set_config=lora:app_key:XXXX at+set_config=lora:dev_addr:XXXX at+set_config=lora:apps_key:XXXX at+set_config=lora:nwks_key:XXXX at+set_config=lora:join_mode:X at+set_config=lora:work_mode:X at+set_config=lora:ch_mask:X:Y at+set_config=lora:class:X at+set_config=lora:confirm:X at+set_config=lora:dr:X at+set_config=lora:tx_power:X at+set_config=lora:adr:X at+set_config=lora:send_interval:X:Y at+get_config=lora:status LoRaP2P AT commands: at+set_config=lorap2p:XXX:Y:Z:A:B:C at+set_config=lorap2p:transfer_mode:X at+send=lorap2p:XXX V1.0 2.3 at+set_config=device:restart 本指令用于重启设备。 操作 写 参数:无 Example at+set_config=device:restartrn UART1 work mode: RUI_UART_NORAMAL Current work_mode:LoRaWAN, join_mode:ABP, Class: A Initialization OK 指令 应答 at+set_config=device:restart 2.4 at+set_config=device:boot 本指令用于强制模块进入BOOT模式。 注:BOOT模式下,串口波特率为固定的115200,且不可更改。 操作 写 参数:无 Example: at+set_config=device:bootrn OK 指令 at+set_config=device:boot 应答 OK V1.0 2.5 at+run 本指令用于强制设备退出boot模式,进入正常运行模式。仅在boot模式下有效,该指令会引起模块重启。 操作 参数:无 Example: at+runrn Stop Boot Mode UART1 work mode: RUI_UART_NORAMAL Current work_mode:LoRaWAN, join_mode:ABP, Class: A Initialization OK 指令 at+run 应答 2.6 at+set_config=device:sleep: 本指令用于使设备休眠或唤醒。 操作 写 参数: status 0: wake up 1: sleep 指令 应答 at+set_config=device:sleep: Example at+set_config=device:sleep:1rn OK Sleep at+set_config=device:sleep:0rn OK Wake Up V1.0 2.7 at+get_config=device:status 本指令用于获取设备当前的状态。 操作 读 参数:无 Example: at+get_config=device:statusrn OK Board Core:LoRa模块RAK811 MCU:STM32L151CB_A LoRa chip:SX1276 指令 应答 at+get_config=device:status OK V1.0 3 接口类AT 3.1 at+set_config=device:uart: 本指令用于配置某个UART的波特率。 操作 写 参数: index baud_rate UART编号 UART波特率:1200,2400,4800,9600,19200,38400,57600,115200 Example: at+set_config=device:uart:1:115200rn OK 指令 应答 at+set_config=device:uart: 3.2 at+set_config=device:uart_mode: 本指令用于设置UART的工作模式为AT配置模式或数据透传模式。 操作 写 参数: index UART编号。LoRa模块RAK811目前只支持UART1。 指令 应答 at+set_config=device:uart_mode: V1.0 mode UART模式:只能取值为1,意思是将该UART设置为数据透传模式。 注:如果要从数据透传模式,变为AT配置模式,则使用“+++”即可(+++后面不用带rn)。 Example: at+set_config=device:uart_mode:1:1rn OK +++ OK 3.3 at+send=uart: 本指令用于通过某个UART发送数据。 操作 写 参数: index data UART编号 发送的数据。最大为255个字符,包括指令字符”at+…”和尾部的”rn”在内。 Example: at+send=uart:3:12345rn OK 指令 应答 at+set_config=device:uart: V1.0 3.4 at+get_config=device:gpio: 本指令用于获取模块上某个管脚的电平状态。 操作 读 参数: pin_num 模块的管脚索引号 0: 低电平 1: 高电平 Example: at+get_config=device:gpio:2rn OK 1 指令 应答 at+get_config=device:gpio: status(返回值) 3.5 at+set_config=device:gpio: 本指令用于设置模块上某个管脚的电平状态为高或低。 操作 写 参数: pin_num status 模块的管脚索引号 0: 低电平 1: 高电平 Example: at+set_config=device:gpio:2:0rn 指令 应答 at+set_config=device:gpio: V1.0 OK 3.6 at+get_config=device:adc: 本指令用于获取模块上某个adc管脚的电压。 操作 读 参数: pin_num 模块上adc管脚的编号 电压值,单位mV 指令 应答 at+get_config=device:adc: Voltage(返回值) Example: at+get_config=device:adc:2rn OK 1663mV V1.0 4 LoRa类AT 4.1 at+join 该指令用于加入LoRaWAN网络。 操作 参数:无 Example: at+joinrn OK Join Success 指令 at+join 应答 OK Join Success 4.2 at+send=lora: 该指令用于通过LoRaWAN发送数据。 操作 参数: port data LoRa的发送端口 要发送的数据。十六进制双字符格式。 最大发送长度会因频段和DR的不同而有所区别(LoRaWAN标准规范),详细请参考指令 应答 at+send=lora: V1.0 本文附录三。 Example: 发送数据为非确认包(unconfirm)类型时: at+send=lora:1:5A00rn OK 发送数据为确认包(confirm)类型时: at+send=lora:1:5A00rn OK at+recv=0,-105,-12,0 注:发送confirm包时,会收到ACK回应,即上面的”at+recv=…”。“0,-105,-12,0”中,”0”代表LoRa的端口,“-105”代表RSSI,“-12”代表SNR,“0”代表数据长度(ACK中无有效数据)。 4.3 at+set_config=lora:region: 该指令用于设置相应的工作频段。 操作 写 参数: region Example: at+set_config=lora:region:EU868rn OK EU433, CN470, IN865, EU868, US915, AU915, KR920, AS923. 指令 应答 at+set_config=lora:region: V1.0 4.4 at+get_config=lora:channel 该指令用于读取设备当前region的所有LoRa信道信息。 操作 读 参数:无 Example (EU868 region): at+get_config=lora:channelrn OK *0,on,868100000,0,5; *1,on,868300000,0,5; *2,on,868500000,0,5; 3,off,0,0,0; 4,off,0,0,0; 5,off,0,0,0; 6,off,0,0,0; 7,off,0,0,0; *8,on,867100000,0,5; *9,on,867300000,0,5; *10,on,867500000,0,5; *11,on,867700000,0,5; *12,on,867900000,0,5; 13,off,0,0,0; 14,off,0,0,0; 15,off,0,0,0 注: 以“*0,on,868100000,0,5”为例,通道参数解析: “*” 如果该channel处于打开状态,前面会有该标识; ”0” 是channel的编号; ”on” 代表该channel目前处于打开状态; “868100000” 是该channel的实际频率,单位Hz; “0,5” 代表该channel的DR范围为DR0~DR5. 指令 AT+BAUDRATE 应答 OK V1.0 4.5 at+set_config=lora:ch_mask: 该指令用于设置当前region的某个channel为打开或关闭状态。 操作 指令 写 参数: channel_number status at+set_config=lora:ch_mask:0:0rn OK Channel的编号 0: off 1: on 应答 at+set_config=lora:ch_mask: 4.6 at+set_config=lora:dev_eui: 该指令用于设置LoRaWAN OTAA模式的参数Device EUI。 操作 写 参数: dev_eui Example: at+set_config=lora:dev_eui:3536rn OK Device EUI. 指令 应答 at+set_config=lora:dev_eui: V1.0 4.7 at+set_config=lora:app_eui: 该指令用于设置LoRaWAN OTAA模式的参数Application EUI。 操作 写 参数: app_eui Example: at+set_config=lora:app_eui:0001rn OK Application EUI. 指令 应答 at+set_config=lora:app_eui: 4.8 at+set_config=lora:app_key: 该指令用于设置LoRaWAN OTAA模式的参数Application Key。 操作 写 参数: app_key Application Key. 指令 应答 at+set_config=lora:app_key: Example: at+set_config=lora:app_key:841986913ACD00BBC2BE2479D70F3228rn OK V1.0 4.9 at+set_config=lora:dev_addr: 该指令用于设置LoRaWAN ABP模式的参数Device Address。 操作 写 参数: dev_addr Device Address. 指令 应答 at+set_config=lora:dev_addr: Example: at+set_config=lora:dev_addr:260125D7rn OK 4.10 at+set_config=lora:apps_key: 该指令用于设置LoRaWAN ABP模式的参数Application Session Key。 操作 写 参数: apps_key Application Session Key. 指令 应答 at+set_config=lora:apps_key: Example: at+set_config=lora:apps_key:841986913ACD00BBC2BE2479D70F3228rn OK 4.11 at+set_config=lora:nwks_key: 该指令用于设置LoRaWAN ABP模式的参数Network Session Key。 V1.0 操作 读 参数: nwks_key Network Session Key. 指令 应答 at+set_config=lora:nwks_key: Example: at+set_config=lora:nwks_key:69AF20AEA26C01B243945A28C9172B42rn OK 4.12 at+set_config=lora:join_mode: 该指令用于设置LoRaWAN的入网模式为OTAA或ABP。 操作 写 参数: mode 入网模式。 0: OTAA 1: ABP Example: at+set_config=lora:join_mode:1rn OK 指令 应答 at+set_config=lora:join_mode: 4.13 at+set_config=lora:work_mode: 该指令用于设置LoRa的工作模式为LoRaWAN或LoRaP2P。此指令会引起模块重启。 V1.0 操作 写 参数: mode 指令 应答 at+set_config=lora:work_mode: LoRa工作模式 0: LoRaWAN 1: LoRaP2P Example: at+set_config=lora:work_mode:1rn UART1 work mode: RUI_UART_NORAMAL Current work_mode:P2P Initialization OK 4.14 at+set_config=lora:class: 该指令用于设置LoRaWAN的Class为Class A、Class B、或Class C。 操作 写 参数: class 0: Class A 1: Class B (暂不支持) 2: Class C Example: at+set_config=lora:class:0rn OK 指令 应答 at+set_config=lora:class: V1.0 4.15 at+set_config=lora:confirm: 该指令用于设置发送数据的类型为确认包(confirm)还是非确认包(unconfirm)。 操作 写 参数: type 0: 非确认包(unconfirm) 1: 确认包(confirm) 2: 广播(multicast) 3. 自定义(proprietary) Example: at+set_config=lora:confirm:0rn OK 指令 应答 at+set_config=lora:confirm: 4.16 at+set_config=lora:dr: 该指令用于设置LoRa的data rate(DR)。 操作 写 参数: dr LoRa的data rate, 取值范围与当前的region有关,大多数LoRa的region中,常指令 应答 at+set_config=lora:dr: V1.0 用的都是0~5。详细的可参考LoRaWAN 1.0.2的规范。 4.17 at+set_config=lora:tx_power: 该指令用于设置LoRa的发射功率等级。 操作 写 参数: tx_power LoRa的发射功率等级(level),会因频段、DR的不同而有所区别。详细的请参考LoRaWAN 1.0.2规范或本文附录二。 Example: at+set_config=lora:tx_power:0rn OK 指令 应答 at+set_config=lora:tx_power: 4.18 at+set_config=lora:adr: 该指令用于设置LoRa的ADR为打开或关闭状态。 操作 写 参数: 指令 应答 at+set_config=lora:adr: V1.0 status 0: 关闭 1: 打开 Example: at+set_config=lora:adr:0rn OK 4.19 at+get_config=lora:status 该指令用于获取当前所有的LoRa状态信息(channel信息除外)。 操作 读 参数:无 Example: at+get_config=lora:statusrn OK Work Mode: LoRaWAN Region: EU868 Send_interval: 600s Auto send status: false. Join_mode: ABP DevAddr: 260125D7 AppsKey: 841986913ACD00BBC2BE2479D70F3228 NwksKey: 69AF20AEA26C01B243945A28C9172B42 Class: A Joined Network:true IsConfirm: false AdrEnable: true EnableRepeaterSupport: false RX2_CHANNEL_FREQUENCY: 869525000, RX2_CHANNEL_DR:0 RX_WINDOW_DURATION: 3000ms RECEIVE_DELAY_1: 1000ms RECEIVE_DELAY_2: 2000ms JOIN_ACCEPT_DELAY_1: 5000ms 指令 at+set_config=lora:status 应答 OK V1.0 JOIN_ACCEPT_DELAY_2: 6000ms Current Datarate: 4 Primeval Datarate: 4 ChannelsTxPower: 0 UpLinkCounter: 1 DownLinkCounter: 0 4.20 at+set_config=lorap2p: 该指令用于设置LoRaP2P的相关参数,仅在LoRa的工作模式为LoRaP2P时有效。 操指令 作 写 参数: frequency spreadfact bandwidth Frequency, the unit is Hz Spreading factor 0: 125KHz 1: 250KHz 2: 500KHz 1: 4/5 2: 4/6 3: 4/7 4: 4/8 Preamble Length. 5~65535 TX power. The unit is dbm. 5~20 at+set_config=lorap2p: OK 应答 codeingrate preamlen power Example: at+set_config=lorap2p:869525000:12:0:1:8:20rn OK V1.0 4.21 at+set_config=lorap2p:transfer_mode: 该指令用于设置LoRaP2P的模式为发送端或接收端,仅在LoRa的工作模式为LoRaP2P时有效。 操指令 作 写 at+set_config=lorap2p: transfer_mode: 应答 参数: mode 1: receiver mode 2: sender mode Example: at+set_config=lorap2p:transfer_mode:1rn OK 4.22 at+send=lorap2p: 该指令用于通过LoRaP2P发送数据,仅在LoRa的工作模式为LoRaP2P时有效。 操作 发送 参数: data 要发送的数据。十六进制格式 指令 at+send=lorap2p: 应答 OK Example: at+send=lorap2p:1234rn OK 注:LoRaP2P模式的接收端接收到的数据格式为: at+recv= V1.0 5 附录一 :各Region的DataRate列表 5.1 EU868/EU433/AS923 DataRate 0 1 2 3 4 5 6 7 8 …15 Configuration LoRa: SF12 / 125kHz LoRa: SF11 / 125kHz LoRa: SF10 / 125kHz LoRa: SF9 / 125kHz LoRa: SF8 / 125kHz LoRa: SF7 / 125kHz LoRa: SF7 / 250kHz FSK: 50kbps RFU Indicative physical bit rate [bit/s] 250 440 980 1760 3125 5470 11000 50000 5.2 CN470/KR920 DataRate 0 1 2 3 4 5 6…15 Configuration LoRa: SF12 / 125kHz LoRa: SF11 / 125kHz LoRa: SF10 / 125kHz LoRa: SF9 / 125kHz LoRa: SF8 / 125kHz LoRa: SF7 / 125kHz RFU Indicative physical bit rate [bit/s] 250 440 980 1760 3125 5470 5.3 US915 DataRate 0 1 2 3 4 Configuration LoRa: SF10 / 125kHz LoRa: SF9 / 125kHz LoRa: SF8 / 125kHz LoRa: SF7 / 125kHz LoRa: SF8 / 500kHz Indicative physical bit rate [bit/s] 980 1760 3125 5470 12500 V1.0 5…7 8 9 10 11 12 13 14…15 RFU LoRa: SF12/500kHz LoRa: SF11/500kHz LoRa: SF10/500kHz LoRa: SF9/500kHz LoRa: SF8/500kHz LoRa: SF7/500kHz RFU 980 1760 3900 7000 12500 21900 5.4 AU915 DataRate 0 1 2 3 4 5 6 7 8 9 10 11 12 Configuration LoRa: SF12 / 125kHz LoRa: SF11 / 125kHz LoRa: SF10 / 125kHz LoRa: SF9 / 125kHz LoRa: SF8 / 125kHz LoRa: SF7 / 125kHz LoRa: SF8/500kHz RFU LoRa: SF12/500kHz LoRa: SF11/500kHz LoRa: SF10/500kHz LoRa: SF9/500kHz LoRa: SF8/500kHz Indicative physical bit rate [bit/s] 250 440 980 1760 3125 5470 12500 RFU 980 1760 3900 7000 12500 5.5 IN865 DataRate 0 1 2 3 4 5 6 7 8 …15 Configuration LoRa: SF12 / 125kHz LoRa: SF11 / 125kHz LoRa: SF10 / 125kHz LoRa: SF9 / 125kHz LoRa: SF8 / 125kHz LoRa: SF7 / 125kHz RFU FSK: 50kbps RFU Indicative physical bit rate [bit/s] 250 440 980 1760 3125 5470 RFU 50000 RFU V1.0 6 附录二 :各Region的TX power列表 6.1 EU868 By default MaxEIRP is considered to be +16dBm. 6.2 US915 6.3 AU915 By default MaxEIRP is considered to be +30dBm. V1.0 6.4 KR920 By default MaxEIRP is considered to be +14dBm. 6.5 AS923 By default Max EIRP shall be 16dBm. 6.6 IN865 By default MaxEIRP is considered to be 30dBm. V1.0 6.7 CN470 By default MaxEIRP is considered to be +19.15dBm. 6.8 EU433 By default MAxEIRP is considered to be +12.15dBm. V1.0 V1.0 7 附录三 :各Region的最大发送负载列表 注:下列表中的M是带MAC头的长度,N为不带MAC头的长度,发送的最大数据长度以N为准。 7.1 EU868 7.2 US915 V1.0 7.3 AU915 7.4 KR920 V1.0 7.5 AS923 7.6 IN865 7.7 CN470 V1.0 7.8 EU433 V1.0 8 附录四:LoRa模块RAK811模块的管脚说明 这里对RAK811模块的部分管脚做一些说明(全部管脚的定义,需查看RAK瑞科慧联提供的产品文档): 1) 关于UART管脚。Pin6(TX1)、Pin7(RX1)为UART1,Pin25(TX3)、Pin26(RX3)为UART3,这四个引脚默认都被配置成了推挽输出,接上拉电阻,因此这四个引脚上电时为高电平; 2) 关于JTAG调试管脚。Pin10、Pin13用于JTAG调试口,上电默认配置为推挽输出,未接上下拉电阻,上电这两个引脚为高阻态。 3) 关于电源管脚。LoRa模块RAK811模块上的电源管脚包括:VCC/GND,Pin1、Pin11、Pin12、Pin21、Pin28、Pin29、Pin30、Pin31、Pin32、Pin34。 4) 关于复位(reset)管脚。LoRa模块RAK811模块上的复位管脚为PIN24; 5) 关于BOOT管脚。LoRa模块RAK811模块上的BOOT0管脚为PIN17; 6) 关于射频天线管脚。LoRa模块RAK811模块上的射频天线管脚为PIN33; 7) 关于ADC管脚。LoRa模块RAK811的高、低频模块上的ADC管脚有所不同,低频模块可作为ADC的引脚有:Pin2、Pin3、Pin4、Pin5、Pin15、Pin20、Pin22、Pin23。高频模块可作为ADC的引脚有:Pin2、Pin3、Pin4、Pin20、Pin22、Pin23; 8) 关于GPIO。LoRa模块RAK811模块上可做GPIO的引脚有:Pin2、Pin3、Pin4、Pin5、Pin8、Pin9、Pin14、Pin15、Pin16、Pin18、Pin19、Pin20、Pin22、Pin23、Pin25、Pin26、Pin27。
2024年2月24日发(作者:漆若翠)
V1.0
LoRa模块RAK811 LoRa模块AT命令手册
注:本文档适用于固件版本为V3.0.0.13.T3及以上。
V1.0
V1.0
目录
LoRa模块RAK811 LoRa模块AT命令手册 ....................................................................... 1
1 概述 ............................................................................................................................... 5
1.1 AT命令接口 ....................................................................................................... 5
1.2 AT命令语法 ....................................................................................................... 5
1.3 EEROR CODE表 .............................................................................................. 6
2 通用类AT ...................................................................................................................... 9
2.1 at+version .......................................................................................................... 9
2.2 at+help ............................................................................................................... 9
2.3 at+set_config=device:restart ........................................................................... 11
2.4 at+set_config=device:boot .............................................................................. 11
2.5 at+run ............................................................................................................... 12
2.6 at+set_config=device:sleep:
2.7 at+get_config=device:status ............................................................................ 13
3 接口类AT .................................................................................................................... 14
3.1 at+set_config=device:uart:
3.2 at+set_config=device:uart_mode:
3.3 at+send=uart:
3.4 at+get_config=device:gpio:
3.5 at+set_config=device:gpio:
3.6 at+get_config=device:adc:
4 LoRa类AT ................................................................................................................. 18
4.1 at+join .............................................................................................................. 18
4.2 at+send=lora:
4.3 at+set_config=lora:region:
4.4 at+get_config=lora:channel ............................................................................. 20
4.5 at+set_config=lora:ch_mask:
4.6 at+set_config=lora:dev_eui:
4.7 at+set_config=lora:app_eui:
4.8 at+set_config=lora:app_key:
4.9 at+set_config=lora:dev_addr:
4.10 at+set_config=lora:apps_key:
4.11 at+set_config=lora:nwks_key:
4.12 at+set_config=lora:join_mode:
4.13 at+set_config=lora:work_mode:
4.14 at+set_config=lora:class:
4.15 at+set_config=lora:confirm:
4.16 at+set_config=lora:dr:
4.17 at+set_config=lora:tx_power:
4.18 at+set_config=lora:adr:
4.19 at+get_config=lora:status ................................................................................ 28
4.20 at+set_config=lorap2p:
4.21 at+set_config=lorap2p:transfer_mode:
4.22 at+send=lorap2p: ................................................................................. 30
5 附录一 :各Region的DataRate列表 ...................................................................... 31
5.1 EU868/EU433/AS923 ...................................................................................... 31
5.2 31
5.3 US915 .............................................................................................................. 31
5.4 AU915 .............................................................................................................. 32
5.5 IN865 ............................................................................................................... 32
6 附录二 :各Region的TX power列表 ...................................................................... 33
6.1 EU868 .............................................................................................................. 33
6.2 US915 .............................................................................................................. 33
6.3 AU915 .............................................................................................................. 33
V1.0
7
8
6.4 KR920 .............................................................................................................. 34
6.5 AS923 .............................................................................................................. 34
6.6 IN865 ............................................................................................................... 34
6.7 CN470 .............................................................................................................. 35
6.8 EU433 .............................................................................................................. 35
附录三 :各Region的最大发送负载列表 .................................................................. 37
7.1 EU868 .............................................................................................................. 37
7.2 US915 .............................................................................................................. 37
7.3 AU915 .............................................................................................................. 38
7.4 KR920 .............................................................................................................. 38
7.5 AS923 .............................................................................................................. 39
7.6 IN865 ............................................................................................................... 39
7.7 CN470 .............................................................................................................. 39
7.8 EU433 .............................................................................................................. 40
附录四:LoRa模块RAK811模块的管脚说明 ............................................................ 41
V1.0
1 概述
1.1 AT命令接口
LoRa模块RAK811的AT命令接口为UART1。波特率默认为115200,数据位8比特,停止位1比特,无校验。
LoRa模块RAK811可用的UART为UART1和UART3,其中UART1为模块上的PIN6(TX1)和PIN7(RX1),UART3(默认波特率为9600)为模块上的PIN25(TX3)和PIN26(RX3),详细的模块管脚定义,请查看本文中的附录四。
1.2 AT命令语法
指令输入:
AT指令字符串长度最大限制为255个字符(包括”rn”)。
命令必须以 “at” 开头, 以
AT命令根据操作方式可分为:
读指令 – 读取设备的配置或状态,一般格式为:at+get_config=
写指令 – 写入/修改设备配置,一般格式为:at+set_config=
其它指令 - 还有一些指令,既不是读指令,也不是写指令,如LoRa发送数据的指令为at+send=lora:
V1.0
特殊指令 – 有一个指令比较特殊:UART有两种模式,AT配置模式和透传模式。从透传模式切换为AT配置模式时,需要输入的指令是”+++”,且不包含”rn”的结束符。
指令应答:
指令应答格式通常为
① 指令配置成功时:
OK [information]rn
都以“OK ”开头,读指令会有information为获取的信息说明,写指令没有information信息。
一些特殊指令会触发module重启,比如“at+set_config=device:restart”,这些特殊的指令在具体的AT指令介绍中会有说明,此类指令以“Initialization OK rn”结束,格式如下:
[information]rn
Initialization OK rn
② 指令配置不成功时:
ERROR:
都以“ERROR:”开头,后跟error code,详见下一章节《ERROR CODE表》。
1.3 EEROR CODE表
code> 1 含义 This is an unsupported AT command. 不支持此AT命令 2 There is an invalid parameter in AT command. AT命令中包含无效的参数或参数格式不对 3 There is an error when reading or writing flash. 读/写flash出错 4 There is an error when reading or writing through IIC. V1.0 读/写IIC出错 5 There is an error when sending through UART. 通过UART发送数据出错 41 The BLE works in an invalid state, so that it can’t be operated. BLE当前工作在无效状态,无法操作。 80 The LoRa is busy, so that it can’t do more things now. LoRa网络正忙,无法进行其它操作。 81 LoRa service is unknown. LoRa服务出现未知错误 82 The LoRa parameters are invalid. LoRa参数无效 83 The LoRa frequency is invalid. LoRa频段无效 84 The LoRa datarate(DR) is invalid. LoRa DR无效 85 The LoRa frequency and datarate are invalid. LoRa 频段和DR均无效 86 The device hasn’t joined a LoRa network. 该设备尚未加入LoRa网络 87 The length of the packet is too long, so that it can’t be sent out over LoRa. 数据包长度过长,无法通过LoRa发送。 88 Service is closed by server. 服务已被Server远程关闭。 89 This is an unsupported region. 不支持该region。 90 duty cycle is restricted 由于Duty cycle的限制,当前不能使用网络。 91 92 There is no valid channel can be found. no free channel found V1.0 没有空闲的通道(只在AS923和KR920存在) 93 status is error 请求网络未按照规则执行完成就会返回该error. 94 LoRa transmiting timeout. LoRa传输超时 95 LoRa receiving in RX1 timeout. LoRa的RX1接收超时 96 LoRa receiving in RX2 timeout. LoRa的RX2接收超时 97 There is an error when receiving in RX1. RX1接收时发生错误 98 There is an error when receiving in RX2. RX2接收时发生错误 99 LoRa join failed. LoRa入网失败 100 downlink repeated 下行计数器重复,下发的数据存疑,服务器和节点靠两个计数器同步,这个下行计数器异常,说明网络处理有异常。 A frame with an invalid downlink counter was received. The downlink counter of the frame was equal to the local copy of the downlink counter of the node 101 payload size error with transmit DR. 当前的负载大小与当前的DR设定不匹配。 102 There are too many downlink frames lost. 丢失的下行数据过多 103 address fail 收到数据了,但是校验地址不对,不是给这个设备的数据. 104 There is an error when verifying the MIC. MIC校验出错 V1.0 2 通用类AT 2.1 at+version 本指令用于读取当前固件的版本号。(如果在boot模式下使用,则用于读取当前bootloader的版本号) 操作 读 参数:无 Example: at+versionrn OK V3.0.0.13.H.T2 指令 at+version 应答 OK <版本号> 2.2 at+help 本指令用户获取当前固件所支持的所有AT命令。 操作 读 参数:无 Example: at+helprn OK Device AT commands: 指令 at+help 应答 OK V1.0 at+version at+help at+run at+set_config=device:restart at+set_config=device:sleep:X at+set_config=device:boot at+get_config=device:status at+set_config=device:uart:X:Y at+set_config=device:uart_mode:X:Y at+send=uart:X:YYY at+set_config=device:gpio:X:Y at+get_config=device:gpio:X at+get_config=device:adc:X LoRaWAM AT commands: at+join at+send=lora:X:YYY at+set_config=lora:region:XXX at+get_config=lora:channel at+set_config=lora:dev_eui:XXXX at+set_config=lora:app_eui:XXXX at+set_config=lora:app_key:XXXX at+set_config=lora:dev_addr:XXXX at+set_config=lora:apps_key:XXXX at+set_config=lora:nwks_key:XXXX at+set_config=lora:join_mode:X at+set_config=lora:work_mode:X at+set_config=lora:ch_mask:X:Y at+set_config=lora:class:X at+set_config=lora:confirm:X at+set_config=lora:dr:X at+set_config=lora:tx_power:X at+set_config=lora:adr:X at+set_config=lora:send_interval:X:Y at+get_config=lora:status LoRaP2P AT commands: at+set_config=lorap2p:XXX:Y:Z:A:B:C at+set_config=lorap2p:transfer_mode:X at+send=lorap2p:XXX V1.0 2.3 at+set_config=device:restart 本指令用于重启设备。 操作 写 参数:无 Example at+set_config=device:restartrn UART1 work mode: RUI_UART_NORAMAL Current work_mode:LoRaWAN, join_mode:ABP, Class: A Initialization OK 指令 应答 at+set_config=device:restart 2.4 at+set_config=device:boot 本指令用于强制模块进入BOOT模式。 注:BOOT模式下,串口波特率为固定的115200,且不可更改。 操作 写 参数:无 Example: at+set_config=device:bootrn OK 指令 at+set_config=device:boot 应答 OK V1.0 2.5 at+run 本指令用于强制设备退出boot模式,进入正常运行模式。仅在boot模式下有效,该指令会引起模块重启。 操作 参数:无 Example: at+runrn Stop Boot Mode UART1 work mode: RUI_UART_NORAMAL Current work_mode:LoRaWAN, join_mode:ABP, Class: A Initialization OK 指令 at+run 应答 2.6 at+set_config=device:sleep: 本指令用于使设备休眠或唤醒。 操作 写 参数: status 0: wake up 1: sleep 指令 应答 at+set_config=device:sleep: Example at+set_config=device:sleep:1rn OK Sleep at+set_config=device:sleep:0rn OK Wake Up V1.0 2.7 at+get_config=device:status 本指令用于获取设备当前的状态。 操作 读 参数:无 Example: at+get_config=device:statusrn OK Board Core:LoRa模块RAK811 MCU:STM32L151CB_A LoRa chip:SX1276 指令 应答 at+get_config=device:status OK V1.0 3 接口类AT 3.1 at+set_config=device:uart: 本指令用于配置某个UART的波特率。 操作 写 参数: index baud_rate UART编号 UART波特率:1200,2400,4800,9600,19200,38400,57600,115200 Example: at+set_config=device:uart:1:115200rn OK 指令 应答 at+set_config=device:uart: 3.2 at+set_config=device:uart_mode: 本指令用于设置UART的工作模式为AT配置模式或数据透传模式。 操作 写 参数: index UART编号。LoRa模块RAK811目前只支持UART1。 指令 应答 at+set_config=device:uart_mode: V1.0 mode UART模式:只能取值为1,意思是将该UART设置为数据透传模式。 注:如果要从数据透传模式,变为AT配置模式,则使用“+++”即可(+++后面不用带rn)。 Example: at+set_config=device:uart_mode:1:1rn OK +++ OK 3.3 at+send=uart: 本指令用于通过某个UART发送数据。 操作 写 参数: index data UART编号 发送的数据。最大为255个字符,包括指令字符”at+…”和尾部的”rn”在内。 Example: at+send=uart:3:12345rn OK 指令 应答 at+set_config=device:uart: V1.0 3.4 at+get_config=device:gpio: 本指令用于获取模块上某个管脚的电平状态。 操作 读 参数: pin_num 模块的管脚索引号 0: 低电平 1: 高电平 Example: at+get_config=device:gpio:2rn OK 1 指令 应答 at+get_config=device:gpio: status(返回值) 3.5 at+set_config=device:gpio: 本指令用于设置模块上某个管脚的电平状态为高或低。 操作 写 参数: pin_num status 模块的管脚索引号 0: 低电平 1: 高电平 Example: at+set_config=device:gpio:2:0rn 指令 应答 at+set_config=device:gpio: V1.0 OK 3.6 at+get_config=device:adc: 本指令用于获取模块上某个adc管脚的电压。 操作 读 参数: pin_num 模块上adc管脚的编号 电压值,单位mV 指令 应答 at+get_config=device:adc: Voltage(返回值) Example: at+get_config=device:adc:2rn OK 1663mV V1.0 4 LoRa类AT 4.1 at+join 该指令用于加入LoRaWAN网络。 操作 参数:无 Example: at+joinrn OK Join Success 指令 at+join 应答 OK Join Success 4.2 at+send=lora: 该指令用于通过LoRaWAN发送数据。 操作 参数: port data LoRa的发送端口 要发送的数据。十六进制双字符格式。 最大发送长度会因频段和DR的不同而有所区别(LoRaWAN标准规范),详细请参考指令 应答 at+send=lora: V1.0 本文附录三。 Example: 发送数据为非确认包(unconfirm)类型时: at+send=lora:1:5A00rn OK 发送数据为确认包(confirm)类型时: at+send=lora:1:5A00rn OK at+recv=0,-105,-12,0 注:发送confirm包时,会收到ACK回应,即上面的”at+recv=…”。“0,-105,-12,0”中,”0”代表LoRa的端口,“-105”代表RSSI,“-12”代表SNR,“0”代表数据长度(ACK中无有效数据)。 4.3 at+set_config=lora:region: 该指令用于设置相应的工作频段。 操作 写 参数: region Example: at+set_config=lora:region:EU868rn OK EU433, CN470, IN865, EU868, US915, AU915, KR920, AS923. 指令 应答 at+set_config=lora:region: V1.0 4.4 at+get_config=lora:channel 该指令用于读取设备当前region的所有LoRa信道信息。 操作 读 参数:无 Example (EU868 region): at+get_config=lora:channelrn OK *0,on,868100000,0,5; *1,on,868300000,0,5; *2,on,868500000,0,5; 3,off,0,0,0; 4,off,0,0,0; 5,off,0,0,0; 6,off,0,0,0; 7,off,0,0,0; *8,on,867100000,0,5; *9,on,867300000,0,5; *10,on,867500000,0,5; *11,on,867700000,0,5; *12,on,867900000,0,5; 13,off,0,0,0; 14,off,0,0,0; 15,off,0,0,0 注: 以“*0,on,868100000,0,5”为例,通道参数解析: “*” 如果该channel处于打开状态,前面会有该标识; ”0” 是channel的编号; ”on” 代表该channel目前处于打开状态; “868100000” 是该channel的实际频率,单位Hz; “0,5” 代表该channel的DR范围为DR0~DR5. 指令 AT+BAUDRATE 应答 OK V1.0 4.5 at+set_config=lora:ch_mask: 该指令用于设置当前region的某个channel为打开或关闭状态。 操作 指令 写 参数: channel_number status at+set_config=lora:ch_mask:0:0rn OK Channel的编号 0: off 1: on 应答 at+set_config=lora:ch_mask: 4.6 at+set_config=lora:dev_eui: 该指令用于设置LoRaWAN OTAA模式的参数Device EUI。 操作 写 参数: dev_eui Example: at+set_config=lora:dev_eui:3536rn OK Device EUI. 指令 应答 at+set_config=lora:dev_eui: V1.0 4.7 at+set_config=lora:app_eui: 该指令用于设置LoRaWAN OTAA模式的参数Application EUI。 操作 写 参数: app_eui Example: at+set_config=lora:app_eui:0001rn OK Application EUI. 指令 应答 at+set_config=lora:app_eui: 4.8 at+set_config=lora:app_key: 该指令用于设置LoRaWAN OTAA模式的参数Application Key。 操作 写 参数: app_key Application Key. 指令 应答 at+set_config=lora:app_key: Example: at+set_config=lora:app_key:841986913ACD00BBC2BE2479D70F3228rn OK V1.0 4.9 at+set_config=lora:dev_addr: 该指令用于设置LoRaWAN ABP模式的参数Device Address。 操作 写 参数: dev_addr Device Address. 指令 应答 at+set_config=lora:dev_addr: Example: at+set_config=lora:dev_addr:260125D7rn OK 4.10 at+set_config=lora:apps_key: 该指令用于设置LoRaWAN ABP模式的参数Application Session Key。 操作 写 参数: apps_key Application Session Key. 指令 应答 at+set_config=lora:apps_key: Example: at+set_config=lora:apps_key:841986913ACD00BBC2BE2479D70F3228rn OK 4.11 at+set_config=lora:nwks_key: 该指令用于设置LoRaWAN ABP模式的参数Network Session Key。 V1.0 操作 读 参数: nwks_key Network Session Key. 指令 应答 at+set_config=lora:nwks_key: Example: at+set_config=lora:nwks_key:69AF20AEA26C01B243945A28C9172B42rn OK 4.12 at+set_config=lora:join_mode: 该指令用于设置LoRaWAN的入网模式为OTAA或ABP。 操作 写 参数: mode 入网模式。 0: OTAA 1: ABP Example: at+set_config=lora:join_mode:1rn OK 指令 应答 at+set_config=lora:join_mode: 4.13 at+set_config=lora:work_mode: 该指令用于设置LoRa的工作模式为LoRaWAN或LoRaP2P。此指令会引起模块重启。 V1.0 操作 写 参数: mode 指令 应答 at+set_config=lora:work_mode: LoRa工作模式 0: LoRaWAN 1: LoRaP2P Example: at+set_config=lora:work_mode:1rn UART1 work mode: RUI_UART_NORAMAL Current work_mode:P2P Initialization OK 4.14 at+set_config=lora:class: 该指令用于设置LoRaWAN的Class为Class A、Class B、或Class C。 操作 写 参数: class 0: Class A 1: Class B (暂不支持) 2: Class C Example: at+set_config=lora:class:0rn OK 指令 应答 at+set_config=lora:class: V1.0 4.15 at+set_config=lora:confirm: 该指令用于设置发送数据的类型为确认包(confirm)还是非确认包(unconfirm)。 操作 写 参数: type 0: 非确认包(unconfirm) 1: 确认包(confirm) 2: 广播(multicast) 3. 自定义(proprietary) Example: at+set_config=lora:confirm:0rn OK 指令 应答 at+set_config=lora:confirm: 4.16 at+set_config=lora:dr: 该指令用于设置LoRa的data rate(DR)。 操作 写 参数: dr LoRa的data rate, 取值范围与当前的region有关,大多数LoRa的region中,常指令 应答 at+set_config=lora:dr: V1.0 用的都是0~5。详细的可参考LoRaWAN 1.0.2的规范。 4.17 at+set_config=lora:tx_power: 该指令用于设置LoRa的发射功率等级。 操作 写 参数: tx_power LoRa的发射功率等级(level),会因频段、DR的不同而有所区别。详细的请参考LoRaWAN 1.0.2规范或本文附录二。 Example: at+set_config=lora:tx_power:0rn OK 指令 应答 at+set_config=lora:tx_power: 4.18 at+set_config=lora:adr: 该指令用于设置LoRa的ADR为打开或关闭状态。 操作 写 参数: 指令 应答 at+set_config=lora:adr: V1.0 status 0: 关闭 1: 打开 Example: at+set_config=lora:adr:0rn OK 4.19 at+get_config=lora:status 该指令用于获取当前所有的LoRa状态信息(channel信息除外)。 操作 读 参数:无 Example: at+get_config=lora:statusrn OK Work Mode: LoRaWAN Region: EU868 Send_interval: 600s Auto send status: false. Join_mode: ABP DevAddr: 260125D7 AppsKey: 841986913ACD00BBC2BE2479D70F3228 NwksKey: 69AF20AEA26C01B243945A28C9172B42 Class: A Joined Network:true IsConfirm: false AdrEnable: true EnableRepeaterSupport: false RX2_CHANNEL_FREQUENCY: 869525000, RX2_CHANNEL_DR:0 RX_WINDOW_DURATION: 3000ms RECEIVE_DELAY_1: 1000ms RECEIVE_DELAY_2: 2000ms JOIN_ACCEPT_DELAY_1: 5000ms 指令 at+set_config=lora:status 应答 OK V1.0 JOIN_ACCEPT_DELAY_2: 6000ms Current Datarate: 4 Primeval Datarate: 4 ChannelsTxPower: 0 UpLinkCounter: 1 DownLinkCounter: 0 4.20 at+set_config=lorap2p: 该指令用于设置LoRaP2P的相关参数,仅在LoRa的工作模式为LoRaP2P时有效。 操指令 作 写 参数: frequency spreadfact bandwidth Frequency, the unit is Hz Spreading factor 0: 125KHz 1: 250KHz 2: 500KHz 1: 4/5 2: 4/6 3: 4/7 4: 4/8 Preamble Length. 5~65535 TX power. The unit is dbm. 5~20 at+set_config=lorap2p: OK 应答 codeingrate preamlen power Example: at+set_config=lorap2p:869525000:12:0:1:8:20rn OK V1.0 4.21 at+set_config=lorap2p:transfer_mode: 该指令用于设置LoRaP2P的模式为发送端或接收端,仅在LoRa的工作模式为LoRaP2P时有效。 操指令 作 写 at+set_config=lorap2p: transfer_mode: 应答 参数: mode 1: receiver mode 2: sender mode Example: at+set_config=lorap2p:transfer_mode:1rn OK 4.22 at+send=lorap2p: 该指令用于通过LoRaP2P发送数据,仅在LoRa的工作模式为LoRaP2P时有效。 操作 发送 参数: data 要发送的数据。十六进制格式 指令 at+send=lorap2p: 应答 OK Example: at+send=lorap2p:1234rn OK 注:LoRaP2P模式的接收端接收到的数据格式为: at+recv= V1.0 5 附录一 :各Region的DataRate列表 5.1 EU868/EU433/AS923 DataRate 0 1 2 3 4 5 6 7 8 …15 Configuration LoRa: SF12 / 125kHz LoRa: SF11 / 125kHz LoRa: SF10 / 125kHz LoRa: SF9 / 125kHz LoRa: SF8 / 125kHz LoRa: SF7 / 125kHz LoRa: SF7 / 250kHz FSK: 50kbps RFU Indicative physical bit rate [bit/s] 250 440 980 1760 3125 5470 11000 50000 5.2 CN470/KR920 DataRate 0 1 2 3 4 5 6…15 Configuration LoRa: SF12 / 125kHz LoRa: SF11 / 125kHz LoRa: SF10 / 125kHz LoRa: SF9 / 125kHz LoRa: SF8 / 125kHz LoRa: SF7 / 125kHz RFU Indicative physical bit rate [bit/s] 250 440 980 1760 3125 5470 5.3 US915 DataRate 0 1 2 3 4 Configuration LoRa: SF10 / 125kHz LoRa: SF9 / 125kHz LoRa: SF8 / 125kHz LoRa: SF7 / 125kHz LoRa: SF8 / 500kHz Indicative physical bit rate [bit/s] 980 1760 3125 5470 12500 V1.0 5…7 8 9 10 11 12 13 14…15 RFU LoRa: SF12/500kHz LoRa: SF11/500kHz LoRa: SF10/500kHz LoRa: SF9/500kHz LoRa: SF8/500kHz LoRa: SF7/500kHz RFU 980 1760 3900 7000 12500 21900 5.4 AU915 DataRate 0 1 2 3 4 5 6 7 8 9 10 11 12 Configuration LoRa: SF12 / 125kHz LoRa: SF11 / 125kHz LoRa: SF10 / 125kHz LoRa: SF9 / 125kHz LoRa: SF8 / 125kHz LoRa: SF7 / 125kHz LoRa: SF8/500kHz RFU LoRa: SF12/500kHz LoRa: SF11/500kHz LoRa: SF10/500kHz LoRa: SF9/500kHz LoRa: SF8/500kHz Indicative physical bit rate [bit/s] 250 440 980 1760 3125 5470 12500 RFU 980 1760 3900 7000 12500 5.5 IN865 DataRate 0 1 2 3 4 5 6 7 8 …15 Configuration LoRa: SF12 / 125kHz LoRa: SF11 / 125kHz LoRa: SF10 / 125kHz LoRa: SF9 / 125kHz LoRa: SF8 / 125kHz LoRa: SF7 / 125kHz RFU FSK: 50kbps RFU Indicative physical bit rate [bit/s] 250 440 980 1760 3125 5470 RFU 50000 RFU V1.0 6 附录二 :各Region的TX power列表 6.1 EU868 By default MaxEIRP is considered to be +16dBm. 6.2 US915 6.3 AU915 By default MaxEIRP is considered to be +30dBm. V1.0 6.4 KR920 By default MaxEIRP is considered to be +14dBm. 6.5 AS923 By default Max EIRP shall be 16dBm. 6.6 IN865 By default MaxEIRP is considered to be 30dBm. V1.0 6.7 CN470 By default MaxEIRP is considered to be +19.15dBm. 6.8 EU433 By default MAxEIRP is considered to be +12.15dBm. V1.0 V1.0 7 附录三 :各Region的最大发送负载列表 注:下列表中的M是带MAC头的长度,N为不带MAC头的长度,发送的最大数据长度以N为准。 7.1 EU868 7.2 US915 V1.0 7.3 AU915 7.4 KR920 V1.0 7.5 AS923 7.6 IN865 7.7 CN470 V1.0 7.8 EU433 V1.0 8 附录四:LoRa模块RAK811模块的管脚说明 这里对RAK811模块的部分管脚做一些说明(全部管脚的定义,需查看RAK瑞科慧联提供的产品文档): 1) 关于UART管脚。Pin6(TX1)、Pin7(RX1)为UART1,Pin25(TX3)、Pin26(RX3)为UART3,这四个引脚默认都被配置成了推挽输出,接上拉电阻,因此这四个引脚上电时为高电平; 2) 关于JTAG调试管脚。Pin10、Pin13用于JTAG调试口,上电默认配置为推挽输出,未接上下拉电阻,上电这两个引脚为高阻态。 3) 关于电源管脚。LoRa模块RAK811模块上的电源管脚包括:VCC/GND,Pin1、Pin11、Pin12、Pin21、Pin28、Pin29、Pin30、Pin31、Pin32、Pin34。 4) 关于复位(reset)管脚。LoRa模块RAK811模块上的复位管脚为PIN24; 5) 关于BOOT管脚。LoRa模块RAK811模块上的BOOT0管脚为PIN17; 6) 关于射频天线管脚。LoRa模块RAK811模块上的射频天线管脚为PIN33; 7) 关于ADC管脚。LoRa模块RAK811的高、低频模块上的ADC管脚有所不同,低频模块可作为ADC的引脚有:Pin2、Pin3、Pin4、Pin5、Pin15、Pin20、Pin22、Pin23。高频模块可作为ADC的引脚有:Pin2、Pin3、Pin4、Pin20、Pin22、Pin23; 8) 关于GPIO。LoRa模块RAK811模块上可做GPIO的引脚有:Pin2、Pin3、Pin4、Pin5、Pin8、Pin9、Pin14、Pin15、Pin16、Pin18、Pin19、Pin20、Pin22、Pin23、Pin25、Pin26、Pin27。