This guide explains how to convert Shelly Plus, Mini, Pro and Gen3 devices to HAA firmware
For older Shelly devices (Gen1) like Shelly 2.5, Shelly Dimmer 2, etc., use this instead: mgos to HAA Shelly ESP8266
Shelly bootloader will be replaced with a standard ESP-IDF bootloader, avoiding to back to original firmware. To back to Shelly firmware or to recover it if something goes wrong, a wired connection to a PC using an FTDI adapter is needed.
- Download corresponding ZIP file from Releases.
- Shelly doesn't need to be updated to latest firmware version, but it can be updated to latest version if you want. This works even with version 1.4.x from Shelly.
- Shelly doesn't need to be connected to your WiFi network, but it can be connected to your WiFi network if you want.
| Device | ZIP File | Preloaded HomeKit functions |
|---|---|---|
| Shelly Dimmer 0/1-10V PM Gen3 | Dimmer0110VPMG3.zip | None |
| Shelly H&T Gen3 | HTG3.zip | None |
| Shelly I4 Gen3 | I4G3.zip | 4 stateless buttons and internal temperature monitoring from HAA Manager |
| Shelly 1 Mini Gen3 | Mini1G3.zip | Switch and internal temperature monitoring from HAA Manager with 75°C overheat protection |
| Shelly 1PM Mini Gen3 | Mini1PMG3.zip | Switch, power monitoring and internal temperature monitoring from HAA Manager with 75°C overheat protection |
| Shelly PM Mini Gen3 | MiniPMG3.zip | Power monitoring and internal temperature monitoring from HAA Manager |
| Shelly Plug US | PlugUS.zip | Outlet, power monitoring and internal temperature monitoring from HAA Manager with 75°C overheat protection |
| Shelly Plus 1 | Plus1.zip | Switch and internal temperature monitoring from HAA Manager with 75°C overheat protection |
| Shelly Plus 0-10V Dimmer | Plus10V.zip | Light dimmer, stateless button and internal temperature monitoring from HAA Manager with 75°C overheat protection |
| Shelly Plus 1 Mini | Plus1Mini.zip | Switch and internal temperature monitoring from HAA Manager with 75°C overheat protection |
| Shelly Plus 1PM | Plus1PM.zip | Switch, power monitoring and internal temperature monitoring from HAA Manager with 75°C overheat protection |
| Shelly Plus 1PM Mini | Plus1PMMini.zip | Switch, power monitoring and internal temperature monitoring from HAA Manager with 75°C overheat protection |
| Shelly Plus 2PM | Plus2PM.zip | 2 switches, power monitoring and internal temperature monitoring from HAA Manager with 75°C overheat protection |
| Shelly Plus H&T | PlusHT.zip | None |
| Shelly Plus I4 | PlusI4.zip | 4 stateless buttons |
| Shelly Plus Plug IT | PlusPlugIT.zip | Outlet, power monitoring and internal temperature monitoring from HAA Manager with 75°C overheat protection |
| Shelly Plus Plug S | PlusPlugS.zip | Outlet, power monitoring and internal temperature monitoring from HAA Manager with 75°C overheat protection |
| Shelly Plus Plug UK | PlusPlugUK.zip | Outlet, power monitoring and internal temperature monitoring from HAA Manager with 75°C overheat protection |
| Shelly Plus PM Mini | PlusPMMini.zip | Power monitoring and internal temperature monitoring from HAA Manager |
| Shelly Plus RGBW PM | PlusRGBWPM.zip | Color lightbulb RGBW |
| Shelly Plus Smoke | PlusSmoke.zip | None |
| Shelly Plus Uni | PlusUni.zip | 2 switches, analog input, and temperature sensor DHT22 |
| Shelly Plus Wall Dimmer | PlusWallDimmer.zip | None |
| Shelly Pro 1 | Pro1.zip | Switch and internal temperature monitoring from HAA Manager with 75°C overheat protection |
| Shelly Pro 1PM | Pro1PM.zip | None |
| Shelly Pro 2 | Pro2.zip | 2 switches and internal temperature monitoring from HAA Manager with 75°C overheat protection |
| Shelly Pro 2PM | Pro2PM.zip | None |
| Shelly Pro 3 | Pro3.zip | 3 switches and internal temperature monitoring from HAA Manager with 75°C overheat protection |
| Shelly Pro 3EM | Pro3EM.zip | None |
| Shelly Pro 4PM | Pro4PM.zip | None |
| Shelly Pro Dimmer 2PM | ProDimmerx.zip | None |
| Shelly Pro EM-50 | ProEM.zip | None |
| Shelly 1 Gen3 | S1G3.zip | Switch and internal temperature monitoring from HAA Manager with 75°C overheat protection |
| Shelly 1PM Gen3 | S1PMG3.zip | Switch, power monitoring and internal temperature monitoring from HAA Manager with 75°C overheat protection |
| Shelly 2PM Gen3 | S2PMG3.zip | 2 switches and internal temperature monitoring from HAA Manager with 75°C overheat protection |
Instructions (YouTube Video with subtitles)
- Connect to Shelly device and open its web interface with a web browser using its IP address.
- Navigate to
Settings -> Firmware, and drag & drop or browse for the ZIP file in theFirmware file image. - Click the
Update from filebutton. - Wait until Shelly web interface tries to reload, and wait 30 seconds more to let new firmware to do the conversion process. Be sure that you don't cut power during these 30 seconds of conversion, or your Shelly will have a chance of 1% to be bricked.
- An
HAA-XXXXXXWiFi HotSpot should be visible to start the HAA Installation steps.
Feel free to change or modify MELPHAA script as your needs. HAA Wiki
In addition to this firmware, you can obtain HAA Home Manager App, the perfect App companion to manage your HAA devices, with batch updates, enable setup mode, and other extra features (This purchase will help to support the development of this project):
If you want to measure the performance of your Apple Home, you can get Home Bench App, the only App that performs speed tests directly over accessories using Apple HomeKit API (This purchase will help to support the development of this project):
And don't forget to subscribe to YouTube Channel:
