最新消息: USBMI致力于为网友们分享Windows、安卓、IOS等主流手机系统相关的资讯以及评测、同时提供相关教程、应用、软件下载等服务。

LoRa模块RAK811AT命令手册

IT圈 admin 30浏览 0评论

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: .............................................................. 12

2.7 at+get_config=device:status ............................................................................ 13

3 接口类AT .................................................................................................................... 14

3.1 at+set_config=device:uart:: ............................................ 14

3.2 at+set_config=device:uart_mode:: ........................................ 14

3.3 at+send=uart:: ......................................................................... 15

3.4 at+get_config=device:gpio: ........................................................... 16

3.5 at+set_config=device:gpio:: ............................................ 16

3.6 at+get_config=device:adc: ............................................................ 17

4 LoRa类AT ................................................................................................................. 18

4.1 at+join .............................................................................................................. 18

4.2 at+send=lora:: ............................................................................ 18

4.3 at+set_config=lora:region: ................................................................ 19

4.4 at+get_config=lora:channel ............................................................................. 20

4.5 at+set_config=lora:ch_mask:: ............................ 21

4.6 at+set_config=lora:dev_eui: ........................................................... 21

4.7 at+set_config=lora:app_eui: ........................................................... 22

4.8 at+set_config=lora:app_key: ......................................................... 22

4.9 at+set_config=lora:dev_addr: ...................................................... 23

4.10 at+set_config=lora:apps_key:...................................................... 23

4.11 at+set_config=lora:nwks_key: ..................................................... 23

4.12 at+set_config=lora:join_mode: ........................................................... 24

4.13 at+set_config=lora:work_mode: ......................................................... 24

4.14 at+set_config=lora:class: .................................................................... 25

4.15 at+set_config=lora:confirm: .................................................................. 26

4.16 at+set_config=lora:dr: .............................................................................. 26

4.17 at+set_config=lora:tx_power: ....................................................... 27

4.18 at+set_config=lora:adr: ...................................................................... 27

4.19 at+get_config=lora:status ................................................................................ 28

4.20 at+set_config=lorap2p:::::: ........................................................................................ 29

4.21 at+set_config=lorap2p:transfer_mode: .............................................. 30

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” 开头, 以(即rn)结束,本文中的指令介绍都省略了“rn”。

AT命令根据操作方式可分为:

 读指令 – 读取设备的配置或状态,一般格式为:at+get_config=:,指令名与参数以“=”分隔,如包含多个参数,参数之间以 “:” 分隔;

 写指令 – 写入/修改设备配置,一般格式为:at+set_config=:,指令名与参数以“=”分隔,如包含多个参数,参数之间以 “:” 分隔;

 其它指令 - 还有一些指令,既不是读指令,也不是写指令,如LoRa发送数据的指令为at+send=lora::,LoRa入网指令:at+join,退出boot模式的指令:at+run等。

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: rn

都以“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: OK

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:: OK

3.2 at+set_config=device:uart_mode::

本指令用于设置UART的工作模式为AT配置模式或数据透传模式。

操作

参数:

index

UART编号。LoRa模块RAK811目前只支持UART1。

指令 应答

at+set_config=device:uart_mode:: OK

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:: OK

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: OK

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:: OK

V1.0

OK

3.6 at+get_config=device:adc:

本指令用于获取模块上某个adc管脚的电压。

操作

参数:

pin_num

模块上adc管脚的编号

电压值,单位mV

指令 应答

at+get_config=device:adc: OK

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:: OK

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: OK

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:: OK

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: OK

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: OK

4.8 at+set_config=lora:app_key:

该指令用于设置LoRaWAN OTAA模式的参数Application Key。

操作

参数:

app_key Application Key.

指令 应答

at+set_config=lora:app_key: OK

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: OK

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: OK

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: OK

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: OK

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: OK

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: OK

4.16 at+set_config=lora:dr:

该指令用于设置LoRa的data rate(DR)。

操作

参数:

dr

LoRa的data rate, 取值范围与当前的region有关,大多数LoRa的region中,常指令 应答

at+set_config=lora:dr: OK

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: OK

4.18 at+set_config=lora:adr:

该指令用于设置LoRa的ADR为打开或关闭状态。

操作

参数:

指令 应答

at+set_config=lora:adr: OK

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: OK

应答

参数:

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: .............................................................. 12

2.7 at+get_config=device:status ............................................................................ 13

3 接口类AT .................................................................................................................... 14

3.1 at+set_config=device:uart:: ............................................ 14

3.2 at+set_config=device:uart_mode:: ........................................ 14

3.3 at+send=uart:: ......................................................................... 15

3.4 at+get_config=device:gpio: ........................................................... 16

3.5 at+set_config=device:gpio:: ............................................ 16

3.6 at+get_config=device:adc: ............................................................ 17

4 LoRa类AT ................................................................................................................. 18

4.1 at+join .............................................................................................................. 18

4.2 at+send=lora:: ............................................................................ 18

4.3 at+set_config=lora:region: ................................................................ 19

4.4 at+get_config=lora:channel ............................................................................. 20

4.5 at+set_config=lora:ch_mask:: ............................ 21

4.6 at+set_config=lora:dev_eui: ........................................................... 21

4.7 at+set_config=lora:app_eui: ........................................................... 22

4.8 at+set_config=lora:app_key: ......................................................... 22

4.9 at+set_config=lora:dev_addr: ...................................................... 23

4.10 at+set_config=lora:apps_key:...................................................... 23

4.11 at+set_config=lora:nwks_key: ..................................................... 23

4.12 at+set_config=lora:join_mode: ........................................................... 24

4.13 at+set_config=lora:work_mode: ......................................................... 24

4.14 at+set_config=lora:class: .................................................................... 25

4.15 at+set_config=lora:confirm: .................................................................. 26

4.16 at+set_config=lora:dr: .............................................................................. 26

4.17 at+set_config=lora:tx_power: ....................................................... 27

4.18 at+set_config=lora:adr: ...................................................................... 27

4.19 at+get_config=lora:status ................................................................................ 28

4.20 at+set_config=lorap2p:::::: ........................................................................................ 29

4.21 at+set_config=lorap2p:transfer_mode: .............................................. 30

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” 开头, 以(即rn)结束,本文中的指令介绍都省略了“rn”。

AT命令根据操作方式可分为:

 读指令 – 读取设备的配置或状态,一般格式为:at+get_config=:,指令名与参数以“=”分隔,如包含多个参数,参数之间以 “:” 分隔;

 写指令 – 写入/修改设备配置,一般格式为:at+set_config=:,指令名与参数以“=”分隔,如包含多个参数,参数之间以 “:” 分隔;

 其它指令 - 还有一些指令,既不是读指令,也不是写指令,如LoRa发送数据的指令为at+send=lora::,LoRa入网指令:at+join,退出boot模式的指令:at+run等。

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: rn

都以“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: OK

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:: OK

3.2 at+set_config=device:uart_mode::

本指令用于设置UART的工作模式为AT配置模式或数据透传模式。

操作

参数:

index

UART编号。LoRa模块RAK811目前只支持UART1。

指令 应答

at+set_config=device:uart_mode:: OK

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:: OK

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: OK

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:: OK

V1.0

OK

3.6 at+get_config=device:adc:

本指令用于获取模块上某个adc管脚的电压。

操作

参数:

pin_num

模块上adc管脚的编号

电压值,单位mV

指令 应答

at+get_config=device:adc: OK

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:: OK

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: OK

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:: OK

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: OK

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: OK

4.8 at+set_config=lora:app_key:

该指令用于设置LoRaWAN OTAA模式的参数Application Key。

操作

参数:

app_key Application Key.

指令 应答

at+set_config=lora:app_key: OK

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: OK

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: OK

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: OK

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: OK

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: OK

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: OK

4.16 at+set_config=lora:dr:

该指令用于设置LoRa的data rate(DR)。

操作

参数:

dr

LoRa的data rate, 取值范围与当前的region有关,大多数LoRa的region中,常指令 应答

at+set_config=lora:dr: OK

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: OK

4.18 at+set_config=lora:adr:

该指令用于设置LoRa的ADR为打开或关闭状态。

操作

参数:

指令 应答

at+set_config=lora:adr: OK

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: OK

应答

参数:

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。

与本文相关的文章

发布评论

评论列表 (0)

  1. 暂无评论