Como configurar o SONOFF TRV com um sensor externo no Home Assistant

Introdução

Uma válvula termostática inteligente instalada num radiador pode ser afetada pelo calor do radiador, pelo ar frio junto a uma janela e pela sua posição de instalação. Consequentemente, a temperatura medida pelo sensor incorporado pode ser superior à temperatura ambiente real.  

Se já estiver instalado um sensor de temperatura separado na divisão, pode criar uma automação no Home Assistant para sincronizar a temperatura medida pelo sensor externo com o TRV. Sempre que o sensor de temperatura externo comunicar uma nova temperatura, o Home Assistant escreve o valor mais recente no TRV, permitindo que o dispositivo controle o aquecimento com base numa temperatura ambiente mais representativa.

• Este tutorial utiliza o SONOFF TRV-ZBT como exemplo. O TRVZB de primeira geração também pode ser configurado seguindo este tutorial.
• O SONOFF SNZB-02DR2 é utilizado como sensor de temperatura externo. Outros sensores que consigam comunicar corretamente a temperatura no Home Assistant podem ser configurados da mesma forma.   

Selecione o método ZHA ou Zigbee2MQTT (Z2M) abaixo, de acordo com a forma como a válvula termostática do radiador está ligada.

Pré-requisitos

Antes de começar, certifique-se de que:

• O SONOFF TRV-ZBT foi adicionado com êxito ao Home Assistant.
• O sensor de temperatura externo foi adicionado com êxito ao Home Assistant e consegue comunicar corretamente a temperatura.
• O TRV-ZBT e o sensor de temperatura externo utilizam a mesma unidade de temperatura. Recomenda-se utilizar graus Celsius (°C) em ambos.
• Confirmou o ID da entidade do sensor de temperatura externo, por exemplo: 

Pode encontrar o ID da entidade acedendo a:

• • Ferramentas de desenvolvimento → Estados
  • Introduza o nome do dispositivo do sensor de temperatura externo na caixa de pesquisa, localize a entidade Temperatura que representa a temperatura atual e copie o respetivo ID completo. Utilizará este ID da entidade ao configurar o acionador da automação e a ação YAML.  

Os IDs das entidades podem variar consoante o método de integração, o nome do dispositivo e a configuração do utilizador. Utilize o ID real da entidade de temperatura apresentado em Ferramentas de desenvolvimento → Estados.  

Passo 1: Criar uma automação

No Home Assistant, aceda a: Definições → Automações e cenas → Automações

• Clique em Criar automação no canto inferior direito e, em seguida, selecione Criar nova automação.
• O nome de automação recomendado é: Sincronizar a temperatura remota com o SONOFF TRV-ZBT.
• Também pode distinguir as automações pelo nome da divisão, por exemplo: Ssincronizar a temperatura do quarto com o TRV-ZBT

Passo 2: Configurar o acionador

Na secção Quando , clique em Adicionar acionador e, em seguida, selecione Estado.

• Em Entidade, introduza ou cole o ID da entidade de temperatura do sensor de temperatura externa que encontrou anteriormente em Ferramentas de programador → Estados e, em seguida, selecione a entidade correspondente nos resultados da pesquisa.
• Deixe Atributo, De e Para vazios. Isto garante que a automação é acionada sempre que o sensor de temperatura externa comunicar um novo valor de temperatura.

Recomenda-se monitorizar apenas as alterações da entidade de temperatura. Não selecione o nível da bateria, a intensidade do sinal nem outros atributos, pois isso pode desencadear ações de sincronização desnecessárias.

Opção 1: TRV ligado ao Home Assistant através do ZHA

Passo 3: Ativar a fonte de temperatura externa

Abra a página do dispositivo TRV-ZBT e confirme que:

• O sensor de temperatura externa está ativado ou selecionado como fonte da temperatura externa.
• A entidade de valor do sensor de temperatura externa está disponível na página.

Passo 4: Confirmar a entidade de entrada de temperatura externa

• Na página do dispositivo TRV-ZBT no Home Assistant, confirme se está disponível a seguinte entidade Number para receber a temperatura externa: Valor do sensor de temperatura externa
• Se aparecerem várias entidades de temperatura com nomes semelhantes na página do dispositivo, confirme o ID completo da entidade acedendo a: Ferramentas de programador → Estados.
• Procure o nome do dispositivo TRV-ZBT e localize a entidade Number correspondente. O ID da entidade geralmente contém: external_temperature_sensor_value
  • Por exemplo: number.sonoff_trv_zbt_external_temperature_sensor_value
• Copie o ID completo da entidade. No passo seguinte, cole-o na caixa de pesquisa de entidades em Destino e, em seguida, selecione a entidade correspondente.

Dica: Verifique sempre o ID completo da entidade para evitar selecionar acidentalmente a entidade da temperatura-alvo ou da temperatura local do TRV.

Passo 5: Adicionar a ação para escrever a temperatura externa

• Na secção Depois fazer , clique em Adicionar ação, procure e selecione: Número: Definir
• Em algumas versões do Home Assistant, esta ação pode aparecer como: Definir valor numérico
• Na caixa de pesquisa de entidades em Destino, cole o ID da entidade de entrada da temperatura externa do TRV-ZBT copiado no passo anterior e, em seguida, selecione a entidade correspondente nos resultados da pesquisa. Por exemplo, a entidade correspondente pode ser apresentada como: Valor do sensor de temperatura externa

Se estiverem instalados vários dispositivos TRV-ZBT, verifique cuidadosamente o nome do dispositivo e a divisão para evitar sincronizar a temperatura com a válvula termostática errada.

• Em seguida, clique no menu de três pontos no canto superior direito da ação e selecione Editar em YAML.

Altere o conteúdo da ação para:

ação: number.set_value
alvo:
  entity_id: number.sonoff_trv_zbt_external_temperature_sensor_value
data:
  value: "{{ states('sensor.sonoff_snzb_02dr2_temperature') | float }}"

Neste exemplo:

• sensor.sonoff_snzb_02dr2_temperature é o ID de entidade da temperatura do sensor de temperatura externa.
• number.sonoff_trv_zbt_external_temperature_sensor_value é o ID da entidade do valor da temperatura externa do TRV-ZBT.

Dica: Substitua estes IDs de entidades pelos IDs reais apresentados na sua instância do Home Assistant. Não copie diretamente os IDs de exemplo.

Opção 2: TRV ligado ao Home Assistant através do Zigbee2MQTT (Z2M)

Passo 3: Selecionar a fonte de temperatura externa

• Abra a página do dispositivo TRV-ZBT no Home Assistant.
• Localize o sensor de temperatura e defina-o como: external
  • external significa que o TRV utilizará, para o controlo da temperatura, a temperatura externa que lhe for escrita.
  • external_2 e external_3 são outras opções reservadas de fontes de temperatura externa. Se estiver a configurar apenas um sensor de temperatura externa, selecione external.

Passo 4: Confirmar a entidade de entrada de temperatura externa

• Nas entidades do dispositivo TRV-ZBT no Home Assistant, localize a entidade Número utilizada para escrever a temperatura externa.
  • Em algumas versões do Z2M e do Home Assistant, esta entidade pode ser apresentada simplesmente como Temperatura na página do dispositivo e pode ter o mesmo nome apresentado que a entidade de temperatura-alvo do TRV. Isto é normal.
• Confirme o ID completo da entidade acedendo a: Ferramentas de programador → Estados.
• Pesquise o nome do dispositivo TRV-ZBT ou o endereço IEEE e, em seguida, localize a entidade Número cujo ID contenha: external_temperature_input.
  • Por exemplo: number.0xa4c138a1e838ed59_external_temperature_input

Mesmo que a entidade seja apresentada como Temperatura na página do dispositivo, é a entidade correta para receber a temperatura externa, desde que o ID completo da entidade contenha 'external_temperature_input'.

Depois de confirmar, copie o ID completo da entidade. No passo seguinte, cole-o na caixa de pesquisa de entidades em Destino e, em seguida, selecione a entidade correspondente.

Não selecione uma entidade apenas com base no nome apresentado. Confirme-a sempre utilizando o ID completo da entidade.

Passo 5: Adicionar a ação para escrever a temperatura externa

• Na secção Em seguida, fazer, clique em Adicionar ação e, em seguida, pesquise e selecione: Número: Definir, ou Definir valor do número
• Na caixa de pesquisa de entidades, em Destino, cole o ID da entidade de entrada de temperatura externa TRV-ZBT copiado no passo anterior e, em seguida, selecione a entidade correspondente nos resultados da pesquisa.
• Em seguida, clique no menu de três pontos no canto superior direito da ação e selecione Editar em YAML.

• Introduza:

ação: number.set_value
alvo:
  entity_id: number.0xa4c138a1e838ed59_external_temperature_input
data:
  valor: "{{ states('sensor.0xd44867fffe0f8731_temperature') | float }}"

Neste exemplo:

• O sensor.0xd44867fffe0f8731_temperature é o ID de entidade da temperatura do sensor de temperatura externa.
• O number.0xa4c138a1e838ed59_external_temperature_input é o ID de entidade da entrada de temperatura externa do TRV-ZBT.

Substitua estes IDs de entidade pelos IDs de entidade reais apresentados na sua instância do Home Assistant.

Se não conseguir encontrar uma entidade que contenha external_temperature_input no Home Assistant, verifique primeiro se o item Temperatura externa está exposto na página do dispositivo TRV-ZBT no Z2M. Se não for apresentado, atualize o Z2M e o conversor do dispositivo e verifique novamente.

Passo final: guardar e ativar a automação

• Depois de concluir a configuração, clique em Guardar para guardar a automação.
• Volte à lista de automações e confirme que o interruptor junto à automação está ativado.
• A partir deste momento, sempre que o sensor de temperatura remoto comunicar uma nova temperatura, o Home Assistant sincronizá-la-á automaticamente com o TRV-ZBT.

Verificar se a configuração foi bem-sucedida

Siga estes passos para confirmar que a automação está a funcionar corretamente:

1. Abra a página do dispositivo do sensor de temperatura externa e registe a temperatura atual.
2. Aguarde que o sensor comunique uma nova leitura de temperatura. Para acelerar o teste, segure suavemente no sensor ou mova-o temporariamente para uma área com uma temperatura ligeiramente diferente, de modo a provocar uma alteração na leitura.
3. Abra a página do dispositivo TRV-ZBT.
4. Confirme que o TRV-ZBT foi sincronizado com êxito e está a utilizar a temperatura externa:

• • Verifique se o valor da entrada de temperatura externa do TRV-ZBT foi atualizado para corresponder à temperatura atual comunicada pelo sensor de temperatura externa.
    • ZHA: Verifique Valor do sensor de temperatura externa. O respetivo ID de entidade Number contém external_temperature_sensor_value.
    • Z2M: Verifique a entidade Number cujo ID de entidade contém external_temperature_input. Esta entidade pode ser apresentada como Temperatura na página do dispositivo.
  • Confirme também que a temperatura atual apresentada pelo TRV-ZBT foi atualizada para o valor da temperatura externa. Pode verificar a temperatura Atualmente apresentada no cartão do termóstato.

5. Volte à página da automação e confirme que Último acionamento apresenta uma hora de execução recente.

Também pode abrir a automação, clicar no menu de três pontos no canto superior direito da ação e selecionar Executar ação para testar manualmente se a temperatura pode ser escrita com êxito no TRV-ZBT.