1. Visão Geral do Add-on
O Add-on de Controle de Hardware iHost é um add-on de controle de hardware desenvolvido exclusivamente para o gateway iHost. Este add-on se comunica com o Home Assistant via protocolo MQTT, mapeando completamente as capacidades de hardware do iHost, como botões físicos, indicadores de status e fitas de luz RGB, para o Home Assistant. Os usuários podem configurar e vincular livremente esses recursos de hardware usando os recursos de automação do Home Assistant, criando uma experiência de interação mais personalizada e inteligente baseada em seus hábitos e cenários domésticos.
2. Pré-requisitos
É necessário inicializar e executar o Home Assistant no iHost via um cartão microSD pré-gravado para usar o Controle de Hardware iHost add-on, pois ele habilita as funções de botão e indicador do iHost. Veja o Guia de Operação para mais detalhes.
3. Instale o Add-on de Controle de Hardware iHost
Adicionar Hassio-iHost-Repositórios de Add-ons
- Vá para a Loja de Add-ons → Clique no Mais botão (⋮) no canto superior direito → Selecione Repositórios
- Cole a seguinte URL:
https://github.com/iHost-Open-Source-Project/hassio-ihost-addon - Ou, simplesmente clique aqui para adicioná-lo automaticamente
Instalar Controle de Hardware iHost Add-on
- Pesquisar por Controle de Hardware iHost na Loja de Add-ons;
- Clique Instalar;
- Aguarde a conclusão da instalação.
Começar Controle de Hardware iHost Add-on
Clique no botão “iniciar” após a instalação ser concluída e aguarde o término da inicialização.
Como o add-on Controle de Hardware iHost depende do MQTT, o add-on do broker Mosquitto é automaticamente instalado e iniciado para você quando iniciar o add-on Controle de Hardware iHost, você precisa aguardar alguns minutos para ver o plugin do broker Mosquitto na lista de add-ons.
Instalar integrações MQTT
Por favor, vá para Configurações -> Dispositivos e Serviços -> clique no botão Adicionar para 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 possui 4 botões físicos na parte superior: Botão de Energia, Botão de Emparelhamento, Botão de Mudo e Botão de Segurança, além de um pequeno orifício na lateral para um Botão de Reset. Esses 5 botões são representados como um dispositivo chamado “iHost Buttons” e possuem 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 |
Pareamento |
Clique Simples |
|
Botões iHost |
Mudo |
Clique Simples |
|
Botões iHost |
Segurança |
Clique Simples |
|
Botões iHost |
Redefinir |
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 possui uma luz indicadora azul, e também há uma longa faixa de luz na lateral. Essas 5 luzes indicadoras são representadas como um dispositivo chamado “Indicadores iHost”, cada um com um Selecione 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 |
Pareamento |
Ligado ,Desligado ,Piscar Rápido、Piscar Duplo |
|
Indicadores iHost |
Mudo |
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. Configurações de Automação Recomendadas
Projetamos as seguintes configurações recomendadas de automação para ajudá-lo a experimentar rapidamente o valor principal do addon. Todas as seguintes podem ser facilmente implementadas usando o recurso “Automação” do Home Assistant:
5.1. Configurando o Efeito de Luz de Inicialização
Descrição do Cenário:
Você quer um efeito de luz perceptível quando o Home Assistant terminar de iniciar.
Implementação：
- Criar nova automação.
- Quando -> Adicionar Gatilho -> Dispositivo -> Automações de Hardware iHost -> “Home Assistant” for 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 economizar energia e evitar confusão.
Implementação:
Nenhuma configuração do usuário é necessária. 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 você 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 -> Aguardar por 200 milissegundos.
- Ação -> Adicionar ação -> Dispositivo -> Indicadores iHost -> Alterar opção Indicadores iHost Emparelhamento -> Desligado.
5.4. Usando 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 Acionar 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 estiver desativado.
- 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á ativado.
- 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 faixa de luz mostra um efeito de luz laranja respirando.
[Automation 3] Detectando Modo de Emparelhamento:
- Criar nova automação.
- Quando -> Adicionar Gatilho -> Dispositivo -> Ponte Zigbee2MQTT -> Permitir associação da Ponte Zigbee2MQTT ativado.
- Ação -> Adicionar ação -> Dispositivo -> Indicadores iHost -> Alterar opção da Faixa Lateral dos Indicadores iHost -> Laranja Respirando.
Descrição do Cenário 4:
Após a parada da associação à rede, a faixa de luz mostra um efeito de luz verde sólida.
[Automation 4] Detectando Saída de Emparelhamento:
- Criar nova automação.
- Quando -> Adicionar Gatilho -> Dispositivo -> Ponte Zigbee2MQTT -> Permitir associação da Ponte Zigbee2MQTT desativado.
- 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 acessar a internet, a faixa de luz exibe um aviso vermelho. A integração Ping (ICMP) deve estar instalada com o endereço ping configurado para 8.8.8.8.
Implementação:
- Criar nova automação.
- Quando -> Adicionar Gatilho -> Acionar 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 Faixa 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 se recupera, a faixa de luz volta automaticamente para verde sólido, sinalizando que o sistema retornou ao normal.
Implementação:
- Criar nova automação.
- Quando -> Adicionar Gatilho -> Acionar 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 estiver 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 à noite para evitar poluição luminosa ou interrupção durante o sono.
Implementação:
- Criar nova automação.
- Quando -> Adicionar Gatilho -> Quando o horário 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. Use o Botão de Energia para Desligamento Físico
Descrição do Cenário:
O desligamento pode ser realizado diretamente pelo botão físico no dispositivo iHost, sem usar a interface web.
Implementação:
- Pressione e segure o Botão de Energia por aproximadamente 10 segundos para iniciar o desligamento.
- Para ligar o sistema novamente, basta pressionar o Botão de Energia uma vez. Este recurso não requer configuração e é gerenciado automaticamente pelo complemento.
Nota: É ideal para cenários de proteção contra falta de energia ou manutenção.
Você está convidado a explorar nosso projeto no GitHub e participar das discussões no fórum eWeLink . Nosso projeto open source iHost continuará trazendo recursos novos e empolgantes—fique ligado!
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.