Skip to content

CellularStatus (повідомлення UORB)

Cellular status.

This is currently used only for logging cell status from MAVLink 1:1.

TOPICS: cellular_status

Fields

НазваТипUnit [Frame]Range/EnumОпис
timestampuint64usTime since system start
statusuint8STATUS_FLAGStatus
failure_reasonuint8FAILURE_REASONFailure reason
typeuint8CELLULAR_NETWORK_RADIO_TYPECellular network radio type
qualityuint8%Cellular network signal quality in percent. May be used for RSSI (Invalid: UINT8_MAX)
mccuint16Mobile country code (Invalid: UINT16_MAX)
mncuint16Mobile network code (Invalid: UINT16_MAX)
lacuint16Location area code (Invalid: 0)
iduint8Cellular instance number. Indexed from 1. A value of 0 indicates the sender does not support reporting of multiple modems
link_tx_rateuint32KiB/sDownload rate (Invalid: 0)
link_rx_rateuint32KiB/sUpload rate (Invalid: 0)
cell_tower_idchar[9]ID of the currently connected cell tower. Must be NULL terminated if the length is less than 9 human-readable characters, and without NULL termination character if the length is exactly 9 characters (Invalid: 0)
band_numberuint8LTE frequency band number (Invalid: 0)
band_frequencyfloat32MHzLTE radio frequency (Invalid: 0)
channel_numberuint32Channel Number (CN), Absolute radio-frequency (ARFCN) / E-UTRA (EARFCN) / UTRA (UARFCN) / New radio (NR_CH) (Invalid: 0)
rx_levelfloat32dBmReceiver signal level. On 3G is Received Signal Code Power (RSCP). On LTE Reference Signal Received Power (RSRP). On 5G is New Radio Reference Signal Received Power (NR_RSRP) (Invalid: 0)
tx_levelfloat32dBmTransmitter signal absolute level (Invalid: 0)
rx_qualityfloat32dBmReceived signal quality. On 3G is Receiver Quality (RxQual). On LTE is Reference Signal Received Quality (RSRQ). On 5G is New Radio Reference Signal Received Quality (NR_RSRQ) (Invalid: 0)
sinrfloat32dBSignal to Interference plus Noise Ratio (Invalid: 0)

Enums

STATUS_FLAG

Used in field(s): status

НазваТипЗначенняОпис
STATUS_FLAG_UNKNOWNuint80State unknown or not reportable
STATUS_FLAG_FAILEDuint81Modem is unusable
STATUS_FLAG_INITIALIZINGuint82Modem is being initialized
STATUS_FLAG_LOCKEDuint83Modem is locked
STATUS_FLAG_DISABLEDuint84Modem is not enabled and is powered down
STATUS_FLAG_DISABLINGuint85Modem is currently transitioning to the STATUS_FLAG_DISABLED state
STATUS_FLAG_ENABLINGuint86Modem is currently transitioning to the STATUS_FLAG_ENABLED state
STATUS_FLAG_ENABLEDuint87Modem is enabled and powered on but not registered with a network provider and not available for data connections
STATUS_FLAG_SEARCHINGuint88Modem is searching for a network provider to register
STATUS_FLAG_REGISTEREDuint89Modem is registered with a network provider, and data connections and messaging may be available for use
STATUS_FLAG_DISCONNECTINGuint810Modem is disconnecting and deactivating the last active packet data bearer. This state will not be entered if more than one packet data bearer is active and one of the active bearers is deactivated
STATUS_FLAG_CONNECTINGuint811Modem is activating and connecting the first packet data bearer. Subsequent bearer activations when another bearer is already active do not cause this state to be entered
STATUS_FLAG_CONNECTEDuint812One or more packet data bearers is active and connected

FAILURE_REASON

Used in field(s): failure_reason

НазваТипЗначенняОпис
FAILURE_REASON_NONEuint80No error
FAILURE_REASON_UNKNOWNuint81Error state is unknown
FAILURE_REASON_SIM_MISSINGuint82SIM is required for the modem but missing
FAILURE_REASON_SIM_ERRORuint83SIM is available, but not usable for connection

CELLULAR_NETWORK_RADIO_TYPE

Used in field(s): type

НазваТипЗначенняОпис
CELLULAR_NETWORK_RADIO_TYPE_NONEuint80None
CELLULAR_NETWORK_RADIO_TYPE_GSMuint81GSM
CELLULAR_NETWORK_RADIO_TYPE_CDMAuint82CDMA
CELLULAR_NETWORK_RADIO_TYPE_WCDMAuint83WCDMA
CELLULAR_NETWORK_RADIO_TYPE_LTEuint84LTE

Source Message

Source file (GitHub)

Details

Click here to see original file

c
# Cellular status
#
# This is currently used only for logging cell status from MAVLink 1:1.

uint64 timestamp # [us] Time since system start

uint8 status # [@enum STATUS_FLAG] Status
uint8 STATUS_FLAG_UNKNOWN = 0 # State unknown or not reportable
uint8 STATUS_FLAG_FAILED = 1 # Modem is unusable
uint8 STATUS_FLAG_INITIALIZING = 2 # Modem is being initialized
uint8 STATUS_FLAG_LOCKED = 3 # Modem is locked
uint8 STATUS_FLAG_DISABLED = 4 # Modem is not enabled and is powered down
uint8 STATUS_FLAG_DISABLING = 5 # Modem is currently transitioning to the STATUS_FLAG_DISABLED state
uint8 STATUS_FLAG_ENABLING = 6 # Modem is currently transitioning to the STATUS_FLAG_ENABLED state
uint8 STATUS_FLAG_ENABLED = 7 # Modem is enabled and powered on but not registered with a network provider and not available for data connections
uint8 STATUS_FLAG_SEARCHING = 8 # Modem is searching for a network provider to register
uint8 STATUS_FLAG_REGISTERED = 9 # Modem is registered with a network provider, and data connections and messaging may be available for use
uint8 STATUS_FLAG_DISCONNECTING = 10 # Modem is disconnecting and deactivating the last active packet data bearer. This state will not be entered if more than one packet data bearer is active and one of the active bearers is deactivated
uint8 STATUS_FLAG_CONNECTING = 11 # Modem is activating and connecting the first packet data bearer. Subsequent bearer activations when another bearer is already active do not cause this state to be entered
uint8 STATUS_FLAG_CONNECTED = 12 # One or more packet data bearers is active and connected

uint8 failure_reason # [@enum FAILURE_REASON] Failure reason
uint8 FAILURE_REASON_NONE = 0 # No error
uint8 FAILURE_REASON_UNKNOWN = 1 # Error state is unknown
uint8 FAILURE_REASON_SIM_MISSING = 2 # SIM is required for the modem but missing
uint8 FAILURE_REASON_SIM_ERROR = 3 # SIM is available, but not usable for connection

uint8 type # [@enum CELLULAR_NETWORK_RADIO_TYPE] Cellular network radio type
uint8 CELLULAR_NETWORK_RADIO_TYPE_NONE = 0 # None
uint8 CELLULAR_NETWORK_RADIO_TYPE_GSM = 1 # GSM
uint8 CELLULAR_NETWORK_RADIO_TYPE_CDMA = 2 # CDMA
uint8 CELLULAR_NETWORK_RADIO_TYPE_WCDMA = 3 # WCDMA
uint8 CELLULAR_NETWORK_RADIO_TYPE_LTE = 4 # LTE

uint8 quality # [%] [@invalid UINT8_MAX] Cellular network signal quality in percent. May be used for RSSI
uint16 mcc # [@invalid UINT16_MAX] Mobile country code
uint16 mnc # [@invalid UINT16_MAX] Mobile network code
uint16 lac # [@invalid 0] Location area code

uint8 id # [-] Cellular instance number. Indexed from 1. A value of 0 indicates the sender does not support reporting of multiple modems
uint32 link_tx_rate # [KiB/s] [@invalid 0] Download rate
uint32 link_rx_rate # [KiB/s] [@invalid 0] Upload rate
char[9] cell_tower_id # [@invalid 0] ID of the currently connected cell tower. Must be NULL terminated if the length is less than 9 human-readable characters, and without NULL termination character if the length is exactly 9 characters
uint8 band_number # [-] [@invalid 0] LTE frequency band number
float32 band_frequency # [MHz] [@invalid 0] LTE radio frequency
uint32 channel_number # [@invalid 0] Channel Number (CN), Absolute radio-frequency (ARFCN) / E-UTRA (EARFCN) / UTRA (UARFCN) / New radio (NR_CH)
float32 rx_level # [dBm] [@invalid 0] Receiver signal level. On 3G is Received Signal Code Power (RSCP). On LTE Reference Signal Received Power (RSRP). On 5G is New Radio Reference Signal Received Power (NR_RSRP)
float32 tx_level # [dBm] [@invalid 0] Transmitter signal absolute level
float32 rx_quality # [dBm] [@invalid 0] Received signal quality. On 3G is Receiver Quality (RxQual). On LTE is Reference Signal Received Quality (RSRQ). On 5G is New Radio Reference Signal Received Quality (NR_RSRQ)
float32 sinr # [dB] [@invalid 0] Signal to Interference plus Noise Ratio