Power Configuration

Use Device Config first

Power settings are advanced configuration, most users should choose a role under Device Config to manage power for their device and shouldn't ever need to adjust these settings.

The power config options are: Power Saving, Shutdown after losing power, ADCADC (Analog-to-Digital Converter). A circuit that turns a varying voltage into a digital value. Devices use one to read sensors and to measure battery voltage. Multiplier Override, Wait Bluetooth Interval, Light Sleep Interval, Minimum Wake Interval, and Device Battery INA2xx Address. Power config uses an admin message sending a Config.Power protobufProtobuf (Protocol Buffers). A method developed by Google for serializing structured data, used in Meshtastic for efficient communication protocol between devices..

Power Config Values

Power Saving

warning

If enabled, modifications to settings can be made by waking the device through pressing the user button, resetting, or through the admin channel for remote administration.

When activated, this feature disables Bluetooth, Serial, Wi-Fi, and the device's screen to conserve power. This is particularly beneficial for devices relying on low-current power sources, like solar panels. For details on which device roles have this feature enabled by default, please check the Device Config section.

Shutdown after losing power

Automatically shut down a device after a defined time period if power is lost.

Before setting this, ensure your board correctly detects when it is connected to external power (the "🔌" icon in the app). Otherwise, your device could shut down even when power is present. Many devices detect power status correctly, however for some devices, you will need to modify the ADCADC (Analog-to-Digital Converter). A circuit that turns a varying voltage into a digital value. Devices use one to read sensors and to measure battery voltage. 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.

Should be set to floating point value between 2 and 6

Calibration Process (Attribution)

1. Install the rechargeable battery.
2. Charge the battery until full. Indication of this state may vary depending on device. At this point, the battery voltage should be 4.2V +-1%.
3. Input the "Battery Charge Percent" displayed on the screen or in your connected app into the calculator below.
4. If "Battery Charge Percent" (e.g., B 3.82V 60%) is not displayed on the screen, it means that the default value of "Operative AdcADC (Analog-to-Digital Converter). A circuit that turns a varying voltage into a digital value. Devices use one to read sensors and to measure battery voltage. Multiplier" is too high. Lower the "Operative AdcADC (Analog-to-Digital Converter). A circuit that turns a varying voltage into a digital value. Devices use one to read sensors and to measure battery voltage. Multiplier" to a smaller number (it is recommended to decrease by 0.1) until the screen displays "Battery Charge Percent". Enter the current "Operative AdcADC (Analog-to-Digital Converter). A circuit that turns a varying voltage into a digital value. Devices use one to read sensors and to measure battery voltage. Multiplier" in use into the "Operative AdcADC (Analog-to-Digital Converter). A circuit that turns a varying voltage into a digital value. Devices use one to read sensors and to measure battery voltage. Multiplier" field in the calculator. Also, input the "Battery Charge Percent" displayed on the screen into the calculator.
5. Click the "Calculate" button to compute the "Calculated New Operative AdcADC (Analog-to-Digital Converter). A circuit that turns a varying voltage into a digital value. Devices use one to read sensors and to measure battery voltage. Multiplier", and set it as the new "Operative AdcADC (Analog-to-Digital Converter). A circuit that turns a varying voltage into a digital value. Devices use one to read sensors and to measure battery voltage. Multiplier" for the device.

ADC Calculator

info

This calibration method only maps 4.2V to Battery Charge Percent 100%, and does not address the potential non-linearities of the ADC.

Battery Charge Percent:
Current Adc Multiplier:
Calculated New Operative Adc Multiplier:

Default values for ADC Multipliers are:

Device	Default ADC Multiplier
chatter2	5.0
diy	1.85
esp32-s3-pico	3.1
heltec_v1 & heltec_v2	3.2
heltec_v3 & heltec_wsl_v3	5.1205
heltec_v4	5.1205
heltec_wireless_paper	2
heltec_wireless_tracker 1.0/1.1	5.1205
heltec_T114	4.916
m5stack_coreink	5
nano-g1-explorer	2
nano-g2-ultra	2
picomputer-s3	3.1
rak4631	1.73
rpipico	3.1
rpipicow	3.1
station-g1	6.45
tlora_v2_1_16	2
tlora_v2_1_18	2.11
tlora_t3s3_v1	2.11
t-deck	2.11
t-echo	2

Wait Bluetooth Interval

How long to wait before turning off BLEBLE (Bluetooth Low Energy). The default wireless connection between a node and a phone client. in no Bluetooth states

0 for default of 1 minute

Light Sleep Interval

ESP32 Only

This setting only applies to ESP32ESP32A chipset of microcontroller made/designed by Espressif, used by a number of devices. Higher power usage than nRF52, but often cheaper and supports Wi-Fi if desired.-based boards, it will have no effect on nRF52nRF52A microcontroller chipset made by Nordic, used by several devices such as the RAK Meshtastic Starter Kit and the Lilygo T-Echo. Lower power usage than ESP32./RP2040rp2040A microcontroller chip developed by Raspberry Pi, featuring dual ARM Cortex-M0+ processors. boards.

In light sleep the CPU is suspended, LoRaLoRaA low-power, long-range wireless communication technology used by Meshtastic devices to enable communication over distances of several kilometers without the need for cellular, Wi-Fi, or other traditional network infrastructures. radio is on, BLEBLE (Bluetooth Low Energy). The default wireless connection between a node and a phone client. is off and GPSGPS (Global Positioning System). A satellite positioning system. A node with a GPS module determines its own location and can report that position to the mesh. is on

0 for default of five minutes

Minimum Wake Interval

While in light sleep when we receive packets on the LoRaLoRaA low-power, long-range wireless communication technology used by Meshtastic devices to enable communication over distances of several kilometers without the need for cellular, Wi-Fi, or other traditional network infrastructures. radio we will wake and handle them and stay awake in no Bluetooth mode for this interval

0 for default of 10 seconds

Device Battery INA2xx Address

If an INA-2XX device is auto-detected on one of the I2CI2CA two-wire bus used to attach peripherals such as sensors and displays to a device. buses at the specified address, it will be used as the authoritative source for reading device battery level voltage. Setting is ignored for devices with PMUs (e.g. T-beams)

Convert hexadecimal to decimal

I2CI2CA two-wire bus used to attach peripherals such as sensors and displays to a device. addresses are normally represented in hexadecimal and will require conversion to decimal in order to set via Meshtastic clients. For example the I2CI2CA two-wire bus used to attach peripherals such as sensors and displays to a device. address of 0x40 converted to decimal is 64.

Power Config Client Availability

Android

Android

info

Power Config options are available for Android.

1. Open the Meshtastic App
2. Navigate to: Settings > Power

Apple

Apple

info

Select Power config options are available on iOS, iPadOS and macOS at Settings > Device Configuration > Power.

CLI

CLI

info

All Power config options are available in 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

tip

Because the device will reboot after each command is sent via CLI, it is recommended when setting multiple values in a config section that commands be chained together as one.

Example:

meshtastic --set power.is_power_saving true --set power.on_battery_shutdown_after_secs 120

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

Web

Web

info

All power config options are available in the Web UI.