Skip to main content

Telemetry

About​

The Telemetry Module will allow nodes to send a specific message with information from connected sensors. Currently supported sensors are BME280, BME680, DHT11, DHT12, DHT21, DHT22, Dallas 1-wire DS18B20, and MCP9808.

The preferred setup is using I2C, so the telemetry_module_sensor_pin may not be needed.

Usage Notes​

For basic usage, start with:

telemetry_module_enabled = 1

telemetry_module_screen_enabled = 1

Depending on which pin your sensor is connected to, set it accordingly:

telemetry_module_sensor_pin = 13
note

The device must be restarted after the settings have been changed for the module to take effect.

Hardware​

The sensors can be wired differently, here's one example for sensor DS18B20 https://randomnerdtutorials.com/esp32-ds18b20-temperature-arduino-ide

Example of T-LoraV1 with DHT22 temperature sensor​

Setup of a T-LoraV1 with DHT22 temperature sensor.

Requirements:

  • T-LoraV1 (but any esp32 should work, just be sure to double check which GPIO to use)
  • DHT22 sensor
  • 10 Kohm resistor (optional, but recommended)
  • breadboard (optional)
  • two red wires (could be a different color, but 5V is typically red)
  • two yellow wires for GPIO (could be a different color)
  • one black wire (could be a different color, but GROUND is typically black)

Steps:

  • disconnect power/battery
  • connect black wire from GROUND to "-" on the DHT22
  • connect yellow wire from middle PIN to a row on bread board
  • connect red wire from 5V to a row on breadboard
  • connect resistor between red and yellow rows
  • connect red wire from row with red to "+" on DHT22
  • connect yellow wire from yellow row to GPIO on device (ex: GPIO21)
  • double check the cabling (if you get it wrong, you can damage the device and/or the DHT22 sensor)
  • plug in device
  • configure the device:
meshtastic --set telemetry_module_measurement_enabled true --set telemetry_module_screen_enabled true --set telemetry_module_update_interval 15 --set telemetry_module_display_farenheit true --set telemetry_module_sensor_type DHT22 --set telemetry_module_sensor_pin 21
tip

You can change the values above to suit your needs. The commands can be run one at a time or in a group as show above.

  • reboot/reset the device (press the RST button or unplug/plug in the device)
  • when the device boots it should say "Telemetry" and it may show the sensor data
  • if "no data", then triple check the wiring
  • if still "no data", run:
meshtastic --info

and verify the the telemetry_module_sensor_type and telemetry_module_sensor_pin

Example of T-LoraV1 with Dallas DS18B20 temperature sensor​

Setup of a T-LoraV1 with DS18B20 temperature sensor.

Requirements:

  • T-LoraV1 (but any esp32 should work, just be sure to double check which GPIO to use)
  • DS18B20 sensor
  • 10 Kohm resistor (optional, but recommended)
  • breadboard (optional)
  • two red wires (could be a different color, but 5V is typically red)
  • two yellow wires for GPIO (could be a different color)
  • one black wire (could be a different color, but GROUND is typically black)

Steps:

  • disconnect power/battery
  • connect black wire from GROUND to "-" on the DS18B20
  • connect yellow wire from DAT pin to a row on bread board
  • connect red wire from 5V to a row on breadboard
  • connect resistor between red and yellow rows
  • connect red wire from row with red to "VCC" on DS18B20
  • connect yellow wire from yellow row to GPIO on device (ex: GPIO21)
  • double check the cabling (if you get it wrong, you can damage the device and/or the sensor)
  • plug in device
  • configure the device:
meshtastic --set telemetry_module_measurement_enabled true --set telemetry_module_screen_enabled true --set telemetry_module_update_interval 15 --set telemetry_module_display_farenheit true --set telemetry_module_sensor_type DS18B20 --set telemetry_module_sensor_pin 21
tip

You can change the values above to suit your needs. The commands can be run one at a time or in a group as show above.

  • reboot/reset the device (press the RST button or unplug/plug in the device)
  • when the device boots it should say "Telemetry" and it may show the sensor data
  • if "no data", then triple check the wiring
  • if still "no data", run:
meshtastic --info

and verify the the telemetry_module_sensor_type and telemetry_module_sensor_pin

Example of RAK 4631 with Environment Sensor​

Setup of a RAK 4631 with Environment Sensor

Requirements:

  • RAK4631
  • Environment Sensor

Steps:

  • configure the device:
meshtastic --set telemetry_module_measurement_enabled true --set telemetry_module_screen_enabled true --set telemetry_module_update_interval 15 --set telemetry_module_display_farenheit true --set telemetry_module_sensor_type 6
tip

You can change the values above to suit your needs. The commands can be run one at a time or in a group as show above.

  • reboot/reset the device (press the button or unplug/plug in the device)
  • when the device boots it should say "Telemetry" and it may show the sensor data
  • if still "no data", run:
meshtastic --info

and verify the the telemetry_module_sensor_type

Configuration​

Configuration details are available on the Device Settings pages. Configuring the Telemetry Module requires configuring the following modules:

Known Problems​

  • No default configuration values are currently set, so this must be done when enabling the module.