← Back to wiki

Install firmware over USB.

Use this when you prefer USB flashing, or when support asks you to install a specific release without using OTA from the device web UI.

manual update usb serial .kiri package support path

Choose the right package

Kiri releases may include more than one .kiri file. Pick the one that matches what you are trying to do.

  • Choose kiri_bridge_... .kiri when you want the normal production firmware.
  • Choose kiri_installer_... .kiri when support asks you to restore the installer or start over from WiFi setup.
  • If support sent you a specific filename, use that exact file.
If you are not sure which file to use, stop here. Use OTA from the device portal for normal updates, or ask support which .kiri file to flash.

Before you start

  • Use Chrome or Edge on a computer.
  • Use a USB data cable.
  • Keep the downloaded .kiri file somewhere easy to find.
  • Close any serial monitor or flashing tool that may be using the device.

Flash over USB

  1. Open Firmware recovery. The same tool is used for manual USB installs.
  2. Click Select & verify and pick the Kiri Bridge serial device.
  3. Confirm the page shows an ESP32 / ESP32-PICO-D4 chip and a MAC address.
  4. Click Choose firmware and select the instructed .kiri file.
  5. Review the package summary before continuing.
  6. Check the confirmation box and click Write package.
  7. Wait for the success dialog. Do not unplug the device while writing is in progress.
  8. Restart the device manually after the browser releases USB.

What to do after flashing

If you flashed production firmware

  • Wait about 30 seconds after restart.
  • Open the existing portal address if the device was already on WiFi.
  • If the portal does not open, power-cycle once and try again.

If you flashed installer firmware

  • Wait for the LED to blink blue.
  • Run WiFi setup.
  • Open the reported http://IP:8080/ portal.
  • Install production firmware from the portal using OTA.

If something goes wrong

  • If the browser cannot find the serial port, change USB cable first.
  • If flashing fails before writing starts, download the package again and retry.
  • If flashing fails during writing, unplug the device, plug it back in, and repeat the USB recovery flow with the installer package.
  • If the device flashes successfully but does not boot as expected, use the recovery guide and start from the installer.
Open flasher → Recovery guide