Add power telemetry settings (#1497)
Some checks failed
CI / quality (push) Has been cancelled
CI / build (push) Has been cancelled

* Add power telemetry settings

For some reason these were missing.

* Update telemetry.mdx

* resolve merge conflicts

---------

Co-authored-by: rcarteraz <robert.l.carter2@gmail.com>
This commit is contained in:
noon92 2024-10-25 02:53:39 +03:00 committed by GitHub
parent 593014b4e1
commit ae0671d11b
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -12,7 +12,11 @@ The Telemetry Module provides four types of data over the mesh: Device metrics (
Supported sensors connected to the I2C bus of the device will be automatically detected at startup. The Environment Telemetry, Air Quality, and Health Telemetry modules must be enabled for them to be instrumented and their readings sent over the mesh. Supported sensors connected to the I2C bus of the device will be automatically detected at startup. The Environment Telemetry, Air Quality, and Health Telemetry modules must be enabled for them to be instrumented and their readings sent over the mesh.
<object data="https://www.youtube.com/embed/6jj1s-fsPlc?autohide=1&autoplay=0" width="100%" height="400"></object> <object
data="https://www.youtube.com/embed/6jj1s-fsPlc?autohide=1&autoplay=0"
width="100%"
height="400"
></object>
### Currently Supported Sensor Types ### Currently Supported Sensor Types
@ -35,7 +39,6 @@ Supported sensors connected to the I2C bus of the device will be automatically d
| MAX30102 | 0x57 | Heart Rate, Oxygen Saturation, and body temperature | | MAX30102 | 0x57 | Heart Rate, Oxygen Saturation, and body temperature |
| MLX90614 | 0x5A | Body temperature | | MLX90614 | 0x5A | Body temperature |
## Module Config Values ## Module Config Values
### Environment Telemetry Enabled ### Environment Telemetry Enabled
@ -80,6 +83,16 @@ This option is used to configure the interval (in seconds) that should be used t
Default is `1800` seconds (30 minutes). Default is `1800` seconds (30 minutes).
### Power Metrics Enabled
This option is used to enable/disable the sending of power telemetry as gathered by an attached supported voltage/current sensor. Note that this does not need to be enabled to monitor the voltage of the battery.
Default is `false`.
### Power Metrics Interval
This option is used to configure the interval (in seconds) that should be used to send power metrics from an attached supported sensor over the mesh network.
### Health Telemetry Enabled ### Health Telemetry Enabled
This option is used to enable/disable the sending of health data from an attached supported sensor over the mesh network. This option is used to enable/disable the sending of health data from an attached supported sensor over the mesh network.
@ -140,7 +153,7 @@ All telemetry module config options are available in the python CLI. Example com
## Settings ## Settings
| Setting | Acceptable Values | Default | | Setting | Acceptable Values | Default |
| :---------------------------------------: | :-----------------: | :---------------------------------------: | | :---------------------------------------: | :-----------------: | :----------------------------------------: |
| telemetry.device_update_interval | `integer` (seconds) | Default `0` is 30 minutes(`1800` seconds). | | telemetry.device_update_interval | `integer` (seconds) | Default `0` is 30 minutes(`1800` seconds). |
| telemetry.environment_display_fahrenheit | `true`, `false` | `false` | | telemetry.environment_display_fahrenheit | `true`, `false` | `false` |
| telemetry.environment_measurement_enabled | `true`, `false` | `false` | | telemetry.environment_measurement_enabled | `true`, `false` | `false` |
@ -148,6 +161,8 @@ All telemetry module config options are available in the python CLI. Example com
| telemetry.environment_update_interval | `integer` (seconds) | Default `0` is 30 minutes(`1800` seconds). | | telemetry.environment_update_interval | `integer` (seconds) | Default `0` is 30 minutes(`1800` seconds). |
| telemetry.air_quality_enabled | `true`, `false` | `false` | | telemetry.air_quality_enabled | `true`, `false` | `false` |
| telemetry.air_quality_interval | `integer` (seconds) | Default `0` is 30 minutes(`1800` seconds). | | telemetry.air_quality_interval | `integer` (seconds) | Default `0` is 30 minutes(`1800` seconds). |
| telemetry.power_measurement_enabled | `true`, `false` | `false` |
| telemetry.power_update_interval | `integer` (seconds) | Default `0` is 30 minutes(`1800` seconds). |
| telemetry.health_measurement_enabled | `true`, `false` | `false` | | telemetry.health_measurement_enabled | `true`, `false` | `false` |
| telemetry.health_update_interval | `integer` (seconds) | Default `0` is 30 minutes(`1800` seconds). | | telemetry.health_update_interval | `integer` (seconds) | Default `0` is 30 minutes(`1800` seconds). |
| telemetry.health_screen_enabled | `true`, `false` | `false` | | telemetry.health_screen_enabled | `true`, `false` | `false` |