1. Introdução
Temos o prazer de anunciar que o HA over iHost já está oficialmente disponível! Este projeto traz o sistema operacional completo do Home Assistant para a plataformaSONOFF iHost plataforma, oferecendo aos usuários uma nova e poderosa maneira de executar o Home Assistant localmente no hardware do iHost.
Nascida de necessidades reais da comunidade e da exploração técnica conduzida pelos usuários, esta iniciativa reflete a criatividade e a paixão das comunidades de usuários do Home Assistant e da SONOFF. Muitos usuários do iHost já executam o Home Assistant Core no Docker no sistema nativo para aproveitar o hardware. Alguns usuários avançados foram ainda mais longe, modificando e compilando suas próprias versões para executar o Home Assistant OS completo nativamente no iHost.
Neste guia, mostrarei como executar facilmente o Home Assistant no seu SONOFF iHost. Apresentaremos dois métodos de gravação: usando Balena Etcher ou Raspberry Pi Imager. Vamos começar!
Assista ao tutorial detalhado em vídeo aqui:
2. Pré-requisitos
- É necessário um SONOFF iHost.
- Certifique-se de quer iHost a versão do sistema seja 2.5.1 ou posterior.
- Um Classe de Aplicação 2 recomenda-se um cartão (A2), com capacidade mínima de 32 GB, para melhor desempenho, especialmente em pequenas operações de leitura e gravação.
- Como o iHost é baseado em um processador de 32 bits, alguns recursos do Home Assistant podem não ser compatíveis.
3. Preparando o cartão Micro SD
Hardware necessário
- Recomenda-se um cartão (Classe de Aplicação 2) (A2), com capacidade mínima de 32 GB, para melhor desempenho, especialmente em pequenas operações de leitura e gravação. Sugerimos usar um cartão TF da SanDisk, Kingston ou Samsung. Temos usado internamente cartões dessas marcas para testes.
- Um leitor de cartões SD: qualquer leitor de cartões USB padrão funcionará se o laptop não tiver um leitor de cartões SD integrado.
Software necessário
- Ferramenta para gravar o cartão Micro SD: Balena Etcher ou Raspberry Pi Imageretc.
- Acesse o projeto correspondente no GitHub para obter a imagem do HA over iHost: iHost-Open-Source-Project.
4. Gravação da imagem do HA over iHost no cartão Micro SD
-
Gravar com Balena Etcher
- Insira o cartão Micro SD no leitor de cartões e conecte-o ao computador.
- Baixe e execute o Etcher.
- Clique Gravar a partir do arquivoe selecione oe HA over iHost imagem arquivo baixado no computador.
2. Clique Selecionar destinoe selecione o cartão Micro SD inserido.
*Observação: certifique-se de selecionar a unidade correta!
3. Clique Gravar! para iniciar a gravação de HA over iHost imagem no cartão Micro SD.
*Observação: não remova nem use 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 conecte-o ao computador.
- Baixe e execute o Raspberry Pi Imager.
- Clique ESCOLHER DISPOSITIVO > Sem filtragem.
- Clique ESCOLHER SO > Usar personalizadoe selecione o arquivo de imagem do HA over iHost baixado no computador.
-
Clique ESCOLHER ARMAZENAMENTOe selecione o cartão Micro SD inserido.
*Observação: certifique-se de selecionar o cartão Micro SD correto!
- Clique PRÓXIMO > NÃO, LIMPAR CONFIGURAÇÕESe confirme para apagar todas as configurações do cartão SD.
-
Comece a gravar a imagem do HA over iHost no cartão SD inserido.
*Observação: não interaja com o cartão SD (por exemplo, desconectando-o ou modificando arquivos) durante o processo de gravação.
5. Inicializando Home Assistant Operating System no iHost
Migrar dispositivos Zigbee (opcional)
Se a migração dos dispositivos Zigbee não for necessária, pule para a próxima seção.
O iHost permite exportar e migrar os dados dos dispositivos Zigbee do iHost para o Home Assistant baixando o arquivo de backup disponível empara restaurar no Home Assistant integrado ao ZHA/Zigbee2MQTT. Apenas a rede Zigbee e o status dos dispositivos são migrados. Temporizadores, grupos, cenas e nomes dos dispositivos não são incluídos.
Clique aqui para saber mais: Como restaurar?
InicializaçãoExecutando o Home Assistant Operating System noiHost
- Insira o cartão Micro SD pré-gravado no compartimento de cartão SD do iHost.
- Conecte o iHost a um cabo de rede e ligue-o.
- Dentro de 5 segundos após ligar, pressione repetidamente o botão Silenciar (♪) na parte superior do iHost até que a Faixa de LEDs lateral entre em um padrão de luz pulsante AZUL . Isso indica que o sistema está mudando para o Home Assistant OS gravado no cartão SD.
*Observação: O botão liga/desliga é o primeiro botão de cima, e o botão Silenciar (♪) é o terceiro botão de cima (contando para baixo). Para referência visual, veja a imagem abaixo.
- Se o indicador LED exibir um AZUL padrão de luz pulsante, você poderá acessar a nova interface web do Home Assistant nos próximos 10 minutos. A primeira inicialização pode demorar mais.
Em um navegador de computador, digite homeassistant.local:8123.
*Observação:
- A partir do Home Assistant 2026.8, novas instalações do Home Assistant OS não exigem mais :8123 na URL. Se você estiver usando uma instalação existente, a porta atual permanecerá inalterada, e talvez ainda seja necessário usar homeassistant.local:8123
- Se você estiver executando uma versão mais antiga do Windows ou tiver configurações de rede mais restritivas, talvez seja necessário acessar o Home Assistant usando uma das 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)
Solução de problemas de falhas de inicialização
- Se aA Faixa de LEDs lateral nãonão exibe um AZUL padrão de luz pulsantern, mas um exibe padrão de luz pulsante apósapós ligá-lo por 5 segundos ou depois de pressionar o botão várias vezes, a inicialização falhou. Tente reiniciar oo Home Assistant Operating System da seguinte formaws:
- Desligue e ligue o iHost;
- Não é necessário pressionar nenhum botão.
- o iHost tenta inicializardo Home Assistant Operating System parado 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 você não conseguir acessar a interface web do Home Assistant em até 10 minutos após as operações acima, isso pode ser causado por uma imagem gravada incorretamente. Tente gravar novamente o cartão SD ou usar um novo.
- 6. Voltandopara o eWeLink CUBEPara voltar
- para o eWeLink CUBE,
- siga estas etapas:
- Desligue e ligue o iHost. Pressione repetidamente uma vez o botão de silenciar (♪) em até 3 segundos.de LED mudará para exibe A faixa lateral
um padrão de luz em movimento, confirmando que o sistema voltou para o eWeLink CUBE.
- *Observações:Se vários dispositivos estiverem executando o sistema operacional Home Assistant na
- sua rede, o nome do host [homeassistant.local] poderá não ser resolvido corretamente. Você pode descobrir o endereço IP correto pela interface de gerenciamento do roteador ou transmitindo o serviço mDNS [_home-assistant._tcp.].Se a última inicialização tiver sido feita pelo cartão SD e o cartão for removido sem voltar para o eWeLink CUBE, a a faixa lateral de LED exibe VERMELHA um padrão de luz pulsante,
indicando que o sistema operacional Home Assistant não conseguiu inicializar no iHost.
7. Recursos de hardwareQuando oistema operacional Home Assistant estiver funcion
endo executado com sucesso no iHost, você poderá usar os seguintes hardwares integrados compatíveis:
Botão e indicador LEDO complemento de controle de hardware do iHost permite controlar os botões e indicadores LED do iHost no Home Assistant. Ele os registra como dispositivos e entidades separadas, permitindo que os usuários os utilizem em automações para interações de hardware mais flexíveis(por exemplo, acionando a entidade do botão liga/desliga para desligar o iHost) . Para obter detalhes, consulte o complemento de controle de hardware do iHost
guia.
- Modelo do chipset: Wi-Fi
- Caminho: Bluetooth
- Descoberta: Configurações > Sistema > Rede > Configurar interfaces de rede > WLAN0
Configurações > Dispositivos e serviços > Integrações > Bluetooth
- Modelo do chipset: Wi-Fi
- Caminho: RTL8723DS
- Descoberta: Configuraçõ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: Configurações > Sistema > Hardware > Todo o hardware > /dev/ttyS4
- Descoberta: Por meio do Zigbee Home Automation (ZHA) ou Zigbee2MQTT
8. Sobre a imagem do CoreBox
O CoreBox é uma nova imagem do HA no iHost desenvolvida para uma configuração rápida, com a versão mais recente do HA Core (2025.05.03) pré-integrada.
Com o CoreBox, você não precisa mais esperar que o dispositivo baixe o HA Core do GitHub durante a instalação inicial. Em vez disso, é possível inicializar diretamente usando a versão integrada do HA Core, concluindo a inicialização em até 3 minutos ou até mais rapidamente. O CoreBox elimina a dependência da conexão com a internet, permitindo uma configuração fácil mesmo em ambientes offline. Depois que o sistema estiver em execução, você ainda poderá atualizá-lo para versões mais recentes do HA Core.
Por que o CoreBox?
Temos analisado atentamente seus comentários. Muitos usuários relataram que o processo original de instalação do HA no iHost frequentemente falhava devido à internet lenta ou instável, especialmente durante o download inicial do HA Core. Isso não só causava frustração, como também desmotivava muitos usuários de primeira viagem a continuar.
Mesmo com nosso suporte online, solucionar problemas de rede e orientar o processo de instalação muitas vezes demorava mais do que o esperado — tanto para os usuários quanto para nossa equipe.
Por isso, criamos o CoreBox — uma solução projetada sob a perspectiva do usuário.
Com o CoreBox, você tem:
- Uma experiência de configuração rápida e confiável
- Chega de atrasos ou falhas na instalação devido a problemas de rede
- A confiança de que seu Home Assistant funcionará perfeitamente — a qualquer hora, em qualquer lugar
Posso atualizar o HA Core integrado?
Sim! Assim que o HA for inicializado com a versão integrada (2025.5.3), o Home Assistant detectará se há uma versão mais recente disponível. Você pode atualizar o HA Core normalmente na página Configurações > Sistema > Atualizações — assim como em uma instalação comum.
9. Complementos compatíveis
-
Agora disponível:
-
Complemento de Controle de Hardware do iHost
Controle botões físicos, indicadores RGB e fitas de luz diretamente pelo Home Assistant.
Mapeie entradas de hardware para automações e interaja perfeitamente entre ambientes físicos e virtuais.
Você pode clicar aqui para ver o tutorial. -
Complemento de Gravação do MG21 : atualize o firmware do MG21, com suporte opcional para gravar os protocolos Zigbee ou Thread.
Você pode clicar aqui para ver o tutorial. -
Node-RED : este complemento é uma versão independente e empacotada do Node-RED, desenvolvida exclusivamente para oferecer suporte à arquitetura linux/arm/v7. Ele foi empacotado pela SONOFF, especificamente para usuários do iHost.
Você pode clicar aqui para ver o tutorial. -
Complemento Matter Bridge : faça a ponte entre dispositivos locais e o ecossistema Matter para integração multiplataforma.
Você pode clicar aqui para ver o tutorial.
-
10. Agradecimentos
Este projeto é um desenvolvimento derivado baseado no trabalho de Darkxst [ha-operating-system] projeto do GitHub. Agradecemos sinceramente ao autor original por suas contribuições fundamentais.
3 comentários
Bertrand
Good project
Mia Ma
回复鄭先生: 会在，HAOS是装在新的SD卡上，不会影响原本的CUBE系统。
鄭先生
請問已安裝CUBE使用一段時間，後來安裝HAOS使用一陣子不習慣
如果切換回CUBE，原本的CUBE資料還會在嗎?
HAOS資料還回在嗎?
想切回CUBE試試看哪個適合我使用，但擔心要重新設定很麻煩很困擾
Deixar comentário
Os comentários precisam ser aprovados antes da publicação.
Este site é protegido por hCaptcha e a Política de privacidade e os Termos de serviço do hCaptcha se aplicam.