eWeLink DocsHome Assistant
Saiba como conectar seus dispositivos eWeLink ao Home Assistant usando o complemento oficial eWeLink Smart Home.
I. Recursos
- Atualmente, o complemento oficial suporta interruptores e tomadas eWeLink. Mais dispositivos compatíveis com eWeLink serão suportados em versões futuras.
- Suporte ao modo DIY do Sonoff.
- Prioridade para controlar dispositivos na rede local. Se o dispositivo não suportar o modo LAN ou não estiver na rede local, você pode controlá-lo pela nuvem.
- Sincronização em tempo real do status e das informações de configuração do dispositivo. O nome e a configuração do dispositivo podem ser modificados posteriormente.
- Suporta apenas o Home Assistant instalado através do HassOS e Supervisor.
II. Pré-requisitos
Criar tokens de acesso de longa duração
O complemento eWeLink conecta dispositivos compatíveis com eWeLink chamando a API REST e a API WebSocket do Home Assistant. É necessário um token de acesso de longa duração.
Faça login no console Lovelace do Home Assistant (normalmente a URL é http://homeassistant.local:8123/), clique no nome do usuário na parte inferior da barra lateral para acessar o Perfil do Usuário, encontre a opção «Tokens de Acesso de Longa Duração» na parte inferior da página e clique em CRIAR TOKEN. Digite um nome para o token na caixa de diálogo (eWeLink_HA_AddOn é recomendado) e clique em OK. Copie o token que acabou de gerar e guarde-o em um local seguro.
III. Instalação
Faça login no console Lovelace do Home Assistant (normalmente a URL é http://homeassistant.local:8123/), clique em Supervisor na barra lateral para abrir o painel do HassOS e mude para a aba Add-on Store. Clique nas reticências verticais (três pontos verticais) no canto superior direito, selecione Repositories no menu pop-up, digite o endereço oficial do complemento eWeLink: https://github.com/CoolKit-Technologies/ha-addon na caixa de diálogo «Gerenciar repositórios de complementos» e clique em ADD. Após fechar a caixa de diálogo, você poderá ver o complemento eWeLink recém-adicionado na página do Add-on Store.
Clique no cartão eWeLink Smart Home para abrir a página de informações do complemento, clique em INSTALL e aguarde a conclusão da instalação. Quando terminar, não clique em START imediatamente, em vez disso mude para Configuration, preencha o token de acesso de longa duração e clique em Save. Depois volte à aba Information e clique em START para ativar o complemento «eWeLink Smart Home».
Para acesso rápido ao complemento eWeLink Smart Home, você pode ativar a opção Show in sidebar (Mostrar na barra lateral).
Você precisa alterar a home_assistant_url se estiver usando Docker ou outras versões do Home Assistant que não sejam o Home Assistant OS.
IV. Configuração
Controlar dispositivos DIY eWeLink
Controle dispositivos DIY eWeLink na rede local ou faça login na sua conta eWeLink para controlar todos os dispositivos compatíveis com eWeLink.
Faça login no console Lovelace do Home Assistant (normalmente a URL é http://homeassistant.local:8123/), clique em Supervisor na barra lateral para abrir o painel do HassOS, depois clique no cartão eWeLink Smart Home para acessar a página de informações do complemento. Clique em OPEN WEB UI, a página Web UI do eWeLink Smart Home listará todos os dispositivos DIY na rede local descobertos por mDNS. Você também pode clicar no botão Login no canto superior esquerdo e fazer login na sua conta eWeLink para conectar todos os dispositivos compatíveis.
Atualmente, a versão beta suporta apenas interruptores e tomadas; mais tipos de dispositivos serão suportados em breve.
Configurar cenas e automações
Os dispositivos conectados através da API REST e da API WebSocket do Home Assistant só podem ser mapeados como entidades em vez de dispositivos, o que torna impossível controlar diretamente os dispositivos através das cenas e automações do Home Assistant.
Para resolver esse problema, você precisa ativar o Modo Avançado (Console Lovelace > Perfil > Advanced Mode).
Para usar dispositivos compatíveis com eWeLink em automações, você precisa primeiro criar uma cena que contenha seus dispositivos e depois selecionar Ativar Cenário em Ação > Tipo de Ação da automação.
