ESP32-S3 board#

The S3 build runs on the Waveshare ESP32-S3-LCD-1.47B, and its tested release is OpenCarMind 2.5.1. A beta, 2.5.1b, has every change on main since 2.5.1. It is a pre-release, not yet checked on an S3 board as a whole.

What you need#

  • the board, a Waveshare ESP32-S3-LCD-1.47B,

  • a Bluetooth LE OBD-II adapter that speaks ELM327 commands (Classic-only adapters will not pair, because the S3 has no Classic radio, see Adapters),

  • a FAT-formatted SD card,

  • a USB cable from the car’s USB port, which also powers the board.

Flash the firmware#

With the desktop app you pair it with the board over USB, then use its Flash firmware button. The manual chapter on updating walks through it. To build the image yourself:

You need ESP-IDF v6.1 and Python 3.

. $IDF_PATH/export.sh
idf.py set-target esp32s3
idf.py build
idf.py -p /dev/cu.usbmodemXXXX flash monitor

For the ESP-Mosaico, build with idf.py --preview set-target esp32s31 and flash as docs/MOSAICO.md describes (no buttons, esptool 5.6.0 or later).

The first build downloads ESP-DL, LVGL, led_strip and cJSON through the IDF component manager. If you built an earlier version in the same folder, delete sdkconfig first. If the board stays in download mode after flashing, reset it with python -m esptool --chip esp32s3 -p <port> --after watchdog-reset chip-id.

On first boot the board connects to the strongest nearby adapter that looks like an OBD adapter and remembers it. A later S3 release will ask first: a new adapter offered only at -70 dBm or better, and saved only when you tap BOOT within 5 s. It is in this source but off for the S3 by default (CONFIG_OBD_BLE_PAIR_CONFIRM). To try it, add CONFIG_OBD_BLE_PAIR_CONFIRM=y to sdkconfig.defaults.esp32s3 and delete sdkconfig before you build. It is host-checked, not yet tested on a board. If yours is not found, add its name to OBD_BLE_NAME_PREFIXES in idf.py menuconfig under OBD Logger Configuration. Settings, SD card files, the Wi-Fi list and the CSV columns are in docs/CONFIGURATION.md.

Pair the adapter#

Plug the adapter into the car’s OBD-II port and switch the ignition on. On first boot, the board connects to the strongest nearby adapter that looks like an OBD adapter and remembers it. Hold BOOT for 8 seconds to forget it again. The first-boot section of the manual has the adapter table and the planned pairing prompt.

First drive#

Drive. While you do, the board polls the car, shows the values on its five pages and saves the drive to the SD card every 10 seconds. Page 3 shows “Safe to turn off” in green once everything is on the card. A drive ends by itself 15 seconds after the engine computer stops answering. See First drive and the user manual.