1. Wprowadzenie
Z radością ogłaszamy, że HA over iHost jest już oficjalnie dostępny! Ten projekt wprowadza pełny system operacyjny Home Assistant na SONOFF iHost platformę, oferując użytkownikom nowy, wydajny sposób lokalnego uruchamiania Home Assistant na sprzęcie iHost.
To przedsięwzięcie, zrodzone z rzeczywistych potrzeb społeczności i kierowanej przez użytkowników eksploracji technicznej, odzwierciedla kreatywność i pasję społeczności użytkowników Home Assistant i SONOFF. Wielu użytkowników iHost uruchamiało już Home Assistant Core w Dockerze w natywnym systemie, aby wykorzystać jego sprzęt. Niektórzy zaawansowani użytkownicy poszli jeszcze dalej — modyfikowali i kompilowali własne kompilacje, aby natywnie uruchamiać pełny system Home Assistant OS na iHost.
W tym przewodniku pokażę, jak łatwo uruchomić Home Assistant na urządzeniu SONOFF iHost. Omówimy dwie metody zapisu: z użyciem Balena Etcher lub Raspberry Pi Imager. Zaczynajmy!
Obejrzyj szczegółowy samouczek wideo tutaj:
2. Wymagania wstępne
- Wymagany jest SONOFF iHost.
- Upewnij się, żer iHost wersja systemu to 2.5.1 lub nowsza.
- Karta Application Class 2 karta (A2) o pojemności co najmniej 32 GB jest zalecana dla lepszej wydajności, szczególnie podczas małych operacji odczytu i zapisu.
- Ponieważ iHost jest oparty na procesorze 32-bitowym, niektóre funkcje Home Assistant mogą nie być kompatybilne.
3. Przygotowanie karty Micro SD
Wymagany sprzęt
- W celu uzyskania lepszej wydajności, szczególnie podczas małych operacji odczytu i zapisu, zalecana jest karta (Application Class 2) (A2) o pojemności co najmniej 32 GB. Zalecamy użycie karty TF firmy SanDisk, Kingston lub Samsung. Wewnętrznie używaliśmy tych kart tych marek do testów.
- Czytnik kart SD: jeśli laptop nie ma wbudowanego czytnika kart SD, wystarczy dowolny standardowy czytnik USB.
Wymagane oprogramowanie
- Narzędzie do zapisu na kartę Micro SD: Balena Etcher lub Raspberry Pi Imageritp.
- Odwiedź projekt na GitHubie, aby pobrać odpowiedni obraz HA over iHost: iHost-Open-Source-Project.
4. Zapisywanie obrazu HA over iHost na karcie Micro SD
-
Zapisz za pomocą Balena Etcher
- Włóż kartę Micro SD do czytnika kart i podłącz go do komputera.
- Pobierz i uruchom Etcher.
- Kliknij Zapisz z pliku, a następnie wybierze HA over iHost obraz plik pobrany na komputer.
2. Kliknij Wybierz miejsce docelowe, a następnie wybierz włożoną kartę Micro SD.
*Uwaga: Upewnij się, że wybrano właściwy dysk!
3. Kliknij Zapisz! , aby rozpocząć zapise HA over iHost obraz na karcie Micro SD.
*Uwaga: Nie wyjmuj karty SD ani nie korzystaj z niej podczas procesu zapisu.
-
Zapisz za pomocą Raspberry Pi Imager
- Włóż kartę SD do czytnika kart i podłącz go do komputera.
- Pobierz i uruchom Raspberry Pi Imager.
- Kliknij WYBIERZ URZĄDZENIE > Bez filtrowania.
- Kliknij WYBIERZ SYSTEM > Użyj niestandardowego, a następnie wybierz pobrany na komputer plik obrazu HA over iHost.
-
Kliknij WYBIERZ PAMIĘĆ, a następnie wybierz włożoną kartę Micro SD.
*Uwaga: Upewnij się, że wybrano właściwą kartę Micro SD!
- Kliknij DALEJ > NIE, WYCZYŚĆ USTAWIENIA, a następnie potwierdź usunięcie wszystkich ustawień z karty SD.
-
Rozpocznij zapisywanie obrazu HA over iHost na włożonej karcie SD.
*Uwaga: Nie używaj karty SD (np. nie odłączaj jej ani nie modyfikuj plików) podczas procesu zapisywania obrazu.
5. Uruchamianie System operacyjny Home Assistant na iHost
Migracja urządzeń Zigbee (opcjonalnie)
Jeśli migracja urządzeń Zigbee nie jest potrzebna, przejdź do następnej sekcji.
iHost umożliwia eksportowanie i migrowanie danych urządzeń Zigbee z iHosta do Home Assistant przez pobranie pliku kopii zapasowej dostępnego to przywracaniu w Home Assistant zintegrowanym z ZHA/Zigbee2MQTT. Migrowana jest tylko sieć Zigbee i stan urządzeń. Timery, grupy, sceny i nazwy urządzeń nie są uwzględniane.
Kliknij tutaj, aby dowiedzieć się: Jak przywrócić?
Uruchamianieanie systemu operacyjnego Home Assistant na iHost
- Włóż fabrycznie zaprogramowaną kartę Micro SD do gniazda kart SD iHosta.
- Podłącz iHost do kabla sieciowego i włącz go.
- W ciągu 5 sekund od włączenia zasilania wielokrotnie naciskaj przycisk wyciszania (♪) na górze iHosta, aż boczny pasek LED zacznie wyświetlać NIEBIESKI wzór pulsującego światła. Oznacza to, że system przełącza się na system operacyjny Home Assistant zapisany na karcie SD.
*Uwaga: Przycisk zasilania jest pierwszym przyciskiem od góry, a przycisk wyciszania (♪) jest trzecim przyciskiem od góry (licząc w dół). W celach poglądowych zobacz ilustrację poniżej.
- Jeśli wskaźnik LED pokazuje a NIEBIESKI wzór pulsującego światła, możesz uzyskać dostęp do nowego interfejsu internetowego Home Assistant w ciągu kolejnych 10 minut. Pierwsze uruchomienie może potrwać dłużej.
W przeglądarce na komputerze wpisz homeassistant.local:8123.
*Uwaga:
- Od Home Assistant 2026.8 nowe instalacje systemu operacyjnego Home Assistant nie wymagają już :8123 w adresie URL. Jeśli używasz istniejącej instalacji, obecny port pozostaje bez zmian i nadal może być konieczne użycie homeassistant.local:8123
- Jeśli używasz starszej wersji systemu Windows lub masz bardziej restrykcyjną konfigurację sieci, może być konieczne uzyskanie dostępu do Home Assistant za pomocą jednego z następujących adresów URL: http://homeassistant:8123 lub http://X.X.X.X:8123 (zastąp X.X.X.X adresem IP swojego Raspberry Pi)
Rozwiązywanie problemów z nieudanym uruchamianiem
- Jeśli thPasek boczny LED nie doenie wyświetla a NIEBIESKI wzór pulsującego światłarn, ale a CZERWONA wzór pulsującego światła popo włączeniu zasilania przez 5 sekund lub po wielokrotnym naciśnięciu przycisku uruchamianie nie powiodło się. Spróbuj ponownie uruchomić thSystem operacyjny Home Assistant w następujący sposóbws:
- Wyłącz i włącz zasilanie iHosta;
- Nie trzeba naciskać żadnego przycisku.
- iHost ponawia próby uruchomieniaSystem operacyjny Home Assistant frz karty SD.
- If you cannot access Home Assistant web interface within 10 minutes after the operations above, it may be due to an incorrectly flashed image. Try re-flashing the SD card or using a new one.
Jeśli po wykonaniu powyższych czynności nie możesz uzyskać dostępu do interfejsu internetowego Home Assistant w ciągu 10 minut, przyczyną może być nieprawidłowo wgrany obraz. Spróbuj ponownie nagrać kartę SD lub użyć nowej.6. Przełączanie z powrotem
- o eWeLink CUBEAby przełączyć z powrotem no eWeLink CUBE, p
- stępuj zgodnie z poniższymi krokami:
- Wyłącz i ponownie włącz iHost.
- Naciśnij jednokrotnie przycisk wyciszenia (♪) kilka razy w ciągu 3 sekund. Pasek boczny LEDPasek boczny LED prze CZERWONA wzór przesuwającego się światła, potwierdzający przełączenie systemu z powrotem na eWeLink CUBE.
*Uwagi:
- Jeśli naący Home Assistant Operating System w Twojej sieci nazwa hosta [homeassistant.local] może nie być poprawnie rozpoznawana. Prawidłowy adres IP możesz znaleźć w interfejsie zarządzania routerem lub za pomocą rozgłaszania usługi mDNS [_home-assistant._tcp.].
- Jeśli ostatnie uruchomienie nastąpiło z karty SD, a karta została wyjęta bez przełączenia z powrotem na eWeLink CUBE, tPasek boczny LED wyświetla CZERWONA wzór pulsującego światła, wskazujący, że system operacyjny Home Assistant nie uruchomił się na iHost.
7. Zasoby sprzętowe
Once Home Assistant Operating System is succesfully running on iHost, you can use the following supported onboard hardwares:
Przycisk i wskaźnik LED
Dodatek iHost Hardware Control umożliwia sterowanie przyciskami i wskaźnikami LED urządzenia iHost w Home Assistant. Rejestruje je jako urządzenia i oddzielne encje, dzięki czemu można ich używać w automatyzacjach, zapewniając większą elastyczność interakcji ze sprzętem(np. uruchamiając encję przycisku zasilania w celu wyłączenia iHost). Szczegółowe informacje znajdziesz w Dodatek iHost Hardware Control przewodnikiem.
Bluetooth
- Model chipsetu: RTL8723DS
- Ścieżka: Ustawienia > Urządzenia i usługi > Integracje > Bluetooth
- Wykrywanie: Automatyczny
Wi-Fi
- Model chipsetu: RTL8723DS
- Ścieżka: Ustawienia > System > Sieć > Konfiguruj interfejsy sieciowe > WLAN0
- Wykrywanie: Automatyczny
Zigbee CoKoordynator
- Model chipsetu: 00.21.05.0009 SOC EFR32MG21A020F768IM32-B SiliconLabs QFN32-4*4 （RAM 64kB,Flash 768kB）
- Ścieżka: Ustawienia > System > Sprzęt > Cały sprzęt > /dev/ttyS4
- Wykrywanie: Za pośrednictwem Zigbee Home Automation (ZHA) lub Zigbee2MQTT
8. Informacje o obrazie CoreBox
CoreBox to nowy obraz HA na iHost, zaprojektowany z myślą o szybkiej konfiguracji, zawierający wstępnie zintegrowaną najnowszą wersję HA Core (2025.05.03).
Dzięki CoreBox nie musisz już czekać podczas początkowej instalacji, aż urządzenie pobierze HA Core z GitHub. Zamiast tego możesz bezpośrednio uruchomić wbudowaną wersję HA Core, uzyskując start w ciągu 3 minut lub nawet szybciej. CoreBox eliminuje zależność od połączenia z internetem, umożliwiając łatwą konfigurację nawet w środowiskach offline. Po uruchomieniu systemu nadal możesz zaktualizować HA Core do nowszej wersji.
Dlaczego CoreBox?
Uważnie wsłuchiwaliśmy się w Wasze opinie. Wielu użytkowników zgłaszało, że pierwotny proces instalacji HA na iHost często kończył się niepowodzeniem z powodu słabego lub niestabilnego połączenia z internetem, szczególnie podczas początkowego pobierania HA Core. Powodowało to frustrację i zniechęcało wielu nowych użytkowników do dalszego korzystania z systemu.
Nawet przy naszym wsparciu online rozwiązywanie problemów z siecią i przeprowadzanie użytkowników przez proces instalacji często zajmowało więcej czasu, niż oczekiwaliśmy — zarówno użytkownikom, jak i naszemu zespołowi.
Dlatego stworzyliśmy CoreBox — rozwiązanie zaprojektowane z perspektywy użytkownika.
Z CoreBox otrzymujesz:
- Szybka i niezawodna konfiguracja
- Koniec z opóźnieniami i nieudanymi instalacjami spowodowanymi problemami z siecią
- Pewność, że Home Assistant będzie działać płynnie — zawsze i wszędzie
Czy mogę zaktualizować wbudowany HA Core?
Tak! Gdy HA uruchomi się z wbudowaną wersją (2025.5.3), Home Assistant wykryje, czy dostępna jest nowsza wersja. Możesz zaktualizować HA Core jak zwykle na stronie Ustawienia > System > Aktualizacje — tak jak w przypadku standardowej instalacji.
9. Obsługiwane dodatki
-
Już dostępne:
-
Dodatek iHost do sterowania sprzętem
Steruj fizycznymi przyciskami, wskaźnikami RGB i taśmami świetlnymi bezpośrednio z Home Assistant.
Mapuj wejścia sprzętowe na automatyzacje, aby zapewnić płynną interakcję między środowiskiem fizycznym i wirtualnym.
Możesz kliknąć tutaj , aby wyświetlić instrukcję. -
Dodatek do flashowania MG21 : Aktualizuje oprogramowanie układowe MG21 i opcjonalnie umożliwia flashowanie stosu Zigbee lub Thread.
Możesz kliknąć tutaj , aby wyświetlić instrukcję. -
Node-RED : Ten dodatek to samodzielna, spakowana wersja Node-RED, przeznaczona wyłącznie do obsługi architektury linux/arm/v7. Został spakowany przez SONOFF specjalnie dla użytkowników iHost.
Możesz kliknąć tutaj , aby wyświetlić instrukcję. -
Dodatek Matter Bridge : Łączy lokalne urządzenia z ekosystemem Matter, umożliwiając integrację międzyplatformową.
Możesz kliknąć tutaj , aby wyświetlić instrukcję.
-
10. Podziękowania
Ten projekt jest rozwinięciem bazującym na projekcie Darkxst [ha-operating-system] projekt z GitHub. Serdecznie doceniamy oryginalnego autora za jego fundamentalny wkład.
3 komentarze
Bertrand
Good project
Mia Ma
回复鄭先生: 会在，HAOS是装在新的SD卡上，不会影响原本的CUBE系统。
鄭先生
請問已安裝CUBE使用一段時間，後來安裝HAOS使用一陣子不習慣
如果切換回CUBE，原本的CUBE資料還會在嗎?
HAOS資料還回在嗎?
想切回CUBE試試看哪個適合我使用，但擔心要重新設定很麻煩很困擾
Zostaw komentarz
Wszystkie komentarze są moderowane przed opublikowaniem.
Ta strona jest chroniona przez hCaptcha i obowiązują na niej Polityka prywatności i Warunki korzystania z usługi serwisu hCaptcha.