Professional Documents
Culture Documents
User Guide Lorawan AT Command / Payload Protocol
User Guide Lorawan AT Command / Payload Protocol
LoRaWAN
AT Command / Payload Protocol
www.bovetech.com
CONTENT
2. AT COMMAND .................................................................................................................................................... 3
2.1. ID .................................................................................................................................................................................3
2.2. KEY ..............................................................................................................................................................................3
2.3. CLASS ...........................................................................................................................................................................3
2.4. DR ................................................................................................................................................................................4
2.5. ADR .............................................................................................................................................................................4
2.6. CH ................................................................................................................................................................................5
2.7. ULCONFIRM.................................................................................................................................................................6
2.8. INTERVAL .....................................................................................................................................................................6
2.9. MODE ..........................................................................................................................................................................6
2.10. TIMEPOINT ..................................................................................................................................................................6
2.11. JOIN .............................................................................................................................................................................7
2.12. FDEFAULT ....................................................................................................................................................................7
2.13. RDMETER ....................................................................................................................................................................7
2.14. RTC ..............................................................................................................................................................................8
2.15. VDD .............................................................................................................................................................................8
2.16. TEMP ...........................................................................................................................................................................8
2.17. RESET...........................................................................................................................................................................8
3. WIRELESS FUNCTION........................................................................................................................................... 9
4. PAYLOAD ............................................................................................................................................................. 9
7. REVISION .......................................................................................................................................................... 23
(5) Use optical head to force send data, select the command “AT+RDMETER” and type in
“UL”
2.2. KEY
Change LoRaWAN related AES-128 KEY. If wrong key is used, your LoRaWAN modem will be
rejected by LoRaWAN server. Contact server administrator to know what key should use. All
KEYs are unreadable for security, the one who forgets his KEY need rewrite with a new key.
Format:
Function AT command transmission AT command return
Change network +KEY: NWKSKEY
AT+KEY=NWKSKEY,“16 bytes
session key xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx
length key”
(NWKSKEY) :xx:xx
Change application +KEY: APPSKEY
AT+KEY=APPSKEY,“16 bytes
session key xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx
length key”
(APPSKEY) :xx:xx
Change application +KEY: APPKEY
AT+KEY=APPKEY,“16 bytes
session key xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx
length key”
(APPKEY) :xx:xx
2.3. CLASS
The mode of module.
2.4. DR
Use LoRaWAN defined DRx to set data rate of LoRaWAN AT modem.
Function AT command transmission AT command return
+DR: DR0 (ADR DR2)
+DR: EU868 DR2 SF10 BW125K
Read the band AT+DR
+DR: EU868 DR0 SF12 BW125K
(ADR means Rate adaptation)
Set the band in AT+DR=EU868/IN865/AS923/A +DR: EU868/ +DR: IN865/ +DR:
EU868/ IN865/ U915/CN470/EU433 AS923/ +DR: AU915/ +DR: CN470/
AS923/ AU915/ And so on. +DR EU433
EU433 And so on.
e.g. +DR: DR1
Set the data rate
AT+DR=DR1 +DR: EU868 DR1 SF11 BW125K
2.5. ADR
Set ADR function of LoRaWAN module.
Function AT command transmission AT command return
Enable ADR function AT+ADR=ON +ADR: ON
Disable ADR function AT+ADR=OFF +ADR: OFF
2.13. RDMETER
2.14. RTC
Get real time from LoRaWAN modem. When modem is powered on, it always starts from
2000-01-01 00:00:00, user could set new time to modem to sync to the real time.
Function AT command transmission AT command return
Check current time AT+RTC +RTC: 2000-01-01 10:35:03
Set a new time for the
AT+RTC="2020-07-2215:44:00" +RTC: 2020-07-22 15:44:00
module
Get time zone AT+RTC=ZONE +RTC: ZONE, +08:00
Set the time zone AT+RTC=ZONE,”+06:00” +RTC: ZONE, +06:00
Get verbose RTC AT+RTC=FULL +RTC: 2020-07-22 13:47:19
2.15. VDD
Get supply voltage, return value in unit 0.01V. Format: AT
Function AT command transmission AT command return
AT+VDD
Check current state AT+VDD? +VDD: 3.64V
AT+VDD=?
2.16. TEMP
Get temperature, return value in unit °C.
Function AT command transmission AT command return
AT+TEMP
Check current
AT+TEMP? +TEMP: 23.3
temperature
AT+TEMP=?
2.17. RESET
Reset LoRaWAN network, the device will auto join after reset
Function AT command transmission AT command return
RESET AT+RESET +RESET: OK
4. PAYLOAD
4.1. UPLINK PAYLOAD
4.1.1. The serial number uplink for water meter (port 25)
The define of the data frame
Field Byte Count Parameter Example
Control code 1 - 0x83
Data length 1 - 0x0A
Data identification 1 DI0 0x81
Data identification 1 DI1 0x0A
Count number 1 - 0x00~0xFF
Data field 7 Meter number Lower byte priority
For example: count number is 00, the meter number is 00740039003741
The data frame is: 830A810A0041370039007400
4.1.2. The serial number uplink for heat meter (port 25)
The define of the data frame
Field Byte Count Parameter Example
Control code 1 - 0XA6
D0 00: open
State of Valve 01: close
D1 11: abnormal
D2 - Reserved
D3 - Reserved
D4 - Reserved
D5 - Reserved
D6 - Reserved
D7 - Reserved
Define of ST2:
Field Define Explain
0: normal
D0 Meter Battery Alarm
1: abnormal
D0 00: open
State of Valve 01: close
D1 11: abnormal
D2 - Reserved
D3 - Reserved
D4 - Reserved
D5 - Reserved
D6 - Reserved
D7 - Reserved
Define of ST2:
Field Define Explain
0: normal
D0 Meter Battery Alarm
1: abnormal
0: normal
D1 Empty Pipe Alarm
1: abnormal
0: normal
D2 Reverse Flow Alarm
1: abnormal
0: normal
D3 Over Range Alarm
1: abnormal
Define of LoRaWAN module battery state (more details reference chapter 5.)
Value Explain
0x00 Power supply
0x01-0xFE Electric quantity 0-100%: (Byte-1)/253*100%
0xFF Unknown
For example: count number is 0, current consumption is 51m³, empty pipe, the LoRaWAN
batter percentage is 50%.
The data frame is: 81 0A 90 1F 00 2B 00 10 05 00 00 02 7F
4.1.4. The totalizer uplink for heat meter (port 25)
>>>
>>> >>>
Function Command
FEFE6820AAAAAAAAAAAAAA221000000041542B52444D455445523D5
Trigger
54C1116
FEFE6820AAAAAAAAAAAAAA221500000041542B504552494F443D494
Query interval
E54455256414C8A16
6.5. TRIGGER
Trigger +RDMETER: UL
+PERIOD: INTERVAL,***
Query interval
NOTE: unit of interval is minute
V1.0.5 2020/4/28
+ Corrected the decoding for "meter reading"
+ Changed information to new address and TEL.
V1.0.6 2020/9/09
+ Updated error bits definitions
+ Added trigger via android