MysterBoxFirmware installer & updater

Install the firmware

Latest firmware…
Your browser can't talk to USB devices. Please open this page in Google Chrome or Microsoft Edge on a Windows, macOS or Linux computer.
USB access needs a secure page. Please open this page over https://.

How it works

  1. Use Chrome or Edge on a computer. Phones and tablets can't do this, and no driver is needed on Windows.
  2. Connect the MysterBox with a USB-C data cable (some cables only charge).
  3. Click Connect & install and pick the port called USB JTAG/serial debug unit (on macOS it may show as usbmodem…).
  4. Choose Install MysterBox, decide about erasing (see below) and wait about a minute. The box restarts by itself when it's done.

Erase or not?

Updating MysterBox

Leave “Erase device” unticked

Your settings and the images and sounds stored inside the box stay. The SD card is never touched.

First install

Tick “Erase device”

When the board still runs its factory firmware (for example the Xiaozhi AI demo), erase it first. The first start then takes a little longer while the internal storage is prepared.

Troubleshooting

No port shows up in the list
  • Try another cable and another USB port. Charge-only cables are the most common cause.
  • Close other programs that may hold the port: serial monitors, Arduino IDE, ESP-IDF, another browser tab with this page.
  • Still nothing? Put the board into download mode: switch it off (hold PWR until the screen goes dark), then keep BOOT pressed while you plug in the USB cable. The screen stays dark; try Connect & install again. Afterwards press PWR or re-plug the cable to start the new firmware.
“Failed to initialize” or the install stops halfway

Re-plug the cable and start again. Nothing is lost: the box keeps working with whatever firmware installs completely, and you can always repeat the install. If it keeps failing, use download mode as described above.

Which version is on my box?

The version is shown at the bottom of the mode menu (hold BOOT for one second) and on the start screen.

Release notes

Loading…