1. Introductie
We zijn verheugd aan te kondigen dat HA over iHost nu officieel beschikbaar is! Dit project brengt het volledige Home Assistant-besturingssysteem naar de SONOFF iHost platform, en biedt gebruikers een krachtige nieuwe manier om Home Assistant lokaal op iHost-hardware te draaien.
Geboren uit echte communitybehoeften en door gebruikers gedreven technische verkenning, weerspiegelt dit initiatief de creativiteit en passie van de Home Assistant- en SONOFF-gebruikersgemeenschappen. Veel iHost-gebruikers draaien al Home Assistant Core in Docker op het native systeem om te profiteren van de hardware. Sommige gevorderde gebruikers gingen nog verder—ze pasten hun eigen builds aan en compileerden deze om het volledige Home Assistant OS native op iHost te draaien.
In deze gids laat ik je zien hoe je eenvoudig Home Assistant kunt draaien op je SONOFF iHost. We lopen twee flashmethoden door: met behulp van Balena Etcher of Raspberry Pi Imager. Laten we beginnen!
Bekijk hier de gedetailleerde videotutorial:
2. Vereisten
- Een SONOFF iHost is vereist.
- Zorg ervoor dat jer iHost systeemversie is 2.5.1 of hoger.
- Een Application Class 2 (A2) kaart met een minimale capaciteit van 32GB wordt aanbevolen voor betere prestaties, vooral bij kleine lees- en schrijfoperaties.
- Omdat iHost gebaseerd is op een 32-bit processor, sommige Home Assistant-functies zijn mogelijk niet compatibel.
3. De Micro SD-kaart voorbereiden
Vereiste hardware
- Een (Application Class 2) (A2) kaart met een minimale capaciteit van 32GB wordt aanbevolen voor betere prestaties, vooral bij kleine lees- en schrijfoperaties. We raden aan een TF-kaart van SanDisk, Kingston of Samsung te gebruiken. We hebben deze merkkaarten intern gebruikt voor testen.
- Een SD-kaartlezer: elke standaard USB-kaartlezer werkt als je laptop geen ingebouwde SD-kaartlezer heeft.
Vereiste software
- Micro SD-kaart flash tool: Balena Etcher of Raspberry Pi Imager, enzovoort.
- Bezoek het GitHub-project voor het bijbehorende HA over iHost image: iHost-Open-Source-Project.
4. HA Over iHost Image flashen naar Micro SD-kaart
-
Flash met Balena Etcher
- Plaats de Micro SD-kaart in de kaartlezer en sluit deze aan op je computer.
- Download en start Etcher.
- Klik Flash vanaf bestand, selecteer dan dee HA over iHost image bestand gedownload op je computer.
2. Klik Selecteer doel, kies dan de Micro SD-kaart die je hebt geplaatst.
*Opmerking: Zorg ervoor dat je de juiste schijf selecteert!
3. Klik Flash! om te beginnen met flashen the HA over iHost image op de Micro SD-kaart.
*Opmerking: Verwijder of gebruik de SD-kaart niet tijdens het flashproces.
-
Flash met Raspberry Pi Imager
- Plaats de SD-kaart in de kaartlezer en sluit deze aan op je computer.
- Download en start Raspberry Pi Imager.
- Klik KIES APPARAAT > Geen filtering.
- Klik KIES BESTURINGSSYSTEEM > Gebruik aangepast, selecteer dan het HA over iHost image-bestand dat je op je computer hebt gedownload.
-
Klik OPSLAG KIEZEN, kies dan de Micro SD-kaart die je hebt geplaatst.
*Opmerking: Zorg ervoor dat je de juiste Micro SD-kaart selecteert!
- Klik VOLGENDE > NEE, INSTELLINGEN WISSENen bevestig om alle instellingen op de SD-kaart te wissen.
-
Begin met het flashen van het HA over iHost-image op de geplaatste SD-kaart.
*Opmerking: Raak de SD-kaart niet aan (bijv. loskoppelen of bestanden wijzigen) tijdens het flashproces.
5. Opstarten Home Assistant-besturingssysteem op iHost
Zigbee-apparaten migreren (optioneel)
Als Zigbee-apparaatmigratie niet nodig is, ga dan door naar de volgende sectie.
iHost stelt u in staat om Zigbee-apparaatgegevens van iHost te exporteren en te migreren naar Home Assistant door het downloaden van het beschikbare back-upbestandom te herstellen in Home Assistant geïntegreerd met ZHA/Zigbee2MQTT. Alleen het Zigbee-netwerk en de apparaatstatus worden gemigreerd. Timers, groepen, scènes en apparaatsnamen zijn niet inbegrepen. Klik hier om te leren: Hoe te herstellen?
Opstartenng Home Assistant-besturingssysteem op iHost
- Plaats de vooraf geflashede Micro SD-kaart in de SD-kaartsleuf van de iHost.
- Sluit iHost aan op een netwerkkabel en zet hem aan.
- Binnen 5 seconden na het inschakelen, druk herhaaldelijk op de Dempen knop (♪) bovenop de iHost totdat de LED-zijstrip een BLAUW ademend lichtpatroon toont. Dit geeft aan dat het systeem overschakelt naar het Home Assistant-besturingssysteem dat op de SD-kaart is geflashed.
-
Als de LED-indicator een BLAUW ademend lichtpatroon, dan kunt u binnen 10 minuten toegang krijgen tot uw nieuwe Home Assistant-webinterface. De eerste keer opstarten kan langer duren.
Voer in een desktopbrowser in homeassistant.local:8123.
*Opmerking: Als u een oudere versie van Windows gebruikt of strengere netwerkconfiguraties hebt, moet u mogelijk Home Assistant openen via een van de volgende URL's:
http://homeassistant:8123 of http://X.X.X.X:8123 (vervang X.X.X.X door het IP-adres van uw Raspberry Pi)
Problemen met opstarten oplossen
- Als dede LED-zijstrip doettoont geen BLAUW ademend lichtpatroonterug maar een ROOD ademend lichtpatroon naof het inschakelen gedurende 5 seconden of na meerdere keren drukken op de knop, is het opstarten mislukt. Probeer opnieuw op te startenhet Home Assistant-besturingssysteem als volgtws:
- Start iHost opnieuw op;
- Er hoeft geen knop ingedrukt te worden.
- iHost probeert opnieuw op te startenniet Home Assistant-besturingssysteem vanvan de SD-kaart.
- Als u binnen 10 minuten na bovenstaande handelingen geen toegang krijgt tot de Home Assistant-webinterface, kan dit komen door een verkeerd geflashed image. Probeer de SD-kaart opnieuw te flashen of gebruik een nieuwe.
6. Terugschakelen naarnaar eWeLink CUBE
- Om terug te schakelen naarnaar eWeLink CUBE, fVolg deze stappen:
- Start iHost opnieuw op.
- Druk herhaaldelijk één keer op de dempknop (♪) binnen 3 seconden.
- De LED Zijstrip met verlichtingzal overschakelen naar een ROOD vloeiend lichtpatroon, wat bevestigt dat het systeem is teruggeschakeld naar eWeLink CUBE.
*Opmerkingen:
- Als meerdere apparaten worden uitgevoerdng Home Assistant-besturingssysteem aan in je netwerk, kan de hostnaam [homeassistant.local] mogelijk niet correct worden opgelost. Je kunt het juiste IP-adres vinden via de beheerinterface van je router of door de mDNS-service [_home-assistant._tcp.] te broadcasten.
- Als de laatste opstart vanaf de SD-kaart was, en de kaart wordt verwijderd zonder terug te schakelen naar eWeLink CUBE, dande LED-zijkantstrip zal toont een ROOD ademend lichtpatroon, die aangeven dat Home Assistant Operating System niet is opgestart op iHost.
7. Hardwarebronnen
Aanwanneer Home Assistant Operating System succesvol issuccesvol draaiend op iHost, kun je de volgende ondersteunde onboard hardware gebruiken:
Knop & LED-indicator
De iHost Hardware Control add-on maakt het mogelijk om de knoppen en LED-indicatoren van iHost te bedienen in Home Assistant. Deze worden geregistreerd als apparaten en aparte entiteiten, zodat gebruikers ze kunnen gebruiken in automatiseringen voor flexibelere hardware-interacties.(bijv. het activeren van de aan/uit-knop entiteit om iHost uit te schakelen). Raadpleeg voor details de iHost Hardware Control add-on handleiding.
Bluetooth
- Chipsetmodel: RTL8723DS
- Pad: Instellingen > Apparaten & Diensten > Integraties > Bluetooth
- Detectie: Automatisch
Wi-Fi
- Chipsetmodel: RTL8723DS
- Pad: Instellingen > Systeem > Netwerk > Netwerkinterfaces configureren > WLAN0
- Detectie: Automatisch
Zigbee-coördinator
- Chipsetmodel: 00.21.05.0009 SOC EFR32MG21A020F768IM32-B SiliconLabs QFN32-4*4 （RAM 64kB, Flash 768kB）
- Pad: Instellingen > Systeem > Hardware > Alle hardware > /dev/ttyS4
- Detectie: Via Zigbee Home Automation (ZHA) of Zigbee2MQTT
7. Over CoreBox Image
CoreBox is een nieuwe HA over iHost image ontworpen voor snelle installatie, met de nieuwste HA Core-versie (2025.05.03) vooraf geïntegreerd.
Met CoreBox hoef je tijdens de eerste installatie niet meer te wachten tot het apparaat HA Core van GitHub downloadt. In plaats daarvan kun je direct opstarten vanaf de ingebouwde HA Core-versie, waardoor de opstarttijd binnen 3 minuten of zelfs sneller is. CoreBox maakt je niet afhankelijk van internetverbinding, waardoor je eenvoudig kunt installeren, zelfs offline. Je kunt later nog steeds binnen het systeem updaten naar nieuwere HA Core-versies zodra het draait.
Waarom CoreBox?
We hebben goed geluisterd naar jullie feedback. Veel gebruikers meldden dat het oorspronkelijke installatieproces van HA via iHost vaak mislukte door slechte of onstabiele internetverbinding, vooral tijdens het eerste downloaden van HA Core. Dit veroorzaakte niet alleen frustratie, maar ontmoedigde ook veel nieuwe gebruikers om door te gaan.
Zelfs met onze online ondersteuning duurde het oplossen van netwerkproblemen en het doorlopen van het installatieproces vaak langer dan verwacht — zowel voor gebruikers als ons team.
Dus hebben we CoreBox ontwikkeld — een oplossing ontworpen vanuit het perspectief van de gebruiker.
Met CoreBox krijg je:
- Een snelle en betrouwbare installatie-ervaring
- Geen vertragingen of mislukte installaties meer door netwerkproblemen
- Vertrouwen dat je Home Assistant soepel draait — altijd en overal
Kan ik de ingebouwde HA Core bijwerken?
Ja! Zodra HA opstart met de ingebouwde versie (2025.5.3), detecteert Home Assistant of er een nieuwere versie beschikbaar is. Je kunt HA Core bijwerken zoals gewoonlijk via Instellingen > Systeem > Updates — net als bij een normale installatie.
9. Ondersteunde Add-ons
-
Nu beschikbaar:
-
iHost Hardware Control Add-on
Bedien fysieke knoppen, RGB-indicatoren en lichtstrips direct vanuit Home Assistant.
Koppel hardware-ingangen aan automatiseringen voor naadloze interactie tussen fysieke en virtuele omgevingen.
Je kunt hier klikken voor de tutorial. -
MG21 Flashing Add-on : Upgrade de MG21-firmware, met optionele ondersteuning voor het flashen van Zigbee- of Thread-stacks.
Je kunt hier klikken voor de tutorial. -
Node-Red : Deze add-on is een zelfstandige verpakte versie van Node-RED, exclusief ontworpen om de linux/arm/v7 architectuur te ondersteunen. Het is verpakt door SONOFF, speciaal afgestemd op iHost-gebruikers.
Je kunt hier klikken voor de tutorial. -
Matter Bridge Add-on : Verbind lokale apparaten met het Matter-ecosysteem voor cross-platform integratie.
Je kunt hier klikken voor de tutorial.
-
10. Erkenning
Dit project is een afgeleide ontwikkeling gebaseerd op Darkxst’s [ha-operating-system] project van GitHub. We waarderen de oorspronkelijke auteur oprecht voor zijn fundamentele bijdragen.
3 reacties
Bertrand
Good project
Mia Ma
回复鄭先生: 会在，HAOS是装在新的SD卡上，不会影响原本的CUBE系统。
鄭先生
請問已安裝CUBE使用一段時間，後來安裝HAOS使用一陣子不習慣
如果切換回CUBE，原本的CUBE資料還會在嗎?
HAOS資料還回在嗎?
想切回CUBE試試看哪個適合我使用，但擔心要重新設定很麻煩很困擾
Laat een reactie achter
Alle reacties worden gemodereerd voordat ze worden gepubliceerd.
Deze site wordt beschermd door hCaptcha en het privacybeleid en de servicevoorwaarden van hCaptcha zijn van toepassing.