Skip to main content

Telemetry Module: Device, Environment, and Power

The Telemetry module broadcasts sensor data from your node across the mesh - battery voltage, temperature, humidity, barometric pressure, and more. Other nodes receive this data and display it in the app, and it can be forwarded to external systems via MQTT.

Enabling Telemetry

In the Meshtastic app: Radio Config → Modules → Telemetry

Via CLI:

meshtastic --set telemetry.device_update_interval 900
meshtastic --set telemetry.environment_update_interval 900
meshtastic --set telemetry.power_update_interval 900

Intervals are in seconds. Setting to 0 disables that telemetry type. The default of 900 seconds (15 minutes) is appropriate for most deployments.

Device Telemetry

Device telemetry is always available - it reports internal state from the node itself, no external sensors required:

FieldSourceNotes
Battery level (%)Hardware ADCAccuracy varies by board; some boards always report 100% if battery not detected
Voltage (V)Hardware ADCUseful for deriving SoC for LiFePO4 packs
Channel utilization (%)Radio statsPercentage of airtime used; over 25% indicates congestion
Air utilization TX (%)Radio statsPercentage of time this node was transmitting
Uptime (seconds)System clockResets on power cycle

Environment Telemetry

Requires an external I2C sensor. Supported sensors include:

SensorMeasuresI2C AddressNotes
BME280Temp, Humidity, Pressure0x76 or 0x77Most popular; inexpensive; not suitable for air quality
BME680Temp, Humidity, Pressure, VOC/IAQ0x76 or 0x77Adds air quality index; requires 5-minute warmup
SHT31Temp, Humidity0x44 or 0x45High accuracy; ±0.3°C, ±2% RH
MCP9808Temperature only0x18-0x1F±0.25°C accuracy; for precision temperature monitoring
SHTC3Temp, Humidity0x70Low power; used on some integrated boards
meshtastic --set telemetry.environment_measurement_enabled true
meshtastic --set telemetry.environment_screen_enabled true

Power Telemetry

Requires an INA219 or INA260 current sensor on the I2C bus. Reports voltage, current draw, and calculated power consumption - useful for monitoring solar systems and diagnosing battery drain.

meshtastic --set telemetry.power_measurement_enabled true

Telemetry Intervals and Airtime Impact

Every telemetry broadcast consumes airtime. At Long Fast preset, a telemetry packet takes approximately 0.3-0.5 seconds of airtime. At 15-minute intervals with one sensor type, this is negligible. But if you enable all three telemetry types at 5-minute intervals on a busy network, the combined airtime impact becomes meaningful. As a guideline:

  • Fixed infrastructure nodes: 15-30 minute intervals are appropriate
  • Portable/personal nodes: 30-60 minute intervals to reduce network load
  • Emergency operations (where battery monitoring is critical): 5-minute intervals acceptable