Skip to content

OpenCarMind 2.5.1b (beta): ESP32-S3 car board firmware

Pre-release
Pre-release

Choose a tag to compare

@AlveeeRahman AlveeeRahman released this 13 Nov 00:57
735a120

Beta. For the Waveshare ESP32-S3-LCD-1.47B car board only. Do not flash it on the ESP-Mosaico (that board's firmware is OpenCarMind EdgeOS 2.1.0).

OpenCarMind 2.5.1b is a beta of the ESP32-S3 firmware with every change on main since the 2.5.1 release. The parts were tested one by one while they were made, but this image as a whole has not been checked on an S3 board yet. If you want the tested firmware, keep 2.5.1, which stays the latest release and the one the desktop app installs. The board shows "2.5.1b" on page 5.

This release has the firmware only. The desktop app for 2.5.1 works with it.

A new brand, a screen made for the LCD, and a visible power-off.

  • Connects on its own when a car is awkward: on cars where several computers answer at once (engine and transmission, hybrid systems), the logger now picks the engine (7E8, or 18DAF110 on 29-bit CAN), checks that it answers RPM on its own address and polls it directly, so the supported-PID list and every reading come from the engine. With no engine data for a minute it searches by itself: every protocol, each computer on its own address, RPM on each, and keeps the one that works (once per connection; read-only, nothing is written to the car or the adapter). A BOOT double-click starts the same search at any time, or shows the link when it is working. With no adapter in range it lifts the saved-adapter lock for 90 s so a different adapter can be found; only devices that look like OBD adapters are tried. The result is on screen and in the session file (search, poll_ecu).
  • The LED and CPU-monitor tasks keep their stacks in PSRAM, leaving internal RAM for Bluetooth, Wi-Fi and the search; a task that cannot start is now reported instead of failing silently.
  • Page 1 labels the coolant CAR TEMP and page 5 labels the chip's own temperature SYS TEMP.
  • Page 5 MIPS tile says which core is which: SYS (Bluetooth, Wi-Fi clock, display) and AI (car data, the model, the learner). The CPU monitor now releases on a fixed one-second period. The JOBS line shows the job load as SYS/AI in the same order, instead of "core load".
  • Light theme reworked for the LCD: pure white view with tiles drawn by their borders, brand navy text, a light blue accent, warm oranges in place of dark browns, a coral power bar, and vivid section colours on page 5. The Mosaico concept shows its three screens in the dark, light and dark themes.
  • Brand: a new night-drive palette (navy, warm ink, cobalt, amber) across the README, the website, the desktop app and its icons, and a sharper vector logo. Banner chips now read ESP32-S3, Bluetooth LE, TinyML, Desktop app and Active Learning.
  • Screen colours for a backlit LCD: the dark theme is pure black, because any tint in the background glows through the backlight. Text is 4.5:1 or more on every background in both themes. Page 5 gives each of its seven sections its own colour (classifier orange, estimator red), checked for normal and colour-blind vision.
  • Power-off you can see: holding BOOT shows "Turning off" while the drive is saved, then "Off, safe to unplug". The backlight fades and the LED stays dark in deep sleep.
  • Page 1: CPU (both cores, out of 100 %) and estimated power, each as a name, a bar and a value. The connection and MIL line moved to the Faults page. Coolant temperature shows in °F where the units are US.
  • Page 5: instructions per second on each core from the chip's hardware counters, PSRAM used out of total, the chip's own temperature (°C or °F), uptime.
  • Page 3: the pattern line sits above the page dots.
  • New boards start on CarMind R.E.V when the firmware carries it. A board that already chose a model keeps it.
  • Supply chain: CodeQL, a fuzz harness over the input parsers, Dependabot, hash-pinned test dependencies and release provenance.
  • USB door opens only with a code from the desktop tools: HELLO now answers with a random challenge and nothing else (no firmware version, board id or pairing state). The door's code is the HMAC-SHA256 of that challenge keyed with the paired app's token, which only the desktop tools hold; the board then says who it is. The 6-digit code on the board's screen now only pairs a new computer: after it, PAIR is the one command accepted.
  • USB door: unbiased pairing codes. The desktop app explains an expired session and can restart the board.
  • Desktop app: says new boards start on R.E.V, and shows the running model's mark.
  • Report image: ghcr.io/alveeerahman/opencarmind-report serves the SD card's drives as the HTML report (dashboard/Dockerfile).
  • Fix: the switch to the light theme reset the board. Re-colouring every screen created a new LVGL style on every object and part, which emptied LVGL's 64 KB pool and halted in its allocation check until the task watchdog fired 30 s later. The walk now re-colours only what each object set itself, with one style refresh per screen: 27 ms, no allocation. It had been in the firmware since 2.0.1 but only runs once the board knows the time of day.
  • Top bar clock: 1 px more letter spacing, so the digits of the faux-bold time no longer run together.
  • Fixes: the status LED no longer drops a frame when the button and the LED task update it at once ("RMT transaction is busy"). The boot log no longer lists the saved Wi-Fi networks. The model self-test log says plainly when the board differs from the PC simulation.
  • Figures: the seven workflow figures were redrawn with straight connectors and larger text, the three README GIFs re-rendered with the brand fonts, and the screen mock-ups and the Mosaico concept updated to the new colours.
  • Model marks: small variants for figures, tags and GIFs, and figures rendered at 3x, so the marks stay sharp when zoomed.

Flash it

You need esptool 5.6.0 or later.

  1. Connect the board over USB. Hold BOOT while you plug it in if esptool cannot reach it.
  2. Write the merged image: esptool --chip esp32s3 --port <port> write-flash --flash-mode dio --flash-freq 80m --flash-size 16MB 0x0 opencarmind-2.5.1b-firmware-merged.bin
  3. The merged image covers everything from 0x0 to the end of the app, including the settings area, so the board's settings, its pairing with the desktop app and its saved Wi-Fi networks go. The drives on the SD card are not touched. To keep the settings, write only the app at 0x20000: esptool --chip esp32s3 --port <port> write-flash 0x20000 opencarmind-2.5.1b-firmware-app.bin

To go back, flash the 2.5.1 release the same way. Check the download against SHA256SUMS.