RAK813 LoRaWAN+BLE+GPS Sensor Node With Eclipse IDE

In the IoT world, it is all about security, connectivity, and low power. LoRaWAN with the Things Network is able to connect devices over several kilometers, and I’m running my gateway for it already (see “Contributing an IoT LoRaWAN Raspberry Pi RAK831 Gateway to The Things Network“). This tutorial is about building a BLE+LoRaWAN+GPS sensor node with GNU tools and Eclipse:

LoRa+BLE with RAK813 and LPC845

As far as hardware, I’m using the RAK815 board, which features the RAK813 BLE+LoRaWAN module from RAK Wireless.

I ordered the RAK815 board from AliExpress as a kit (EU868) for $52, which includes everything you need to get started:

RAK815 Kit

The board features the RAK813 module (nRF52832+SX1276), a uBlox GPS module, the SHT31 humidity/temperature sensor, plus the LIS3DH accelerometer.

Setup

For this tutorial, you need:

• Eclipse IDE: the IDE we are going to use
• GNU MCU Eclipse Plugins: Eclipse plugins to use the GNU toolchain for ARM
• GNU toolchain for ARM: the GNU toolchain
• nRFgo Studio: used to flash the Nordic SoftDevice
• RAK815 board with RAK813 module (search on AliExpress: “RAK815”)
• SEGGER J-Link (e.g. SEGGER J-Link Mini with the debug Adapter from Adafruit).

To set up the IDE+toolchain, see this tutorial on how to set up a DIY IDE.

The picture below shows my setup. The RAK815 includes an nRF52832 (ARM Cortex M4F with 512KByte FLASH and 64 KByte RAM). I’m using it in combination with the NXP LPC845-BRK board:

Hardware Setup

Because the original projects provided by RAK Wireless are for IAR and Keil only, I have ported them to Eclipse: that way, the free-of-charge IDE and compiler can be used.

The complete project is available on GitHub (see the links at the end of this article).

Below are the porting steps:

Creating a Project

First, clone the repository from https://github.com/RAKWireless/RAK813-BreakBoard

Then, create an empty project for GNU ARM Embedded

Add the Apps, Board, LoRa_Lib, and nRF_Lib folders as linked folders to the project. Add startup code and System files:

Linked Folders

Files not used have to be ‘excluded from build,’ see “Exclude Source Files from Build in Eclipse“.

In the project settings, use the ARM Cortex-M4 with FPU:

ARM Compiler Settings

Add the following folders to the compiler and include settings:

Compiler Includes

../../nRF_Lib/components/toolchain/cmsis/include
../../Apps
../../Board
../../Board/lora_board
../../Board/peripherals
../../LoRa_Lib/mac
../../LoRa_Lib/mac/region
../../LoRa_Lib/radio
../../LoRa_Lib/radio/sx1276
../../LoRa_Lib/system
../../LoRa_Lib/system/crypto
../../nRF_Lib/external/fprintf
../../nRF_Lib/external/segger_rtt
../../nRF_Lib/components/boards
../../nRF_Lib/components/device
../../nRF_Lib/components/ble/ble_services/ble_nus
../../nRF_Lib/components/toolchain
../../nRF_Lib/components/softdevice/common
../../nRF_Lib/components/softdevice/s132/headers
../../nRF_Lib/components/softdevice/s132/headers/nrf52
../../nRF_Lib/components/drivers_nrf/clock
../../nRF_Lib/components/drivers_nrf/common
../../nRF_Lib/components/drivers_nrf/gpiote
../../nRF_Lib/components/drivers_nrf/rtc
../../nRF_Lib/components/drivers_nrf/spi_master
../../nRF_Lib/components/drivers_nrf/timer
../../nRF_Lib/components/drivers_nrf/uart
../../nRF_Lib/components/drivers_nrf/twi_master
../../nRF_Lib/components/libraries/balloc
../../nRF_Lib/components/libraries/bsp
../../nRF_Lib/components/libraries/util
../../nRF_Lib/components/libraries/button
../../nRF_Lib/components/libraries/experimental_log
../../nRF_Lib/components/libraries/experimental_memobj
../../nRF_Lib/components/libraries/fds
../../nRF_Lib/components/libraries/fifo
../../nRF_Lib/components/libraries/fstorage
../../nRF_Lib/components/libraries/uart
../../nRF_Lib/components/libraries/experimental_section_vars
../../nRF_Lib/components/drivers_nrf/hal
../../nRF_Lib/components/libraries/strerror
../../nRF_Lib/components/libraries/experimental_log/src
../../nRF_Lib/components/libraries/timer
../../nRF_Lib/components/drivers_nrf/delay
../../nRF_Lib/components/libraries/atomic
../../nRF_Lib/components/libraries/pwr_mgmt
../../nRF_Lib/components/ble/common
../../nRF_Lib/components/libraries/mutex
../../nRF_Lib/components/ble/ble_advertising
../../nRF_Lib/components/drivers_nrf/wdt
../../nRF_Lib/components/ble/nrf_ble_gatt
../../nRF_Lib/components/libraries/mem_manager
../../nRF_Lib/components/ble/ble_db_discovery
../../nRF_Lib/components/ble/peer_manager
../../nRF_Lib/components/libraries/atomic_fifo

Define the following in the compiler Preprocessor-defined symbols:

preprocessor Settings

BOARD_CUSTOM
USE_APP_CONFIG
NRF52
NRF52832_XXAA
NRF52_PAN_74
NRF_SD_BLE_API_VERSION=5
S132
SOFTDEVICE_PRESENT
SWI_DISABLE0
CONFIG_GPIO_AS_PINRESET
REGION_EU868

Specify the linker file:

Linker File

Link the Math library and use ‘..’ as library path to find the linker file:

Math Library

Use the newlib-nano without syscalls:

Library Options

The linker file needs to match the size of the SoftDevice. Using the S123, the start address for the application is 0x23000:

MEMORY
{
  FLASH (rx) : ORIGIN = 0x1c000+0x7000, LENGTH = 0x64000-0x7000 
  RAM (rwx) :  ORIGIN = 0x20002a68, LENGTH = 0xd598
}

With this, the application should build just fine

Application Build with Eclipse

Debug Connection

The board does not have a standard debug header :-(, so I have to build an adapter:

SWD Debug Header (Source: RAK815 Schematics)

I’m using the J-Link Mini, which has the 10pin mini SWD/JTAG connector. With the Adafruit Debug adapter, I can connect the wires:

Debug Connection

SoftDevice

As a first step, the SoftDevice needs to be programmed. Use the nRFgo Studio and use the following SoftDevice file:

<repo>/nRF_Lib/components/softdevice/s132/hex/s132_nrf52_5.0.0_softdevice.hex

programming SoftDevice with nRFgo Studio

Notice that the SoftDevice will use the Region 1 up to 0x23000: This is how we have configured the linker file.

Debug

Now, we can use GDB to download and debug the target. Create a new .launch Debug configuration. Check that it is pointing to the correct Segger Client and GDB server:

Debug Configuration

With this, I’m debugging the application:

Debugging LoRaWAN Application

It reports the status to the serial console:

console output

Note: The EUI’s and keys are defined in Commissioning.h or can be configured with the smartphone using the BLE connection.

Success.

Summary

It took me a while to build that LoRaWAN+BLE demo application, but now, I have the power of Eclipse to develop it further. The RAK815 board comes with everything I need to start the first prototype for a larger application. With the BLE, I can connect to a smartphone (using a virtual UART), and with the LoRaWAN, I can communicate to the gateways in my area. The board includes an SSD1306 I2C LCD interface, which I plan to add in a next step.

Happy RAKing!

Links:

• The project discussed in this article: https://github.com/ErichStyger/RAK813-BreakBoard
• RAK813 GitHub: https://github.com/RAKWireless/RAK813-BreakBoard
• Getting Started with RAK815 (Arduino): https://www.hackster.io/naresh-krish/getting-started-with-rak815-tracker-module-and-arduino-1c7bc9