solutions
LoRa Basics Modem and LoRa Edge documentation
Scenario - Modem-E Initialization¶
Introduction¶
For the LoRa Basics™ Modem-E to operate properly on a LoRaWAN® network, it must be initialized by its host Microcontroller Unit (MCU). During this process, a set of parameters related to its hardware configuration and the LoRa Cloud™ Modem & Geolocation Services must be initialized.
Compatibility¶
Prerequisites/Dependencies¶
Common:
None
Prerequisites for LoRa Basics™ Modem:
Not applicable
Prerequisites for LoRa Basics™ Modem-E:
The LR1110 chip must be flashed with the LoRa Basics Modem-E firmware. For more information, see the LR1110 Updater Tool documentation.
The LR1110 chip must be connected to an end device application MCU.
A Low-frequency (LF) clock must be supplied, either with the built-in real time clock (RTC) (with an onboard 32.768kHz XTAL), or from the host MCU on pin
DIO10
The device must be powered-up within the applicable voltage operating range.
The device must have finished its power-on reset (POR) sequence.
Step-by-Step Procedure¶
Before the LoRa Basics™ Modem-E can start the join procedure, the following steps are required:
Configure the application hardware, with the following board-specific settings:
LF clock source, using the
ConfigLfClck()
command.Regulator mode (DC-DC or LDO), using the
SetRegMode()
command.TCXO controller, using the command
SetTCXOMode()
.PA options, using the command
ManageRFOutput()
.RF switch control, using the
SetDioAsRfSwitch()
command.Configure the TX power offset, uing the
SetTxPowerOffset()
command.
Configure an alarm timer if necessary:
SetAlarmTimer()
.Configure the LoRaWAN class with
SetClass()
. The default value isClass A
.Select an adaptive data rate (ADR) profile with
SetAdrProfile()
. By default, the ADR profile is set toNetwork Controlled
.Set the modem management FPort, if needed, using the
SetDmPort()
command. The default value is199
.Configure the modem management reporting interval using the
SetDminfoInterval()
command. The default value is1 hour
.Configure the modem management information fields using
SetDminfoFields()
. The default information fields are:status
,charge
,temperature
,signal
,uptime
andrxtime
.Configure the LoRaWAN region using the
SetRegion()
command. This will automatically enable duty cycle restrictions for regions where they apply. The default region isEU868
.For end devices using assisted GNSS, or if the application requires timing, configure clock synchronization over-the-air using the
SetAlcSyncPort()
andSetAlcSyncMode()
commands.Configure the connection timeout using the
SetConnectionTimeout()
command.
Note
The following parameters do not persist in flash memory and must be set after each reset: Alarm Timer, LoRaWAN class, modem management info interval, modem management info fields, connection timeout, and parameters related to clock sync.
Used By¶
Application MCU
Troubleshooting¶
With LoRa Basics Modem-E version 1.0.7 or less, the
SetAdrProfile()
command must be sent after each successful join procedure.
LoRa Basics Modem and LoRa Edge documentation
Table of Contents
- Overview - LoRa Edge™ Asset Management Platform
- Use Case - Basic Asset Tracking
- Use Case - IR Image Upload on Detected Motion
- Scenario - GNSS Assisted Scan
- Scenario - GNSS Autonomous Scan
- Scenario - LoRa Basics™ Wi-Fi Passive Scan
- Scenario - GNSS Scan with ROSE
- Scenario - Wi-Fi Scan with ROSE
- Scenario - LoRa Cloud™ Join Server
- Scenario - Claiming a Device
- Scenario - Unclaiming a Device
- Scenario - Modem-E Initialization
- Scenario - LoRa Basics™ Almanac Update
- Scenario - User Loaded Almanac Update
- Scenario - Intermittent Network
- Component - Clock Synchronization
- Component - Large File Upload
- Component - Reliable Octet Stream Encoding
- Cryptographic Engine
- Glossary
ADDITIONAL RESOURCES - VIDEOS