LoRa Basics™ Modem User Manual v1.0 documentation

LoRa Basics™ Modem Device Management Field Codes

LoRa Basics™ Modem periodically sends status messages that update the device record in the LoRa Cloud™ Modem & Geolocation Services. The fields that are to be included in these status messages can be read and adjusted through the smtc_modem_dm_get_info_fields(...) and smtc_modem_dm_set_info_fields(...) functions. The following table lists the names of the Device Management fields that can be reported to the LoRa Cloud Modem & Geolocation Services.

LoRa Basics Modem Device Management Field Codes

Field Code

Description

SMTC_MODEM_DM_FIELD_STATUS

Modem status

SMTC_MODEM_DM_FIELD_CHARGE

Charge counter [mAh]

SMTC_MODEM_DM_FIELD_VOLTAGE

Supply voltage [1/50 V]

SMTC_MODEM_DM_FIELD_TEMPERATURE

Junction temperature [deg Celsius]

SMTC_MODEM_DM_FIELD_SIGNAL

RSSI and SNR of the last downlink

SMTC_MODEM_DM_FIELD_UP_TIME

Duration since last reset [h]

SMTC_MODEM_DM_FIELD_RX_TIME

Duration since last downlink [h]

SMTC_MODEM_DM_FIELD_ADR_MODE

ADR profile (0-3)

SMTC_MODEM_DM_FIELD_JOIN_EUI

Join EUI

SMTC_MODEM_DM_FIELD_INTERVAL

Reporting interval [values 0-63, units s/m/h/d]

SMTC_MODEM_DM_FIELD_REGION

Regulatory region

SMTC_MODEM_DM_FIELD_RST_COUNT

Modem reset count

SMTC_MODEM_DM_FIELD_DEV_EUI

Device EUI

SMTC_MODEM_DM_FIELD_SESSION

Session ID / join nonce

SMTC_MODEM_DM_FIELD_CHIP_EUI

Chip EUI

SMTC_MODEM_DM_FIELD_APP_STATUS

Application-specific status

SMTC_MODEM_DM_FIELD_ALMANAC_STATUS

Almanac status (specific to LR1110 transceiver)

Note

In addition to the periodic status reporting, the LoRa Cloud Modem & Geolocation Services can explicitly request a status update by means of a GetInfo downlink. However, these requests are handled internally by the LoRa Basics Modem, and are therefore not exposed by the API to the application.