Settings#

The ESP-Mosaico has a Settings app on the touch screen. Every item is explained in the manual chapter Settings in detail. On both boards the desktop app writes the same settings to config.json, and the build-time options are in idf.py menuconfig.

config.json#

Put a file called config.json in /sdcard/obd/ and reboot. The board applies the keys it knows and stores them in flash. It does not delete the file, so remove any wifi entries once they are imported.

Key

Meaning

Range

poll_interval_ms

pause between polling cycles

50 to 5000

slow_group_every

poll slow-changing PIDs every N cycles

1 to 50

dtc_interval_s

read the warning light and trouble codes every N seconds

10 to 3600

backlight_pct

screen brightness

5 to 100

theme_mode

0 by time of day, 1 dark, 2 light

0 to 2

day_start_hour, day_end_hour

light theme from the start hour until the end hour, local time. The defaults, 6 and 17, give light from 06:00 to 16:59 and dark from 17:00

0 to 23

timezone

the board’s local time zone as a POSIX string, for example CST6CDT,M3.2.0,M11.1.0 (US Central) or <+06>-6 (UTC+6). The desktop app fills it in from your computer. Without it the board uses SYNC_TIMEZONE from the build, which is UTC

text, 3 to 47 characters

time_host

the one HTTPS server the board asks for the time (2.5.0). It must present a valid certificate for this name. "" goes back to the default, www.google.com

host name, 4 to 63 characters, no scheme, port or IP

units

auto (default), metric, us or uk. Auto starts in km and km/L. The first time the board joins Wi-Fi it reads the country code the access point broadcasts and switches to miles and mpg in the US or the UK, then keeps that choice. Without a country code, a UK time zone (GMT0BST) also counts. Set a value to override the detection

text

wifi

list of {"ssid", "password"}, or {"ssid", "forget": true}

custom_pids

the text of custom_pids.csv

rev

a number you can use to track versions

Files larger than 4096 bytes and invalid JSON are ignored, and the board logs a warning event.