Skip to main content

Telemetry Module Configuration

The Telemetry Module provides three types of data over the mesh: Device metrics (Battery Level, Voltage, Channel Utilization and Airtime) from your Meshtastic device, Environment Metrics from attached I2C sensors, and Air Quality Metrics from attached I2C particle sensors.

Supported sensors connected to the I2C bus of the device will be automatically detected at startup. Environment Telemetry and Air Quality must be enabled for them to be instrumented and their readings sent over the mesh.

Currently Supported Sensor Types

SensorI2C AddressData Points
BMP2800x76, 0x77Temperature and barometric pressure
BME2800x76, 0x77Temperature, barometric pressure and humidity
BME6800x76, 0x77Temperature, barometric pressure, humidity and air resistance
INA2600x40, 0x41Current and Voltage
INA2190x40, 0x41Current and Voltage
LPS220x5D, 0x5cBarometric pressure
SHTC30x70Temperature and humidity
SHT310x44Temperature and humidity
PMSA003I0x12Concentration units by size and particle counts by size

Module Config Values

Environment Telemetry Enabled

Enable the Environment Telemetry (Sensors).

Environment Metrics Update Interval

How often we should send Environment(Sensor) Metrics over the mesh.

Default is 900 seconds (15 minutes).

Device Metrics Update Interval

How often we should send Device Metrics over the mesh.

Default is 900 seconds (15 minutes).

Environment Screen Enabled

Show the environment telemetry data on the device display.

Default is false.

Display Fahrenheit

The sensor is always read in Celsius, but the user can opt to display in Fahrenheit (on the device display only) using this setting.

Default is false.

Air Quality Enabled

This option is used to enable/disable the sending of air quality metrics from an attached supported sensor over the mesh network.

Default is false.

Air Quality Interval

This option is used to configure the interval (in seconds) that should be used to send air quality metrics from an attached supported sensor over the mesh network.

Default is 900 seconds (15 minutes).

Telemetry Config Client Availability


All telemetry module config options are available on iOS, iPadOS and macOS at Settings > Module Configuration > Telemetry.


RAK 4631 with BME680 Environment Sensor

Setup of a RAK 4631 with Environment Sensor


  • RAK4631
  • Environment Sensor


  • configure the device:
meshtastic --set telemetry.environment_measurement_enabled true --set telemetry.environment_screen_enabled true --set telemetry.environment_display_fahrenheit true

While the above values serve as an example and can be modified to fit your specific needs, it is advisable to chain multiple commands together, as demonstrated in the example. This approach will minimize the number of necessary reboots.

  • Device will reboot after command is sent.
  • When the device boots again it should say "Telemetry" and it may show the sensor data
  • If this does not appear to have any effects, run:
meshtastic --noproto

And examine the serial logs for Telemetry diagnostic information.

Supporting Additional Sensors

Environment Metrics

The environment metrics in the telemetry module supports a limited amount of fields as they are stored in memory on the device. Support for sensors that provide one or more of the following fields can potentially be added to the main firmware provided there is a GPL licensed library for us to include to support it, and the library size is not prohibitive.

  • Temperature
  • Relative Humidity
  • Barometric Pressure
  • Gas Resistance (AQI)
  • Voltage
  • Current

Supporting Other Sensor types

For other interesting sensor types and use cases we need to add a portnum for more generic telemetry packets and a second MCU will be required to interact with the sensor and process the data to be sent over the mesh. This data will not be stored in the nodedb on the device.