LoRa Basics Modem
Overview
LoRa Basics Modem (LBM) is a LoRaWAN stack developed and maintained by Semtech. It is publicly available on github
LoRa Basics Modem SDK (SWSD001).
Miromico ported the LBM to support the following families of modules:
- FMLR-61-STM
- FMLR-1110-STM
- FMLR-80-STM
The ported code including example applications are available on our github.
Preparing Development Environment
LoRa Basic Modem is using a makefile based compiler environment. The recommended way to develop with LBM under Windows is using WSL. Follow the guide to install WSL on your computer.
Getting the source code
Miromico is providing LBM based example firmware on gitlab This is a fork of the official release from Semtech, ported to Miromico FMLR modules.
Clone the repository and update all submodules using the following git commands
Project Configuration
Modify Makefile defining your hardware. The MCU architecture (STM32L0 or STM32L4) and the correct settings for radio chipset have to be set.
To configure MCU architecture set according to the MCU present on the module. Beware of the case matching for the #defines.
Variable | STM32L0 | STM32L4 |
---|---|---|
BSP | bsp_l0 | bsp_l4 |
BOOTLOADER | bootloader_l0 | bootloader_l4 |
To set configuration for the radio, use configuration as per table below
SX1261 | LR1110 | SX128x | |
---|---|---|---|
RADIO | sx1261 | lr1110 | sx128x |
USE_GNSS | no | yes | no |
REGION | EU_868 or US_915 | EU_868 or US_915 | comment out |
Note
If you want to use a native Windows IDE or text editor to write your code, it is recommended, to clone your code outside WSL in your regular Windows file system. Your Windows file system is mounted in /mnt/c (for C:) within WSL.
Building the Project
To build the application run
Download Application
The EVK is providing an on-board J-Link programmer. Follow the guide using the on-board J-Link on how to install all necessary drivers and download your application onto the target device.
The EVK getting started guide explains how to use the EVK software and send data through LoRaWAN.
Building LoRa Applications
The LoRa Basics Modem stack is provided by Semtech. Check the documentation on their gitlab repository for details on how to get started with writing your own application.
Important
Make sure you configure consistent LoRaWAN parameters such as DevEUi, AppEUI/JoinEUI and AppKey on your device and the network server.