Skip to content

Firmware update

A firmware update is one file uploaded from the web interface. WiCAN writes it to its spare slot, checks it, switches to it and restarts; a failed or interrupted upload never touches the firmware that is running. Settings, files and the SD card stay as they are.

Get the file

Releases are at https://github.com/meatpiHQ/wican-fw/releases. Download the WiCAN PRO image, a .bin file named like wican-fw_obd_pro_v6.00.bin, and read the release notes. About and System › Firmware update show the version installed now.

Update

  1. Power that will not go away. The car's ignition on, or a bench supply. The write takes seconds; a power cut in the middle only costs the attempt, but do not provoke it.

  2. System › Firmware update › Choose File, pick the .bin, Flash Firmware.

  3. Wait. A progress bar follows the upload; the LED blinks red fast while the image is written. When the upload is checked and accepted the page says it is rebooting and reconnects by itself.

  4. Check. About shows the new version, and the Partition row on the Firmware update page has flipped (ota_0 to ota_1, or back). If the browser still shows the old pages, reload them once: a page loaded from a previous build may be cached.

The Firmware Update card: the installed version and partition, the file chooser with Flash Firmware, and the warning not to power off

System, Firmware update.

From the command line

For a script or a PC without a browser, the same route takes the file as a form upload or as the raw body:

curl -F firmware=@wican-fw_obd_pro_v6.00.bin http://192.168.0.10/api/ota/upload
curl --data-binary @wican-fw_obd_pro_v6.00.bin -H "Content-Type: application/octet-stream" http://192.168.0.10/api/ota/upload

The answer names the partition written and the device restarts a second later; GET /api/ota/status reports the progress meanwhile (HTTP API).

firmware 6.0.0-beta.1+ The same page updates a dongle on the USB port: the Firmware update card gets a second row for the ESPNetLink with its installed version, Check now, Release notes and Update dongle. WiCAN downloads the dongle's release over WiFi, checks it, sends it over the cable (or over the dongle's own WiFi in WiFi modem mode) and waits for the dongle to restart; keep the dongle plugged in until the row says Dongle updated. Internet through the dongle pauses for about a minute meanwhile. A dongle on firmware 1.20 or older shows Needs a USB flash: it is updated once from a computer, after which it installs from here. The dongle side, the timings and the failure texts are in the ESPNetLink manual: Update.

Coming from the 4.x firmware

This manual describes firmware version 6 and later. A WiCAN PRO on the 4.x firmware is updated to version 6 through the 4.x interface itself: download the version 6 .bin from the releases page, then in the 4.x interface open System, under Firmware Update choose the file and click Update.

The 4.x interface's System page: the Firmware Update section with the version 6 file chosen and the Update button

The 4.x interface, System page: choose the version 6 file, then Update.

The first start of version 6 rewrites WiCAN's partition layout and restarts once more by itself (recorded as partition_migrate in the restart history). The device then starts with factory settings: join WiCAN_<device id> with the password @meatpi#, open http://192.168.0.10/ and run Quick Setup. The 4.x configuration is not converted, so note down what you want to type again (WiFi, MQTT, the vehicle profile) before you start. Going back to the 4.x firmware through the same page works too; it then starts as a fresh device.

When the web interface is out of reach

Hold the button while applying power: WiCAN starts in safe mode (LED solid yellow after a few seconds), opens its factory access point WiCAN_<device id> with the password @meatpi#, and serves a small recovery page at http://192.168.0.10/ with a firmware upload on it. See Factory reset for the whole safe mode. When even safe mode does not come up, write the firmware over the USB-C cable instead: Recovery over USB.

Troubleshooting

Symptom Likely cause What to do
image validation failed not a WiCAN PRO v6 image (a zip, another product's file) the .bin for WiCAN PRO from the releases page
short image (connection dropped?) the WiFi link broke during the upload closer to the device, or over the USB link; try again
update already in progress a second upload while one runs wait for the first
The page does not come back the device restarted and the browser kept the old connection wait 30 s and reload; the address may have changed with the network
The old interface still shows a cached page from the previous build reload the page
Unexpected resets climbs after the update the new firmware crashes on something in your setup the crash report; go back to the previous release through the same page