Product Guides

Come eseguire Home Assistant su SONOFF iHost

How to Run Home Assistant over SONOFF iHost

1. Introduzione

Siamo entusiasti di annunciare che HA over iHost è ora ufficialmente disponibile! Questo progetto porta il completo Sistema Operativo Home Assistant su SONOFF iHost piattaforma, offrendo agli utenti un nuovo modo potente per eseguire Home Assistant localmente sull'hardware iHost.

Nato da reali esigenze della comunità e dall'esplorazione tecnica guidata dagli utenti, questa iniziativa riflette la creatività e la passione delle comunità di utenti Home Assistant e SONOFF. Molti utenti iHost hanno già eseguito Home Assistant Core in Docker sul sistema nativo per sfruttare il suo hardware. Alcuni utenti avanzati sono andati oltre, modificando e compilando le proprie build per eseguire il sistema operativo completo di Home Assistant nativamente su iHost.

In questa guida ti mostrerò come eseguire facilmente Home Assistant sul tuo SONOFF iHost. Ti guideremo attraverso due metodi di scrittura: usando Balena Etcher o Raspberry Pi Imager. Iniziamo!


Guarda il tutorial video dettagliato qui:

2. Prerequisiti

  • È richiesto un SONOFF iHost.
  • Assicurati dir iHost la versione del sistema è 2.5.1 o successiva.
  • Una Classe applicazione 2 (A2) con capacità minima di 32GB è consigliata per migliori prestazioni, specialmente nelle operazioni di lettura e scrittura.
  • Poiché iHost si basa su un processore a 32 bit, alcune funzionalità di Home Assistant potrebbero non essere compatibili.

3. Preparazione della scheda Micro SD

Hardware richiesto

  • Si consiglia una scheda (Application Class 2) (A2) con capacità minima di 32GB per migliori prestazioni, specialmente nelle operazioni di lettura e scrittura di piccole dimensioni. Suggeriamo di usare una scheda TF di SanDisk, Kingston o Samsung. Internamente abbiamo testato queste marche.
  • Un lettore di schede SD: qualsiasi lettore USB standard funzionerà se il tuo portatile non ha un lettore SD integrato.

Software richiesto

4. Scrittura dell'immagine HA Over iHost sulla scheda Micro SD

  • Scrivi con Balena Etcher

  1. Inserisci la scheda Micro SD nel lettore di schede e collegalo al tuo computer.
  2. Scarica e avvia Etcher.
  1. Clicca Scrivi da file, quindi seleziona ile HA over iHost immagine file scaricato sul tuo computer.

2. Clicca Seleziona destinazione, quindi scegli la scheda Micro SD che hai inserito.
*Nota: Assicurati di selezionare l'unità corretta!

3. Clicca Scrivi! per iniziare la scrittura the HA over iHost immagine sulla scheda Micro SD.
*Nota: Non rimuovere né utilizzare la scheda SD durante il processo di scrittura.

  • Scrivi con Raspberry Pi Imager

  1. Inserisci la scheda SD nel lettore di schede e collegalo al tuo computer.
  2. Scarica e avvia Raspberry Pi Imager.
  1. Clicca SELEZIONA DISPOSITIVO > Nessun filtro.
  1. Clicca SELEZIONA SISTEMA OPERATIVO > Usa personalizzato, quindi seleziona il file immagine HA over iHost scaricato sul tuo computer.
  1. Clicca SELEZIONA MEMORIA, quindi scegli la scheda Micro SD che hai inserito.
    *Nota: Assicurati di selezionare la scheda Micro SD corretta!
  1. Clicca AVANTI > NO, CANCELLA IMPOSTAZIONI, e conferma di cancellare tutte le impostazioni sulla scheda SD.
  1. Inizia a flashare l'immagine HA su iHost sulla scheda SD inserita.
    *Nota: Non interagire con la scheda SD (ad esempio, scollegarla o modificare i file) durante il processo di flashing.

5. Avvio Sistema operativo Home Assistant su iHost

Migrare dispositivi Zigbee (Opzionale)

Se la migrazione dei dispositivi Zigbee non è necessaria, passa alla sezione successiva.

iHost ti permette di esportare e migrare i dati dei dispositivi Zigbee di iHost su Home Assistant scaricando il file di backup disponibile tPer ripristinare in Home Assistant integrato con ZHA/Zigbee2MQTT. Vengono migrati solo la rete Zigbee e lo stato dei dispositivi. Timer, gruppi, scene e nomi dei dispositivi non sono inclusi. Clicca qui per imparare: Come ripristinare?

StivaleSistema operativo Home Assistant in esecuzione su iHost

  1. Inserisci la scheda Micro SD pre-flashata nello slot SD di iHost.
  2. Collega iHost a un cavo di rete e accendilo.
  3. Entro 5 secondi dall'accensione, premi ripetutamente il pulsante Muto (♪) sulla parte superiore di iHost finché la Striscia LED laterale non entra in uno schema di luce respirante BLU . Questo indica che il sistema sta passando al sistema operativo Home Assistant flashato sulla scheda SD.
  1. Se l'indicatore LED mostra un BLU schema di luce respirante, puoi accedere alla nuova interfaccia web di Home Assistant entro i prossimi 10 minuti. Il primo avvio potrebbe richiedere più tempo.
    Su un browser desktop, inserisci homeassistant.local:8123.

*Nota: Se stai usando una versione più vecchia di Windows o hai configurazioni di rete più restrittive, potresti dover accedere a Home Assistant usando uno dei seguenti URL:
http://homeassistant:8123 o http://X.X.X.X:8123 (sostituisci X.X.X.X con l'indirizzo IP del tuo Raspberry Pi)

Risoluzione dei problemi di avvio fallito

  • Se illa striscia LED laterale non fanon mostra un BLU schema di luce respirantern ma un ROSSO schema di luce respirante dopodopo aver acceso per 5 secondi o dopo aver premuto il pulsante più volte, l'avvio è fallito. Prova a riavviare ilil Sistema operativo Home Assistant come seguews:
  1. Riavvia iHost;
  2. Non è necessario premere alcun pulsante.
  3. iHost tenta di avviarenon Sistema operativo Home Assistant dadalla scheda SD.

 

  • Se non riesci ad accedere all'interfaccia web di Home Assistant entro 10 minuti dopo le operazioni sopra, potrebbe essere dovuto a un'immagine flashata in modo errato. Prova a riflashare la scheda SD o a usarne una nuova.
  • Per tornare aa eWeLink CUBE, fSegui questi passaggi:
    1. Riavvia iHost.
    2. Premere ripetutamente una volta il pulsante muto (♪) entro 3 secondi.
    3. Il LED Striscia laterale wpasserà a un ROSSO schema di luce fluente, confermando che il sistema è tornato a eWeLink CUBE.

*Note:

  • Se più dispositivi sono in funzioneng Sistema operativo Home Assistant in esecuzione su la tua rete, il nome host [homeassistant.local] potrebbe non risolversi correttamente. Puoi scoprire l'indirizzo IP corretto tramite l'interfaccia di gestione del router o trasmettendo il servizio mDNS [_home-assistant._tcp.].
  • Se l'ultimo avvio è stato dalla scheda SD, e la scheda viene rimossa senza tornare a eWeLink CUBE, ilLa striscia LED laterale mostrare un ROSSO schema di luce pulsante, indica che Home Assistant Operating System non è riuscito ad avviarsi su iHost.

7. Risorse hardware

Accesoce Home Assistant Operating System è succSe i sistemi sono in esecuzione correttamente su iHost, puoi utilizzare i seguenti hardware integrati supportati:

Pulsante & indicatore LED

L'add-on Controllo Hardware iHost consente di controllare i pulsanti e gli indicatori LED di iHost in Home Assistant. Li registra come dispositivi ed entità separate, permettendo agli utenti di usarli nelle automazioni per interazioni hardware più flessibili.(ad esempio, attivare l'entità del pulsante di accensione per spegnere iHost). Per dettagli, fare riferimento a Add-on Controllo Hardware iHost guida.

 

Bluetooth

  • Modello chipset: RTL8723DS
  • Percorso: Impostazioni > Dispositivi & Servizi > Integrazioni > Bluetooth
  • Rilevamento: Automatico

Wi-Fi

  • Modello chipset: RTL8723DS
  • Percorso: Impostazioni > Sistema > Rete > Configura interfacce di rete > WLAN0
  • Rilevamento: Automatico

Coordinatore Zigbee

  • Modello chipset: 00.21.05.0009 SOC EFR32MG21A020F768IM32-B SiliconLabs QFN32-4*4 (RAM 64kB, Flash 768kB)
  • Percorso: Impostazioni > Sistema > Hardware > Tutto l'hardware > /dev/ttyS4
  • Rilevamento: Via Zigbee Home Automation (ZHA) o Zigbee2MQTT

7. Informazioni sull'immagine CoreBox

CoreBox è una nuova immagine HA su iHost progettata per una configurazione rapida, con l'ultima versione di HA Core (2025.05.03) pre-integrata.

Con CoreBox, non devi più aspettare durante l'installazione iniziale che il dispositivo scarichi HA Core da GitHub. Puoi invece avviare direttamente dalla versione integrata di HA Core, raggiungendo l'avvio in 3 minuti o anche meno. CoreBox elimina la dipendenza dalla connettività internet, permettendo una configurazione facile anche in ambienti offline. Puoi comunque aggiornare a versioni più recenti di HA Core direttamente dal sistema una volta avviato.

Perché CoreBox?

Abbiamo ascoltato attentamente i vostri feedback. Molti utenti hanno segnalato che il processo di installazione originale di HA su iHost spesso falliva a causa di una connessione internet scarsa o instabile, specialmente durante il download iniziale di HA Core. Questo non solo causava frustrazione, ma scoraggiava molti utenti alle prime armi dal proseguire.

Anche con il nostro supporto online, risolvere problemi di rete e seguire il processo di installazione spesso richiedeva più tempo del previsto — sia per gli utenti che per il nostro team.

Abbiamo quindi creato CoreBox — una soluzione progettata dal punto di vista dell'utente.

Con CoreBox, ottieni:

  • Un'esperienza di configurazione rapida e affidabile
  • Niente più ritardi o installazioni fallite a causa di problemi di rete
  • La certezza che il tuo Home Assistant funzioni senza problemi — in qualsiasi momento e ovunque

Posso aggiornare il Core HA integrato?

Sì! Una volta che HA si avvia con la versione integrata (2025.5.3), Home Assistant rileverà se è disponibile una versione più recente. Puoi aggiornare il Core di HA come al solito dalla pagina Impostazioni > Sistema > Aggiornamenti — proprio come in un'installazione normale.

9. Add-on supportati

  • Ora disponibile:
    1. Add-on iHost Hardware Control
      Controlla direttamente da Home Assistant i pulsanti fisici, gli indicatori RGB e le strisce luminose.
      Mappa gli ingressi hardware alle automazioni per un'interazione fluida tra ambienti fisici e virtuali.
      Puoi cliccare qui per il tutorial.

    2. MG21 Flashing Add-on : Aggiorna il firmware MG21, con supporto opzionale per il flashing degli stack Zigbee o Thread.
      Puoi cliccare qui per il tutorial.

    3. Node-Red : Questo add-on è una versione autonoma e pacchettizzata di Node-RED, progettata esclusivamente per supportare l'architettura linux/arm/v7. È stato confezionato da SONOFF, specificamente pensato per gli utenti iHost.
      Puoi cliccare qui per il tutorial.

    4. Matter Bridge Add-on : Collega i dispositivi locali all'ecosistema Matter per un'integrazione multipiattaforma.
      Puoi cliccare qui per il tutorial.

10. Riconoscimenti

Questo progetto è uno sviluppo derivato basato su Darkxst’s [ha-operating-system] progetto da GitHub. Ringraziamo sinceramente l'autore originale per i suoi contributi fondamentali.

Scopri di più

Defining Button & Light Feature in iHost Hardware Control Add-on
Explore NSPanel Pro V3.0.0 NEW UI: RUBIK

3 commenti

Bertrand

Bertrand

Good project

Mia Ma

Mia Ma

回复鄭先生: 会在,HAOS是装在新的SD卡上,不会影响原本的CUBE系统。

鄭先生

鄭先生

請問已安裝CUBE使用一段時間,後來安裝HAOS使用一陣子不習慣
如果切換回CUBE,原本的CUBE資料還會在嗎?
HAOS資料還回在嗎?
想切回CUBE試試看哪個適合我使用,但擔心要重新設定很麻煩很困擾

Commenta

Nota che i commenti devono essere approvati prima di essere pubblicati.

Questo sito è protetto da hCaptcha e applica le Norme sulla privacy e i Termini di servizio di hCaptcha.