Blog

Envie o ritmo cardíaco, os passos, o sono e a bateria do seu Amazfit para o Home Assistant (e 10 automações)

O seu Amazfit já sabe quando adormece, quantos passos deu e quanta bateria lhe resta. Eis como pôr tudo isso no Home Assistant como sensores comuns, e o que automatizar com eles.

Publicado 19 min de leitura

Neste artigo
  1. A resposta curta
  2. O que chega ao Home Assistant
    1. Unidades, classes e estatísticas de longo prazo
    2. Leituras que ficam de fora
    3. Os ids das entidades
  3. Como funciona: o relógio torna-se um dispositivo Mobile App
  4. Ativá-lo, passo a passo
  5. Atualizações em segundo plano: a cada 1 a 6 minutos
    1. Conceder a permissão
    2. O que mais convém saber
  6. Porque é que os sensores do relógio não aparecem
  7. Dez automações
    1. 1. Bateria do relógio fraca
    2. 2. Carregue-o antes de dormir
    3. 3. A dormir: luzes desligadas, aquecimento mais baixo
    4. 4. Acordado: a rotina da manhã
    5. 5. Carregado e esquecido no carregador
    6. 6. Ritmo cardíaco em repouso acima do habitual
    7. 7. Objetivo de passos atingido
    8. 8. Um empurrão para a caminhada ao fim do dia
    9. 9. Relatório do sono pela manhã
    10. 10. Fim de dia stressante: luzes mais calmas
    11. Uma nota sobre os tempos
  8. Ideias para painéis
  9. O que não é
  10. Perguntas frequentes

O AmazHA, uma app Home Assistant para relógios Amazfit, funciona sobretudo num sentido: as suas luzes, estores e termóstatos no pulso. A sua função Sensores do relógio funciona no sentido inverso. O relógio lê os seus próprios dados, dos passos ao estado do sono e à bateria, e envia-os para o Home Assistant como entidades sensor que pode pôr num gráfico, mostrar num painel e usar em automações.

A seguir: o que é enviado, como lá chega, como o ativar, porque é que faltam sensores e dez automações prontas a colar.

A resposta curta

Com o AmazHA, um relógio Amazfit pode enviar até 18 leituras para o Home Assistant: passos, distância, calorias, ritmo cardíaco, ritmo cardíaco em repouso, oxigénio no sangue, stress, pontuação do sono, duração do sono, um estado a dormir/acordado em tempo real, estado de uso, pressão atmosférica, bateria e mais. Chegam através da integração Mobile App do Home Assistant como sensor.<prefix>_<key>, em cada abertura da app e depois a cada 1 a 6 minutos em segundo plano.

O que chega ao Home Assistant

Dezoito sensores, em quatro grupos, cada um ativado separadamente. Esta é a lista completa, com a chave que termina o id da entidade e o estado que vai ver no Home Assistant:

Chave Unidade O que é Estado de exemplo
steps passos Passos contados hoje 6412
distance m Distância percorrida hoje 4870
calories kcal Calorias queimadas hoje 1834
stand h Horas em pé hoje 7
fat_burning min Minutos intensivos hoje 22
pai — Pontuação PAI 68
heart_rate bpm A última leitura de ritmo cardíaco do relógio 71
resting_heart_rate bpm Ritmo cardíaco em repouso 58
spo2 % Última medição do oxigénio no sangue 97
stress — Valor atual do stress 34
body_temperature °C Temperatura corporal, uma casa decimal 36.4
sleep_score — Pontuação do último sono 81
sleep_duration min Duração do último sono 452
sleep_state — Se está a dormir agora ou não asleep / awake
pressure hPa Pressão atmosférica, uma casa decimal 1013.2
altitude m Altitude a partir do barómetro 212
battery % A bateria do próprio relógio 64
wear — Se o relógio está num pulso not_worn / worn / in_motion / unknown

Nas definições do AmazHA estão agrupados em Atividade, Saúde, Ambiente e Dispositivo, com os nomes Passos, Distância, Calorias, Horas em pé, Minutos intensivos, PAI, Ritmo cardíaco, Ritmo cardíaco em repouso, Oxigénio no sangue (SpO2), Stress, Temperatura corporal, Pontuação do sono, Duração do sono, Estado do sono, Pressão atmosférica, Altitude, Bateria do relógio e Estado de uso.

Unidades, classes e estatísticas de longo prazo

Os sensores trazem os metadados do Home Assistant, por isso comportam-se como qualquer outro sensor. A bateria tem a classe de dispositivo battery, por isso recebe o ícone de bateria e encaixa num manómetro. A distância e a altitude são distance, a pressão atmosférica é atmospheric_pressure, a temperatura corporal é temperature, os minutos intensivos e a duração do sono são duration. Cada sensor tem o seu próprio ícone.

Os contadores diários (passos, distância, calorias, horas em pé, minutos intensivos) usam a classe de estado total_increasing: voltam a zero quando o relógio começa um novo dia, e o Home Assistant lê isso como uma reposição, não como uma descida. Os indicadores (ritmo cardíaco, bateria, pressão e os restantes) usam measurement. Em qualquer caso, o Home Assistant guarda estatísticas de longo prazo para eles, por isso um gráfico de estatísticas dos seus passos funciona sem configuração extra.

sleep_state e wear são estados de texto, sem unidade nem classe. Use-os em acionadores e condições de estado.

Leituras que ficam de fora

O relógio só envia um sensor quando tem uma leitura válida. Não envia um zero nem um valor fictício em vez dela:

  • O ritmo cardíaco, o ritmo cardíaco em repouso, o stress, a pontuação do sono e a duração do sono ficam de fora enquanto o relógio indicar 0, o que significa que ainda não mediu. Quando o relógio não tem dados de sono novos, os sensores de sono mantêm o último valor.
  • O oxigénio no sangue é uma medição, não um sinal contínuo. O AmazHA envia a mais recente que encontrar: uma acabada de fazer, as amostras das últimas duas horas ou o último valor válido com até 24 horas. Por isso, spo2 é «a última medição», não «agora mesmo».
  • A temperatura corporal só é enviada nos relógios que têm esse sensor, e só depois de ter dados.
  • A pressão atmosférica e a altitude só são enviadas nos relógios com barómetro.
  • O estado do sono só é enviado quando o relógio diz a dormir ou acordado.

Quando uma leitura fica de fora, o Home Assistant mantém o último valor que tinha. Isso importa nas automações: um sensor que não mudou pode simplesmente não ter sido atualizado.

Os ids das entidades

Cada entidade é sensor.<prefix>_<key>. O prefixo é o que escrever em Prefixo das entidades (opcional); se ficar vazio, é o nome do seu relógio adaptado a um id de entidade, por isso um «Amazfit GTS 4» dá sensor.amazfit_gts_4_steps, sensor.amazfit_gts_4_battery e assim por diante. O ecrã Sensores do relógio mostra o id exato, com a unidade, por baixo de cada sensor, por isso nunca tem de adivinhar.

O prefixo fica fixado da primeira vez que o relógio envia os seus dados. Mudar mais tarde o nome do relógio não mexe nas suas entidades. Mudar você mesmo o prefixo mexe: regista um segundo dispositivo com ids de entidade novos, e o dispositivo antigo fica no Home Assistant até o apagar. Escolha o prefixo antes de construir automações com base nele.

Como funciona: o relógio torna-se um dispositivo Mobile App

O relógio regista-se na integração Mobile App do Home Assistant, a mesma que a app Companion do próprio Home Assistant usa. O seu relógio torna-se um dispositivo, as suas leituras tornam-se sensores desse dispositivo, e não é preciso instalar nada no HACS nem escrever nada em configuration.yaml.

O que acontece, passo a passo:

  1. O relógio lê os sensores que ativou e envia-os para o telemóvel por Bluetooth.
  2. A parte do AmazHA no telemóvel, que corre dentro da app Zepp, regista o relógio uma vez na integração Mobile App do Home Assistant. O dispositivo aparece com a Amazfit como fabricante.
  3. Cada sensor é registado uma vez, com a sua unidade, classe e ícone. Depois disso, cada atualização é uma única chamada agrupada para todos os sensores.

Como são entidades reais no registo do Home Assistant, com um id único, pode mudar-lhes o nome, mudar-lhes o ícone, ocultá-las ou pô-las numa área a partir da interface do Home Assistant. Mantêm-se depois dos reinícios do Home Assistant. Se apagar o dispositivo no Home Assistant, o AmazHA regista-o de novo no envio seguinte.

A integração Mobile App faz parte da configuração predefinida do Home Assistant, por isso quase todas as instalações já a têm. Se a sua não a carregar, o AmazHA passa a escrever os estados diretamente, o que funciona, mas dá entidades que o Home Assistant não consegue gerir a partir da sua interface e que desaparecem quando ele reinicia. Se for o seu caso, acrescente mobile_app: à sua configuração.

O relógio nunca fala diretamente com o Home Assistant. Quem fala é o telemóvel, usando os mesmos endereços que o resto do AmazHA: o endereço local em casa, o endereço remoto quando está fora. Se só definir um endereço local, as atualizações enviadas enquanto está fora não conseguem chegar ao Home Assistant. O acesso remoto para o seu relógio explica as opções.

Ativá-lo, passo a passo

Precisa primeiro da versão completa e de uma ligação ao Home Assistant que funcione. Depois, demora um minuto, como se mostra no tutorial 9, Sensores do relógio:

  1. Abra Sensores do relógio. Nas definições do AmazHA (na app Zepp: Perfil › o seu relógio › Apps › AmazHA › Definições), toque em Sensores do relógio. Passo 1.
  2. Ative a função. Ative Enviar para o Home Assistant. Passo 2.
  3. Dê-lhe um nome, se quiser. Prefixo das entidades (opcional) dá o nome sensor.<prefix>_… a todas as entidades. Se ficar vazio, usa o nome do seu relógio. Passo 3.
  4. Defina a frequência. Atualizar a cada define o intervalo em segundo plano, de 1 a 6 minutos. Passo 4.
  5. Escolha os sensores. Ative os que quiser. Todos começam desativados. Passo 5.
  6. Abra o AmazHA no relógio. O relógio envia as primeiras leituras e pede a Atividade em segundo plano. Permita-a. Passo 6.
  7. Encontre-o no Home Assistant. Vá a Configuração › Dispositivos & serviços › Mobile App e abra o seu relógio. Passo 7.

Se o ecrã Sensores do relógio mostrar em vez disso um cartão de desbloqueio, a versão completa ainda não está ativa: veja desbloquear a versão completa. Se disser Ligue-se primeiro ao Home Assistant, configure a ligação como em Ligar o Home Assistant.

Quando os dados tiverem chegado, o ecrã Sensores do relógio mostra uma linha como 6 sensores enviados · 14:05, com · segundo plano no fim quando vieram de uma atualização em segundo plano. Essa linha é a forma mais rápida de confirmar que tudo funciona.

Atualizações em segundo plano: a cada 1 a 6 minutos

O relógio envia os seus sensores em cada abertura da app e depois em segundo plano, ao intervalo que escolheu, desde que a permissão Atividade em segundo plano esteja concedida. Sem a permissão, os sensores só atualizam quando abre o AmazHA.

Quando Precisa de
Ao abrir a app Sempre que abre o AmazHA no relógio Nada além da configuração
Com a app aberta Ao seu intervalo Nada além da configuração
Em segundo plano Ao seu intervalo, 1 a 6 min (5 por predefinição), com a app fechada Atividade em segundo plano permitida no relógio

Todos precisam do telemóvel por perto, com o Bluetooth ligado e a app Zepp a correr, porque é o telemóvel que envia os dados para o Home Assistant.

Conceder a permissão

Num relógio com o AmazHA instalado a partir da Zepp App Store, o relógio pede a Atividade em segundo plano da próxima vez que abrir o AmazHA depois de ativar a função. Pede uma vez. Se recusou, ou se o pedido nunca apareceu, tem duas formas de voltar atrás:

  • Conceda-a nas definições do próprio relógio: Permissões de apps (ou Privacidade, consoante o relógio), depois AmazHA, e depois permita a atividade em segundo plano.
  • Ou desative e volte a ativar Enviar para o Home Assistant nas definições do AmazHA, e depois abra o AmazHA no relógio: volta a perguntar.

O que mais convém saber

  • As alterações chegam ao segundo plano na abertura seguinte da app. Se ativar ou desativar um sensor, ou mudar Atualizar a cada, abra o AmazHA no relógio uma vez. As atualizações em segundo plano mantêm a seleção antiga até lá.
  • A poupança de bateria interrompe as atualizações em segundo plano. Enquanto o relógio está no modo de poupança de bateria, não corre tarefas em segundo plano, por isso os sensores fazem uma pausa; abrir o AmazHA depois disso retoma-os de imediato.
  • Um reinício do relógio não é o fim. Depois de um reinício curto, as atualizações em segundo plano voltam sozinhas, normalmente dentro de uma hora. Abrir o AmazHA retoma-as de imediato.

Porque é que os sensores do relógio não aparecem

Quando faltam sensores, a causa é quase sempre um dos pontos abaixo. Verifique-os por esta ordem:

  1. Enviar para o Home Assistant está desativado. O menu das definições mostra Sensores do relógio como Ligado ou Desligado. Tem de estar Ligado.
  2. Os sensores individuais estão desativados. Todos os sensores começam desativados. O ecrã Sensores do relógio mostra quantos envia, por exemplo «6 de 18 sensores enviados para o HA».
  3. Ainda não abriu o AmazHA no relógio desde então. Os primeiros dados são enviados pelo relógio quando abre a app. Abra-a uma vez depois de mudar o que quer que seja.
  4. A versão completa não está ativa. Sem a licença, o ecrã mostra um cartão de desbloqueio e nada é enviado.
  5. O Home Assistant não está ligado. O ecrã diz Ligue-se primeiro ao Home Assistant. Corrija a ligação: tutorial 4 e, para os erros, Quando algo corre mal.
  6. O sensor ainda não tem uma leitura válida. O oxigénio no sangue, o stress e a temperatura corporal só aparecem depois de uma medição; a pressão e a altitude só nos relógios com barómetro. Se a linha de estado disser Nenhum sensor ativado, nenhum dos sensores que ativou tinha uma leitura para enviar.
  7. Só atualiza quando abre a app. É a permissão Atividade em segundo plano: veja acima.
  8. Está a procurar no sítio errado. Os sensores pertencem a um dispositivo em Configuração › Dispositivos & serviços › Mobile App, com o nome do seu prefixo. Também pode pesquisar o prefixo no separador Entidades de Configuração › Dispositivos & serviços.
  9. O telemóvel não consegue chegar ao Home Assistant. Fora de casa, o telemóvel precisa de um endereço remoto. Abra o endereço do seu Home Assistant no browser do telemóvel: se falhar aí, falha também para os sensores. O passo 3 do tutorial de resolução de problemas trata disso.
  10. Os valores parecem congelados. Veja a hora na linha de estado. Se for antiga, o telemóvel ou o relógio não enviaram nada desde então: telemóvel fora de alcance, app Zepp fechada, poupança de bateria ativa ou falta da permissão.

Dez automações

As dez automações abaixo cobrem os pedidos que surgem uma e outra vez: bateria fraca, adormecer, acordar, o relógio esquecido no carregador, objetivos de atividade. Usam a sintaxe atual do Home Assistant e podem ser coladas tal como estão.

Para acrescentar uma: Configuração › Automações e cenas › Criar automação › Criar nova automação, depois o menu de três pontos, Editar em YAML, e cole.

Todos os ids de entidade aqui são exemplos. Os sensores do relógio usam o prefixo amazfit_gts_4; substitua-o pelo seu. notify.mobile_app_your_phone é a ação de notificação de um telemóvel com a app Companion do Home Assistant; encontre a sua em Ferramentas de programador › Ações escrevendo «notify». As luzes, os estores, as cenas e a entidade pessoa são marcadores para os seus próprios. Os limiares são pontos de partida: veja uma semana de histórico antes de fixar os seus.

1. Bateria do relógio fraca

Uma notificação quando o relógio desce abaixo dos 15 %.

alias: Bateria do relógio fraca
description: Notificar quando a bateria do relógio desce abaixo dos 15 %
triggers:
  - trigger: numeric_state
    entity_id: sensor.amazfit_gts_4_battery
    below: 15
actions:
  - action: notify.mobile_app_your_phone
    data:
      title: Bateria do relógio fraca
      message: "O seu relógio está a {{ states('sensor.amazfit_gts_4_battery') }} %."
mode: single

Um acionador numeric_state dispara quando o valor atravessa a linha, não em cada atualização abaixo dela, por isso notifica-o uma vez por descarga.

2. Carregue-o antes de dormir

Se quer o registo do sono, o relógio tem de aguentar a noite. Um lembrete ao fim do dia quando não vai aguentar:

alias: Carregar o relógio antes de dormir
triggers:
  - trigger: time
    at: "21:30:00"
conditions:
  - condition: numeric_state
    entity_id: sensor.amazfit_gts_4_battery
    below: 30
actions:
  - action: notify.mobile_app_your_phone
    data:
      message: "Relógio a {{ states('sensor.amazfit_gts_4_battery') }} %: carregue-o já para registar o sono desta noite."
mode: single

3. A dormir: luzes desligadas, aquecimento mais baixo

Quando o relógio diz que está a dormir, e o diz há dez minutos, desligue as luzes da sala e baixe o termóstato do quarto.

alias: A dormir - luzes desligadas
triggers:
  - trigger: state
    entity_id: sensor.amazfit_gts_4_sleep_state
    to: "asleep"
    for:
      minutes: 10
conditions:
  - condition: time
    after: "21:00:00"
    before: "04:00:00"
actions:
  - action: light.turn_off
    target:
      area_id: living_room
  - action: climate.set_temperature
    target:
      entity_id: climate.bedroom
    data:
      temperature: 18
mode: single

A janela horária evita que uma sesta à tarde desligue a casa; uma janela que atravessa a meia-noite não é problema numa condição de tempo. Os dez minutos de for: filtram uma breve soneca no sofá. Tenha em conta que o estado só chega ao Home Assistant na atualização seguinte, por isso o atraso real é o seu intervalo mais o for:.

4. Acordado: a rotina da manhã

Quando acorda numa manhã de dia útil, abra os estores do quarto, ligue a luz da cozinha e ponha a máquina do café a trabalhar, uma vez por dia.

alias: Acordado - rotina da manhã
triggers:
  - trigger: state
    entity_id: sensor.amazfit_gts_4_sleep_state
    from: "asleep"
    to: "awake"
    for:
      minutes: 5
conditions:
  - condition: time
    after: "05:30:00"
    before: "10:30:00"
    weekday:
      - mon
      - tue
      - wed
      - thu
      - fri
  - condition: template
    value_template: >-
      {{ this.attributes.last_triggered is none
         or this.attributes.last_triggered < today_at() }}
actions:
  - action: cover.open_cover
    target:
      entity_id: cover.bedroom_blinds
  - action: light.turn_on
    target:
      entity_id: light.kitchen
    data:
      brightness_pct: 60
  - action: switch.turn_on
    target:
      entity_id: switch.coffee_machine
mode: single

from: "asleep" é importante: só conta uma mudança real de a dormir para acordado, e não o sensor a regressar de unknown ou unavailable, o que de outra forma poderia começar a sua manhã às 3 da madrugada. A condição de template só a deixa correr uma vez por dia, por isso acordar às 6, voltar a adormecer e acordar de novo às 7 abre os estores uma vez.

5. Carregado e esquecido no carregador

O relógio está cheio, mas continua fora do pulso: um lembrete para o voltar a pôr.

alias: Relógio carregado, volte a pô-lo
triggers:
  - trigger: state
    entity_id: sensor.amazfit_gts_4_wear
    to: "not_worn"
    for:
      minutes: 45
conditions:
  - condition: numeric_state
    entity_id: sensor.amazfit_gts_4_battery
    above: 90
  - condition: time
    after: "07:00:00"
    before: "22:00:00"
actions:
  - action: notify.mobile_app_your_phone
    data:
      message: O seu relógio está carregado e está fora do pulso há 45 minutos.
mode: single

Fora do pulso com a bateria alta normalmente significa que está no carregador ou na secretária. Repare que unknown também é um valor válido de wear: o relógio não tinha a certeza. No Home Assistant parece exatamente o «unknown» de um sensor sem dados, por isso nunca acione com base nele.

6. Ritmo cardíaco em repouso acima do habitual

Um aviso discreto quando o seu ritmo cardíaco em repouso se mantém acima do seu intervalo normal. É um lembrete para verificar como se sente, não um alerta médico.

alias: Ritmo cardíaco em repouso acima do habitual
triggers:
  - trigger: numeric_state
    entity_id: sensor.amazfit_gts_4_resting_heart_rate
    above: 80
    for:
      hours: 1
actions:
  - action: notify.mobile_app_your_phone
    data:
      message: "Ritmo cardíaco em repouso de {{ states('sensor.amazfit_gts_4_resting_heart_rate') }} bpm, acima do habitual."
mode: single

Defina o limiar a partir do seu próprio histórico: abra o sensor no Home Assistant e veja algumas semanas. Um valor 10 a 15 bpm acima do seu ritmo em repouso habitual é um ponto de partida razoável.

7. Objetivo de passos atingido

Uma notificação no momento em que passa os 10 000 passos.

alias: Objetivo de passos atingido
triggers:
  - trigger: numeric_state
    entity_id: sensor.amazfit_gts_4_steps
    above: 9999
actions:
  - action: notify.mobile_app_your_phone
    data:
      message: "10 000 passos hoje. Bom trabalho."
mode: single

above é estritamente maior do que, daí o 9999. Os passos voltam a zero quando o relógio começa um novo dia, por isso o acionador fica pronto outra vez no dia seguinte.

8. Um empurrão para a caminhada ao fim do dia

Às 18:30, se tiver o relógio posto e ainda estiver abaixo dos 5000 passos, uma sugestão para ir dar uma volta.

alias: Empurrão para a caminhada ao fim do dia
triggers:
  - trigger: time
    at: "18:30:00"
conditions:
  - condition: numeric_state
    entity_id: sensor.amazfit_gts_4_steps
    below: 5000
  - condition: state
    entity_id: sensor.amazfit_gts_4_wear
    state:
      - worn
      - in_motion
actions:
  - action: notify.mobile_app_your_phone
    data:
      message: "{{ states('sensor.amazfit_gts_4_steps') }} passos até agora hoje. Que tal uma caminhada?"
mode: single

A condição de uso evita incomodá-lo num dia em que o relógio ficou no carregador: a contagem baixa seria do relógio, não sua.

9. Relatório do sono pela manhã

Um pequeno resumo da noite às 9:00, em horas e minutos.

alias: Relatório do sono pela manhã
triggers:
  - trigger: time
    at: "09:00:00"
conditions:
  - condition: template
    value_template: "{{ states('sensor.amazfit_gts_4_sleep_duration') | is_number }}"
actions:
  - variables:
      mins: "{{ states('sensor.amazfit_gts_4_sleep_duration') | int(0) }}"
  - action: notify.mobile_app_your_phone
    data:
      title: A noite passada
      message: >-
        {{ mins // 60 }} h {{ mins % 60 }} min,
        pontuação do sono {{ states('sensor.amazfit_gts_4_sleep_score') }}.
mode: single

A pontuação e a duração do sono seguem o próprio resumo do sono do relógio, que o relógio atualiza ao seu próprio ritmo. Um relatório a uma hora fixa, bem depois de se levantar, é mais fiável do que um acionado no momento em que acorda.

10. Fim de dia stressante: luzes mais calmas

Quando o valor do stress se mantém alto durante um quarto de hora ao fim do dia enquanto está em casa, mude a sala para uma cena calma.

alias: Stress alto - luzes calmas
triggers:
  - trigger: numeric_state
    entity_id: sensor.amazfit_gts_4_stress
    above: 75
    for:
      minutes: 15
conditions:
  - condition: state
    entity_id: person.you
    state: "home"
  - condition: time
    after: "17:00:00"
    before: "23:00:00"
actions:
  - action: scene.turn_on
    target:
      entity_id: scene.living_room_calm
mode: single

A presença vem de person.you, não do relógio. Os 15 minutos de for: significam que o valor tem de se manter alto ao longo de várias atualizações, o que filtra um pico isolado depois de subir as escadas.

Uma nota sobre os tempos

Todas as automações acima reagem a um estado que o Home Assistant recebeu do telemóvel. Com um intervalo de 5 minutos, uma mudança no relógio pode demorar até 5 minutos a chegar, e um for: acrescenta o seu próprio tempo por cima. Escolha automações em que alguns minutos não façam diferença: as luzes depois de adormecer, sim; um alarme quando sai de casa, não.

Ideias para painéis

Os sensores do relógio são sensores normais do Home Assistant, por isso todos os cartões padrão funcionam com eles. Algumas disposições que se leem bem:

  • Um cartão do relógio no topo do painel do telemóvel: um Tile card (cartão de mosaico) para battery, wear e sleep_state, lado a lado.
  • A bateria como manómetro: um Gauge card (cartão de manómetro) em battery com cores de gravidade, por exemplo vermelho abaixo de 20 e âmbar abaixo de 40.
  • O ritmo cardíaco ao longo do dia: um History graph card (gráfico de histórico) com heart_rate e resting_heart_rate ao longo de 24 horas.
  • Passos por dia: um Statistics graph card (gráfico de estatísticas) em steps com o período diário e a estatística «change» (variação). Funciona porque os contadores diários usam a classe de estado total_increasing.
  • A noite numa linha: um Entities card (cartão de entidades) com sleep_score, sleep_duration e spo2.
  • Estação meteorológica no pulso: nos relógios com barómetro, um History graph card de pressure ao longo de dois ou três dias mostra a tendência que uma mudança de tempo traz.

A duração do sono chega em minutos. Se preferir horas no painel, acrescente um sensor de template: Configuração › Dispositivos & serviços › Auxiliares › Criar auxiliar › Template › Template a sensor (criar um sensor a partir de um template), com este template de estado e h como unidade:

{{ (states('sensor.amazfit_gts_4_sleep_duration') | float(0) / 60) | round(1) }}

O que não é

Os sensores do relógio são úteis para automações que podem esperar alguns minutos. Não substituem sensores dedicados, e convém conhecer três limites antes de contar com eles.

Não é instantâneo. As atualizações chegam em cada abertura da app e depois ao seu intervalo, de 1 a 6 minutos. Uma mudança de estado no relógio pode demorar isso a chegar ao Home Assistant, e mais quando o telemóvel está fora de alcance, a app Zepp está fechada ou a poupança de bateria está ativa. As atualizações em segundo plano dependem ainda da permissão Atividade em segundo plano.

Não é um sensor de presença. Nenhum dos 18 sensores diz onde está. wear diz se o relógio está num pulso, não de quem é o pulso nem em que casa. As atualizações precisam do telemóvel por perto, mas isso não diz nada sobre se está em casa. Use o telemóvel, uma entidade pessoa ou um sensor de divisão para a presença.

Não são dados médicos. O ritmo cardíaco, o oxigénio no sangue, o stress e a temperatura corporal vêm dos próprios sensores do relógio. Servem para tendências e lembretes discretos, não para diagnósticos nem para alarmes de que dependa a sua saúde. O oxigénio no sangue, em particular, é a última medição feita pelo relógio, que pode ter horas.

Os seus dados continuam a ser seus. As leituras vão do relógio para o telemóvel por Bluetooth, e do telemóvel para o seu próprio Home Assistant. O AmazHA não tem contas, nem estatísticas de utilização, nem um servidor próprio, e os dados de saúde nunca são enviados ao programador nem a terceiros. No Home Assistant, são guardados como qualquer outro sensor, segundo as suas definições de retenção. Todos os sensores ficam desativados até os ativar, por isso envia exatamente o que escolher. A política de privacidade tem os pormenores.

Perguntas frequentes

Preciso de instalar alguma coisa no Home Assistant ou no HACS?

Não. O relógio regista-se através da integração Mobile App do próprio Home Assistant, que a configuração predefinida já carrega. Nada a instalar a partir do HACS, nenhum YAML a acrescentar: o relógio aparece em Configuração › Dispositivos & serviços › Mobile App depois do primeiro envio.

Porque é que os sensores do relógio só atualizam quando abro o AmazHA?

As atualizações em segundo plano precisam da permissão Atividade em segundo plano no relógio. Aceite o pedido que o relógio mostra na próxima abertura, ou conceda-a à mão nas definições do próprio relógio (Permissões de apps, ou Privacidade, e depois AmazHA). Desativar e voltar a ativar Enviar para o Home Assistant faz o relógio perguntar de novo. Veja o tutorial 9, passo 6.

Com que frequência atualizam os sensores?

Sempre que abre o AmazHA no relógio e, depois, em segundo plano, ao intervalo que definir em Atualizar a cada: de 1 a 6 minutos, 5 por predefinição. Com a app aberta, continua a enviar ao mesmo intervalo. O telemóvel tem de estar por perto com a app Zepp a correr, porque é o telemóvel que fala com o Home Assistant.

Quais são os ids das entidades?

Cada sensor é sensor.<prefix>_<key>, por exemplo sensor.amazfit_gts_4_battery. O prefixo é o que escrever em Prefixo das entidades (opcional); se ficar vazio, é o nome do seu relógio. O ecrã Sensores do relógio mostra o id exato por baixo de cada sensor. Mudar o prefixo mais tarde cria um segundo dispositivo com ids novos.

Posso usar o relógio como sensor de presença?

Não. Nenhum dos 18 sensores diz onde está, e as atualizações chegam, no melhor dos casos, a cada poucos minutos. Use o telemóvel ou uma entidade pessoa para a presença, e o relógio para aquilo em que é bom: o sono, o estado de uso, a atividade e a sua própria bateria.

Funciona com a versão gratuita?

Não. Os sensores do relógio fazem parte da versão completa, tal como a ligação ao seu próprio Home Assistant. A versão gratuita é uma demo com dados de exemplo. A versão completa é um desbloqueio único, sem subscrição.

Porque é que o oxigénio no sangue, o stress ou a temperatura corporal nunca aparecem?

Cada sensor só é enviado com uma leitura válida. O oxigénio no sangue, o stress e a temperatura corporal aparecem quando o relógio os tiver realmente medido, a temperatura corporal só nos relógios com esse sensor, e a pressão atmosférica e a altitude só nos relógios com barómetro.

Para onde vão os meus dados de saúde?

Do relógio para o seu telemóvel por Bluetooth, e do telemóvel para o seu próprio Home Assistant. Nunca são enviados ao programador nem a terceiros: o AmazHA não tem contas, nem estatísticas de utilização, nem um servidor próprio. Veja a política de privacidade.

Veja em vídeo

Os tutoriais curtos em que este artigo se baseia: vídeos em inglês, cada passo escrito em português.

Todos os artigos