Skip to content

Configuring your RAK811 LoRa® Breakout Module

Outdated: this section documents The Things Network V2, which is no longer maintained. See the documentation for The Things Stack V3, or browse the V2 docs index.

The purpose of this document is to demonstrate on how to configure the RAK811 thru the use of AT Commands via a Serial Port Tool running in your Windows PC. The list below shows the AT Commands available for use:

Note: It is highly recommended to use our own RAK Serial Port Tool for its built-in AT Commands for your convenience.

AT Command Description
at+version Get the current firmware version number.
at+get_config=device:status Get all information about the device’s hardware components and their current status.
at+set_config=device:restart After set, the device will restart.
at+set_config=device:boot Let the device work in boot mode
at+run Stop boot mode and run as normal. It is valid when the device works in boot mode.
at+set_config=device:sleep:X After setting, the device will go to sleep mode or wake up immediately.{::nomarkdown}
  • X - 0: sleep, 1: wake-up
{:/}
at+join Start to join LoRa® network
at+send=lora:X:YYY Send a customized data.{::nomarkdown}
  • X - LoRa® port
{:/}{::nomarkdown}
  • YYY - the data which you want to send. The limited length is 50 Bytes, and the data must be in HEX format.
{:/}
at+set_config=lora:work_mode:X Set the work mode for LoRa®.{::nomarkdown}
  • X - 0: LoRaWAN™, 1: LoRaP2P, 2: Test Mode.
{:/}
at+set_config=lora:join_mode:X Set the join mode for LoRaWAN™.{::nomarkdown}
  • X - 0: OTAA, 1: ABP
{:/}
at+set_config=lora:class:X Set the class for LoRa®.{::nomarkdown}
  • X - 0: Class A,1: Class B,2: Class C
{:/}
at+set_config=lora:region:XXX Set the region for LoRa®.{::nomarkdown}
  • XXX - one of the following items: EU868 EU433, CN470, IN865, EU868, AU915, US915, KR920, AS923.
{:/}
at+set_config=lora:confirm:X Set the type of messages which will be sent out through LoRa®.{::nomarkdown}
  • X - 0: unconfirm, 1: confirm
{:/}
at+set_config=lora:dev_eui:XXXX Set the device EUI for OTAA.{::nomarkdown}
  • XXXX - the device EUI.
{:/}
at+set_config=lora:app_eui:XXXX Set the application EUI for OTAA.{::nomarkdown}
  • XXXX - the application EUI.
{:/}
at+set_config=lora:app_key:XXXX Set the application key for OTAA.{::nomarkdown}
  • XXXX - the application key.
{:/}
at+set_config=lora:dev_addr:XXXX Set the device address for ABP.{::nomarkdown}
  • XXXX - the device address.
{:/}
at+set_config=lora:apps_key:XXXX Set the application session key for ABP.{::nomarkdown}
  • XXXX - the application session key.
{:/}
at+set_config=lora:nwks_key:XXXX Set the network session key for ABP.{::nomarkdown}
  • XXXX - the network session key.
{:/}
at+set_config=lora:ch_mask:X:Y Set a certain channel on or off.{::nomarkdown}
  • X - the channel number, and you can check which channel can be set before you set it.
{:/}{::nomarkdown}
  • Y - 0: off, 1: on
{:/}
at+set_config=lora:adr:X Open or close the ADR function of LoRa® Node.{::nomarkdown}
  • X - 0: Close ADR, 1: Open ADR.
{:/}
at+set_config=lora:dr:X Set the DR of LoRa® Node.{::nomarkdown}
  • X - the number of DR. Generally, the value of X can be 0~5. More details, please check the LoRaWAN™ 1.0.2 specification.
{:/}
at+get_config=lora:channel It will return the state of all LoRa® channels, then you can see which channel is closed and which channel is open very clearly
at+set_config=lorap2p:XXX:Y:Z:A:B:C Set the parameters for LoRa® P2P mode. This AT command is valid when the work mode is ·LoRaP2P.{::nomarkdown}
  • XXX - Frequency in Hz.
{:/}{::nomarkdown}
  • Y - Spreading factor, [6, 7, 8, 9, 10, 11, 12].
{:/}{::nomarkdown}
  • Z - Bandwidth, 0: 125 kHz, 1: 250 kHz, 2: 500kHz.
{:/}{::nomarkdown}
  • A - Coding Rate, 1: 4/5, 2: 4/6, 3: 4/7, 4: 4/8.
{:/}{::nomarkdown}
  • B - Preamble Length, 5~65535.
{:/}{::nomarkdown}
  • C - Power in dbm, 5~20.
{:/}
at+send=lorap2p:XXX Send data through LoRaP2P. This AT command is valid when it works in LoRaP2P mode.{::nomarkdown}
  • XXX - the data in HEX.
{:/}