/LoRaMac-node_Silabs

LoRaMac-node stack ported to Silicon Labs MCUs

Primary LanguageC

LoRaMacNode for Silabs Family 2

Introduction

This repository details all steps, files and information needed to generate a new Simplicity Studio v5 project for the Family 2 devices and add the LoRaMacNode stack to it and create a basic example of a LoRaWAN application.

HW Requirements

The HW required for this is listed here:

  • Silabs development board, for example:
    • EFM32PG22 Dev Kit - BRD2503A
    • Thunder Board Sense 2 BG22 - BRD4184A
    • Bluetooth radio board MG22 - BR4182A (requires base board BRD4001A)
    • etc
  • Semtech mbed shield, for example:
    • SX1262MB2xAS
    • SX1272MB2xAS
    • etc
  • Adaption boards or wire connections between the target MCU board and the mbed shield. We recommend the following interposer boards:
    • Vermont adapter for Thunderboard > Adapts the pins from the Thunderboard to the EXT spacing
    • Vermont Semtech Silabs LoRa Adapter - Easiest option is the version with configurable connections which can be used with any shield / MCU board by reprogramming the jumper 0 ohm resistors but the previous version with fixed connections (2018) can also be used for specific cases.

Basic Steps

The steps required are:

  1. Create a basic project from the Launcher into Simplicity Studio v5 for the development board selected, using SDK3.1.2 or SDK4.0.1, such as:

    • Bluetooth SoC Thermometer (default name: soc_thermometer) for BG22 or MG22
    • Empty C Project (default name: empty) for PG22
    • etc

  2. Add Software Components for specific peripheral / functions support for anything not originally included into the starting project above. Open .slcp file and review all the details.

    • Into the folder Example_Projects there are ready projects but also instructions on which Components to add for such examples.

  3. Copy the following files and folders from the To_Copy folder:

comm_lorawan
port_loramac_node_board
vendor
  1. Add the following list of include directories for both C Compiler and Assembly:
"${workspace_loc:/${ProjName}/vendor/LoRaMac-node-4.4.7/src/boards}"
"${workspace_loc:/${ProjName}/vendor/LoRaMac-node-4.4.7/src/system}"
"${workspace_loc:/${ProjName}/vendor/LoRaMac-node-4.4.7/src/mac/region}"
"${workspace_loc:/${ProjName}/vendor/LoRaMac-node-4.4.7/src/radio}"
"${workspace_loc:/${ProjName}/vendor/LoRaMac-node-4.4.7/src/peripherals/soft-se}"
"${workspace_loc:/${ProjName}/vendor/LoRaMac-node-4.4.7/src/mac}"
"${workspace_loc:/${ProjName}/comm_lorawan/common/LmHandler/packages}"
"${workspace_loc:/${ProjName}/comm_lorawan/common/LmHandler}"
"${workspace_loc:/${ProjName}/comm_lorawan}"
"${workspace_loc:/${ProjName}/comm_lorawan/common}"
"${workspace_loc:/${ProjName}/port_loramac_node_board}"
  1. Add the following list of defines into the Preprocessor list for C Compiler:
"ACTIVE_REGION=LORAMAC_REGION_AU915"
REGION_AU915=1
SOFT_SE=1
SX1262MBXCAS=1
BLUETOOTH_ID_PRESENT=1
  • This last one BLUETOOTH_ID_PRESENT=1 shall only be added if the Bluetooth ID is present in the MCU (such as in BG22 or MG22 series)

  1. Exclude from Build the unused files for the radio board support, by selecting the radio folder or only the .c file. The location of such folders is vendor/LoRaMac-node-4.4.7/src/radio and at this level there are the transceiver folders SX126x, SX1272 and SX1276. Example: if using the SX1262, exclude from Build, the SX1272 and SX1276 support files / folders.

  2. Configure the mbed shield pins properly into the file board-config.h located into the folder port_loramac_node_board for your specific case. The pins can be modified by either commenting / uncommenting the define lines for the BRDxxxx pins into the EXT connector that lead to the LoRa transceiver signals in the mbed shield or by typing the proper pins in the case such defines aren´t already available.

  3. Modify the application file app.c (or maybe some other related file, such as blink.c when using Blink Baremetal as base project) to properly do the application processing of the LoRaWAN protocol coordinated with the original application tasks.

    • There are example of such application files into the Example_Projects folder to help identify possible processing alternatives.

  4. Don´t forget to configure and create the proper LoRaWAN IDs in the files Commissioning.h and se-identity.h that are into the folder comm_lorawan. The example files mentioned below have all empty zeroed fields.

Ready Example Projects

There are also ready to use example projects in the .sls format inside the folder Example_Projects to use through the Simplicity Studio v5 Import function.

Code Inheritance

The code available here unifies the codes from the repositories available at: