meshtastic/docs/configuration/device-config/power.mdx

167 lines
6.5 KiB
Plaintext
Raw Normal View History

2022-06-24 19:42:37 -07:00
---
id: power
title: Power Configuration
2022-11-02 11:46:54 -07:00
slug: /settings/config/power
2022-06-24 19:42:37 -07:00
sidebar_label: Power
---
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
2022-11-09 01:50:40 -08:00
The power config options are: Power Saving, Shutdown after losing power, ADC Multiplier Override Wait Bluetooth Interval, Mesh Super Deep Sleep Timeout, Super Deep Sleep Interval, Light Sleep Interval and Minimum Wake Interval. Power config uses an admin message sending a `Config.Power` protobuf.
2022-06-24 19:42:37 -07:00
2022-08-03 08:14:18 -07:00
Power settings are advanced configuration, most users should choose a role under Device Config to manage power for their device and should never need to touch any of these settings.
2022-06-24 19:42:37 -07:00
## Power Config Values
### Power Saving
If set, we are powered from a low-current source (i.e. solar), so even if it looks like we have power flowing in we should try to minimize power consumption as much as possible.
### Shutdown after losing power
Automatically shut down a device after a defined time period if power is lost.
### ADC Multiplier Override
**Fixes issues on Heltec v2**
2022-10-05 06:25:07 -07:00
Ratio of voltage divider for battery pin e.g. 3.20 (R1=100k, R2=220k)
2022-06-24 19:42:37 -07:00
Overrides the ADC_MULTIPLIER defined in the firmware device variant file for battery voltage calculation.
Should be set to floating point value between 2 and 4
### Wait Bluetooth Interval
How long wait before turning off BLE in no Bluetooth states
`0` for default of 1 minute
### Mesh Super Deep Sleep Timeout
While in Light Sleep if this value is exceeded we will lower into super deep sleep
or Super Deep Sleep Interval (default 1 year) or a button press
`0` for default of two hours, MAXUINT for disabled
### Super Deep Sleep Interval
While in Light Sleep if Mesh Super Deep Sleep Timeout Seconds is exceeded we will lower into super deep sleep or this value (default 1 year) or a button press
`0` for default of one year
### Light Sleep Interval
**ESP32 Only Setting**
In light sleep the CPU is suspended, LoRa radio is on, BLE is off an GPS is on
`0` for default of five minutes
### Minimum Wake Interval
While in light sleep when we receive packets on the LoRa radio we will wake and handle them and stay awake in no Bluetooth mode for this interval
`0` for default of 10 seconds
## Power Config Client Availability
<Tabs
groupId="settings"
2022-07-15 19:57:03 -07:00
defaultValue="cli"
2022-06-24 19:42:37 -07:00
values={[
{label: 'Android', value: 'android'},
{label: 'Apple', value: 'apple'},
2022-06-29 22:33:26 -07:00
{label: 'CLI', value: 'cli'},
2022-06-24 19:42:37 -07:00
{label: 'Flasher', value: 'flasher'},
{label: 'Web', value: 'web'},
]}>
<TabItem value="android">
:::info
2022-12-04 13:13:26 -08:00
Power Config options are available for Android.
1. Open the Meshtastic App
2. Navigate to: **Vertical Ellipsis (3 dots top right) > Device Settings > Power Config**
2022-06-24 19:42:37 -07:00
:::
</TabItem>
<TabItem value="apple">
:::info
Power config is not available on Apple OS's.
:::
</TabItem>
<TabItem value="cli">
2022-08-03 08:14:18 -07:00
All Power config options are available in the python CLI.
2022-06-24 19:42:37 -07:00
| Setting | Acceptable Values | Default |
| :----------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------: |
| power.is_power_saving | `true`, `false` | `false` |
| power.on_battery_shutdown_after_secs | `integer` (seconds) | Default of `0` is off |
| power.adc_multiplier_override | `2-4` (floating point value) | Default of `0` uses firmware values |
| power.wait_bluetooth_secs | `integer` (seconds) | Default of `0` is 1 minute |
| power.mesh_sds_timeout_secs | `integer` (seconds) | Default of `0` is 2 hours |
| power.sds_secs | `integer` (seconds) | Default of `0` is 1 year |
| power.ls_secs | `integer` (seconds) | Default of `0` is 1 hour |
| power.min_wake_secs | `integer` (seconds) | Default of `0` is 10 seconds |
2022-06-24 19:42:37 -07:00
2022-06-25 08:44:03 -07:00
```shell title="Enable / Disable Power Saving"
meshtastic --set power.is_power_saving true
meshtastic --set power.is_power_saving false
2022-06-24 19:42:37 -07:00
```
2022-06-25 08:44:03 -07:00
```shell title="Enable / Disable Shutdown after losing power"
meshtastic --set power.on_battery_shutdown_after_secs 120
meshtastic --set power.on_battery_shutdown_after_secs 0
2022-06-24 19:42:37 -07:00
```
2022-06-25 08:44:03 -07:00
```shell title="Set Wait Bluetooth Interval (Default of 0 is 60 seconds)"
meshtastic --set power.wait_bluetooth_secs 0
meshtastic --set power.wait_bluetooth_secs 120
2022-06-24 19:42:37 -07:00
```
2022-06-25 08:44:03 -07:00
```shell title="Set Mesh Super Deep Sleep Timeout (Default of 0 is 2 hours/7200 seconds)"
meshtastic --set power.mesh_sds_timeout_secs 0
meshtastic --set power.mesh_sds_timeout_secs 120
2022-06-25 08:44:03 -07:00
// Disable using MAXUINT
meshtastic --set power.mesh_sds_timeout_secs 4294967295
2022-06-24 19:42:37 -07:00
```
2022-06-25 08:44:03 -07:00
```shell title="Set Super Deep Sleep (Default of 0 is 1 year)"
meshtastic --set power.sds_secs 0
meshtastic --set power.sds_secs 120
2022-06-24 19:42:37 -07:00
```
2022-06-25 08:44:03 -07:00
```shell title="Set Light Sleep to default (Default of 0 is 5 minutes)"
meshtastic --set power.ls_secs 0
meshtastic --set power.ls_secs 120
2022-06-24 19:42:37 -07:00
```
2022-06-25 08:44:03 -07:00
```shell title="Set Minimum Wake Interval (Default of 0 is 10 seconds)"
meshtastic --set power.min_wake_secs 0
meshtastic --set power.min_wake_secs 120
2022-06-24 19:42:37 -07:00
```
</TabItem>
<TabItem value="flasher">
:::info
Power config is not available in the Flasher.
:::
</TabItem>
<TabItem value="web">
:::info
2022-08-03 08:14:18 -07:00
All power config options are available in the Web UI.
2022-06-24 19:42:37 -07:00
:::
</TabItem>
</Tabs>