A resposta curta
Sim. O AmazHA, uma app Home Assistant para relógios Amazfit, funciona em 25 modelos com Zepp OS e controla luzes, clima, estores, fechaduras, multimédia, cenas e muito mais a partir do pulso. Não existe uma app oficial do Home Assistant para Zepp OS. O relógio fala com o telemóvel por Bluetooth, o telemóvel fala com o Home Assistant e, em casa, o seu endereço local é tudo o que precisa.
| Em resumo | |
|---|---|
| Relógios | 25 modelos Amazfit com Zepp OS, quadrados e redondos |
| Tipos de dispositivo | 17, cada um com o seu próprio ecrã de controlo |
| Ligação | Relógio ↔ telemóvel por Bluetooth, telemóvel ↔ Home Assistant por HTTP |
| Endereços | URL local em casa, URL remoto opcional fora de casa |
| Token | Um token de acesso de longa duração de um administrador, guardado no telemóvel |
| Atualização | A cada 8 segundos enquanto a app está aberta |
| Dispositivos no relógio | Até 100; com algumas dezenas, continua rápido |
| Widget no mostrador | Até quatro dispositivos |
| Dados do relógio no Home Assistant | 18 sensores opcionais, através da integração Mobile App |
| Modelo de preço | Demo gratuita, depois um desbloqueio único, sem subscrição |
Como um relógio Zepp OS fala com o Home Assistant
O relógio nunca fala diretamente com o Home Assistant: é o telemóvel que o faz. Uma app de relógio Zepp OS não pode fazer pedidos web, por isso o AmazHA é feito de duas metades. Uma corre no relógio e desenha os ecrãs. A outra corre no telemóvel, dentro da app Zepp, e é a única parte que fala com o seu servidor Home Assistant.
Relógio ↔ telemóvel por Bluetooth, telemóvel ↔ Home Assistant por HTTP
Quando abre uma divisão no relógio, o relógio pergunta ao telemóvel por Bluetooth. O telemóvel chama a API REST do Home Assistant com o seu endereço e o seu token, reduz a resposta ao que o relógio precisa e envia-a de volta. Quando toca numa luz, o mesmo caminho é percorrido no sentido inverso: o relógio avisa o telemóvel, e o telemóvel chama o serviço no Home Assistant.
Este desenho tem duas consequências:
- Só chega ao relógio o que escolheu. O telemóvel carrega os dispositivos que ativou nas definições e mais nada, o que mantém o tráfego Bluetooth pequeno.
- O ecrã do relógio não depende da origem dos dados. A demo gratuita e a sua casa real usam os mesmos ecrãs; só muda a fonte.
O que nunca chega ao relógio
O endereço do seu Home Assistant e o seu token de acesso de longa duração ficam no telemóvel. O relógio recebe os nomes dos dispositivos, os estados e os valores que mostra, e mais nada. O token só é enviado para o seu servidor Home Assistant e, depois de guardado, as definições no telemóvel mostram pontos em vez do próprio token. O AmazHA não tem contas, nem estatísticas de utilização, nem um servidor do programador que guarde o que quer que seja sobre si ou sobre a sua casa.
Porque é que o telemóvel tem de estar por perto, e porque é que o relógio não precisa de Wi-Fi
O relógio chega ao Home Assistant através do telemóvel, por isso o telemóvel tem de estar ao alcance do Bluetooth, com o Bluetooth ligado e a app Zepp a correr em segundo plano. O próprio relógio não precisa de Wi-Fi nem de dados móveis: o Bluetooth até ao telemóvel é a sua única ligação.
O telemóvel, por sua vez, tem de chegar ao seu servidor. Em casa, isso é a sua rede local. Fora de casa, precisa de um endereço remoto, e se nunca usar o relógio fora de casa nunca vai precisar de um.
Primeiro o local, o remoto quando está fora
Pode introduzir dois endereços: um URL local (LAN), como http://192.168.1.50:8123 (um exemplo), e um URL remoto para quando está fora. Qualquer um dos campos pode ficar vazio. Com os dois definidos, o AmazHA prefere o local e passa sozinho para o remoto quando o local não responde. Um só token serve para os dois. O artigo sobre acesso remoto compara o Home Assistant Cloud, as VPN e o seu próprio domínio.
O que pode controlar a partir do pulso
O AmazHA trata 17 tipos de dispositivo do Home Assistant, e cada um tem o seu próprio ecrã de controlo. O ecrã inicial mostra as suas áreas, com os nomes que têm no Home Assistant; uma divisão mostra os seus dispositivos agrupados por tipo; um toque num mosaico abre os controlos completos. As luzes, os interruptores e os ventiladores também têm um interruptor no próprio mosaico, e as cenas, os scripts, as automações e os botões são executados a partir do seu.
| Tipo de dispositivo | Domínios do Home Assistant | O que faz o ecrã do relógio |
|---|---|---|
| Luz | light |
Controlo deslizante de brilho; a coroa altera-o em passos de 4%. Uma luz sem regulação de intensidade tem um simples mostrador ligar/desligar |
| Interruptor | switch |
Um grande controlo ligar/desligar |
| Ventilador | fan |
Controlo deslizante de velocidade e botão de energia; os ventiladores sem velocidades têm só o controlo ligar/desligar |
| Clima | climate |
Temperatura pretendida num mostrador, meio grau por passo da coroa; modos Desligado, Aquecer, Arrefecer e Auto |
| Estore | cover |
Abrir, Parar, Fechar, e ainda um controlo deslizante de posição e a coroa quando o estore suporta posições |
| Fechadura | lock |
Tranca com um toque; para destrancar pede um segundo toque de confirmação |
| Alarme | alarm_control_panel |
Arma nos modos que a sua central suporta (em casa, ausente); para desarmar pede o seu código num teclado |
| Multimédia | media_player |
Reproduzir, pausa, anterior e seguinte, um controlo deslizante de volume (a coroa ajusta o volume) e energia, quando o leitor os suporta |
| Aspirador | vacuum |
Iniciar, pausa, parar e mandá-lo de volta à base |
| Cena | scene |
Executa com um toque |
| Script | script |
Executa com um toque |
| Automação | automation |
Dispara com um toque |
| Botão | button, input_button |
Carrega com um toque |
| Seletor | select, input_select |
A lista de opções; toque numa para a escolher |
| Sensor | sensor |
O valor atual em letra grande; os sensores sem classe aparecem como texto (o estado de uma caixa de correio, o dia do lixo) |
| Câmara | camera |
Uma imagem fixa obtida pelo telemóvel, com Atualizar e Ao vivo |
| Localizador | device_tracker, person |
Só de leitura: em casa, fora ou a zona, com a última atualização e a bateria quando o Home Assistant as tem |
Os sensores são filtrados pelas classes que fazem sentido num relógio: temperatura, humidade, potência, energia, bateria, qualidade do ar, iluminância, pressão e semelhantes. Os sensores de diagnóstico, como a intensidade do sinal ou a tensão, e as marcas temporais ficam de fora de propósito.
As alterações são otimistas: o mosaico muda no instante em que toca nele, o pedido segue para o Home Assistant em segundo plano e a atualização seguinte corrige o ecrã se o Home Assistant discordar.
Que relógios funcionam
O AmazHA funciona em 25 modelos Amazfit com Zepp OS, com disposições para ecrãs quadrados e redondos. Nos relógios redondos, os títulos ficam centrados e as listas usam todo o vidro.
| Formato | Modelos |
|---|---|
| Quadrado | Active, Active 2, Bip 6, Bip Max, Cheetah Square, GTS 4 |
| Redondo | Active 2, Active 2 Golf, Active 3 Premium, Active Max, Balance, Balance 2, Balance 2 XT, Balance 3, Balance 3 Ti, Balance Ultra, Cheetah 2 Pro, Cheetah 2 Ultra, Cheetah Pro, Cheetah Round, Falcon, GTR 4, T-Rex 3, T-Rex 3 Pro, T-Rex Ultra, T-Rex Ultra 2 |
Três relógios ficam de fora por opção. O Active Edge e o Bip 5 têm ecrãs demasiado pequenos para a disposição, e o T-Rex 2 não tem memória suficiente. Os modelos Zepp OS mais antigos, abaixo do nível de API 3.0, estão fora de âmbito. Para um sim ou um não por modelo, veja que relógios Amazfit funcionam com o Home Assistant.
A verificação mais rápida é a própria loja: na app Zepp, abra a App Store e pesquise AmazHA. Se o seu relógio estiver emparelhado e for suportado, pode instalá-lo e experimentar a demo.
O que precisa antes de começar
Precisa de quatro coisas: um servidor Home Assistant a que o telemóvel consiga chegar, um token de acesso de longa duração de um administrador, a app Zepp e o seu relógio emparelhado com ela.
| Requisito | Porquê |
|---|---|
| Home Assistant acessível a partir do telemóvel | É o telemóvel que faz todos os pedidos. Em casa, o endereço local basta |
| Um token de acesso de longa duração de um administrador | O AmazHA lê as suas áreas através da API de templates, que o Home Assistant reserva aos administradores |
| A app Zepp no Android ou no iPhone | As definições do AmazHA e a sua metade do telemóvel vivem dentro dela |
| Um relógio suportado, emparelhado por Bluetooth | O relógio chega ao telemóvel da mesma forma que a app Zepp já chega |
Não é preciso instalar nada no Home Assistant para controlar os seus dispositivos: o AmazHA usa a API REST que todos os servidores Home Assistant têm. O token cria-se no Home Assistant, no seu perfil, no separador Segurança; o artigo sobre o token de acesso de longa duração explica os passos e porque é que o token de um utilizador normal não chega.
A configuração em seis passos
A configuração completa demora poucos minutos, e os dois primeiros passos não custam nada. Cada passo tem um pequeno tutorial em vídeo.
1. Instale o AmazHA
Na app Zepp do telemóvel, abra a App Store, toque no ícone de pesquisa e escreva AmazHA. Abra AmazHA — Home Assistant Companion App e toque em Instalar: vai diretamente para o relógio. Depois, no relógio, abra a lista de apps e toque em AmazHA. (Instalar o AmazHA)
2. Experimente a demo
O AmazHA abre numa casa demo com divisões e dispositivos. Todos os ecrãs funcionam com dados de exemplo, sem limite de tempo: abra uma divisão, ligue e desligue um interruptor, rode a coroa numa luz. É a forma honesta de ver como a app se comporta no seu próprio relógio antes de pagar o que quer que seja. (Navegar no relógio)
3. Desbloqueie-o uma vez
No relógio, toque no banner laranja Modo demo · sem licença, no topo do ecrã inicial. O relógio mostra um código de 5 dígitos. No telemóvel, abra kzl.io/code no browser, introduza o código, toque em Continue e conclua o pagamento. O relógio mostra Purchase Successful! e volta sozinho à app. Mais detalhes abaixo. (Desbloquear a versão completa)
4. Ligue o Home Assistant
Na app Zepp, vá a Perfil › o seu relógio › Apps › AmazHA › Definições e toque em Home Assistant. Introduza o URL local (LAN) e, se quiser usar o relógio fora de casa, o URL remoto. Cole o token em Token de acesso de longa duração e toque em Ligar. Com um só endereço, o resultado diz Ligado; com os dois, mostra LAN e Remoto separadamente. (Ligar o Home Assistant, a partir do passo 4)
5. Escolha os seus dispositivos
Nas definições do AmazHA, toque em Dispositivos. As suas divisões estão lá, e todos os dispositivos começam ocultos: abra uma divisão e ative o que usa. As listas longas, como Outros, para onde vão os dispositivos sem divisão, têm uma caixa Pesquisar; Mostrar tudo e Ocultar tudo atuam só nos dispositivos que correspondem à pesquisa. As pessoas e os telemóveis têm uma área própria, Localizadores. (Escolher os seus dispositivos)
6. Abra o AmazHA no relógio
As suas divisões e os seus dispositivos aparecem no relógio. A partir daqui, o relógio arranca de imediato com os seus últimos dados e atualiza-os a partir do Home Assistant enquanto a app está aberta.
À sua medida
Tudo o que muda o aspeto do relógio define-se nas definições do telemóvel, e o relógio vai buscá-lo lá.
Favoritos e Favoritos como ecrã inicial
Em Dispositivos › Favoritos, ative Mostrar no relógio e escolha qualquer dispositivo de qualquer divisão, mesmo um que não tenha ativado na respetiva divisão. Reordenar favoritos define a ordem. Os Favoritos aparecem então em primeiro lugar no ecrã inicial do relógio. Ative Usar Favoritos como ecrã inicial e o ecrã inicial do relógio passa a ser só essa lista, e só esses dispositivos são carregados. As áreas voltam quando desativar a opção. (Favoritos e energia, passo 4)
O painel de energia
Em Dispositivos › Energia, ative Mostrar painel de energia e escolha um sensor para cada função que tiver, como Potência da rede (com sinal), solar, bateria, e o consumo e o custo de hoje. Só aparecem os sensores adequados a cada função. O ecrã inicial do relógio ganha uma área Energia com a potência da rede neste momento, a importar ou a exportar, e depois a produção solar, a bateria e os totais de hoje. (Favoritos e energia)
Chips do ecrã inicial, ordem das divisões e ícones
Em Aparência › Chips do ecrã inicial, cada um dos três chips no topo do ecrã inicial pode contar luzes, interruptores, estores, clima, multimédia, fechaduras, câmaras ou localizadores, ou mostrar o alarme, a sua energia ou nada. Disposição do início define a ordem das áreas, e um toque no ícone de uma divisão permite escolher outro. Dentro de Dispositivos, uma divisão com sensores de temperatura ou de humidade permite escolher que sensor alimenta os chips dessa divisão, para que a leitura interna de um dispositivo não se sobreponha ao sensor da divisão. (À sua medida)
Nomes personalizados
Os nomes longos do Home Assistant raramente cabem num mosaico do relógio. Em Dispositivos, cada dispositivo que o relógio mostra tem um lápis depois do nome: toque no nome e escreva um novo em Nome no relógio, até 32 caracteres. O relógio usa-o em todos os ecrãs e no widget, enquanto o Home Assistant mantém o seu próprio nome. Repor o nome original volta a ele. Os nomes ficam no telemóvel e sobrevivem a Repor cache. (Nomes personalizados e o widget)
Tamanho do texto, tamanho dos cartões, vibração e tempo do ecrã
Em Preferências:
- Tamanho do texto aumenta todo o texto no relógio: 110%, 120% ou 130%. Aplica-se da próxima vez que abrir o AmazHA no relógio.
- Tamanho dos cartões aumenta os cartões de área do ecrã inicial e os mosaicos dos dispositivos: 115%, 130% ou 145%.
- Vibrar nas ações dá uma vibração curta quando toca num dispositivo, executa uma ação ou roda a coroa num ecrã de controlo. Vem desativada por predefinição.
- Tempo do ecrã define durante quanto tempo o ecrã fica ligado enquanto o AmazHA está aberto: 30 segundos, 1 minuto, 5 minutos ou Nunca, a predefinição. A opção Nunca também ignora o baixar do pulso, o que é prático mas gasta mais bateria.
O idioma do relógio segue o seu próprio idioma de sistema; Idioma, nas definições, só muda a página de definições. (Preferências)
O widget no mostrador
O widget coloca até quatro dos seus dispositivos nos cartões de atalho do relógio, à distância de um toque, sem abrir a app. Faz parte da versão completa; na versão gratuita, propõe o desbloqueio.
Para o configurar, abra Dispositivos › Widget no relógio nas definições do telemóvel e toque em até quatro dispositivos, pela ordem em que os quer: da esquerda para a direita, de cima para baixo. Depois, no relógio, deslize para a direita a partir do mostrador até aos cartões de atalho, toque em Editar e adicione o AmazHA. Até abrir a app uma vez, o widget diz Abrir o AmazHA; a partir daí, os seus dispositivos estão lá. (Nomes personalizados e o widget, passo 4)
O que faz um toque no widget depende do dispositivo:
| Dispositivo no widget | Um toque |
|---|---|
| Luz, interruptor, ventilador | Liga-o ou desliga-o; o widget mostra o novo estado |
| Cena, script, botão, automação | Executa-o |
| Tudo o resto (uma fechadura, um estore, um sensor, uma câmara) | Abre o seu próprio ecrã no AmazHA, onde uma fechadura continua a pedir confirmação |
Se um comando não passar, o ecrã diz porquê, com Repetir e Abrir o AmazHA; Repetir nunca executa uma ação duas vezes. O cabeçalho do widget indica sempre a idade dos estados, por exemplo AmazHA · há 1 min. Fica cinzento enquanto o relógio está offline, ou quando os estados têm 12 horas, e um toque abre então a app, que o põe em dia. As alterações que fizer no telemóvel chegam ao widget da próxima vez que abrir o AmazHA.
Uma nota prática: nos relógios mais recentes, uma atualização do AmazHA instalada com o widget no mostrador mantém parte da versão antiga a correr até o relógio reiniciar. O ecrã inicial mostra então Reinicie o relógio até o fazer.
Os dados do seu relógio no Home Assistant
O AmazHA também funciona no sentido inverso: pode enviar 18 leituras do seu relógio para o Home Assistant como entidades sensor. Chegam através da integração Mobile App do próprio Home Assistant, como um dispositivo com os seus sensores, com o nome sensor.<prefix>_<key>.
As leituras cobrem a atividade (passos, distância, calorias, horas em pé, minutos intensivos, PAI), a saúde (ritmo cardíaco, ritmo cardíaco em repouso, SpO2, stress, temperatura corporal, pontuação do sono, duração do sono, estado do sono), o ambiente (pressão atmosférica, altitude) e o dispositivo (bateria do relógio, estado de uso). Todas começam desligadas, e ativa só as que quiser, em Sensores do relógio › Enviar para o Home Assistant.
O relógio envia os seus dados sempre que abre o AmazHA. Para atualizações com a app fechada, defina Atualizar a cada (1 a 6 minutos) e permita a Atividade em segundo plano quando o relógio pedir; o telemóvel tem de estar por perto para cada atualização. No Home Assistant, encontra o relógio em Configuração › Dispositivos & serviços › Mobile App. O artigo sobre os sensores do relógio tem a tabela completa e exemplos de automações. (Sensores do relógio)
Limites que convém conhecer
Uma app de relógio que passa pelo telemóvel tem alguns limites por natureza, e é melhor conhecê-los antes de comprar.
| Limite | O que significa na prática |
|---|---|
| O telemóvel tem de estar por perto | Sem ligação Bluetooth ao telemóvel, não há controlo. O relógio mostra Offline · O telemóvel não responde |
| Os estados atualizam com a app aberta | A cada 8 segundos, por isso uma alteração feita noutro lado aparece em poucos segundos. Com a app fechada, nada é atualizado |
| Sem notificações a partir do Home Assistant | É o relógio que pede os estados; o Home Assistant não pode enviar notificações nem atualizações para o relógio através do AmazHA |
| 100 dispositivos no máximo | Com algumas dezenas, continua rápido. O ecrã Dispositivos recomenda 40 ou menos por área: em alguns relógios, uma área com 70 ou mais pode esgotar a memória e deixar o ecrã preto |
| Fora de casa é preciso um endereço remoto | Só se o quiser usar fora; o endereço local cobre a casa |
| Atualizações dos sensores em segundo plano | Precisam da permissão Atividade em segundo plano e do telemóvel ao alcance; caso contrário, o relógio envia os dados quando abre a app |
| Só Zepp OS | Há uma versão para Wear OS em desenvolvimento, sem data |
As duas primeiras linhas explicam a maior parte das surpresas. Se deixar o telemóvel noutra divisão e sair do alcance do Bluetooth, o relógio continua a mostrar os seus últimos dados, mas não consegue mudar nada. E se uma luz mudar com o AmazHA fechado, o relógio mostra o novo estado da próxima vez que o abrir.
Quando algo corre mal
Quando algo não funciona, o relógio diz o que se passa, e cada mensagem tem uma causa habitual. Esta tabela segue o tutorial de resolução de problemas, que tem um passo para cada mensagem.
| O relógio diz | Causa | Solução |
|---|---|---|
| Nenhum dispositivo selecionado | Todos os dispositivos começam ocultos | Ative os dispositivos que quer em Dispositivos, nas definições do AmazHA (passo 1) |
| Offline · O telemóvel não responde | O relógio não consegue chegar ao telemóvel | Mantenha o telemóvel por perto, com o Bluetooth ligado e a app Zepp a correr (passo 2) |
| Offline · Home Assistant inacessível | O telemóvel não consegue chegar ao Home Assistant | Abra o seu endereço no browser do telemóvel: tem de funcionar a partir do sítio onde o telemóvel está, e fora de casa precisa de HTTPS com um certificado válido (passo 3) |
| Endereço errado | O endereço responde, mas não é a API do Home Assistant | Use apenas o endereço do servidor, sem nada depois (sem /lovelace) (passo 4) |
| É preciso token admin | O token pertence a um utilizador sem direitos de administrador | Crie um novo token de longa duração como administrador e cole-o (passo 5) |
| Verifica o token | O token tem um carácter que nenhum token tem, normalmente por causa de uma cópia cortada (…) | Copie-o de novo, completo, e cole-o (passo 6) |
| O relógio está lento ou reinicia | Demasiados dispositivos | Mantenha a seleção pequena: com algumas dezenas, continua rápido, e 100 é o limite (passo 7) |
| Modo demo · sem licença | A app não está desbloqueada | Toque no banner e desbloqueie-a (Desbloquear a versão completa) |
| Modo demo · Configure o servidor HA na app do telemóvel | Desbloqueada, mas ainda sem servidor definido | Introduza o seu endereço e o token em Home Assistant, nas definições (Ligar o Home Assistant) |
| Reinicie o relógio | Uma atualização instalada com o widget no mostrador | Reinicie o relógio |
Por baixo de um banner Offline, o relógio acrescenta Repete a cada 8 s, por isso não tem de fazer nada quando a causa desaparece, e uma pequena linha de código mais abaixo diz ao suporte exatamente o que falhou. Uma fotografia do relógio é a coisa mais útil para enviar.
Se nada da lista se aplicar, abra Preferências, toque em Repor cache e depois em Toca novamente para confirmar. Apaga os dados em cache no relógio e no telemóvel, e mantém a ligação, os dispositivos e a licença; depois, volte a abrir o AmazHA no relógio (passo 8). Se mesmo assim não resolver, o formulário Suporte nas definições envia um relatório com a sua mensagem. Nunca inclui o endereço do seu Home Assistant, o seu token nem os nomes dos seus dispositivos.
Um exemplo concreto: teste verde, relógio vazio
Um relato frequente no primeiro dia: Ligar fica verde, mas o relógio não mostra nada. Duas causas cobrem quase todos os casos. Ou ainda não ativou nenhum dispositivo, e o relógio diz Nenhum dispositivo selecionado, ou o token pertence a um utilizador que não é administrador, e o relógio diz É preciso token admin. A segunda apanha as pessoas de surpresa, porque o teste de ligação lê os estados sem problemas; é a consulta das áreas, através da API de templates, que o Home Assistant recusa a um utilizador normal. Um novo token, criado com sessão iniciada como administrador, resolve.
Desbloquear a versão completa
O desbloqueio é um pagamento único feito a partir do relógio, através da KiezelPay: sem conta, sem subscrição, sem anúncios. Liga o AmazHA ao seu próprio Home Assistant, local e remoto, e ativa os sensores do relógio e o widget. Até lá, a app é uma demo com dados de exemplo, e nada chega a um servidor real.
- No relógio, toque no banner laranja Modo demo · sem licença. O relógio mostra um código de 5 dígitos.
- No telemóvel, abra kzl.io/code no browser.
- Escreva o código e toque em Continue.
- Pague uma vez, com cartão ou PayPal. É uma licença vitalícia.
- O relógio mostra Purchase Successful! e volta sozinho à app.
O tutorial Desbloquear a versão completa mostra cada ecrã, e a secção de preços da página inicial indica o que inclui cada versão.