1. Visão Geral do Add-on
O Add-on de Controlo de Hardware iHost é um add-on de controlo de hardware desenvolvido exclusivamente para a gateway iHost. Este add-on comunica com o Home Assistant via o protocolo MQTT, mapeando completamente as capacidades de hardware do iHost, como botões físicos, indicadores de estado e tiras de luz RGB, para o Home Assistant. Os utilizadores podem configurar e ligar livremente estes recursos de hardware usando as funcionalidades de automação do Home Assistant, criando uma experiência de interação mais personalizada e inteligente baseada nos seus hábitos e cenários domésticos.
2. Pré-requisitos
É necessário arrancar e executar o Home Assistant no iHost através de um cartão microSD pré-gravado para usar o Controlo de Hardware iHost add-on, pois permite as funções de botão e indicador do iHost. Veja o Guia de Operação para mais detalhes.
3. Instalar o Add-on de Controlo de Hardware iHost
Adicionar Hassio-iHost-Repositórios de Add-ons
- Vá à Loja de Add-ons → Clique no botão Mais (⋮) no canto superior direito → Selecione Repositórios
- Cole o seguinte URL:
https://github.com/iHost-Open-Source-Project/hassio-ihost-addon - Ou, simplesmente clique aqui para adicionar automaticamente
Instalar Controlo de Hardware iHost Complemento
- Pesquisar por Controlo de Hardware iHost na Loja de Add-ons;
- Clique Instalar;
- Aguarde a conclusão da instalação.
Começar Controlo de Hardware iHost Complemento
Clique no botão “iniciar” após a instalação estar completa e aguarde até o início terminar.
Como o add-on Controlo de Hardware iHost depende do MQTT, o add-on do broker Mosquitto é automaticamente instalado e iniciado para si quando inicia o add-on Controlo de Hardware iHost, precisa de esperar alguns minutos para ver o plugin do broker Mosquitto na lista de add-ons.
Instalar integrações MQTT
Por favor, vá a Definições -> Dispositivos & Serviços -> clique no botão Adicionar para a Integração MQTT e aguarde a conclusão da adição.
Verifique os Botões e Indicadores do iHost nas Integrações MQTT
4. Entidades Fornecidas pelo Add-on
-
Botões iHost
O dispositivo iHost tem 4 botões físicos no topo: Botão de Energia, Botão de Emparelhamento, Botão de Silenciar e Botão de Segurança, bem como um pequeno orifício na lateral para um Botão de Reset. Estes 5 botões são representados como um dispositivo chamado “Botões iHost” e têm 5 entidades associadas. Por favor, consulte a tabela abaixo para detalhes específicos.
- Nota: Uma pressão longa (10 segundos) no Botão de Energia desligará o hardware do iHost.
|
Dispositivo |
Entidades |
Capacidades |
|
Botões iHost |
Potência |
Clique Simples |
|
Botões iHost |
Emparelhamento |
Clique Simples |
|
Botões iHost |
Silenciar |
Clique Simples |
|
Botões iHost |
Segurança |
Clique Simples |
|
Botões iHost |
Repor |
Clique Duplo Pressão Longa (Segure o botão por mais de 10s) |
-
Indicador iHost
Cada um dos 4 botões físicos no iHost tem uma luz indicadora azul, e há também uma longa faixa luminosa na lateral. Estas 5 luzes indicadoras são representadas como um dispositivo chamado “Indicadores iHost”, cada um com um Selecionar entidade. Por favor, consulte a tabela abaixo para detalhes específicos.
|
Dispositivo |
Entidades |
Capacidades |
|
Indicadores iHost |
Potência |
Ligado ,Desligado ,Piscar Rápido、Piscar Duplo |
|
Indicadores iHost |
Emparelhamento |
Ligado ,Desligado ,Piscar Rápido、Piscar Duplo |
|
Indicadores iHost |
Silenciar |
Ligado ,Desligado ,Piscar Rápido、Piscar Duplo |
|
Indicadores iHost |
Segurança |
Ligado ,Desligado ,Piscar Rápido、Piscar Duplo |
|
Indicadores iHost |
Faixa Lateral |
1. Desligado |
5. Definições Recomendadas de Automação
Desenhámos as seguintes configurações recomendadas de automação para o ajudar a experienciar rapidamente o valor principal do addon. Todas as seguintes podem ser facilmente implementadas usando a funcionalidade “Automação” do Home Assistant:
5.1. Configurar Efeito de Luz de Arranque
Descrição do Cenário:
Quer um efeito de luz notório quando o Home Assistant termina de iniciar.
Implementação：
- Criar nova automação.
- Quando -> Adicionar Disparador -> Dispositivo -> Automação de Hardware iHost -> “Home Assistant” é iniciado.
- Ação -> Adicionar ação -> Dispositivo -> Indicadores iHost -> Alterar opção Faixa Lateral dos Indicadores iHost -> Verde Sólido. Este cenário ajuda a indicar se o sistema está pronto.
5.2. Desligar Automaticamente as Luzes Após o Desligamento
Descrição do Cenário:
Desligar automaticamente todas as luzes quando o iHost for desligado para poupar energia e evitar confusão.
Implementação:
Não é necessária configuração do utilizador. O addon desligará automaticamente todas as luzes quando o sistema for desligado, sem necessidade de intervenção manual.
5.3. Efeito de Luz de Feedback do Botão
Descrição do Cenário:
Quando pressiona o Botão de Emparelhamento no iHost, o indicador do botão tem um efeito de luz de feedback: liga o indicador, depois desliga após 200ms.
Implementação:
- Criar nova automação.
- Quando -> Adicionar Gatilho -> Dispositivo -> Botões iHost -> "Clique Único" Emparelhamento.
- Ação -> Adicionar ação -> Dispositivo -> Indicadores iHost -> Alterar opção Emparelhamento dos Indicadores iHost -> Ligado.
- Ação -> Adicionar ação -> Atraso de 200 milissegundos.
- Ação -> Adicionar ação -> Dispositivo -> Indicadores iHost -> Alterar opção Indicadores iHost Emparelhamento -> Desligado.
5.4. Usar o Botão de Emparelhamento para Controlar os Efeitos de Luz de Entrada na Rede Zigbee2MQTT
Descrição do Cenário 1:
Pressione o Botão de Emparelhamento para mostrar o efeito de luz do botão (ligar o indicador, depois desligar após 200ms) e permitir que dispositivos ZigBee entrem na rede.
[Automação 1] Sem Estado de Emparelhamento, Botão de Emparelhamento para Disparar Entrada na Rede:
- Criar nova automação.
- Quando -> Adicionar Gatilho -> Dispositivo -> Botões iHost -> "Clique Único" Emparelhamento.
- E se -> Adicionar condição -> Dispositivo -> Ponte Zigbee2MQTT -> Permitir associação da Ponte Zigbee2MQTT está desligado.
- Ação -> Adicionar ação -> Dispositivo -> Ponte Zigbee2MQTT -> Ativar Permitir associação da Ponte Zigbee2MQTT.
Descrição do Cenário 2:
Durante o processo de associação à rede, pressione o Botão de Emparelhamento para mostrar o efeito de luz do botão (ligar o indicador, depois desligar após 200ms) e parar a associação à rede ZigBee.
[Automation 2] Durante o Emparelhamento, Botão de Emparelhamento para Parar Associação à Rede:
- Criar nova automação.
- Quando -> Adicionar Gatilho -> Dispositivo -> Botões iHost -> "Clique Único" Emparelhamento.
- E se -> Adicionar condição -> Dispositivo -> Ponte Zigbee2MQTT -> Permitir associação da Ponte Zigbee2MQTT está ligado.
- Ação -> Adicionar ação -> Dispositivo -> Ponte Zigbee2MQTT -> Desligar Permitir associação da Ponte Zigbee2MQTT.
Descrição do Cenário 3:
Durante o processo de associação à rede, a tira de luz mostra um efeito de luz laranja a respirar.
[Automation 3] Detectando Modo de Emparelhamento:
- Criar nova automação.
- Quando -> Adicionar Gatilho -> Dispositivo -> Ponte Zigbee2MQTT -> Permitir associação da Ponte Zigbee2MQTT ligado.
- Ação -> Adicionar ação -> Dispositivo -> Indicadores iHost -> Alterar opção da Tira Lateral dos Indicadores iHost -> Laranja Respirando.
Descrição do Cenário 4:
Após a paragem da associação à rede, a tira de luz mostra um efeito de luz verde sólido.
[Automation 4] Detectando Saída de Emparelhamento:
- Criar nova automação.
- Quando -> Adicionar Gatilho -> Dispositivo -> Ponte Zigbee2MQTT -> Permitir associação da Ponte Zigbee2MQTT desligado.
- Ação -> Adicionar ação -> Dispositivo -> Indicadores iHost -> Alterar opção Indicadores iHost Faixa Lateral -> Verde Sólido.
5.5. Efeito de Luz de Alarme de Rede Offline
Descrição do Cenário:
Quando o dispositivo não consegue aceder à internet, a tira de luz exibe um aviso vermelho. A integração Ping (ICMP) deve estar instalada com o endereço ping definido para 8.8.8.8.
Implementação:
- Criar nova automação.
- Quando -> Adicionar Gatilho -> Ativar no 3º segundo de cada minuto de cada hora.
-
E se -> Adicionar condição -> Dispositivo -> 8.8.8.8 (dispositivo de integração Ping) -> 8.8.8.8 está desconectado.
-
Ação -> Adicionar ação -> Dispositivo -> Indicadores iHost -> Alterar opção da Tira Lateral dos Indicadores iHost -> Vermelho Sólido.
5.6. Efeito de Luz de Recuperação de Rede
Descrição do Cenário:
Quando a rede recupera, a tira de luz volta automaticamente a verde sólido, sinalizando que o sistema voltou ao normal.
Implementação:
- Criar nova automação.
- Quando -> Adicionar Gatilho -> Ativar no 3º segundo de cada minuto de cada hora.
- E se -> Adicionar condição -> Dispositivo -> 8.8.8.8 (dispositivo de integração Ping) -> 8.8.8.8 está conectado.
- Ação -> Adicionar ação -> Dispositivo -> Indicadores iHost -> Alterar opção Indicadores iHost Faixa Lateral -> Verde Sólido.
5.7. Desligar Todas as Luzes à Noite
Descrição do Cenário:
Desligar automaticamente todos os indicadores e faixas de luz durante a noite para evitar poluição luminosa ou perturbações durante o sono.
Implementação:
- Criar nova automação.
- Quando -> Adicionar Gatilho -> Quando a hora for igual a 23:30.
- Ação -> Adicionar ação -> Dispositivo -> Indicadores iHost -> Alterar opção Indicadores iHost Faixa Lateral -> Desligado.
- Ação -> Adicionar ação -> Dispositivo -> Indicadores iHost -> Alterar opção Indicadores iHost Energia -> Desligado.
- Ação -> Adicionar ação -> Dispositivo -> Indicadores iHost -> Alterar opção Indicadores iHost Emparelhamento -> Desligado.
- Ação -> Adicionar ação -> Dispositivo -> Indicadores iHost -> Alterar opção Indicadores iHost Segurança -> Desligado.
- Ação -> Adicionar ação -> Dispositivo -> Indicadores iHost -> Alterar opção Indicadores iHost Mudo -> Desligado.
5.8. Utilizar o Botão de Energia para Desligamento Físico
Descrição do Cenário:
O desligamento pode ser efetuado diretamente através do botão físico no dispositivo iHost, sem usar a interface web.
Implementação:
- Pressione e mantenha pressionado o Botão de Energia durante aproximadamente 10 segundos para iniciar o desligamento.
- Para ligar o sistema novamente, basta pressionar o Botão de Energia uma vez. Esta funcionalidade não requer configuração e é gerida automaticamente pelo add-on.
Nota: É ideal para cenários de proteção contra falha de energia ou manutenção.
Sinta-se à vontade para explorar o nosso projeto GitHub e juntar-se às discussões no fórum eWeLink . O nosso projeto open source iHost continuará a trazer funcionalidades novas e empolgantes — fique atento!
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.