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

Introdução

Uma válvula termostática inteligente de radiador instalada em um radiador pode ser afetada pelo calor do radiador, pelo ar frio próximo a uma janela e pela posição de instalação. Como resultado, a temperatura medida pelo sensor integrado pode ser mais alta que a temperatura ambiente real.  

Se já houver um sensor de temperatura separado instalado no cômodo, você poderá criar uma automação no Home Assistant para sincronizar a temperatura medida pelo sensor externo com a TRV. Sempre que o sensor de temperatura externo informar uma nova temperatura, o Home Assistant enviará o valor mais recente para a TRV, permitindo que o dispositivo controle o aquecimento com base em uma temperatura ambiente mais representativa.

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

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

Pré-requisitos

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

• O SONOFF TRV-ZBT foi adicionado com sucesso ao Home Assistant.
• O sensor de temperatura externo foi adicionado com sucesso ao Home Assistant e consegue informar a temperatura corretamente.
• O TRV-ZBT e o sensor de temperatura externo usam a mesma unidade de temperatura. Recomenda-se usar graus Celsius (°C) para ambos.
• Você confirmou o ID da entidade do sensor de temperatura externo, por exemplo: 

Você pode encontrar o ID da entidade acessando:

• • Ferramentas do desenvolvedor → Estados
  • Digite o nome do dispositivo do sensor de temperatura externo na caixa de pesquisa, encontre a entidade Temperatura que representa a temperatura atual e copie seu ID completo. Você usará esse ID de entidade ao configurar o acionador da automação e a ação YAML.  

Os IDs das entidades podem variar dependendo do método de integração, do nome do dispositivo e da configuração do usuário. Use o ID real da entidade de temperatura exibido em Ferramentas do desenvolvedor → Estados.  

Etapa 1: Criar uma automação

No Home Assistant, acesse: Configurações → Automações e cenas → Automações

• Clique em Criar automação no canto inferior direito e selecione Criar nova automação.
• O nome de automação recomendado é: Sincronizar a temperatura externa com o SONOFF TRV-ZBT.
• Você também pode distinguir as automações pelo nome do cômodo, por exemplo: Ssincronizar a temperatura do quarto com o TRV-ZBT

Etapa 2: Configurar o gatilho

Na seção Quando , clique em Adicionar gatilho e selecione Estado.

• Em Entidade, insira ou cole o ID da entidade de temperatura do sensor de temperatura externa encontrado anteriormente em Ferramentas do desenvolvedor → Estados e selecione a entidade correspondente nos resultados da pesquisa.
• Deixe Atributo, De e Para vazios. Isso garante que a automação seja acionada sempre que o sensor de temperatura externa informar um novo valor de temperatura.

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

Opção 1: TRV conectado ao Home Assistant via ZHA

Etapa 3: Ativar a fonte de temperatura externa

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

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

Etapa 4: Confirmar a entidade de entrada de temperatura externa

• Na página do dispositivo TRV-ZBT no Home Assistant, confirme se a seguinte entidade Número está disponível para receber a temperatura externa: Valor do sensor de temperatura externa
• Se várias entidades de temperatura com nomes semelhantes aparecerem na página do dispositivo, confirme o ID completo da entidade acessando: Ferramentas do desenvolvedor → Estados.
• Pesquise o nome do dispositivo TRV-ZBT e localize a entidade Número 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. Na próxima etapa, cole-o na caixa de pesquisa de entidades em Destino e selecione a entidade correspondente.

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

Etapa 5: Adicionar a ação para gravar a temperatura externa

• Na seção Então faça , clique em Adicionar ação, depois pesquise e selecione: Número: Definir
• Em algumas versões do Home Assistant, esta ação pode aparecer como: Definir valor do número
• Na caixa de pesquisa de entidades em Destino, cole o ID da entidade de entrada de temperatura externa do TRV-ZBT copiado na etapa anterior e selecione a entidade correspondente nos resultados da pesquisa. Por exemplo, a entidade correspondente pode ser exibida como: Valor do sensor de temperatura externa

Se vários dispositivos TRV-ZBT estiverem instalados, verifique cuidadosamente o nome do dispositivo e o cômodo 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:

action: number.set_value
target:
  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 de 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 entidade pelos IDs reais exibidos na sua instância do Home Assistant. Não copie os IDs de exemplo diretamente.

Opção 2: TRV conectado ao Home Assistant via Zigbee2MQTT (Z2M)

Etapa 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 usará a temperatura externa gravada nele para o controle da temperatura.
  • external_2 e external_3 são outras opções reservadas de fonte de temperatura externa. Se você estiver configurando apenas um sensor de temperatura externa, selecione external.

Etapa 4: Confirmar a entidade de entrada de temperatura externa

• Nas entidades do dispositivo TRV-ZBT no Home Assistant, localize a entidade Número usada para gravar a temperatura externa.
  • Em algumas versões do Z2M e do Home Assistant, essa entidade pode ser exibida simplesmente como Temperatura na página do dispositivo e pode ter o mesmo nome exibido que a entidade de temperatura-alvo do TRV. Isso é normal.
• Confirme o ID completo da entidade acessando: Ferramentas do desenvolvedor → Estados.
• Pesquise o nome do dispositivo TRV-ZBT ou o endereço IEEE e localize a entidade Número cujo ID contenha: external_temperature_input.
  • Por exemplo: number.0xa4c138a1e838ed59_external_temperature_input

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

Depois de confirmar, copie o ID completo da entidade. Na próxima etapa, cole-o na caixa de pesquisa de entidades em Destino e selecione a entidade correspondente.

Não selecione uma entidade apenas com base no nome exibido. Sempre confirme usando o ID completo da entidade.

Etapa 5: Adicionar a ação para gravar a temperatura externa

• Na seção Depois faça, clique em Adicionar ação e pesquise e selecione: Número: Definir ou Definir valor numérico
• Na caixa de pesquisa de entidades em Destino, cole o ID da entidade de entrada de temperatura externa do TRV-ZBT copiado na etapa anterior e 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.

• Digite:

action: number.set_value
target:
  entity_id: number.0xa4c138a1e838ed59_external_temperature_input
data:
  value: "{{ states('sensor.0xd44867fffe0f8731_temperature') | float }}"

Neste exemplo:

• O sensor.0xd44867fffe0f8731_temperature é o ID de entidade de 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 esses IDs de entidade pelos IDs de entidade reais exibidos na sua instância do Home Assistant.

Se você não encontrar uma entidade contendo external_temperature_input no Home Assistant, primeiro verifique se o item Temperatura externa está exposto na página do dispositivo TRV-ZBT no Z2M. Se não estiver sendo exibido, atualize o Z2M e o conversor do dispositivo e verifique novamente.

Etapa final: salve e ative a automação

• Após concluir a configuração, clique em Salvar para salvar a automação.
• Retorne à lista de automações e confirme se o interruptor ao lado da automação está ativado.
• A partir deste momento, sempre que o sensor de temperatura remoto informar uma nova temperatura, o Home Assistant a sincronizará automaticamente com o TRV-ZBT.

Verifique se a configuração foi concluída com sucesso

Siga estas etapas para confirmar se a automação está funcionando corretamente:

1. Abra a página do dispositivo do sensor de temperatura externa e anote a temperatura atual.
2. Aguarde o sensor informar uma nova leitura de temperatura. Para acelerar o teste, segure suavemente o sensor ou mova-o temporariamente para uma área com temperatura ligeiramente diferente para provocar uma alteração na leitura.
3. Abra a página do dispositivo TRV-ZBT.
4. Confirme se o TRV-ZBT foi sincronizado com sucesso e está usando a temperatura externa:

• • Verifique se o valor da entrada de temperatura externa do TRV-ZBT foi atualizado para corresponder à temperatura atual informada pelo sensor de temperatura externa.
    • ZHA: Verifique o valor do sensor de temperatura externa. O ID de entidade Number contém external_temperature_sensor_value.
    • Z2M: Verifique a entidade Number cujo ID de entidade contém external_temperature_input. Essa entidade pode ser exibida como Temperatura na página do dispositivo.
  • Confirme também se a temperatura atual exibida pelo TRV-ZBT foi atualizada para o valor da temperatura externa. Você pode verificar a temperatura exibida em Atualmente no cartão do termostato.

5. Retorne à página da automação e confirme se Última execução exibe um horário de execução recente.

Você 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 gravada com sucesso no TRV-ZBT.