1. Introdução
Estamos entusiasmados em anunciar que o HA sobre iHost está agora oficialmente disponível! Este projeto traz o Home Assistant Operating System completo para o SONOFF iHost plataforma, oferecendo aos usuários uma nova forma poderosa de executar o Home Assistant localmente no hardware iHost.
Nascida de necessidades reais da comunidade e exploração técnica guiada pelos usuários, esta iniciativa reflete a criatividade e paixão das comunidades de usuários do Home Assistant e SONOFF. Muitos usuários do iHost já estavam executando o Home Assistant Core em Docker no sistema nativo para aproveitar seu hardware. Alguns usuários avançados foram ainda mais longe—modificando e compilando suas próprias versões para rodar o Home Assistant OS completo nativamente no iHost.
Neste guia, vou mostrar como executar facilmente o Home Assistant no seu SONOFF iHost. Vamos mostrar dois métodos de flashing: usando Balena Etcher ou Raspberry Pi Imager. Vamos começar!
Assista ao tutorial em vídeo detalhado aqui:
2. Pré-requisitos
- Um SONOFF iHost é necessário.
- Certifique-se de que vocêr iHost a versão do sistema é 2.5.1 ou posterior.
- Um Application Class 2 (A2) card, with a minimum capacity of 32GB, is recommended for better performance, especially on small read&write operations.
- 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
- Um cartão (Application Class 2) (A2), com capacidade mínima de 32GB, é recomendado para melhor desempenho, especialmente em operações pequenas de leitura e escrita. Sugerimos usar um cartão TF da SanDisk, Kingston ou Samsung. Temos usado internamente esses cartões para testes.
- Um leitor de cartão SD: qualquer leitor USB padrão funcionará se seu laptop não tiver um leitor de cartão SD embutido.
Software Necessário
- Ferramenta para gravar cartão Micro SD: Balena Etcher ou Raspberry Pi Imager, etc.
- Visite o projeto no GitHub para a imagem correspondente do HA over iHost: iHost-Open-Source-Project.

4. Gravando a Imagem HA Over iHost no Cartão Micro SD
-
Gravar com Balena Etcher
- Insira o cartão Micro SD no leitor de cartão e conecte-o ao seu computador.
- Baixar e executar Etcher.

- Clique Gravar a partir do arquivo, então selecione oe HA over iHost imagem arquivo baixado no seu computador.

2. Clique Selecionar destino, então escolha o cartão Micro SD que você inseriu.
*Nota: Por favor, certifique-se de selecionar o drive correto!

3. Clique Gravar! para começar a gravar oe HA over iHost imagem no cartão Micro SD.
*Nota: Não remova ou 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ão e conecte-o ao seu computador.
- Baixe e execute o Raspberry Pi Imager.

- Clique ESCOLHA O DISPOSITIVO > Sem filtro.

- Clique ESCOLHA O SO > Usar personalizado, então selecione o arquivo de imagem HA over iHost baixado no seu computador.


-
Clique ESCOLHER ARMAZENAMENTO, então escolha o cartão Micro SD que você inseriu.
*Nota: Por favor, certifique-se de selecionar o cartão Micro SD correto!

- Clique PRÓXIMO > NÃO, LIMPAR CONFIGURAÇÕES, e confirme para apagar todas as configurações no cartão SD.



-
Comece a gravar a imagem HA over iHost no cartão SD inserido.
*Nota: Não interaja com o cartão SD (por exemplo, desconectar ou modificar arquivos) durante o processo de gravação.


5. Inicializando Home Assistant Operating System em iHost
Migrar Dispositivos Zigbee (Opcional)
Se a migração dos dispositivos Zigbee não for necessária, pule para a próxima seção.
iHost permite que você exporte e migre os dados dos dispositivos Zigbee do iHost para o Home Assistant baixando o arquivo de backup disponível emPara restaurar no Home Assistant integrado com 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 aprender: Como restaurar?
InicializaçãoExecutando Home Assistant Operating System em iHost
- Insira o cartão Micro SD pré-gravado no slot 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 Mute (♪) no topo do iHost até que a Faixa de LED Lateral entre em um padrão de luz pulsante AZUL . Isso indica que o sistema está alternando para o Home Assistant OS gravado no cartão SD.

-
Se o indicador LED mostrar um AZUL padrão de luz pulsante, você pode acessar sua nova interface web do Home Assistant dentro dos próximos 10 minutos. A primeira inicialização pode levar mais tempo.
Em um navegador de desktop, digite homeassistant.local:8123.
*Nota: Se você estiver usando uma versão mais antiga do Windows ou tiver configurações de rede mais restritivas, pode ser 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 na Inicialização
- Se oa faixa de LED lateral não faznão mostra um AZUL padrão de luz pulsantern mas um VERMELHO padrão de luz pulsante apór ligado por 5 segundos ou após pressionar o botão várias vezes, a inicialização falhou. Tente reiniciar ouse o Home Assistant Operating System como seguews:
- Reinicie o iHost;
- Não é necessário pressionar nenhum botão.
- iHost tenta reiniciarnão é o Home Assistant Operating System frdo cartão SD.

- Se você não conseguir acessar a interface web do Home Assistant dentro de 10 minutos após as operações acima, pode ser devido a uma imagem gravada incorretamente. Tente regravar o cartão SD ou usar um novo.
6. Voltando para opara o eWeLink CUBE
- Para voltar para opara o eWeLink CUBE, fSiga estes passos:
- Reinicie o iHost.
- Pressione repetidamente o botão de mudo (♪) uma vez dentro de 3 segundos.
- O LED Faixa Lateral cvou mudar para um VERMELHO padrão de luz fluindo, confirmando que o sistema voltou para o eWeLink CUBE.

*Notas:
- Se vários dispositivos estiverem executandong Home Assistant Operating System em sua rede, o nome do host [homeassistant.local] pode não resolver corretamente. Você pode descobrir o endereço IP correto através da interface de gerenciamento do seu roteador ou transmitindo o serviço mDNS [_home-assistant._tcp.].
- Se a última inicialização foi a partir do cartão SD, e o cartão for removido sem voltar para o eWeLink CUBE, tA faixa lateral de LED irá mostrar um VERMELHO padrão de luz respiratória, indicando que o Home Assistant Operating System falhou ao inicializar no iHost.
7. Recursos de Hardware
Ligadoce Home Assistant Operating System está succexecutando com sucesso no iHost, você pode usar os seguintes hardwares onboard suportados:
Botão e indicador LED
O add-on iHost Hardware Control permite o controle dos 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 de energia para desligar o iHost). Para detalhes, consulte o Add-on iHost Hardware Control guia.
Bluetooth
- Modelo do Chipset: RTL8723DS
- Caminho: Configurações > Dispositivos e Serviços > Integrações > Bluetooth
- Descoberta: Automático

Wi-Fi
- Modelo do Chipset: RTL8723DS
- Caminho: Configurações > Sistema > Rede > Configurar Interfaces de Rede > WLAN0
- Descoberta: Automático

Coordenador Zigbee
- Modelo do Chipset: 00.21.05.0009 SOC EFR32MG21A020F768IM32-B SiliconLabs QFN32-4*4 (RAM 64kB,Flash 768kB)
- Caminho: Configurações > Sistema > Hardware > Todo Hardware > /dev/ttyS4
- Descoberta: Via Zigbee Home Automation (ZHA) ou Zigbee2MQTT

7. Sobre a Imagem CoreBox
CoreBox é uma nova imagem do HA sobre iHost projetada para configuração rápida, com a versão mais recente do HA Core (2025.05.03) pré-integrada.
Com CoreBox, você não precisa mais esperar durante a instalação inicial para que o dispositivo baixe o HA Core do GitHub. Em vez disso, você pode inicializar diretamente a partir da versão integrada do HA Core, alcançando a inicialização em até 3 minutos ou até mais rápido. CoreBox elimina a dependência da conectividade com a internet, permitindo uma configuração fácil mesmo em ambientes offline. Você ainda pode atualizar para versões mais recentes do HA Core de dentro do sistema uma vez que ele esteja em execução.
Por que CoreBox?
Temos ouvido atentamente seu feedback. Muitos usuários relataram que o processo original de instalação do HA sobre iHost frequentemente falhava devido à internet ruim ou instável, especialmente durante o download inicial do HA Core. Isso não só causava frustração, mas também desmotivava muitos usuários iniciantes a continuar.
Mesmo com nosso suporte online, solucionar problemas de rede e acompanhar o processo de instalação frequentemente levava mais tempo do que o esperado — tanto para os usuários quanto para nossa equipe.
Então criamos o CoreBox — uma solução projetada a partir da perspectiva do usuário.
Com CoreBox, você obtém:
- Uma experiência de configuração rápida e confiável
- Chega de atrasos ou falhas na instalação devido a problemas de rede
- Confiança de que seu Home Assistant funcionará perfeitamente — a qualquer hora, em qualquer lugar
Posso atualizar o HA Core embutido?
Sim! Uma vez que o HA inicialize com a versão embutida (2025.5.3), o Home Assistant detectará se uma versão mais recente está disponível. Você pode atualizar o HA Core normalmente na página Configurações > Sistema > Atualizações — assim como em uma instalação normal.
9. Add-ons Suportados
-
Agora disponível:
-
iHost Hardware Control Add-on
Controle botões físicos, indicadores RGB e fitas de luz diretamente do Home Assistant.
Mapeie entradas de hardware para automações para uma interação perfeita entre ambientes físicos e virtuais.
Você pode clicar aqui para o tutorial. -
MG21 Flashing Add-on : Atualize o firmware MG21, com suporte opcional para flash de pilhas Zigbee ou Thread.
Você pode clicar aqui para o tutorial. -
Node-Red : Este add-on é uma versão empacotada independente do Node-RED, projetada exclusivamente para suportar a arquitetura linux/arm/v7. Foi empacotado pela SONOFF, especificamente adaptado para o usuário iHost.
Você pode clicar aqui para o tutorial. -
Matter Bridge Add-on : Conecte dispositivos locais ao ecossistema Matter para integração multiplataforma.
Você pode clicar aqui para o tutorial.
-
10. Agradecimentos
Este projeto é um desenvolvimento derivado baseado no Darkxst’s [ha-operating-system] projeto do GitHub. Agradecemos sinceramente ao autor original por suas contribuições fundamentais.
2 comentários
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.