🌐 中文 (简体) — Community translation View in English

Telemetry & Sensors

Meshtastic nodes can collect and share sensor data across the mesh network.

总览

Telemetry allows nodes equipped with sensors to broadcast environmental, power, and device health information. This data is visible on the node detail screen and can be logged over time.

Device Telemetry

All Meshtastic nodes report basic device telemetry:

公制 说明 Typical Range
电池电量 Charge percentage 0–100%
电压 Battery voltage 3.0–4.2V (LiPo)
频道利用率 % of airtime used locally 0–100%
Air Utilization TX % of airtime used by this node 0–100%
正常运行时间 Seconds since last boot Varies

Environment Sensors

Supported environmental sensors:

Temperature & Humidity

传感器 温度 湿度 气压 注
BME280 ✓ ✓ ✓ Recommended all-in-one
BME680 ✓ ✓ ✓ Adds gas resistance/IAQ
SHT31 ✓ ✓ — High accuracy
MCP9808 ✓ — — Precision temperature
LPS22 — — ✓ Pressure only

Air Quality

传感器 公制 注
BME680 Gas Resistance / IAQ Volatile organic compounds
PMSA003I PM1.0, PM2.5, PM10 Particulate matter
SEN55 PM, NOx, VOC, Temp, Humidity Multi-sensor

Light & UV

传感器 公制
OPT3001 Ambient light (lux)
VEML7700 Ambient light (lux)
LTR390 UV index

电源计量

Nodes with INA-series power sensors can report:

公制 说明
Bus Voltage Supply rail voltage
电流 Power consumption (mA)
电源 Calculated power (mW)

Useful for monitoring solar charging or battery health on remote nodes.

Configuring Telemetry

  1. Navigate to Settings → Module Config → Telemetry.
  2. Set reporting intervals:
    • Device Metrics Interval — how often to broadcast device metrics
    • Environment Metrics Interval — how often to broadcast sensor data
  3. Enable specific sensor types as needed.
Use Case Device (s) Environment (s)
Urban mesh (many nodes) 3600 3600
Rural mesh (few nodes) 900 900
Weather station 900 300
Battery conservation 7200 7200

⚠️ Note: Shorter intervals increase airtime usage and battery drain across the mesh.

Viewing Telemetry

  1. Navigate to Nodes and select a node.
  2. Telemetry sections show on the detail screen:
    • Device Metrics (always available)
    • Environment Metrics (if sensors present)
    • Power Metrics (if INA sensor present)
  3. Historical graphs show trends over time.

Telemetry actions

问题排查

  • No environment data showing? The remote node needs a physical sensor connected (e.g., BME280 on I2C). Device telemetry (battery, uptime) is always available, but environment metrics require hardware.
  • Stale readings? Check the reporting interval — very long intervals (7200s+) mean data updates infrequently. Also verify the remote node is still online.
  • Sensor conflict on I2C bus? Some sensors share I2C addresses. If you have multiple sensors on the same bus, check for address collisions in the radio’s serial debug output.