The board looks after itself#

OpenCarMind EdgeOS is the layer of the firmware that decides what may run and when. It runs by itself. This section explains what it shows you and what to do about it.

The health check#

About a minute (65 s) after every start, the board rates itself. It looks at the model’s self-test, the storage check, the drive store, the first screen update, the touch controller and the job deadlines.

  • Good: everything passed. Green on the Board page.

  • Degraded: the board runs, but something is off. Amber. The events list names the reason, for example “Boot health: degraded: NAND not mounted”.

  • Bad: the screen never updated, or the board started in safe mode after three crashes in a row. Red.

  • Pending: the first minute, before the check

The result shows at the top right of the Board page, for example “Parked, health good”, and in the events list as “Boot health: good”.

What a degraded reason means#

  • model self-test differs, model self-test not run: the model did not match its known answers at start. Note it and send the Board page.

  • flash FAT repaired, flash FAT audit warning: the board fixed or found a problem in its flash files at start. Your data is still there.

  • flash FAT not mounted, NAND not mounted: a store did not open. See Troubleshooting.

  • touch failing: the touch controller did not answer at start

  • deadline misses, job stalls, not schedulable: a job was late, stopped, or would not fit in time

  • UI slow to start: the first screen update took more than 15 s

Board states#

The board is always in one or more of these states. The Board page shows the main one.

  • Boot: the first seconds after a start, until start-up has finished

  • Parked: none of the others. Everything is allowed.

  • Driving: a drive is being recorded, or the car’s computer answers and the board logs rows. Searching for the adapter, connecting to it, or an adapter in a parked car with the engine off keep the board Parked.

  • Safe: the board started in safe mode after three crashes in a row. Logging stays on, the model and R.E.V’s learning stay off.

  • Update: a restart, a firmware download or Format storage is running

  • Saving: the battery is too warm, so the board saves power. The screen dims, Wi-Fi waits and R.E.V’s learning pauses. The board goes back to Parked by itself when the battery has cooled. See Battery protection below.

Each action is allowed only in some states. If several states hold at once, the action has to be allowed in all of them.

Action

Allowed when

Refused when

Switch models

Parked

Boot, Driving, Safe, Update, Saving

Format storage

Parked, Safe

Boot, Driving, Update, Saving

Set the clock by hand

Parked, Boot, Safe

Driving, Update, Saving

Wi-Fi: search, join, forget, clock sync

Parked, Boot, Safe

Driving, Update, Saving

Desktop app commands over USB, after pairing

Parked, Boot, Safe

Driving, Update, Saving

R.E.V’s learning

Parked, Boot, Driving

Safe, Update, Saving

Messages when an action has to wait#

  • “A drive is active. End the drive first, then switch models.”: a drive is being recorded. The same message ends with “set the clock” or “format” for those actions. Hold End drive, or switch the engine off and wait for the drive to end.

  • “Not now: a drive is running. Try again later.”: the same reason for the clock sync, Format and other actions. Wait until the drive ends.

  • “Not now: the car link is up. Try again later.”: the car’s computer answers, but no drive is recorded yet. Switch the engine off, or wait for the drive to end.

  • “Not now: the board is starting. Try again later.”: start-up has not finished. Try again a few seconds later.

  • “Not now: an update or format is running. Try again later.”: wait for the format or the restart to finish

  • “Not now: safe mode is on. Try again later.”: the board is in safe mode. Restart it. If it stays in safe mode, send the Board page and the events.

  • “Not now: the board is saving power. Try again later.”: the battery is warm. Let the board cool down. If you tap Sync clock now while the board saves power, the sync waits until the battery has cooled.

  • “Not forgotten: a drive is running.”: Forget for a Wi-Fi network waits until you park

  • “ERR busy: …, try again when parked”: the board answers the desktop app with this during a drive

When the model falls behind#

If the model starts missing its 1-second deadline, the board gives up comfort before function. It takes one step every 10 seconds while the misses go on:

  1. The screen draws half as many frames. Events: “Model deadlines: UI slowed”.

  2. R.E.V’s learning pauses. What it learned is kept. Events: “Model deadlines: learner paused”.

  3. The model pauses. The same model stays loaded. Events: “Model deadlines: model paused”.

A minute without misses takes one step back, and the events say so. The last step is undone only when you park, so the model does not go on and off during one drive. The board never switches to the other model by itself.

Battery protection#

Every 2 seconds the board reads the cell’s voltage, current and temperature from its fuel gauge. The temperature comes from the gauge chip next to the cell, not from the cell itself.

  • “Battery hot (45.0 C on USB): load shed”: at 45 °C on USB power, Wi-Fi and R.E.V’s learning stop, the screen dims and changes wait. “Battery cooled” follows at 42 °C.

  • “Battery too hot (60 C): stopped”: at 60 °C the board saves its logs and stops writing. After 30 seconds at 57 °C or below it restarts by itself.

  • “Battery over-voltage (4250 mV): charger fault, stopped”: the cell reached 4.25 V or more, which points to a charger fault. The board saves and stops until you restart it. Unplug it and have the board checked.

These limits are placeholders until the cell’s datasheet is known. The board cannot stop or limit charging: the charger has no control line. A cell kept full in a hot car ages faster, so keep the board out of direct sun.

One safe restart#

Every restart the firmware asks for, such as the restart after Format storage or the firmware download door, takes the same path. It saves and closes the flash files and the drive store first, then restarts. The next start writes in its log which requested restart ended the last run.

Faster screen drawing#

The chip has a pixel accelerator and a 2D copy engine. OpenCarMind EdgeOS uses them to copy the page pictures while you swipe and to fill large areas of the screen. If an engine fails three times in a row, or its start-up test does not match the processor’s result, the board turns that engine off until the next start and draws with the processor instead.

On the board (OpenCarMind EdgeOS 2.0.0 4aeff43) both engines stayed on with no failures. How much faster the screen draws is not yet verified on the board.