24
1 LoRa TM Wireless Communication Module LM-130H1 AT Command Reference Guide VER: 1.0 GlobalSat WorldCom Corporation 16F., No. 186, Jian 1 st Rd, Zhonghe Dist., New Taipei City 23553, Taiwan Tel: 886.2.8226.3799 / Fax: 886.2.8226.3899 [email protected] www.globalsat.com.tw USGlobalSat Incorporated 14740 Yorba Court Chino, CA 91710 Tel: 888.323.8720 / Fax: 909.597.8532 [email protected] www.usglobalsat.com

LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

  • Upload
    others

  • View
    2

  • Download
    0

Embed Size (px)

Citation preview

Page 1: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

1

LoRaTM

Wireless

Communication Module

LM-130H1

AT Command Reference Guide

VER: 1.0

GlobalSat WorldCom Corporation

16F., No. 186, Jian 1st Rd, Zhonghe Dist.,

New Taipei City 23553, Taiwan

Tel: 886.2.8226.3799 / Fax: 886.2.8226.3899

[email protected]

www.globalsat.com.tw

USGlobalSat Incorporated

14740 Yorba Court Chino, CA 91710 Tel: 888.323.8720 / Fax: 909.597.8532

[email protected]

www.usglobalsat.com

Page 2: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

2

Revision History

Rev. Change History Issue Date Remark

0.9 Draft 2017.03.01 Preliminary

1.0 Initial Release 2017.03.27

Page 3: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

3

CONTENT

1. Introduction................................................................................................ 4

1.1 Product Description ........................................................................... 4

1.2 AT Command .................................................................................... 4

2. How to Switch Device Protocol .................................................................. 5

3. LoRaWAN AT Command .......................................................................... 6

4. MOST Link AT Command ....................................................................... 17

5. Appendix ................................................................................................. 24

Page 4: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

4

1. Introduction

1.1 Product Description The GlobalSat LM-130H1 is a RF module that based on LoRaTM technology which provides long-range, low data rate IoT connectivity to sensors, electronic meter reading, geolocation devices, industrial monitoring and control, home and building automation, long range irrigation systems, and all kinds of IoT/M2M equipments. It can work as the end-node devices in the LoRaWANTM infrastructure or in GlobalSat proprietary MOST Link mode.

1.2 AT Command

All of the LM-130H1 module’s settings and commands are transmitted over UART using the ASCII interface. All commands need to be terminated with <CR><LF> and any replies they generate will also be terminated by the same sequence. The settings for the UART interface are 57600 bps, 8 bits, no parity, 1 stop bit, no flow control. After setting LM-130H1 module, you must use AT command (AAT1 Save) to save the settings to the flash. You would see “ok” when the settings are saved. Then use AT command (AAT1 Reset) to run the new settings. Note: All AT commands are case sensitive

Page 5: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

5

2. How to Switch Device Protocol

The default protocol of LM-130H1 is LoRaWAN. Use AT command (AAT1 LW=1) to define protocol as MOST Link. * Ref. Appendix Table A.

Command Description

AAT1 LW=parameter

Set LoRa Device Transmission Protocol [parameter]: x (Default=1) 0: protocol is LoRaWAN 1: protocol is MOST Link Response:

ok ﹣parameter is valid

invalid_param ﹣parameter is not valid

AAT1 LW=?

Read LoRa Device Transmission Protocol status Response: x

0 ﹣LoRaWAN

1 ﹣MOST Link

AAT1 Save All parameters are saved to flash.

AAT1 Reset Reboot the LM-130H1.

AAT1 Restore Restore to default parameters and reboot.

AAT1 UpdateFW LT-130H1 is ready for new firmware upgrade.

Page 6: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

6

3. LoRaWAN AT Command

AAT1 - Command for parameters setting up and send / receive data.

AAT2 - Command for functions setting up under LoRaWAN.

Command Description

AAT1 Save All parameters are saved. Response ok after parameters are saved.

AAT1 Reset Reboot the LM-130H1 module. Response ok after entering the command.

AAT1 Restore Restore the defaults of FW. Response ok after entering the command.

AAT1 UpdateFW Upgrade the LM-130H1 module firmware. Response ok after entering the command.

AAT1 FwVersion Show up firmware version.

AAT1 SLEEP

Put LM-130H1 into sleep mode. To leave sleep mode, just Input 0xFF by UART to wake up LM-130H1. Response ok after entering the command.

AAT1

TestMode=[parameter1]

[parameter1]: 0: Disable (Active Report Mode: Off) 1: Enable (Active Report Mode: On) Response:

ok ﹣value is valid

invalid_param ﹣parameter1 is not valid

This command is for setting active report mode of module.

AAT1 TestMode=?

Response: 0: disable (Active Report Mode: Off) 1: enable (Active Report Mode: On) This command is for reading active report mode is On or Off.

AAT2 DevAddr=[parameter1]

[parameter1]: 4-byte hexadecimal number representing the device address, from 00000001 – FFFFFFFF. Response:

ok ﹣address is valid

invalid_param ﹣parameter1 is not valid

Page 7: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

7

Command Description

This command configures the module with a 4-byte unique network device address [parameter1]. The [parameter1] must be unique to the current network. This must be directly set solely for activation by personalization devices. This parameter must not be set before attempting to join using over-the-air activation because it will be overwritten once the join process is over.

AAT2 DevAddr=?

Response: 4-byte hexadecimal number representing the device address, from 00000001 to FFFFFFFF. This command is for reading the address of the module.

AAT2 DevEui=[parameter1]

[parameter1]: 8-byte hexadecimal number representing the device EUI. Response:

ok ﹣address is valid

invalid_param ﹣parameter1 is not valid

This command is for setting the globally unique device identifier for the module. The identifier must be set by the host MCU. The module contains a pre-programmed unique EUI and can be retrieved using user provided EUI can be configured using the AAT2 DevEui command.

AAT2 DevEui=?

Response: 8-byte hexadecimal number representing the device EUI. This command is for reading the globally unique identifier of the module.

AAT2 AppEui=[parameter1]

[parameter1]: 8-byte hexadecimal number representing the application EUI. Response:

ok ﹣address is valid

invalid_param ﹣parameter1 is not valid

This command is for setting the application identifier for the module.

AAT2 AppEui=?

Response: 8-byte hexadecimal number representing the application EUI. This command is for reading the application identifier for the module. The application identifier is a value given to the device by the network.

AAT2 NwkSKey=[parameter1]

[parameter1]: 16-byte hexadecimal number representing the network session key. Response:

ok ﹣address is valid

invalid_param ﹣parameter1 is not valid

Page 8: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

8

Command Description

This command is for setting the network session key for the module. This key is 16 bytes in length, and should be modified with each session between the module and network. The key should remain the same until the communication session between devices is terminated.

AAT2 NwkSKey=?

Response: [parameter1]: 16-byte hexadecimal number representing the network session key. This command is for reading the network session key of the module.

AAT2 AppSKey=[parameter1]

[parameter1]: 16-byte hexadecimal number representing the application session key. Response:

ok ﹣address is valid

invalid_param ﹣parameter1 is not valid

This command is for setting the application session key for the module. This key is unique, created for each occurrence of communication, when the network requests an action taken by the application.

AAT2 AppSKey=?

Response: [parameter1]: 16-byte hexadecimal number representing the application session key. This command is for reading the application session key for the module.

AAT2 AppKey=[parameter1]

[parameter1]: 16-byte hexadecimal number representing the application key. Response:

ok ﹣address is valid

invalid_param ﹣parameter1 is not valid

This command is for setting the application key for the module. The application key is used to identify a grouping over module units which perform the same or similar task.

AAT2 AppKey=?

Response: [parameter1]: 16-byte hexadecimal number representing the application key. This command is for reading the application key of the module.

AAT2 ADR=[parameter1] [parameter1]: 0: disable 1: enable

Page 9: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

9

Command Description

Response:

ok ﹣address is valid

invalid_param ﹣parameter1 is not valid

This command is for setting if the adaptive data rate (ADR) is to be enabled, or disabled. The server is informed about the status of the module’s ADR in every uplink frame it receives from the ADR field in uplink data packet. If ADR is enabled, the server will optimize the data rate and the transmission power of the module based on the information collected from the network.

AAT2 ADR=?

Response: 0: disable 1: enable This command is for reading the adaptive data rate mechanism is On or Off.

AAT1 EVK_TxCycle=[parameter1]

[parameter1]: decimal number representing the report interval in seconds, from 1 to 254. This command will only take effect when “TestMode”=1. Response:

ok ﹣parameter1 is valid

invalid_param ﹣parameter1 is not valid

This command is for setting the report interval for the module.

AAT1 EVK_TxCycle=?

Response: decimal number representing the interval, in seconds, for EVK_TxCycle, from 1 to 254. This command is for reading the interval of EVK_TxCycle.

AAT2 JoinMode=[parameter1]

[parameter1]: 0: ABP mode 1: OTAA mode Response:

ok ﹣address is valid

invalid_param ﹣parameter1 is not valid

This command is for reading the module activation type.

AAT2 JoinMode=?

Response: 0: ABP mode 1: OTAA mode This command is for reading the module activation type.

AAT2 reTx=[parameter1] [parameter1]: decimal number representing the number of re-transmission

Page 10: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

10

Command Description

for an uplink confirmed packet, from 0 to 8. Response:

ok ﹣address is valid

invalid_param ﹣parameter1 is not valid

This command is for setting the number for re-transmission uplink of module when it does not receive downlink acknowledgment from server.

AAT2 reTx=?

Response: decimal number representing the number of re-transmission, from 0 to 8. This command is for reading number of re-transmission uplink of module when it does not receive downlink acknowledgement from server.

AAT2 RxDelay1=[parameter1]

[parameter1]: decimal number representing the delay between the transmission and the first reception window in microseconds, from 100000 to 10000000. Response:

ok ﹣address is valid

invalid_param ﹣parameter1 is not valid

This command is for setting the delay time between the transmission and the first reception window.

AAT2 RxDelay1=?

Response: decimal number representing the interval, in microseconds, for RxDelay1. This command is for reading the delay time between transmission and the first reception window.

AAT2 Tx=[parameter1],

[parameter2],

[parameter3]

[parameter1]:

decimal number representing the port number, from 1 to

223.

[parameter2]:

string representing the uplink payload type, either “cnf” or

“uncnf”. (cnf = confirmed, uncnf = unconfirmed)

[parameter3]:

hexadecimal number representing the payload value.

The length of [parameter3] bytes capable of being

transmitted are dependent upon the set data rate.

Page 11: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

11

Command Description

Response:

This command may reply with two responses. The first

response will be received immediately is valid (ok reply

received), the second reply will be received after the end

of the uplink transmission.

Response after entering the command:

ok ﹣parameters and configurations are valid.

Invalid_param ﹣if parameters

( [parameter1],[parameter2],[parameter3]) are not valid.

Tx_ok ﹣“cnf” radio Tx return with ACK

Tx_ok ﹣uncnf” radio Tx return

Tx_noACK ﹣”cnf” radio Tx return without ACK

Rx < parameter1> < parameter2> ﹣transmission was

successful, [parameter1] port number, from 1 to 223;

[parameter2] hexadecimal number that was received from

the server.

AAT2

DutyCycle=[parameter1]

[parameter1]: 0: disable 1: enable Response:

ok ﹣address is valid

invalid_param ﹣parameter1 is not valid

This command is for setting the state of the duty cycle.

You could set the ratio of duty cycle by AAT2

Tx_Band=[parameter1],[parameter2],[parameter3].

For the details, please refer to the command below.

AAT2 DutyCycle=?

Response: 0: disable 1: enable This command is for reading the state of the duty cycle.

AAT2

PLCheck=[parameter1]

[parameter1]: 0: disable 1: enable Response:

Page 12: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

12

Command Description

ok ﹣address is valid

invalid_param ﹣parameter1 is not valid

This command is for setting the payload length’s verification.

AAT2 PLCheck=?

Response: 0: disable 1: enable This command is for reading the state of payload length’s verification.

AAT2 Rx2_Freq_DR=

[parameter1],[parameter2]

[parameter1]:

decimal number representing Rx2 frequency, from

000000001 to 999999999 in Hz.

[parameter2]: decimal number representing Rx2 Data Rate, from 0 to 15. Response:

ok ﹣address is valid

invalid_param ﹣parameter1 is not valid

This command is for setting the frequency and Data Rate of Rx2.

AAT2 Rx2_Freq_DR=?

Response: decimal number representing the frequency and Data Rate of Rx2. This command is for reading the frequency and Data Rate of Rx2. When Rx2 frequency is 915MHz and Data Rate is 3, the response message is as “Freq.915000000, DR3”.

AAT2

ClassMode=[parameter1]

[parameter1]:

0: Class A 2: Class C This command is for setting the operation mode of the module.

AAT2 ClassMode=?

Response: 0: Class A 2: Class C This command is for reading the operation mode of module.

AAT2

Rx1DrOffset=[parameter1]

[parameter1]: decimal number representing the index of Rx1 offset, from 0 to 3. This command is for setting the index of Rx1 offset. The

Page 13: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

13

Command Description

Rx1DrOffset sets the offset between the uplink data rate and the downlink data rate used to communicate with the end-device on the first reception slot (Rx1). As a default this offset is 0. The offset is used to take into account maximum power density constraints for base stations in some regions and to balance the uplink and downlink radio link margins.

AAT2 Rx1DrOffset=?

Response: decimal number representing the index of Rx1 offset. This command is for reading the index of Rx1 offset.

AAT2 Tx_Channel=

[parameter1],[parameter2]

[parameter3],[parameter4]

[parameter5]

[parameter1]:

decimal number representing the channel number. The

range for US is from 0 to 71. The range for EU is from 0 to

15.

[parameter2]: decimal number representing the frequency of Tx channel, from 000000001 to 999999999 in Hz. [parameter3]:

2-digit decimal numbers representing the operating range

of Data Rate. (The left one is DR’s Max, the right one is

DR’s Min.) The range of DR is from 0 to 15.

Note: According to LoRaWAN_Regional_Parameter.pdf,

Data Rate in some regions will be limited in a particular

range. For example, upstream 64 channels numbered 0 to

63 utilizing LoRa 125 kHz BW varying from DR0 to DR3 for

US.

[parameter4]: 0/1 representing the channel is close/open. [parameter5]: decimal number representing the number of band grouping. The range for US is 0. The range for EU is from 0 to 3. Please refer to AAT2 Tx_Band=[parameter1],[paramter2],[parameter3] for further understanding. Response:

ok ﹣address is valid

invalid_param ﹣one of parameters is not valid.

This command is for setting the frequency, Data Rate,

Page 14: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

14

Command Description

status and the number of band grouping for assigned Tx channel. For example: AAT2 Tx_Channel=3,973300000,40,1,0 Description: Modify Channel 3 to have the settings below. 973300000 = Frequency 40 = DR Range; (4=DR Max, 0=DR Min) 1=Status ;(1=open) 0= the number of band grouping

AAT2 Tx_Channelx=?

Response: the assigned Tx channel will be shown. Variable x needs to be assigned as channel number. This command is for reading the assigned Tx channel. For example: AAT2 Tx_Channel15=? Channel15 message will be shown as below: channel_15,Freq.905300000,DrRange.0-3,Status0, Band0

AAT2 Tx_Band=

[parameter1],

[parameter2],

[parameter3]

[parameter1]:

decimal number representing the number of band

grouping. The range for US is 0. The range for EU is from 0

to 3.

[parameter2]: decimal number representing the value of duty cycle, from 1 to 9999. The real duty cycle could be calculated as (100% / duty cycle value). [parameter3]:

decimal number representing the index of Tx power, from 0

to 15. Response:

ok ﹣address is valid

invalid_param ﹣one of parameters is not valid.

This command is for setting duty cycle and Tx power for the assigned number of band grouping. For example: AAT2 Tx_Band=0,50,5 (for US) Description: The real duty cycle = 100% / 50 = 2% Modify band grouping 0 to set duty cycle as 2% and Tx power index as 5 (20dBm).

AAT2 Tx_Band=?

Response: the list of all Tx bands will be shown. This command is for reading the list of all Tx bands.

Page 15: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

15

Command Description

AAT2 Tx_Bandx=?

Response: the assigned Tx band will be shown. Variable x needs to be assigned as band grouping number. This command is for reading the assigned Tx band. For example: AAT2 Tx_Band0=? The message will be shown as below: Band_0, DutyCycle.1, TxPower.5

AAT2 Uplink_Count=?

Response: decimal number representing the number of uplink frame counter. This command is for reading the number of uplink frame counter.

AAT2 Downlink_Count=?

Response: decimal number representing the number of downlink frame counter. This command is for reading the number of downlink frame counter.

AAT2 Tx_Power=

[parameter1],[parameter2]

[parameter1]:

decimal number representing the index of Tx power from 0

to 15.

[parameter2]: decimal number representing the real TxPower. The range for US is 0 to 30. The range for EU is from 0 to 20. Response:

ok ﹣address is valid

invalid_param ﹣one of parameters is not valid

This command is for setting the index of Tx power and the real Tx power for Tx power table.

AAT2 Tx_Power=?

Response: the Tx power table will be shown. This command is for reading Tx power table.

AAT2 Tx_Powerx=?

Response: the real power of assigned Tx power index will be shown. Variable x needs to be assigned as Tx power index. This command is for reading the real power of the assigned Tx power index. For example: AAT2 Tx_Power2=? The message will be shown as below:

Page 16: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

16

Command Description

TxPower_2, 26 dBm.

AAT2 Pl_Max_Length=

[parameter1],[parameter2]

[parameter1]:

decimal number representing Data Rate from 0 to 15.

[parameter2]:

decimal number representing maximum application

payload length (N) from 0 to 255.

Response:

ok ﹣address is valid

invalid_param ﹣one of parameters is not valid

This command is for setting maximum application payload length (N) (without repeater) according to the assigned Data Rate.

AAT2 Pl_Max_Length=?

Response: the list of all Pl_Max_Length settings will be shown. This command is for reading the list of all Pl_Max_Length settings.

AAT2 Pl_Max_Lengthx=?

Response: the list of assigned Pl_Max_Length setting will be shown. Variable x needs to be assigned as the level of Data Rate. This command is for reading the assigned Pl_Max_Length setting.

AAT2 Plre_Max_Length=

[parameter1],[parameter2]

[parameter1]:

decimal number representing DataRate from 0 to 15.

[parameter2]:

decimal number representing maximum application

payload length (N) from 0 to 255.

Response:

ok ﹣address is valid

invalid_param ﹣one of parameters is not valid

This command is for setting maximum application payload

length (N) (with repeater) according to the assigned Data Rate.

AAT2 Plre_Max_Length=?

Response: the list of all Plre_Max_Length settings will be shown. This command is for reading the list of all Plre_Max_Length settings.

AAT2

Plre_Max_Lengthx=?

Response: the list of assigned Plre_Max_Length setting will be shown. Variable x needs to be assigned as the level of Data Rate. This command is for reading the assigned Plre_Max_Length setting.

Page 17: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

17

4. MOST Link AT Command

AAT1 - Command for parameters setting up and send / receive data.

AAT3 - Command for functions setting up under MOST Link.

Under this protocol, the default mode is Disable (P0=0), which is the payload data transmission

in transparent. It only supports command A0, A1 for AES128 encryption function.

Use AT command [AAT3 P0=1] to Enable MOST Link mode. (Ref. Appendix Table A.)

Command Description

AAT3 P0=parameter

Enable / Disable MOST Link mode [parameter]: x (Default=0, 1 Digit) 1: Enable 0: Disable Response:

ok ﹣parameter is valid

invalid_param ﹣parameter is not valid

AAT3 P0=?

Read MOST Link mode status Response: x

0 ﹣Disable

1 ﹣Enable

AAT1 Save All parameters are saved.

AAT1 Reset Reboot the LM-130H1.

AAT1 Restore Restore to default parameters and reboot.

AAT1 UpdateFW LT-130H1 is ready for new firmware upgrade.

AAT3 MA=parameter

Set LoRa Device Role [parameter]: x (Default=0, 1 Digit) 0: set module as Node 1: set module as Gateway Response:

ok ﹣parameter is valid

invalid_param ﹣parameter is not valid

AAT3 MA=?

Read LoRa Device Role status Response: x

0 ﹣Node

1 ﹣Gateway

AAT3 MD=parameter Set LoRa Device MODE

Page 18: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

18

Command Description

[parameter]: x (Range: 1-3, Default=1) 1: Mode 1, Normal mode 2: Mode 2, Wake up mode 3: Mode 3, Power saving mode Response:

ok ﹣parameter is valid

invalid_param ﹣parameter is not valid

Note: 1. In Mode-2, the module stays awake and send

wake up code (i.e. Normal mode plus with preamble byte) if data transmission needed.

2. In Mode-3, the module kept sleep, send [AAT1 WK] or any command would feedback “ACK” on screen as a wake up code. Within 0.5 sec the ACK respond, send [AAT3 MD=1] to change it back to Mode-1. It would only accept commands [AAT3 MD] and [AAT1 Save] during this mode.

AAT3 MD=?

Read LoRa Device MODE status Response: x

1 ﹣Normal mode

2 ﹣Wake up mode

3 ﹣Power saving mode

AAT1 L0=?

Read LoRa Device MAC Response: xxxxxxxxxxxxxxxx (16 Bytes) Example: ABCDEF0123456789

AAT1 L1=?

Read LoRa Device Name Response: LM130H1 (7 Bytes) Example: LM130H1

AAT1 L2=?

Read LoRa Device FW Version Response: F-XXX-XX-XXXXXXX (16 Bytes) Example: F-0LR-1E-1703221

AAT1 L3=parameter

Set LoRa Channel Group ID [parameter]: x (Range: 0-255, Default=0) Response:

ok ﹣parameter is valid

invalid_param ﹣parameter is not valid

AAT1 L3=? Read LoRa Channel Group ID Response: x (Range: 0-255)

Page 19: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

19

Command Description

AAT1 L4=parameter1,parameter2

Set LoRa Channel Rx / Tx Frequency [parameter1]: xxxxxx (Rx, 6-digit, Default=915000) [parameter2]: xxxxxx (Tx, 6-digit, Default=915000) Response:

ok ﹣parameter is valid

invalid_param ﹣parameter is not valid

Example: Set frequency Rx/Tx both in 921000 KHz inputs [AAT1 L4=921000,921000]

AAT1 L4=?

Read LoRa Channel Rx / Tx Frequency Response: xxxxxx, xxxxxx Note: Frequency default Rx/Tx shows [915000,915000]

AAT1 L5=parameter

Set LoRa Channel Data Rate [parameter]: x (Range: 0-5, Default=3) Value 0-5: 0=0.81K, 1=1.46K, 2=2.6K, 3=4.56K, 4=9.11K, 5=18.23K bps Response:

ok ﹣parameter is valid

invalid_param ﹣parameter is not valid

AAT1 L5=? Read LoRa Channel Data Rate Response: x (Range: 0-5)

AAT1 L6=parameter

Set LoRa Channel Wake up Time [parameter]: x (Range: 0-9, Default=3) Value 0-9: 0=200ms, 1=400ms, 2=600ms, 3=1s, 4=1.5s, 5=2s, 6=2.5s, 7=3s, 8=4s, 9=5s Response:

ok ﹣parameter is valid

invalid_param ﹣parameter is not valid

AAT1 L6=? Read LoRa Channel Wake up Time Response: x (Range: 0-9)

AAT1 L7=x

Set Module Tx Power Value [parameter]: x (Range: 0-7, Default=7, 20dBm) Value 0-7: 0=0dBm, each step increases 3dBm(approx.)

Page 20: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

20

Command Description

Response:

ok ﹣parameter is valid

invalid_param ﹣parameter is not valid

AAT1 L7=? Read Module Tx Power value Response: x (Range: 0-7)

AAT1 T1=parameter * MOST Link Disable, P0= 0

Send Data to LoRa Channel via LM-130H1 [parameter]: The capable transmitted length of [parameter] depends upon the Data Rate. 1. The length of the parameters : 2-198 Bytes

(Payload: 1-99 Bytes) 2. The length of the parameters : 2-192 Bytes

(Payload: 1-96 Bytes) *AES128 Enable

Response:

ok ﹣parameter is valid

invalid_param ﹣parameter is not valid

Tx_OK ﹣module data is transmitted

Received end would shown: AAT1 R1=RSSI,data Data received from LoRa Channel, UART output [RSSI]: RSSI range is 0-160 integer (Decimal) [data]: data is ASCII (Hex) format, and terminated with <CR><LF> at the end. The capable transmitted length of [data] depends upon the Data Rate. The length of the parameters : 1-99 Bytes * Ref. Appendix Table B. Note: Transmission data format must be ASCII (Hex).

Example: 0x41 are two digits ‘41’ in ASCII (Hex) format, transform in letter is A.

AAT1 T2=ack,LoRa_MAC,payload * MOST Link Enable, P0= 1

Send Data to LoRa Channel via LM-130H1, Module is Gateway (MA=1) [ack] x 1: ACK enable 0: ACK disable [LoRa MAC]: xxxxxxxxxxxxxxxx (16 Btyes) Enable MOST Link mode, send to the Node of

Page 21: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

21

Command Description

specify MAC. [payload]: The capable transmitted length of [data] depends upon the Data Rate. 1. The length of the parameters : 2-168 Bytes

(Payload: 1-84 Bytes) 2. The length of the parameters : 2-160 Bytes

(Payload: 1-80 Bytes) *AES128 Enable

Response:

ok ﹣parameter is valid

invalid_param ﹣parameter is not valid

Tx_OK ﹣module data is transmitted

Tx_NO_ACK ﹣ module data is not transmitted

Received end would shown: AAT1 R2=RSSI,LoRa_MAC,Flags,Payload Data received from LoRa Channel, UART output [RSSI]: RSSI range is 0-160 integer (Decimal) [LoRa_MAC]: LoRa MAC = 0 (Node will check whether this MAC is for itself) [Flags]: x (Hex) MOST Link AT Command Flags [Payload]: received data(Hex) from Gateway. * Ref. Appendix Table B. Note: Transmission data format must be ASCII (Hex). Example: Letter A is 0x41

AAT1 T3=ack,payload * MOST Link Enable, P0= 1

Send Data to LoRa Channel via LM-130H1, Module is Node (MA=0) [ack] x 1: ACK enable 0: ACK disable [payload]: The capable transmitted length of [data] depends upon the Data Rate.

1. The length of the parameters : 2-168 Bytes (Payload: 1-84 Bytes)

2. The length of the parameters : 2-160 Bytes (Payload: 1-80 Bytes)

Page 22: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

22

Command Description

*AES128 Enable Response:

ok ﹣parameter is valid

invalid_param ﹣parameter is not valid

Tx_OK ﹣module data is transmitted

Tx_NO_ACK ﹣ module data is not transmitted

Received end would shown: AAT1 R2=RSSI,LoRa_MAC,Flags,Payload Data received from LoRa Channel, UART output [RSSI]: RSSI range is 0-160 integer (Decimal) [LoRa_MAC]: xxxxxxxxxxxxxxxx LoRa MAC = 16 Bytes [Flags]: x (Hex) MOST Link AT Command Flags [Payload]: received data(Hex) from Node. * Ref. Appendix Table B. Note: Transmission data format must be ASCII (Hex). Example: Letter A is 0x41

AAT3 A0=parameter

Enable / Disable AES128 Encryption [parameter]: x (Default=0, 1 Digit) 0: Disable 1: Enable Response:

ok ﹣parameter is valid

invalid_param ﹣parameter is not valid

Note: 1. A0 set 1, data is encrypted before sending,

receiving side check Flags setting: Bit4=1 is at auto decryption.

2. AES128 encryption multiplied in length of 16 Bytes, A0=1 Payload sending data length is different. AAT1 T1: Payload= 96 Bytes AAT1 T2/T3: Payload= 80 Bytes

AAT3 A0=?

Read AES128 Encryption status Response: x

0 ﹣Disable

1 ﹣Enable

Page 23: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

23

Command Description

AAT3 A1=parameter

Set AES128 Encryption KEY [parameter]: The parameter format is 16 Bytes, the length transform into ASCII (Hex) is 32 Bytes. Response:

ok ﹣parameter is valid

invalid_param ﹣parameter is not valid

Note: The letter length is 16 Bytes, Default= GlobalSat2016abc [ASCII] 476C6F62616C53617432303136616263 (32-Byte)

AAT3 A1=?

Read AES128 Encryption KEY Response: xxxxxxxxxxxxxxxx (Hex, 32 Bytes) Range : The letter length format is ASCII in 16 Bytes, transformed into Hexadecimal is 32 Bytes.

AAT3 P3=parameter1,parameter2

Set MOST Link Resend Cycle [parameter1]: x (Range: 0-9, Default=0) 0= Disable resend cycle [parameter2]: y (Range: 1-255, Default=3) ACK timeout (Sec) Response:

ok ﹣parameter is valid

invalid_param ﹣parameter is not valid

AAT3 P3=?

Read MOST Link Resend Cycle Response: x,y x (Range: 0-9) y (Range: 1-255)

Page 24: LoRaTM Wireless Communication Module...AAT2 DutyCycle=[parameter1] [parameter1]: 0: disable 1: enable Response: ok ﹣address is valid invalid_param ﹣parameter1 is not valid This

24

5. Appendix

Command Protocol

AAT1 LW = 0 LoRaWAN (Default)

AAT1 LW = 1 MOST Link Disable (P0=0)

Enable (P0=1)

Table A. - Device Protocol Definition

MOST Link Send Received-ends

Disable (Default) T1 R1

Enable

T2

[ Gateway, MA=1 ]

R2

[ LoRa MAC=0 ]

T3

[ Node, MA=0 ]

R2

[ LoRa MAC=16 Bytes ]

Table B. - MOST Link mode Send and Received-ends relational