OpenPPG Controller Settings Configuration

OpenPPG-Controller-Serial-Settings.md

OpenPPG Controller Settings Configuration

This document describes how to change settings on the OpenPPG Controller using the WebSerial or USB Serial console.

Prerequisites

• Device must be DISARMED (settings commands are ignored when armed)
• Access to the ESP32 WebSerial console in your browser

Available Settings

Change Settings Command

{"settings": {"setting_name": value}}

Available Settings

Setting	Type	Values	Description
metric_alt	boolean	true = meters, false = feet	Altitude display units
metric_temp	boolean	true = Celsius, false = Fahrenheit	Temperature display units
screen_rot	number	1 or 3	Screen rotation (90° increments)
sea_pressure	number	950.0 - 1200.0	Sea level pressure in hPa/mbar
performance_mode	number	0 = chill, 1 = sport	Throttle response mode

Example Commands

Change altitude to feet:

{"settings": {"metric_alt": false}}

Change temperature to Fahrenheit:

{"settings": {"metric_temp": false}}

Multiple settings at once:

{"settings": {"metric_alt": false, "metric_temp": false, "theme": 1}}

Other Commands

Get Current Settings

{"command": "sync"}

Returns current device configuration and state.

Reboot Device

{"command": "reboot"}

Restarts the ESP32.

Response Format

After sending a settings command, the device responds with current settings:

{
  "mj_v": 7,
  "mi_v": 1,
  "arch": "ESP32S3",
  "scr_rt": 3,
  "ar_tme": 142,
  "m_tmp": true,
  "m_alt": false,
  "prf": 0,
  "sea_p": 1013.25,
  "thm": 0
}

Notes

• All settings are automatically saved to persistent storage
• Invalid values are ignored and defaults are used
• Settings take effect immediately
• Some settings like screen rotation may require a reboot to apply