Repository navigation
OpenCarMind 2.4.0: ESP32-S3 car board firmware and desktop app
-
CarMind E.V (
dfa9af416dfb, 89,152 bytes), a new on-board model that holds up better on cars it has not seen. About 3.5 ms per run. Scores are indocs/MODEL.md. -
Fixes from a code review, with no change to the model, the scheduler's default behaviour, the OBD polling or the log format:
- Diesel fuel use from MAF accepts the lean commanded ratios diesels run at (up to 8). It read about 3x high before.
- A fuel-cut reading of PID 0x44, which is polled slowly, no longer zeroes the fuel rate once the throttle opens again.
- Fuel and economy start fresh with each drive, and the previous drive's model fuel estimate is no longer borrowed.
- The amber "estimate" colour is cleared when a value stops being an estimate.
- Unit captions are redrawn only when the units change.
- The units event no longer prints the country code when the time zone decided.
- The 10 s model stall rule applies only when the model runs every second.
- Host tests: 321 checks.
-
The desktop app shows fuel as unknown, not 0 L, for a drive where the car gave no fuel source.
-
The events screen names the model "ML Model - CarMind Edge". Its hash stays in the serial log and in every
.ml.csvrow. -
Repository: removed six screen renders no page used and five desktop design mockups of screens the app does not have.
ml/onboard/export.jsonlists the file details only..gitignorecovers those renders and assistant, scratch and editor files. -
Architecture proposals: a new issue template. We train what you send on the same data and splits and post the scores.
-
Figures for the inference path updated. The old model's bench summary (
ml/onboard/bench_summary.json) is removed. -
Field check: the author drove the board with the new features (the drive ending when the engine stops, the BOOT power-off, fuel economy, units) and the 10 s model, and reported every feature working.
-
Fuel economy: the first screen's LOAD tile now shows the drive's economy in km/L, or mpg in the US and the UK (LOAD moved to page 3, replacing BARO). The fuel rate comes from PID 0x5E when the car has it, else from MAF with the commanded equivalence ratio (PID 0x44, where 0 means decel fuel cut), else from the on-board model's estimate, shown in amber. New CSV columns
fuel_lph_calc,fuel_src,trip_km,trip_fuel_l(main/econ.c, host-tested). -
Units: metric by default. On the first Wi-Fi connection the access point's country code (802.11d) sets miles and mpg for the US and the UK, once, stored in NVS (
main/units.c). A UK time zone is the fallback. Tested on the board with a US access point: it switched to miles and mpg and kept them after a reboot.unitsinconfig.json(metric,us,uk,auto) overrides it. Speed, odometer and MIL distance follow the units on screen, and the session JSON records them. -
Desktop app: fuel used and economy per drive in each drive's units, an average-economy card, and a table of every value the car reported in a drive (columns the car never filled are left out).
-
Scheduler: the model job's stall limit is one 10 s label window instead of three 1 s periods, which the car's own row gaps (up to 3.6 s) could trip.
-
A drive ends when the ECU stops answering for 15 s (before: 11 failed poll cycles, about 2.5 minutes on a real car). The session is saved and closed, the model stops expecting rows, and the board leaves DRIVE, so the power line turns green and the USB door and the Wi-Fi upload work again. An adapter left powered with the ignition off no longer keeps the board in "Not safe: logging". If the ECU answers again without a reboot, a new session starts.
-
Power-off with BOOT: logging stops as soon as the hold reaches 2 s. On release the board waits for the drive to be saved and closed, then sleeps. Holding on to 8 s (forget adapter) resumes logging.
-
DRIVE now means connecting to the adapter or logging rows. Waiting for a quiet ECU counts as parked.