https://github.com/lora-net/swl2001
LoRa Basics Modem LoRaWAN stack
https://github.com/lora-net/swl2001
lbm lora lorawan lr1110 lr1120 lr1121 lr11xx modem stack sx1261 sx1262 sx126x sx1280
Last synced: about 1 month ago
JSON representation
LoRa Basics Modem LoRaWAN stack
- Host: GitHub
- URL: https://github.com/lora-net/swl2001
- Owner: Lora-net
- License: bsd-3-clause-clear
- Created: 2021-10-26T13:29:36.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-12-20T07:29:28.000Z (5 months ago)
- Last Synced: 2025-03-28T15:08:02.942Z (about 2 months ago)
- Topics: lbm, lora, lorawan, lr1110, lr1120, lr1121, lr11xx, modem, stack, sx1261, sx1262, sx126x, sx1280
- Language: C
- Homepage:
- Size: 7.31 MB
- Stars: 134
- Watchers: 28
- Forks: 69
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# LoRa Basic Modem
**LoRa Basic Modem** proposes an full implementation of the [TS001-LoRaWAN L2 1.0.4](https://resources.lora-alliance.org/technical-specifications/ts001-1-0-4-lorawan-l2-1-0-4-specification) and [Regional Parameters RP2-1.0.3](https://resources.lora-alliance.org/technical-specifications/rp2-1-0-3-lorawan-regional-parameters) specifications.
**LoRa Basic Modem** embeds also an implementation of all LoRaWAN packages dedicated to Firmware Update Over The Air (FUOTA):
- Application Layer Clock Synchronization (ALCSync)
- Remote Multicast Setup
- Fragmented Data Block Transport
- Firmware Management Protocol (FMP)
- Multi-Package Access (MPA)
**LoRa Basic Modem** embeds also an implementation the Relay LoRaWAN® Specification TS011-1.0.1
- Relay Tx
- Relay Rx
**LoRa Basic Modem** offers extended services:
- LoRaWAN certification process
- Geolocation with LoRa Edge chips
- LoRaCloud features such as Stream, Large File Upload, Device Management or Almanac Update
## Prerequisites
The ARM GCC tool chain must be setup under your development environment.
LBM library code has been developed using GNU Arm Embedded Toolchain 10-2020-q4-major 10.2.1 20201103 (release)
## LoRa Basics Modem library
LBM library code can be found in folder [lbm_lib](lbm_lib/).
Please refer to [README.md](lbm_lib/README.md) to get all information related to LoRa Basics Modem library
## Examples
Under `lbm_examples` folder, one will find a few examples on how to use the LoRa Basics Modem stack.
- Hardware Modem (Implements a hardware modem controlled by a serial interface)
- Periodical uplink (joins the network and then sends periodic uplinks and each time the button is pushed)
- Porting tests (Allows to verify if the project porting process is correct)
- LCTT certification (to run LoRaWAN certification)
The examples are targeted for the Nucleo L476 kit featuring an STM32L476 micro-controller.
For further details please refer to `lbm_examples` directory [README](lbm_examples/README.md) file.
To build the periodical uplink example targeting the LR1110 Semtech radio the following should be executed on the command line:
```bash
make -C lbm_examples full_lr1110 MODEM_APP=PERIODICAL_UPLINK
```
## Applications
Under `lbm_applications` folder, one will find 3 specific applications that are using LoRa Basics Modem stack.
- A ThreadX Operating System running on STM32U5 ([lbm_applications/1_thread_x_on_stm32_u5/README.md](lbm_applications/1_thread_x_on_stm32_u5/README.md))
- A LBM porting on Nordic NRF52840 ([lbm_applications/2_porting_nrf_52840/README.md](lbm_applications/2_porting_nrf_52840/README.md))
- A Geolocation application running on Lora Edge ([lbm_applications/3_geolocation_on_lora_edge/README.md](lbm_applications/3_geolocation_on_lora_edge/README.md))
An integration in Zephyr OS is available in another repository, instructions to download this integration and LoRa Basics Modem
are available at [LBM_Zephyr](https://github.com/Lora-net/LBM_Zephyr/blob/master/README.md).