MAVLink messages update Thu May 21 06:29:33 UTC 2026

Author: PX4BuildBot

en/messages/common.md

@@ -3284,17 +3284,34 @@ pos_yaw | `float[5]` | rad | Yaw. Set to NaN for unchanged
 
 ### CELLULAR_STATUS (334) {#CELLULAR_STATUS}
 
-Report current used cellular network status
+Cellular network status as reported by a particular modem.
 
-Field Name | Type | Values | Description
---- | --- | --- | ---
-status | `uint8_t` | [CELLULAR_STATUS_FLAG](#CELLULAR_STATUS_FLAG) | Cellular modem status 
-failure_reason | `uint8_t` | [CELLULAR_NETWORK_FAILED_REASON](#CELLULAR_NETWORK_FAILED_REASON) | Failure reason when status in in [CELLULAR_STATUS_FLAG_FAILED](#CELLULAR_STATUS_FLAG_FAILED) 
-type | `uint8_t` | [CELLULAR_NETWORK_RADIO_TYPE](#CELLULAR_NETWORK_RADIO_TYPE) | Cellular network radio type: gsm, cdma, lte... 
-quality | `uint8_t` | invalid:UINT8_MAX | Signal quality in percent. If unknown, set to UINT8_MAX 
-mcc | `uint16_t` | invalid:UINT16_MAX | Mobile country code. If unknown, set to UINT16_MAX 
-mnc | `uint16_t` | invalid:UINT16_MAX | Mobile network code. If unknown, set to UINT16_MAX 
-lac | `uint16_t` | invalid:0 | Location area code. If unknown, set to 0 
+
+This is primarily intended for logging, but a GCS may choose to display link_tx_rate and link_rx_rate.
+
+Note that a value of 0 in the id field indicates that the sender does not support reporting of multiple modems.
+Message data should be from a single modem, but that is not guaranteed.
+
+Field Name | Type | Units | Values | Description
+--- | --- | --- | --- | ---
+status | `uint8_t` | | [CELLULAR_STATUS_FLAG](#CELLULAR_STATUS_FLAG) | Cellular modem status 
+failure_reason | `uint8_t` | | [CELLULAR_NETWORK_FAILED_REASON](#CELLULAR_NETWORK_FAILED_REASON) | Failure reason when status in in [CELLULAR_STATUS_FLAG_FAILED](#CELLULAR_STATUS_FLAG_FAILED) 
+type | `uint8_t` | | [CELLULAR_NETWORK_RADIO_TYPE](#CELLULAR_NETWORK_RADIO_TYPE) | Cellular network radio type: gsm, cdma, lte... 
+quality | `uint8_t` | | invalid:UINT8_MAX | Signal quality in percent. If unknown, set to UINT8_MAX 
+mcc | `uint16_t` | | invalid:UINT16_MAX | Mobile country code. If unknown, set to UINT16_MAX 
+mnc | `uint16_t` | | invalid:UINT16_MAX | Mobile network code. If unknown, set to UINT16_MAX 
+lac | `uint16_t` | | invalid:0 | Location area code. If unknown, set to 0 
+<span class='ext'>id</span> <a href='#mav2_extension_field'>++</a> | `uint8_t` | | min:1 | Cellular modem instance number. Indexed from 1.<br>[Instance field]: Uniquely identifies a device/subcomponent within a single source/target MAVLink component. 
+<span class='ext'>link_tx_rate</span> <a href='#mav2_extension_field'>++</a> | `uint32_t` | KiB/s | invalid:0 | Download rate. 
+<span class='ext'>link_rx_rate</span> <a href='#mav2_extension_field'>++</a> | `uint32_t` | KiB/s | invalid:0 | Upload rate. 
+<span class='ext'>cell_tower_id</span> <a href='#mav2_extension_field'>++</a> | `char[9]` | | invalid:0 | ID of the currently connected cell tower. This must be NULL terminated if the length is less than 9 human-readable chars, and without the null termination (NULL) byte if the length is exactly 9 chars. 
+<span class='ext'>band_number</span> <a href='#mav2_extension_field'>++</a> | `uint8_t` | | invalid:0 | LTE frequency band number. 
+<span class='ext'>band_frequency</span> <a href='#mav2_extension_field'>++</a> | `float` | MHz | invalid:0 | LTE radio frequency. 
+<span class='ext'>channel_number</span> <a href='#mav2_extension_field'>++</a> | `uint32_t` | | invalid:0 | The channel number (CN). Absolute radio-frequency (ARFCN) / E-UTRA (EARFCN) / UTRA (UARFCN) / New radio ([NR_CH](#NR_CH)). 
+<span class='ext'>rx_level</span> <a href='#mav2_extension_field'>++</a> | `float` | dBm | invalid:0 | On 3G is Received Signal Code Power (RSCP). On LTE is Reference Signal Received Power (RSRP). On 5G is New Radio Reference Signal Received Power ([NR_RSRP](#NR_RSRP)). 
+<span class='ext'>tx_level</span> <a href='#mav2_extension_field'>++</a> | `float` | dBm | invalid:0 | Transmitter (modem) signal absolute power level. 
+<span class='ext'>rx_quality</span> <a href='#mav2_extension_field'>++</a> | `float` | dBm | invalid:0 | 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](#NR_RSRQ)). 
+<span class='ext'>sinr</span> <a href='#mav2_extension_field'>++</a> | `float` | dB | invalid:0 | Signal to interference plus noise ratio (SINR). 
 
 
 ### ISBD_LINK_STATUS (335) {#ISBD_LINK_STATUS}