Power settings are considered advanced configuration, and most users should select a role under Device Config to manage power for their device without needing to adjust these settings. The power config options include: Power Saving, Shutdown after losing power, ADC Multiplier Override, Wait Bluetooth Interval, Light Sleep Interval, Minimum Wake Interval, and Device Battery INA2xx Address. Power config uses an admin message to send a Config.Power protobuf.
Power Config Values
Power Saving
When activated, this feature disables Bluetooth, Serial, WiFi, and the device's screen to conserve power. This is especially beneficial for devices that rely on low-current power sources, such as solar panels. For details on which device roles have this feature enabled by default, please refer to the Device Config section.
Shutdown after losing power
Automatically shut down a device after a specified time if power is lost.
Before configuring this feature, ensure your board accurately detects when it is connected to external power (the "🔌" icon in the app). Otherwise, your device may shut down even when power is available. While many devices detect power status correctly, some may require you to adjust the ADC Multiplier (below).
ADC Multiplier Override
Ratio of voltage divider for battery pin, e.g., 3.20 (R1=100k, R2=220k).
Overrides the ADC_MULTIPLIER defined in the firmware device variant file for battery voltage calculation.
It should be set to a floating-point value between 2 and 6.
Calibration Process (Attribution)
-
Install the rechargeable battery.
-
Charge the battery until full. The indication of this state may vary depending on the device. At this point, the battery voltage should be 4.2V ± 1%.
-
Input the "Battery Charge Percent" displayed on the screen or in your connected app into the calculator below.
-
If "Battery Charge Percent" (e.g., B 3.82V 60%) is not displayed on the screen, it means that the default value of "Operative Adc Multiplier" is too high. Lower the "Operative Adc Multiplier" to a smaller number (it is recommended to decrease by 0.1) until the screen displays "Battery Charge Percent". Enter the current "Operative Adc Multiplier" in use into the "Operative Adc Multiplier" field in the calculator. Also, input the "Battery Charge Percent" displayed on the screen into the calculator.
-
Click the "Calculate" button to compute the "Calculated New Operative Adc Multiplier" and set it as the new "Operative Adc Multiplier" for the device.
Wait for Bluetooth Interval
The waiting time before turning off BLE in no Bluetooth states is 0 for the default of 1 minute.
Light Sleep Interval
In light sleep, the CPU is suspended, the LoRa radio is on, BLE is off, and GPS is on.
A value of 0 indicates the default duration of five minutes.
NOTE: This setting applies exclusively to ESP32-based boards and will not impact nRF52/RP2040 boards.
Minimum Wake Interval
While in light sleep, upon receiving packets on the LoRa radio, the device will wake up to handle them and remain awake in no Bluetooth mode for the specified interval.
A value of 0 represents the default duration of 10 seconds.
Device Battery INA2xx Address
If an INA-2XX device is automatically detected on one of the I2C buses at the specified address, it will serve as the primary source for reading the device's battery level voltage. This setting will be disregarded for devices equipped with PMUs (e.g., T-beams).
Convert hexadecimal to decimal: I2C addresses are typically represented in hexadecimal and must be converted to decimal for configuration via Meshtastic clients. For instance, the I2C address of 0x40 converts to 64 in decimal.
Power Configuration Client Availability
Android
Power configuration options are accessible on Android.
-
Open the Meshtastic App.
-
Go to: Vertical Ellipsis (three dots in the top right) > Radio Configuration > Power.
Apple
Power configuration options can be selected on iOS, iPadOS, and macOS under Settings > Device Configuration > Power.
CLI
All Power configuration options can be accessed through the Python CLI.
| 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.ls_secs | integer (seconds) | Default of 0 is 5 minutes |
| power.min_wake_secs | integer (seconds) | Default of 0 is 10 seconds |
| power.device_battery_ina_address | integer (I2C address as decimal) | Default of 0 is no address set |
-
Enable / Disable Power Saving
| meshtastic --set power.is_power_saving true meshtastic --set power.is_power_saving false |
-
Enable / Disable Shutdown after losing power
| meshtastic --set power.on_battery_shutdown_after_secs 120 meshtastic --set power.on_battery_shutdown_after_secs 0 |
-
Set Wait Bluetooth Interval (Default of 0 is 60 seconds)
| meshtastic --set power.wait_bluetooth_secs 0 meshtastic --set power.wait_bluetooth_secs 120 |
-
Set Light Sleep to default (Default of 0 is 5 minutes)
| meshtastic --set power.ls_secs 0 meshtastic --set power.ls_secs 120 |
-
Set Minimum Wake Interval (Default of 0 is 10 seconds)
| meshtastic --set power.min_wake_secs 0 meshtastic --set power.min_wake_secs 120 |
NOTE: Since the device reboots after each command is sent through the CLI, it is advisable to chain commands together as a single command when setting multiple values in a configuration section. For example:
| meshtastic --set power.is_power_saving true --set power.on_battery_shutdown_after_secs 120 |
Web
All power configuration options can be accessed through the Web UI.
