Field checks#
These checks need a real car, a real adapter or a real card, so they cannot run in CI. The result tables are empty on purpose. Run a check, then report what you saw in an issue (use the “Field check” template) and the table gets a row.
Input checks on the board#
Put the file named in each row on the SD card at obd/, boot the board and read the log over USB.
Check |
Do this |
Expected |
Firmware |
Board |
Result |
|---|---|---|---|---|---|
Short Wi-Fi password rejected |
|
log says |
|||
Over-long line skipped |
|
log says |
|||
Normal clock sync |
a valid |
log says |
|||
Control character rejected |
|
the line is not imported |
Driving#
Check |
Do this |
Expected |
Firmware |
Car and adapter |
Result |
|---|---|---|---|---|---|
Power-off line |
watch page 3 while driving, then switch the car off |
red “Not safe: logging” while driving, green “Safe to turn off” about 10 s after the car stops |
|||
Power off while driving |
cut power mid-drive, pull the card |
the last rows of |
|||
Another adapter |
pair a different BLE OBD adapter |
the board finds it, connects and logs rows |
|||
Adapter name not on the list |
an adapter whose name is not in |
it is not found until its name prefix is added |
Clock and the desktop app#
Check |
Do this |
Expected |
Firmware and app |
Computer |
Result |
|---|---|---|---|---|---|
HTTPS clock |
park near a known Wi-Fi network after a boot |
page 2 shows Clock: synced, and the session JSON has |
|||
Your time server |
set Time server on the Board page to a host you run, restart |
the clock still syncs; a host without a valid certificate is refused |
|||
R.E.V torque and tank |
drive with R.E.V selected, then open the Fuel page |
torque shows on page 5 in amber (idle when stopped); the Fuel page shows the tank learning progress |
Wi-Fi upload to the desktop app (not in 2.5.0)#
Check |
Do this |
Expected |
Firmware and app |
Computer |
Result |
|---|---|---|---|---|---|
Pair and receive |
pair over USB from the Board page, add your Wi-Fi, then park the car near that network |
the app lists the board within a minute and the Overview shows its drives |
|||
Resume |
close the app during an upload, open it again |
the upload continues and no row is repeated |
|||
Firewall prompt |
first connection after installing |
the system asks to allow incoming connections |
|||
Flash from the app |
Board page, Flash the firmware |
the board restarts on the new version and still has its Wi-Fi networks and pairing |
|||
Import over USB |
Board page, Import drives over USB |
the drives appear on the Overview, and a second import copies nothing new |
|||
Window tiling |
snap the app to half the screen (Windows), split view (macOS), a tiling window manager (Linux) |
it fills the tile and stays usable down to 480 by 360 |
|||
Clock after a power cut |
let the clock sync, cut power, boot without Wi-Fi |
the screen clock shows in amber and keeps running, and the session JSON says |
How to report#
Open a “Field check” issue with the firmware version (page 2 of the screen, or status), your board, your car and adapter, and what you saw. Do not paste Wi-Fi names or passwords from the log.