How lora-net/swl2001 works
LoRa Basic Modem is an embedded LoRaWAN stack exposed through a modem API. The principal workflow is an application issuing modem commands, which the modem schedules and processes through LoRaWAN and radio layers before communicating over the radio. The README also documents FUOTA packages, relay operation, certification, and LoRa Edge geolocation. The tree and excerpts show only selected implementation details, so some documented capability links are dashed where their internal wiring is not evidenced.
Main entry points: smtc_modem_api.h Modem API · modem_tx_protocol_manager.c TX Protocol Manager · lorawan_beacon_tx_service_example.c Beacon TX Service · modem_supervisor_light.h Modem Supervisor
Components 17
Application Interface
- Modem API
lbm_lib/smtc_modem_api/smtc_modem_api.h - Test API
lbm_lib/smtc_modem_api/smtc_modem_test_api.h - Geolocation API
lbm_lib/smtc_modem_api/smtc_modem_geolocation_api.h
LoRaWAN Stack
- Modem Supervisor
lbm_lib/smtc_modem_core/modem_supervisor/modem_supervisor_light.h - TX Protocol Manager
lbm_lib/smtc_modem_core/modem_supervisor/modem_tx_protocol_manager.c - LoRaWAN API Layer
lbm_lib/smtc_modem_core/lorawan_api/lorawan_api.h - LoRaWAN MAC
lbm_lib/smtc_modem_core/lr1mac/src/lr1_stack_mac_layer.h
Modem Services
- FUOTA Packages
lbm_lib/smtc_modem_core/lorawan_packages/fragmented_data_block_transport/v2.0.0/lorawan_fragmentation_package_v2.0.0.c - Relay RX Service
lbm_lib/smtc_modem_core/modem_services/relay_service/lorawan_relay_rx_service.c - Beacon TX Service
lbm_lib/smtc_modem_core/modem_services/beacon_tx_service/lorawan_beacon_tx_service_example.c - Certification
lbm_lib/smtc_modem_core/modem_supervisor/modem_tx_protocol_manager.c - Geolocation Services
lbm_lib/smtc_modem_api/smtc_modem_geolocation_api.h
Radio and Platform
- Radio Planner
lbm_lib/smtc_modem_core/radio_planner/src/radio_planner.h - LR11xx Driver
lbm_lib/smtc_modem_core/radio_drivers/lr11xx_driver/src/lr11xx_crypto_engine.c - Modem HAL
lbm_lib/smtc_modem_hal/smtc_modem_hal.h
Other components
- Application
- LoRaWAN Network
Connections 20
- Application → Modem API: issues commands
README.md - Application → Test API: runs tests
README.md - Application → Geolocation API: requests geolocation
README.md - Modem API → Modem Supervisor: submits requests
- Test API → TX Protocol Manager: selects test mode
lbm_lib/smtc_modem_core/modem_supervisor/modem_tx_protocol_manager.c - Modem Supervisor → TX Protocol Manager: schedules transmissions
lbm_lib/smtc_modem_core/modem_supervisor/modem_tx_protocol_manager.c - TX Protocol Manager → LoRaWAN API Layer: uses LoRaWAN layer
lbm_lib/smtc_modem_core/modem_supervisor/modem_tx_protocol_manager.c - TX Protocol Manager → Radio Planner: coordinates radio
- LoRaWAN API Layer → LoRaWAN MAC: uses MAC
lbm_lib/smtc_modem_core/lorawan_api/lorawan_api.h - LoRaWAN MAC → LoRaWAN Network: exchanges frames
README.md - Modem API → FUOTA Packages: exposes package services
README.md - Modem API → Relay RX Service: exposes relay features
README.md - Modem API → Beacon TX Service: supports beacon service
lbm_lib/smtc_modem_core/modem_services/beacon_tx_service/lorawan_beacon_tx_service_example.c - Modem API → Certification: supports certification
README.md - Geolocation API → Geolocation Services: provides geolocation
README.md - Relay RX Service → LoRaWAN API Layer: uses LoRaWAN layer
lbm_lib/smtc_modem_core/modem_services/relay_service/lorawan_relay_rx_service.c - Beacon TX Service → Modem Supervisor: uses supervisor
lbm_lib/smtc_modem_core/modem_services/beacon_tx_service/lorawan_beacon_tx_service_example.c - Beacon TX Service → Radio Planner: schedules radio work
lbm_lib/smtc_modem_core/modem_services/beacon_tx_service/lorawan_beacon_tx_service_example.c - Radio Planner → LR11xx Driver: dispatches radio work
- LR11xx Driver → Modem HAL: sends chip commands
lbm_lib/smtc_modem_core/radio_drivers/lr11xx_driver/src/lr11xx_crypto_engine.c