Configurar feeds de temperatura

Adicione URLs de feeds pull HTTPS, defina a chave raiz do JSON, nomeie as sondas e confira a Home: complemento do guia “Adicionar dispositivos”.

Close de cabos Ethernet Cat-5e brancos com conectores RJ45
O JSON das sondas normalmente sai da rede local por Ethernet ou por um relay próximo, não direto pela internet pública. Foto: DiscDepotDundee.co.uk. CC BY-SA 4.0

Os feeds por pull permitem que o ProbeHarbor busque JSON por HTTPS em um agendamento quando a sua sonda já serve uma URL pública (ou um relay com TLS). Para o passo a passo completo de push e pull que corresponde à tela Devices atual, comece por adicionando dispositivos push e pull.

Passos de configuração

  1. Confira o feed com curl: sondas aninhadas sob um objeto raiz (padrão temp).
  2. Abra a aba Dashboard → Devices → Pull feeds.
  3. Adicione a URL HTTPS e defina a JSON root key se o seu objeto não se chamar temp (por exemplo, readings).
  4. Use Test feed URL e depois Save pull setup: as chaves das sondas são importadas automaticamente.
  5. Renomeie os rótulos na mesma página ou clique em Accept suggested names.

Chave raiz do JSON

A leitura por pull procura { "<root>": { "0": { "f": …, "h": … }, … } }. A raiz padrão é temp. Chaves planas no estilo push e sensors[] tipados servem para a ingestão por push, não para o caminho padrão de pull.

SenML e Home Assistant REST

Quando a raiz configurada não existe, o ProbeHarbor detecta automaticamente SenML JSON (array RFC 8428) e JSON de sensor HA REST (state + attributes). Cole a URL HTTPS como está, sem precisar mudar a raiz do JSON. Mapeie as chaves das sondas a partir dos nomes SenML (por exemplo, 0) ou de state em feeds REST de entidade única. Experimente o exemplo SenML público ou o exemplo HA REST.

Vários feeds

Você pode adicionar várias URLs de pull (respeitando os limites do plano). Documente qual URL é de produção e qual é de demonstração. Segurança: segurança do relay. Comportamento da busca: busca das sondas na página inicial.

Solução de problemas

Uma chave raiz errada ou erros de digitação nas chaves das sondas escondem os cartões mesmo quando a URL retorna 200. Veja depurando leituras desatualizadas.