https://github.com/ravensystem/mgos32tohaa
ESP32 Mongoose OS to HAA OTA updates for Shelly
https://github.com/ravensystem/mgos32tohaa
apple esp-idf esp32 firmware haa home-automation homekit iot matter mongoose-os ota shelly smarthome
Last synced: 11 months ago
JSON representation
ESP32 Mongoose OS to HAA OTA updates for Shelly
- Host: GitHub
- URL: https://github.com/ravensystem/mgos32tohaa
- Owner: RavenSystem
- License: other
- Created: 2024-03-31T17:28:34.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-09T20:32:16.000Z (12 months ago)
- Last Synced: 2025-04-09T21:35:36.457Z (12 months ago)
- Topics: apple, esp-idf, esp32, firmware, haa, home-automation, homekit, iot, matter, mongoose-os, ota, shelly, smarthome
- Homepage:
- Size: 103 KB
- Stars: 18
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Shelly convert to HAA
This guide explains how to convert Shelly Plus, Mini, Pro, Gen3 and Gen4 devices to [HAA firmware](https://github.com/RavenSystem/esp-homekit-devices/wiki)
For older Shelly devices (Gen1) like Shelly 2.5, Shelly Dimmer 2, etc., use this instead: [mgos to HAA Shelly ESP8266](https://github.com/RavenSystem/mgostoHAA)
[](https://github.com/RavenSystem/mgos32toHAA/releases/latest)
[](https://github.com/RavenSystem/mgos32toHAA/releases/latest)
[](https://paypal.me/ravensystem)
[](https://twitter.com/RavenSystem)
[](https://discord.com/invite/v8hyxj2)
## :warning: **There is no OTA way back to Shelly firmware if the new ZIP file has been uploaded!**
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.
:warning: **This is a third-party experimental project, without any relation with Shelly or Alterco. If you decide to try it, [all is under your responsability](https://github.com/RavenSystem/mgos32toHAA/blob/main/LICENSE)**
:warning: Support for Shelly Gen4 devices is currently very experimental.
#### [Source Code](https://github.com/RavenSystem/esp-homekit-devices/tree/master/HAA/HAA_mgos32_Installer)
## Pre-requisites
- Download corresponding ZIP file from [Releases](https://github.com/RavenSystem/mgos32toHAA/releases/latest). If Shelly firmware is loaded again when you upload ZIP file, use alternative "_alt.zip" file.
- 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 Gen3 | DDimmerG3.zip | None
| Shelly Dimmer 0/1-10V PM Gen3 | Dimmer0110VPMG3.zip | None
| Shelly EM Gen3 | EMG3.zip | Switch and power metering with data history
| Shelly H&T Gen3 | HTG3.zip | None
| Shelly I4 Gen3 | I4G3.zip | 4 stateless buttons and internal temperature monitoring from HAA Home
| Shelly 1 Mini Gen3 | Mini1G3.zip | Switch and internal temperature monitoring from HAA Home with 75°C overheat protection
| Shelly 1 Mini Gen4 | Mini1G4.zip | None
| Shelly 1PM Mini Gen3 | Mini1PMG3.zip | Switch, power monitoring with data history and internal temperature monitoring from HAA Home with 75°C overheat protection
| Shelly 1PM Mini Gen4 | Mini1PMG4.zip | None
| Shelly PM Mini Gen3 | MiniPMG3.zip | Power monitoring with data history and internal temperature monitoring from HAA Home
| Shelly Plug US | PlugUS.zip | Outlet, power monitoring with data history and internal temperature monitoring from HAA Home with 75°C overheat protection
| Shelly Plus 1 | Plus1.zip | Switch and internal temperature monitoring from HAA Home with 75°C overheat protection
| Shelly Plus 0-10V Dimmer | Plus10V.zip | Light dimmer, stateless button and internal temperature monitoring from HAA Home with 75°C overheat protection
| Shelly Plus 1 Mini | Plus1Mini.zip | Switch and internal temperature monitoring from HAA Home with 75°C overheat protection
| Shelly Plus 1PM | Plus1PM.zip | Switch, power monitoring with data history and internal temperature monitoring from HAA Home with 75°C overheat protection
| Shelly Plus 1PM Mini | Plus1PMMini.zip | Switch, power monitoring with data history and internal temperature monitoring from HAA Home with 75°C overheat protection
| Shelly Plus 2PM | Plus2PM.zip | 2 switches, Zero-Cross relay protection, power monitoring with data history and internal temperature monitoring from HAA Home 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 with data history and internal temperature monitoring from HAA Home with 75°C overheat protection
| Shelly Plus Plug S | PlusPlugS.zip | Outlet, power monitoring with data history and internal temperature monitoring from HAA Home with 75°C overheat protection
| Shelly Plus Plug UK | PlusPlugUK.zip | Outlet, power monitoring with data history and internal temperature monitoring from HAA Home with 75°C overheat protection
| Shelly Plus PM Mini | PlusPMMini.zip | Power monitoring with data history and internal temperature monitoring from HAA Home
| 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 Home with 75°C overheat protection
| Shelly Pro 1PM | Pro1PM.zip | None
| Shelly Pro 2 | Pro2.zip | 2 switches and internal temperature monitoring from HAA Home with 75°C overheat protection
| Shelly Pro 2PM | Pro2PM.zip | None
| Shelly Pro 3 | Pro3.zip | 3 switches and internal temperature monitoring from HAA Home with 75°C overheat protection
| Shelly Pro 3EM | Pro3EM.zip | None
| Shelly Pro 4PM | Pro4PM.zip | None
| Shelly Pro Dimmer 0/1-10V PM | ProDimmer0110VPM.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 Home with 75°C overheat protection
| Shelly 1 Gen4 | S1G4.zip | None
| Shelly 1PM Gen3 | S1PMG3.zip | Switch, power monitoring with data history and internal temperature monitoring from HAA Home with 75°C overheat protection
| Shelly 1PM Gen4 | S1PMG4.zip | None
| Shelly 2PM Gen3 | S2PMG3.zip | 2 switches, Zero-Cross relay protection, power monitoring with data history and internal temperature monitoring from HAA Home with 75°C overheat protection
| Shelly 2PM Gen4 | S2PMG4.zip | None
## Instructions [(YouTube Video with subtitles)](https://www.youtube.com/watch?v=06YHkRkwJE4)
1. Connect to Shelly device and open its web interface with a web browser using its IP address.
2. Navigate to `Settings -> Firmware`, and drag & drop or browse for the ZIP file in the `Firmware file image`.
3. Click the `Update from file` button.
4. 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.
5. If Shelly firmware is loaded again when you upload ZIP file, repeat the process using alternative "_alt.zip" file.
6. An `HAA-XXXXXX` WiFi HotSpot should be visible to start the [HAA Installation steps](https://github.com/RavenSystem/esp-homekit-devices/wiki/installation#installing-haa).
Feel free to change or modify MELPHAA script as your needs. [HAA Wiki](https://github.com/RavenSystem/esp-homekit-devices/wiki)
In addition to this firmware, you can obtain [**HAA Home App**](https://github.com/RavenSystem/esp-homekit-devices/wiki/haa-home-manager), 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**](https://github.com/RavenSystem/esp-homekit-devices/wiki/home-bench), 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:
