← Back to wiki

Recover with USB flashing.

Use this when the Kiri Bridge web UI will not open, an OTA update failed, the device is in a bad state, or support asks you to restore the installer firmware.

recovery usb cable chrome / edge installer firmware

When to use this

  • The device does not show up on your network.
  • The local portal at http://IP:8080/ does not load after rebooting.
  • An OTA update failed and the device no longer behaves normally.
  • Support tells you to restore or re-flash the installer.
This process writes firmware over USB. It is safe for Kiri Bridge hardware, but you should not use it on random ESP32 boards.

Before you start

  • Use Chrome or Edge on a computer.
  • Use a USB data cable, not a charge-only cable.
  • Download the latest kiri_installer_... .kiri file from GitHub Releases.
  • Close serial monitor tools, Arduino IDE, ESP-IDF monitor, or anything else using the same USB port.

1. Connect and verify the board

  1. Connect Kiri Bridge to your computer with USB.
  2. Open Firmware recovery.
  3. Click Select & verify.
  4. In the browser's serial picker, select the Kiri Bridge USB serial device.
  5. Wait for the page to show the chip and MAC address summary.

If the serial device is missing

  • Try a different USB cable.
  • Try a different USB port.
  • Unplug Kiri Bridge, wait 5 seconds, plug it back in, and click Select & verify again.

2. Choose the installer package

  1. Click Choose firmware.
  2. Select the kiri_installer_... .kiri file.
  3. Read the package summary. It should say installer, Kiri Bridge, and ESP32.
  4. If the browser rejects the file, download it again from GitHub Releases and retry.
Do not choose a .bin file. The recovery page expects a .kiri package.

3. Write the package

  1. Check the confirmation box that says this is Kiri Bridge hardware.
  2. Click Write package.
  3. Do not unplug the device while the progress bar is moving.
  4. When the success dialog appears, the browser has released the USB port.
  5. Restart the device manually by pressing reset, unplugging and plugging it back in, or moving it to the heat pump.

4. After recovery

  1. Wait for the LED to blink blue.
  2. Open WiFi setup.
  3. Send WiFi credentials again.
  4. Open the portal at the reported http://IP:8080/ address.
  5. Install the latest production kiri_bridge_... .kiri file through OTA.
Open recovery → Activation guide