Warning:
This section contains documentation written for The Things Network V2, which is no longer maintained. See documentation for The Things Stack V3.

Configuring your RAK811 LoRa® Evaluation Board

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+help This AT command can show all available AT commands of this module/product for you
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+set_config=device:gpio:X:Y Set a certain GPIO pin to high/low level. {::nomarkdown}
  • X - the pin number of a certain GPIO on RAK811 module.
{:/}{::nomarkdown}
  • Y - 0: low level, 1: high level.
{:/}
at+get_config=device:gpio:X Get a certain GPIO’s level. {::nomarkdown}
  • X - the pin number of a certain GPIO on RAK811 module.
{:/}
at+get_config=device:adc:X Get the ADC value. {::nomarkdown}
  • X - the pin number of the ADC on RAK811 module.
{:/}
at+set_config=device:iic:X:YY:ZZ:AAA Read data from I2C or write a data to I2C. {::nomarkdown}
  • X - 0: read, 1: write.
{:/}{::nomarkdown}
  • YY - device address, in HEX format.
{:/}{::nomarkdown}
  • ZZ - sensor’s register address, in HEX format.
{:/}{::nomarkdown}
  • AAA - if read, this parameter means the length you want to read. If write, this parameter means the data you want to write. It must be in HEX format too.
{:/}
at+set_config=device:uart_mode:X:Y Set the UART work mode. {::nomarkdown}
  • X - UART number on RAK811 module.
{:/}{::nomarkdown}
  • Y - 1: Passthrough mode.
{:/}{::nomarkdown}
  • Note: If you want to go back to configuration mode, enter +++in the serial port.
{:/}
at+set_config=device:uart:X:Y Set a certain UART’s Baud rate. {::nomarkdown}
  • X - the UART number
{:/}{::nomarkdown}
  • Y - the Baud rate value.
{:/}
at+send=uart:X:YYY Send data through UART. {::nomarkdown}
  • X - the UART number of RAK811 module
{:/}{::nomarkdown}
  • YYY - the data you want to send through UART
{:/}
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+set_config=lora:tx_power:X Set the TX power level.{::nomarkdown}
  • X - The level of TX power.
{:/}If you want to know the relationship between TX power level and dbm, please have a look at LoRaWAN™ 1.0.2 region specification on this link
at+get_config=lora:status It will return all of the current information of LoRa®, except LoRa® channel.
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.
{:/}