Recovery - mongoose-os-apps/shelly-homekit GitHub Wiki

Device recovery

From invalid WiFi configuration

If a device cannot be located on the network it is supposed to connect to, it can be put back into AP mode via the following methods:

  • On devices with a physical button press and hold the button for 10 seconds while the device is on.
  • On most models within first 30 seconds after boot, toggle the input 10 times in succession.
    • On devices with multiple inputs, use the first input.
  • On all devices within first 10 seconds after boot, cut the device power and connect it again, repeat that 5 times

This kind of reset will also reset device password (if any) but will not reset HAP state, if the device was paired before it will remain paired. Once you have reset the WiFi on the device follow this procedure here.

From invalid HAP state

If a device does not appear on the list of new devices to be added, this could be due to device being paired already. This is indicated by "Paired: yes" status in the HomeKit settings section of the Web UI. In this case, the right thing to do is to remove the device from the controller it is currently paired to. If that is not possible (e.g. the iDevice it was paired with is no longer accessible), use "Reset" button on the Web UI to reset HAP state and remove all the pairings. This will completely reinitialize the HAP state of the device, including generating new ID, it should appear in the scan results.

From crash looping or otherwise misbehaving firmware

If firmware won't stay up or is otherwise misbehaving in some way that requires full reset, it can be put into a fail-safe mode: power off the device, power it on, then press and hold the device button while the LED is flashing rapidly (you have 5 seconds). Hold until LED is solid on (not currently available on Shelly 1 as it doesn't have a button or LED, file an issue if you have suggestions on what to do about it).

In this mode device wipes all its configuration, HAP and WiFi and reverts back to AP mode. Bare-bones web interface will be available at http://192.168.33.1/ when connected to the device's AP, it allows uploading new firmware (can be HomeKit or stock).

To exit fail-safe mode, flash new firmware or reboot the device again without holding the button.