The desktop app, and flashing new firmware#

The desktop app works as with the S3#

The OpenCarMind desktop app (Windows, macOS, Linux) talks to the Mosaico over its USB cable, the same way it talks to the ESP32-S3 board. Pairing, the drive list and import, the model switch and adding Wi-Fi networks all work the same. During a drive the board answers the app’s commands with “busy” until you park.

Two things in the app are written for the S3:

  • Its Flash firmware button is for the ESP32-S3 only. Do not use it for the Mosaico. Follow the steps below instead.

  • Where the app says “SD card”, on the Mosaico it means the board’s own storage.

Warning

Before you flash, copy your drives off and expect to pair again.

The firmware image covers the board’s internal settings. Flashing it erases the pairing with the desktop app, the saved Wi-Fi networks, the settings, the Smart swipe and Smart UI verdicts, the model choice and the session counter.

Flashing does not write the drive store or the flash files. New drives continue after the highest session number found, so old drives are not overwritten. Import your drives anyway. Never flash while Format storage is running.

Flashing version 2.0.0#

You need the image EdgeOS-2.0.0-esp32s31-merged.bin and its .sha256 file, a USB-C cable, Python with pyserial (pip install pyserial) and esptool 5.6.0 or later (pip install "esptool>=5.6.0"). You press no buttons.

The image checked on the board is built from 4aeff43. It is not published yet. The release image will be rebuilt from the latest 2.0.0 code, with the pairing sheet and the larger text, so its SHA-256 will differ. Check the .sha256 file that comes with the image you download.

  1. Plug the board into the computer. It shows up as a USB serial port: /dev/cu.usbmodem... on macOS, /dev/ttyACM... on Linux, COMx on Windows.

  2. Open that port at 1200 baud and close it again. This is the download door. The board finishes its writes and restarts into the chip’s download mode.

    python -c "import serial; serial.Serial('/dev/cu.usbmodemXXXX', 1200).close()"
    
  3. A new port appears. Write the image to it.

    esptool --chip esp32s31 --port <new port> --before no-reset --after hard-reset \
        write-flash --flash-mode dio --flash-freq 80m --flash-size 16MB 0x0 EdgeOS-2.0.0-esp32s31-merged.bin
    
  4. The board restarts into the new firmware. Settings > FIRMWARE AND BOARD shows OpenCarMind EdgeOS 2.0.0. Pair it again from the desktop app.

The download door needs no pairing. Anyone with the cable can put the board into download mode. That is how flashing works without buttons.

Going back to mossREV 1.2.0#

Follow the same four steps with the image mossREV-1.2.0-esp32s31-merged.bin. Flashing it erases the internal settings again, so pair again afterwards. The drive logs on the NAND and what R.E.V learned stay on the board.

Going back is not yet verified on the board.