RAK4270 WisDuo Breakout Board Quick Start Guide

Prerequisites

What Do You Need?

Before going through each and every step in the installation and guide of the RAK4270 Breakout Board, make sure to prepare the necessary items listed below:

Hardware Tools

1. RAK4270 Breakout Board
2. USB-UART Module (RAKDAP1 Tool)
3. Gateway in Range for Testing
4. Jumper Wires
5. 3.3 V Battery Power Supply
6. A Windows/Mac OS/Linux Computer

Software Tools

1. RAK Serial Port Tool
2. RAK4270 Firmware
3. RAK Device Firmware Upgrade (DFU) Tool

NOTE

The bootloader of the RAK4270 Breakout Board is already pre-installed upon manufacturing so flashing the bootloader is not necessary for you to perform. If you find that the bootloader of your RAK4270 Breakout Board is damaged, contact RAK support through RAKwireless forum. However, if you want to upgrade the firmware of the device, refer to the miscellaneous section of this document.

What's Included in the Package?

• 1 pc - RAK4270 Breakout Board (chipset pre-soldered on the board)
• 1 pc - LoRa Antenna

List of Acronyms

Acronym	Definition
DFU	Device Firmware Upgrade
JTAG	Joint Test Action Group
LoRa	Long Range
OTAA	Over-The-Air-Activation
ABP	Activation-By-Personalization (ABP)
TTN	The Things Network
TTS	The Things Stack

Product Configuration

Interfacing with RAK4270 Breakout Board

RAK4270 Breakout Board can be configured using AT commands via the UART interface. You need a USB to UART TTL adapter to connect the RAK4270 board to the PC's USB port and a serial terminal tool.

You can use RAKDAP1 as the USB to the UART interface device. RAKDAP1 is compatible with other RAK modules and can be used as a debugging tool and firmware uploader. It is also highly recommended to use the RAK Serial Port Tool so you can easily send AT commands and view the replies from its console output.

warning

Before powering the RAK4270 Breakout Board, make sure you have installed the LoRa antenna first. Not doing so might damage the board.

USB to UART

• Connect your RAK4270 Breakout Board to the USB-UART interface, as shown in Figure 1 and Figure 2.
• UART1 is used for AT commands input as well as a firmware update. Check the RAK4270 Breakout Board Pin Definition on the datasheet for complete details.

Figure 7651: RAK4270 Breakout Board Connected to RAKDAP1 USB-UART Interface

Figure 7652: RAK4270 Breakout Board to USB Uart Module Connection

• Connect your USB - UART Module to your Windows PC and open RAK Serial Port Tool then select the right COM port and baud rate.

Figure 7653: Correct Port Number and Baud rate

Connecting to The Things Stack (TTN V3)

This section will show how to connect the RAK4270 board to The Things Stack (TTN V3) platform.

Figure 7654: The Things Stack diagram

As shown in Figure 4, The Things Stack is an open-source LoRaWAN Network Server suitable for global, geo-distributed public and private deployments as well as for small, local networks. The architecture follows the LoRaWAN Network Reference Model for standards compliancy and interoperability. This project is actively maintained by The Things Industries.

LoRaWAN is a protocol for low-power wide-area networks. It allows large-scale Internet of Things deployments where low-powered devices efficiently communicate with Internet-connected applications over long-range wireless connections.

The RAK4270 Breakout Board can be part of this ecosystem as a device, and the objective of this section is to demonstrate how simple it is to send data to The Things Stack using the LoRaWAN protocol. To achieve this, the RAK4270 board must be located inside the coverage of a LoRaWAN gateway connected to The Things Stack server.

Registration to TTN and Creating LoRaWAN Applications

The first step is to go to The Things Network platform and select a cluster, as shown in Figure 5. The Things Industries adds more clusters from time to time so select the one closes to your location. In this guide, Europe 1 is selected.

Figure 7655: Selecting Cluster in TTN V3

You can use the same login credentials on the TTN V2 if you have one. If you have no account yet, you need to create one.

1. To register as a new user to TTN, click on Login with The Things ID then select register on the next page, as shown in Figure 6 and Figure 7.

Figure 7656: Login using TTN account

Figure 7657: Registration of new account

You should now be on the step of creating your TTN account. Fill in all the necessary details and activate your account.

2. After creating an account, you should log in on the platform using your username/email and password then click Submit, as shown in Figure 8.

Figure 7658: Logging in to TTN platform

3. You need to click Authorize to proceed.

Figure 7659: Authorization to TTN

4. Now that you are logged in to the platform, the next step is to create an application. Click Create an application.

Figure 7660: Creating TTN application for your LoRaWAN devices

5. To have an application registered, you need to input first the specific details and necessary information about your application then click Create application.

Figure 7661: Details of the TTN application

If you have no error on the previous step, you should now be on the application console page. The next step is to add end-devices to your The Things Stack application. LoRaWAN specification enforces that each end device has to be personalized and activated. There are two options on registering devices depending on the activation mode selected. Activation can be done either via Over-The-Air-Activation (OTAA) or Activation-By-Personalization (ABP).

NOTE

Once you have the application in The Things Stack (TTN V3), you need to ensure that you are in coverage of a LoRaWAN gateway that is registered to The Things Stack (TTN V3) as well. Without the coverage of that LoRaWAN gateway, you cannot activate any device that you will register in your application.

RAKwireless has LoRaWAN gateways that you can connect to The Things Stack (TTN V3) if no LoRaWAN gateway coverage is available in your location.

The Things Stack OTAA Device Registration

1. Go to your application console to be able to register a device. To start adding an OTAA end-device, you need to click + Add end device, as shown in Figure 12.

Figure 7662: Add end device

2. To register the module, you need to click first Manually then configure the activation method by selecting Over the air activation (OTAA) and compatible LoRaWAN version then click Start button, as shown in Figure 13 and Figure 14.

Figure 7663: Manually register device to The Things Stack

Figure 7664: Device activation configuration

3. Then input a unique End device ID and EUIs (DevEUI and AppEUI), as shown in Figure 15. Check if your module has a DevEUI on sticker or QR that you can scan then use this as the device unique DevEUI.

Optionally, you can add a more descriptive End device name and End device description about your device.

4. After putting all the details, click Network layer settings to proceed to the next step.

NOTE

It is advisable to use a meaningful End device ID, End device name, and End device description that will match your device purpose. The End device ID rak-device is for illustration purposes only.

Figure 7665: OTAA Device Information

5. Next step is to set up Frequency plan, compatible Regional Parameter version, and LoRaWAN class supported. Then you can click Join settings.

Figure 7666: OTAA Configuration

6. The last step in the registration of a new OTAA end device is the configuration of the AppKey. To get the AppKey, you must click the generate button. Then you need to click Add end device to finish your new device registration.

Figure 7667: OTAA AppKey generation and device registration

You should now be able to see the device on The Things Stack console after you fully registered your device, as shown in Figure 18.

NOTE

• The AppEUI, DevEUI, and AppKey are the parameters that you will need to activate your LoRaWAN end device via OTAA. The AppKey is hidden by default for security reasons, but you can easily show it by clicking the show button. You can also copy the parameters quickly using the copy button.

• The three OTAA parameters on The Things Stack device console are MSB by default.

• These parameters are always accessible on the device console page, as shown in Figure 18.

Figure 7668: OTAA device successfully registered to The Things Stack

RAK4270 OTAA Configuration for The Things Stack

The RAK4270 Breakout Board supports a series of AT commands to configure its internal parameters and control the functionalities of the module. To set up the RAK4270 board to join The Things Stack using OTAA, start by connecting the RAK4270 board to the Computer (see Figure 1) and open the RAK Serial Port Tool. Wait for the communication to start. It is recommended to test the serial communication and verify the current configuration by sending either of these two AT commands:

at+set_config=device:restart

at+version

Figure 7669: AT Command response

As an example, these are the list of the parameters you need to configure in RAK4270:

• LoRa join mode: OTAA
• LoRa class: Class A
• LoRa region: EU868
• Device EUI: 1133557799224466
• Application EUI: 1000000000000009
• Application Key: 04FA4E626EF5CF227C969601176275C2

1. Set the LoRa join mode to OTAA.

at+set_config=lora:join_mode:0

2. Set the LoRa class to Class A.

at+set_config=lora:class:0

3. Set the frequency/region to EU868.

• Refer to the RAK4270 Breakout Board Datasheet for the list of supported frequencies.

at+set_config=lora:region:EU868

4. Set the Device EUI.

at+set_config=lora:dev_eui:1133557799224466

5. Set the Application EUI.

NOTE

All zero value Application EUI at+set_config=lora:app_eui:0000000000000000 is not supported and will return error.

at+set_config=lora:app_eui:1000000000000009

6. Set the Application Key.

at+set_config=lora:app_key:04FA4E626EF5CF227C969601176275C2

Figure 7670: Configuring LoRa Parameters

NOTE

After configuring all the parameters, you need to reset your RAK4270 Breakout Board to save the parameters.

7. After resetting, join in OTAA mode.

at+join

After 5 or 6 seconds, if the request is successfully received by a LoRa gateway, then you should see the messages shown in Figure 21.

8. Try to send a message from the RAK4270 board.

at+send=lora:2:1234567890

Figure 7671: OTAA Test Sample Data Sent via RAK Serial Port Tool

You can see the data sent by the RAK4270 board on The Things Stack platform, as shown in Figure 22.

Figure 7672: OTAA Test Sample Data Sent Viewed in The Things Stack

The Things Stack ABP Device Registration

1. To register an ABP device, go to your application console and select the application where you want your device to be added. Then you need to click + Add end device, as shown in Figure 23.

Figure 7673: Add end device

2. To register the module, you need to click first Manually then configure the activation method by selecting Activation by personalization (ABP), compatible LoRaWAN version, and click Start button, as shown in Figure 24 and Figure 25.

Figure 7674: Add end device

Figure 7675: Manually register device to The Things Stack

3. At this step, input a unique End device ID and DevEUI, as shown in Figure 26. Check if your module has a DevEUI on sticker or QR that you can scan then use this as the device unique DevEUI.

Optionally, you can add a more descriptive End device name and End device description about your device.

4. After putting all the details, click Network layer settings to proceed to the next step.

NOTE

It is advisable to use a meaningful End device ID, End device name, and End device description that will match your device purpose. The End device ID rak-device-abp is for illustration purposes only.

Figure 7676: Device Information

5. Next step is to set up Frequency plan, compatible Regional Parameter version, and LoRaWAN class supported. In an ABP device, you also need to generate Device Address and NwkSKey (Network Session Keys). Then you can click Application layers settings.

Figure 7677: ABP Configuration in The Things Stack

6. The last step in the registration of a new ABP end device is the configuration of the AppSKey. To get the AppSKey, you must click the generate button. Then click Add end device to finish your new device registration.

Figure 7678: ABP Configuration in The Things Stack

You should now be able to see the device on The Things Stack console after you fully registered your device, as shown in Figure 29.

Figure 7679: RAK4270 registered at The Things Stack

RAK4270 ABP Configuration for The Things Stack

To set up the RAK4270 Breakout Board to join The Things Stack using ABP, start by connecting the RAK4270 board to the Computer (see Figure 1) and open the RAK Serial Port Tool. It is recommended to test the serial communication by sending either of these two AT commands:

at+set_config=device:restart

at+version

Figure 7680: AT Command response

As an example, these are the list of the parameters you need to configure in RAK4270:

• LoRa join mode: ABP
• LoRa class: Class A
• LoRa region: EU868
• Device address: 260BDE80
• Network Session Key: 433C7A924F7F6947778FE821525F183A
• Application Session Key: A585653A949C2B2D44B55E99E94CB533

1. Set the LoRa join mode to ABP.

at+set_config=lora:join_mode:1

2. Set the LoRa class to Class A.

at+set_config=lora:class:0

3. Set the frequency/region to EU868.

• Refer to the RAK4270 Breakout Board Datasheet for the list of supported frequencies.

at+set_config=lora:region:EU868

4. Set the Device Address.

at+set_config=lora:dev_addr:260BDE80

5. Set the LoRa Network Session Key.

at+set_config=lora:nwks_key:433C7A924F7F6947778FE821525F183A

6. Set the LoRa Application Session Key.

at+set_config=lora:apps_key:A585653A949C2B2D44B55E99E94CB533

Figure 7681: AT Command for ABP LoRa parameters via RAK Serial Port Tool

NOTE

After configuring all the parameters, you need to reset the RAK4270 Breakout Board to save the parameters.

7. After resetting, join in ABP mode.

at+join

NOTE

By using the ABP mode in LoRaWAN, it doesn’t require to join a network before sending a LoRaWAN package. But to keep the consistency of internal states of the firmware of the RAK4270 board, it is still required to send the at+join command in the ABP mode. This time, the firmware should reply almost immediately with an “OK”.

8. Try to send data from the RAK4270 to The Things Network in ABP mode.

at+send=lora:2:1234567890

Figure 7682: ABP Test Sample Data Sent via RAK Serial Port Tool

You can see the data sent by the RAK4270 board on The Things Stack device console Live data section and the Last seen info should be few seconds ago.

Figure 7683: OTAA Test Sample Data Sent Viewed in The Things Stack

Connecting with ChirpStack

The ChirpStack, previously known as the LoRaServer project, provides open-source components for building LoRaWAN networks. Like the case of TTN, the RAK4270 Breakout Module is located in the periphery and transmits the data to the backend servers through a LoRa gateway. Learn more about ChirpStack.

Figure 7684: RAK4270 Breakout Board in the Context of the ChirpStack Platform

NOTE

In this document, it is assumed that you are using RAK Gateway and its built-in ChirpStack or RAK cloud testing ChirpStack. Also, the RAK Gateway with the ChirpStack must be configured successfully. For further information, check the RAK documents.

In this section, you need the following requirements:

1. Have ChirpStack online gateway, the frequency band of the nodes should be consistent with the frequency band of the gateway in use.
   • Connect the Gateway with Chirpstack
2. The RAK Serial Port Tool provided by RAK
3. RAK4270 Breakout Board

NOTE

The frequency band used in the test is EU868, use the high-frequency version of the RAK4270 Breakout Board.

Before you start, you must choose which mode you are going to use, whether in OTAA or ABP mode, to register the device to the network server.

Sign up and login

Login to the ChirpStack server using your account and password.

Create a New Application

1. Go to the Application section, as shown in Figure 35.

Figure 7685: Application Section

2. By default, you should create a new Application, although you can reuse the existing ones. For this setup, create a new Application by clicking on the “CREATE” button, and filling the required parameters, as shown in Figure 36 and Figure 37.

Figure 7686: Creating a New Application

• For this setup, create an Application named “rak_node_test”.

ChirpStack LoraServer supports multiple system configurations, with only one by default.

• Service profile: field is to select the system profile.
• Payload codec: the parsing method for selecting load data such as parsing LPP format data.

Figure 7687: Filling Parameters of an Application

Register a New Device

3. Choose the Application created in the previous step, then select the DEVICES tab, as shown in Figure 38 and Figure 39.

4. Once done, click “CREATE APPLICATION”.

Figure 7688: List of Applications Created

Figure 7689: Device Tab of an Application

5. Once inside of the DEVICE tab, create a new device (LoRa node) by clicking on the “+ CREATE” button.

Figure 7690: Add a New Device

Figure 7691: New Device Registration Form

6. Once the node is created, fill in the necessary data. You can generate a Device EUI automatically by clicking the following icon, or you can write a correct Device EUI in the edit box.

Fill in the parameters requested:

• Device name and Device description: These are descriptive texts about your device.
• Device EUI: This interface allows you to generate a Device EUI automatically by clicking the icon highlighted in red in Figure 42. You can also add a specific Device EUI directly in the form.
• Device Profile:
  • If you want to join in OTAA mode, select “DeviceProfile_OTAA”.
  • If you want to join in ABP mode, select “DeviceProfile_ABP”.

Figure 7692: Generate a New Device EUI

LoRaWAN Join Mode

In LoRaWAN, there are two (2) ways a node can connect itself to the LoRaWAN network. This is referred to as Join Mode. LoRaWAN allows both the OTAA mode and the ABP mode. In this section, the configuration process of these two modes, both on the platform side and the node side will be explained.

OTAA Mode

Configure the OTAA Mode on the Platform

1. If you have selected “DeviceProfile_OTAA”, as shown in Figure 43, then after the device is created, an Application Key must be also created for this device.

Figure 7693: Chirpstack OTAA Activation

2. A previously created Application Key can be entered here, or a new one can be generated automatically by clicking the icon highlighted in red in Figure 44.

Figure 7694: Chirpstack OTAA Set Device Keys

3. Once the Application Key is added to the form, the process can be finalized by clicking on the “SET DEVICE-KEYS” button.

• As shown in Figure 45, a new device should be listed in the DEVICES tab. The most important parameters, such as the Device EUI, are shown in the summary.

Figure 7695: Chirpstack OTAA List of Device in the Device Tab

4. To end the process, it is a good practice to review that the Application Key is properly associated with this device. The Application Key can be verified in the KEYS(OTAA) tab, as shown in Figure 46.

Figure 7696: Application Key Associated with the New Device

NOTE

Standard OTAA mode requires the Device EUI, Application Key, and the Application EUI. But in ChirpStack’s implementation, only the Device EUI and the Application Key are mandatory. The Application EUI is neither required nor recorded in the Application tab. Nevertheless, the Application EUI is a mandatory parameter in the RAK4270 Breakout Board firmware. To resolve this mismatch, you can reuse the Device EUI as the Application EUI during the configuration on the side of the node.

Configure the OTAA mode on the RAK4270 Breakout Board

The RAK4270 Breakout Board supports a series of AT commands to configure its internal parameters and control the functionalities of the module.

To set up the RAK4270 Breakout to join ChirpStack using OTAA, start by connecting the board to the computer (see Figure 2) and open the RAK Serial Port Tool. Wait for the communication to start. It is recommended to test the serial communication by sending either of these two AT commands:

at+get_config=lora:status

at+version

Figure 7697: at+version command response

As an example, these are the list of the parameters you need to configure in the RAK4270 Breakout Board:

• LoRa join mode: OTAA
• LoRa class: Class A
• LoRa region: EU868
• Device EUI: 5e9d1e0857cf25f1
• Application EUI: 5e9d1e0857cf25f1
• Application Key: f921d50cd7d02ee3c5e6142154f274b2

1. Set the LoRa join mode to OTAA.

at+set_config=lora:join_mode:0

2. Set the LoRa class to Class A.

at+set_config=lora:class:0

3. Set the frequency/region to EU868.

• Refer to the RAK4270 Breakout Board Datasheet for the list of supported frequencies.

at+set_config=lora:region:EU868

4. Set the Device EUI.

at+set_config=lora:dev_eui:5e9d1e0857cf25f1

5. Set the Application EUI.

at+set_config=lora:app_eui:5e9d1e0857cf25f1

NOTE

The App EUI parameter is not needed for the ChirpStack platform; therefore, you will use the same ID as the Device EUI. Otherwise, the firmware will fail to connect to the network server.

6. Set the Application Key.

• Get the Application Key from the TTN register.

at+set_config=lora:app_key:f921d50cd7d02ee3c5e6142154f274b2

Figure 7698: Chirpstack OTAA configuration via RAK Serial Port Tool

NOTE

After configuring all the parameters, you need to reset your RAK4270 Breakout Board to save the parameters.

7. After resetting, start to join.

at+join

Figure 7699: Chirpstack OTAA Join the Network via RAK Serial Port Tool

8. You can then see the JoinRequest and JoinAccept on the ChirpStack page.

Figure 7700: Checking LoRaWAN Joint Request in Chirpstack OTAA Console

9. Try to send data from the RAK4270 Breakout Board to ChirpStack.

at+send=lora:2:1234567890

Figure 7701: Send a LoRaWAN Message via RAK Serial Port Tool

• On the ChirpStack platform, you should also see the messages in the LORAWAN FRAMES tab, as shown in Figure 52. By convention, messages sent from nodes to gateways are considered as Uplinks, while messages sent by gateways to nodes are considered as Downlinks.

Figure 7702: Chirpstack Data Received Preview

This concludes the exercise to send data in the OTAA mode.

ABP Mode

Configure the ABP Mode on the Platform

During the registration of a new device, if you select DeviceProfile_ABP”, as shown in Figure 53, then the ChirpStack platform will assume that this device will join to the LoRaWAN network using the ABP mode.

NOTE

Check “Disable counting frame verification”. During the test, when the module is restarted, the frame counting number will be also be restarted from zero. This would cause a synchronization problem with the ChirpStack server treating it as a replay attack. For the testing purpose, it is safe to disable this feature, but remember to activate it in a production environment.

Figure 7703: ChirpStack Console, Configuring a Device

After selecting the ABP mode, the following parameters appear in the Activation tab:

• Device address
• Network Session Key
• Application Session Key

Figure 7704: Chirpstack ABP Activation Parameters Needed

• The parameters can be generated as random numbers by the platform or can be set with user values. Once these parameters are filled in properly, the process is completed by clicking on the “ACTIVATE DEVICE” button.

Configure the ABP mode on the RAK4270 Breakout Board

In the following steps, you will configure the RAK4270 Breakout Board to work in the ABP mode. To set up the RAK4270 Breakout Board to join ChirpStack using ABP, start by connecting the board to the computer (see Figure 2) and open the RAK Serial Port Tool. Wait for the communication to start. It is recommended to test the serial communication by sending either of these two AT commands:

at+get_config=lora:status

at+version

Figure 7705: at+version command response

As an example, these are the list of the parameters you need to configure in the RAK4270 Breakout Board:

• LoRa join mode: ABP
• LoRa class: Class A
• LoRa region: EU868
• Device address: 26011af9
• Network Session Key: c280cb8d1df688bc18601a97025c5488
• Application Session Key: 4d42ec5caf97f03d833cdaf5003f69e1

1. Set LoRa join mode to ABP.

at+set_config=lora:join_mode:1

2. Set LoRa class to Class A.

at+set_config=lora:class:0

3. Set the frequency/region to EU868.

• Refer to the RAK4270 Breakout Board Datasheet for the list of supported frequencies.

at+set_config=lora:region:EU868

4. Set the Device Address.

at+set_config=lora:dev_addr:26011af9

5. Set the Network Session Key.

at+set_config=lora:nwks_key:c280cb8d1df688bc18601a97025c5488

6. Set the Application Session Key.

at+set_config=lora:apps_key:4d42ec5caf97f03d833cdaf5003f69e1

Figure 7706: Chirpstack ABP Parameters Configuration via RAK Serial Port Tool

NOTE

After configuring all the parameters, you need to reset your RAK4270 Breakout Board to save the parameters.

7. After resetting the RAK4270 Breakout Board, join in ABP mode.

at+join

NOTE

By using the ABP mode in the LoRaWAN protocol, it doesn’t require to join a network before sending the LoRaWAN package. But to keep the consistency of internal states of the firmware of the RAK4270 Breakout Board, it is still required to send the at+join command in the ABP mode. This time, the firmware should reply almost immediately with an “OK”.

8. Try to send data from the RAK4270 Breakout Board to ChirpStack.

at+send=lora:2:1234567890

Figure 7707: Chirpstack Sample Data Sent via RAK Serial Port Tool

LoRa P2P Mode

This section will show you how to set up and connect two RAK4270 Breakout Board units to work in the LoRa P2P mode. You will be using EU868 as your frequency, although it is applicable also to other standard bands.

1. Two RAK4270 Breakout Board units shall be set to operate on EU868 frequency.

2. The setup of the RAK4270 board units is done by connecting them with a general-purpose computer through the UART port. The setup of each RAK4270 Breakout Board can be done separately, but testing the LoRa P2P mode will require having both units connected simultaneously to their respective UART port. This could be one computer with two USB ports or two computers with one USB port each.

3. Set the RAK4270 Breakout Board to work in LoRa P2P mode. Open the RAK Serial Port Tool and send the following command:

at+set_config=lora:work_mode:1

Figure 7708: P2P Initialization

4. Then, configure LoRa P2P parameters for both of them.

at+set_config=lorap2p:XXX:Y:Z:A:B:C

For this example, the LoRa parameters are the following:

• Link frequency: 869525000 Hz
• Spreading factor: 7
• Bandwidth: 125 kHz
• Coding Rate: 4/5
• Preamble Length: 5
• Power: 5 dBm

NOTE

Refer to the Configuring Using AT Commands section to learn more about the definition of the parameters used.

Hence, it is translated into the following RAK4270 Breakout Board AT command and sent to both units.

at+set_config=lorap2p:869525000:7:0:1:5:5

Figure 7709: Configuring P2P in both RAK4270 Breakout Board

5. Set the transmission mode of the module. Unit 1 is configured as the sender, and Unit 2 is set to the receiver by AT command.

at+set_config=lorap2p:transfer_mode:2

at+set_config=lorap2p:transfer_mode:1

Figure 7710: Setting Modes in both RAK4270 Breakout Board

6. Try to send a message from Unit 1 to Unit 2.

at+send=lorap2p:1234567890

Figure 7711: Message sent and received status in the two modules

Miscellaneous

Upgrading the Firmware

Before you start working with the RAK4270 Breakout Board, it is recommended to keep the board updated to the latest version of the firmware. Download the latest RAK4270 firmware.

NOTE

For RAK4270 modules with firmware version V3.0.0.12 and below, you need to use the STM32CubeProgrammer to upgrade your firmware and upload the .hex file (not the .bin file) of the latest RAK4270 firmware. The lower versions of the firmware have a different bootloader code and will not work on the RAK DFU Tool.

In the following sections, two (2) options for flashing new firmware in the RAK4270 Breakout Module are shown: Upgrade through DAPLink and Upgrade through UART1.

Firmware Upgrade Through DAPLink

Refer to the RAKDAP1 Flash and Debug Tool guide in the Accessories Category.

Firmware Upgrade Through UART1

Minimum Hardware and Software Requirements

Refer to the table for the minimum hardware and software required to perform the firmware upgrade using J-Link.

Hardware/Software	Requirement
Computer	A Windows/Ubuntu/Mac computer
Firmware File	Bin firmware file downloaded from the website
Others	A USB to TTL module

Firmware Upgrade Procedure

Execute the following procedure to upgrade the firmware in Device Firmware Upgrade (DFU) mode through the UART1 interface.

1. Download the latest application firmware of the RAK4270 Breakout Board.

   • RAK4270 Firmware

2. Download the RAK Device Firmware Upgrade (DFU) tool.

   • RAK Device Firmware Upgrade (DFU) Tool

3. Connect the RAK4270 Breakout Board with a computer through a USB to TTL.

4. Open the Device Firmware Upgrade tool. Select the serial port and baud rate of the module and click the "Select Port" button.

Figure 7712: Device Firmware Upgrade Tool

5. Select the application firmware file of the module with the suffix ".bin".

Figure 7713: Select Firmware

6. Click the "Upgrade" button to upgrade the device. After the upgrade is complete, the RAK4270 Breakout Board will be ready to work with the new firmware.

Figure 7714: Firmware Upgrading

Figure 7715: Upgrade Successful