1. Introdução
Temos o prazer de anunciar que o HA over iHost está agora oficialmente disponível! Este projeto traz o Sistema Operativo Home Assistant para aSONOFF iHost plataforma, oferecendo aos utilizadores uma nova e poderosa forma de executar o Home Assistant localmente no hardware iHost.
Nascida de necessidades reais da comunidade e da exploração técnica impulsionada pelos utilizadores, esta iniciativa reflete a criatividade e a paixão das comunidades de utilizadores do Home Assistant e da SONOFF. Muitos utilizadores do iHost já executam o Home Assistant Core no Docker no sistema nativo, aproveitando o respetivo hardware. Alguns utilizadores avançados foram ainda mais longe — modificaram e compilaram as suas próprias versões para executar o Home Assistant OS completo de forma nativa no iHost.
Neste guia, mostrarei como executar facilmente o Home Assistant no seu SONOFF iHost. Iremos abordar dois métodos de gravação: utilizando o Balena Etcher ou Raspberry Pi Imager. Vamos começar!
Veja aqui o tutorial em vídeo detalhado:
2. Pré-requisitos
- É necessário um SONOFF iHost.
- Certifique-se de quedo iHost a versão do sistema é 2.5.1 ou posterior.
- Um Classe de Aplicação 2 recomenda-se um cartão (A2), com uma capacidade mínima de 32 GB, para obter um melhor desempenho, especialmente em pequenas operações de leitura e escrita.
- Como o iHost se baseia num processador de 32 bits, algumas funcionalidades do Home Assistant poderão não ser compatíveis.
3. Preparar o cartão Micro SD
Hardware necessário
- Recomenda-se um cartão (Classe de Aplicação 2) (A2), com uma capacidade mínima de 32 GB, para obter um melhor desempenho, especialmente em pequenas operações de leitura e escrita. Sugerimos a utilização de um cartão TF da SanDisk, Kingston ou Samsung. Temos utilizado internamente cartões destas marcas para testes.
- Um leitor de cartões SD: qualquer leitor de cartões USB padrão funcionará se o seu computador portátil não tiver um leitor de cartões SD integrado.
Software necessário
- Ferramenta de gravação de cartões Micro SD: Balena Etcher ou Raspberry Pi Imager, etc.
- Visite o projeto no GitHub para obter a imagem correspondente do HA over iHost: iHost-Open-Source-Project.
4. Gravar a imagem HA over iHost no cartão Micro SD
-
Gravar com Balena Etcher
- Insira o cartão Micro SD no leitor de cartões e ligue-o ao computador.
- Transfira e execute o Etcher.
- Clique em Gravar a partir do ficheiroe, em seguida, selecione oe HA over iHost imagem ficheiro transferido para o seu computador.
2. Clique em Selecionar destinoe, em seguida, escolha o cartão Micro SD que inseriu.
*Nota: certifique-se de que seleciona a unidade correta!
3. Clique em Gravar! para começar a gravar oe HA over iHost imagem no cartão Micro SD.
*Nota: não remova nem utilize o cartão SD durante o processo de gravação.
-
Gravar com Raspberry Pi Imager
- Insira o cartão SD no leitor de cartões e ligue-o ao computador.
- Transfira e execute o Raspberry Pi Imager.
- Clique em ESCOLHER DISPOSITIVO > Sem filtragem.
- Clique em ESCOLHER SO > Utilizar personalizadoe, em seguida, selecione o ficheiro de imagem HA over iHost transferido para o seu computador.
-
Clique em ESCOLHER ARMAZENAMENTOe, em seguida, escolha o cartão Micro SD que inseriu.
*Nota: certifique-se de que seleciona o cartão Micro SD correto!
- Clique em SEGUINTE > NÃO, LIMPAR DEFINIÇÕES, e confirme para apagar todas as definições do cartão SD.
-
Comece a gravar a imagem do HA over iHost no cartão SD inserido.
*Nota: Não interaja com o cartão SD (por exemplo, desligando-o ou modificando ficheiros) durante o processo de gravação.
5. Arranque Home Assistant Operating System no iHost
Migrar dispositivos Zigbee (opcional)
Se a migração dos dispositivos Zigbee não for necessária, avance para a secção seguinte.
O iHost permite exportar e migrar os dados dos dispositivos Zigbee do iHost para o Home Assistant, descarregando o ficheiro de cópia de segurança disponível epara restaurar no Home Assistant integrado com ZHA/Zigbee2MQTT. Apenas a rede Zigbee e o estado dos dispositivos são migrados. Os temporizadores, grupos, cenas e nomes dos dispositivos não são incluídos.
Clique aqui para saber: Como restaurar?
Arranquo Home Assistant Operating System no iHost
- Insira o cartão Micro SD previamente gravado na ranhura para cartões SD do iHost.
- Ligue o iHost a um cabo de rede e ligue-o.
- Nos 5 segundos após ligar o dispositivo, prima repetidamente o botão Silenciar (♪) na parte superior do iHost até que a faixa lateral de LED apresente um padrão de luz pulsante AZUL . Isto indica que o sistema está a mudar para o Home Assistant OS gravado no cartão SD.
*Tenha em atenção: O botão de alimentação é o primeiro botão a contar de cima e o botão Silenciar (♪) é o terceiro botão a contar de cima (de cima para baixo). Para referência visual, consulte a imagem abaixo.
- Se o indicador LED apresentar um AZUL um padrão de luz pulsante, poderá aceder à nova interface Web do Home Assistant nos 10 minutos seguintes. O primeiro arranque poderá demorar mais tempo.
Num navegador de computador, introduza homeassistant.local:8123.
*Nota:
- A partir do Home Assistant 2026.8, as novas instalações do Home Assistant OS já não necessitam de :8123 no URL. Se estiver a utilizar uma instalação existente, a sua porta atual permanece inalterada e poderá continuar a ter de utilizar homeassistant.local:8123
- Se estiver a utilizar uma versão mais antiga do Windows ou configurações de rede mais restritivas, poderá ter de aceder ao Home Assistant através de um dos seguintes URLs: http://homeassistant:8123 ou http://X.X.X.X:8123 (substitua X.X.X.X pelo endereço IP do seu Raspberry Pi)
Resolução de problemas de falhas de arranque
- SeA faixa lateral de LED não apresentnão apresenta um AZUL padrão de luz pulsantrna, mas um apresentará um padrão de luz pulsante depoapós ligar o dispositivo durante 5 segundos ou depois de premir o botão várias vezes, o arranque falhou. Tente reiniciaro Home Assistant Operating System da seguinte forms:
- Desligue e volte a ligar o iHost;
- Não é necessário premir nenhum botão.
- o iHost tenta arrancar novdo Home Assistant Operating System pado cartão 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.
6. Switching Back tSe não conseguir aceder à interface Web do Home Assistant no prazo de 10 minutos após as operações acima, tal poderá dever-se a uma imagem gravada incorretamente. Tente voltar a gravar o cartão SD ou utilizar um cartão novo.
- 6. Voltar a mudar parao eWeLink CUBEPara voltar d
- ao eWeLink CUBE, s
- iga estes passos:
- Desligue e volte a ligar o iHost. Prima repetidamente e uma vez o botão de silenciamento (♪) no espaço de 3 segundos.A faixa lateral LED apresentará mudará para um
padrão de luz em movimento, confirmando que o sistema voltou a mudar para o eWeLink CUBE.
- *Notas:Se houver vários dispositivos a executar o Home Assistant Operating System
- na sua rede, o nome do anfitrião [homeassistant.local] poderá não ser resolvido corretamente. Pode descobrir o endereço IP correto através da interface de gestão do router ou transmitindo o serviço mDNS [_home-assistant._tcp.].Se a última inicialização tiver sido feita a partir do cartão SD e o cartão for removido sem voltar a mudar para o eWeLink CUBE, o a faixa lateral LED apresentará VERMELHO um padrão de luz intermitente,
indicando que o Home Assistant Operating System não conseguiu arrancar no iHost.
7. Recursos de hardwareHome Assistant Operating System está a fundo
o Home Assistant Operating System estiver a funcionar corretamente no iHost, pode utilizar o seguinte hardware integrado suportado:
Botão e indicador LEDO complemento iHost Hardware Control permite controlar os botões e os indicadores LED do iHost no Home Assistant. Regista-os como dispositivos e entidades separadas, permitindo aos utilizadores utilizá-los em automatizações para interações de hardware mais flexíveis(por exemplo, acionar a entidade do botão de alimentação para desligar o iHost) . Para obter mais informações, consulte o complemento iHost Hardware Control
guia.
- Modelo do chipset: Wi-Fi
- Caminho: Bluetooth
- Deteção: Definições > Sistema > Rede > Configurar interfaces de rede > WLAN0
Definições > Dispositivos e serviços > Integrações > Bluetooth
- Modelo do chipset: Wi-Fi
- Caminho: RTL8723DS
- Deteção: Definições > Sistema > Rede > Configurar interfaces de rede > WLAN0
Automático ZigbeeCoordenador
- Modelo do chipset: 00.21.05.0009 SOC EFR32MG21A020F768IM32-B SiliconLabs QFN32-4*4 （RAM 64kB,Flash 768kB）
- Caminho: Definições > Sistema > Hardware > Todo o hardware > /dev/ttyS4
- Deteção: Através do Zigbee Home Automation (ZHA) ou do Zigbee2MQTT
8. Sobre a imagem CoreBox
O CoreBox é uma nova imagem do HA no iHost concebida para uma configuração rápida, com a versão mais recente do HA Core (2025.05.03) pré-integrada.
Com o CoreBox, já não precisa de esperar durante a instalação inicial que o dispositivo transfira o HA Core do GitHub. Em vez disso, pode arrancar diretamente a partir da versão do HA Core integrada, iniciando o sistema em 3 minutos ou até mais rapidamente. O CoreBox elimina a dependência da ligação à Internet, permitindo uma configuração fácil mesmo em ambientes offline. Depois de o sistema estar a funcionar, pode continuar a atualizá-lo para versões mais recentes do HA Core.
Porquê o CoreBox?
Temos acompanhado atentamente o vosso feedback. Muitos utilizadores relataram que o processo de instalação original do HA no iHost falhava frequentemente devido a uma ligação à Internet fraca ou instável, especialmente durante a transferência inicial do HA Core. Isto não só causava frustração, como também desencorajava muitos utilizadores principiantes de prosseguir.
Mesmo com o nosso suporte online, a resolução de problemas de rede e o acompanhamento do processo de instalação demoravam frequentemente mais do que o esperado — tanto para os utilizadores como para a nossa equipa.
Por isso, criámos o CoreBox — uma solução concebida a pensar no utilizador.
Com o CoreBox, obtém:
- Uma experiência de configuração rápida e fiável
- Chega de atrasos ou instalações falhadas devido a problemas de rede
- A confiança de que o seu Home Assistant funcionará sem problemas — a qualquer hora e em qualquer lugar
Posso atualizar o HA Core integrado?
Sim! Assim que o HA arrancar com a versão integrada (2025.5.3), o Home Assistant detetará se existe uma versão mais recente disponível. Pode atualizar o HA Core normalmente na página Definições > Sistema > Atualizações — tal como numa instalação normal.
9. Suplementos suportados
-
Agora disponível:
-
Suplemento de controlo de hardware do iHost
Controle botões físicos, indicadores RGB e fitas de luz diretamente a partir do Home Assistant.
Mapeie as entradas de hardware para automações, permitindo uma interação perfeita entre ambientes físicos e virtuais.
Pode clicar aqui para consultar o tutorial. -
Suplemento de atualização do MG21 : Atualize o firmware do MG21, com suporte opcional para atualizar as pilhas Zigbee ou Thread.
Pode clicar aqui para consultar o tutorial. -
Node-RED : Este suplemento é uma versão autónoma e empacotada do Node-RED, concebida exclusivamente para suportar a arquitetura linux/arm/v7. Foi empacotado pela SONOFF, especificamente para utilizadores do iHost.
Pode clicar aqui para consultar o tutorial. -
Suplemento Matter Bridge : Faça a ponte entre dispositivos locais e o ecossistema Matter para uma integração multiplataforma.
Pode clicar aqui para consultar o tutorial.
-
10. Agradecimentos
Este projeto é um desenvolvimento derivado com base no trabalho de Darkxst [ha-operating-system] projeto do GitHub. Agradecemos sinceramente ao autor original pelas suas contribuições fundamentais.
3 comentários
Bertrand
Good project
Mia Ma
回复鄭先生: 会在，HAOS是装在新的SD卡上，不会影响原本的CUBE系统。
鄭先生
請問已安裝CUBE使用一段時間，後來安裝HAOS使用一陣子不習慣
如果切換回CUBE，原本的CUBE資料還會在嗎?
HAOS資料還回在嗎?
想切回CUBE試試看哪個適合我使用，但擔心要重新設定很麻煩很困擾
Deixe um comentário
Todos os comentários são moderados antes de serem publicados.
Este site está protegido pela Política de privacidade da hCaptcha e da hCaptcha e aplicam-se os Termos de serviço das mesmas.