Configuração do kit por QR code

Cole na caixa da sonda um QR code com a URL de ingestão e configure o dispositivo no ProbeHarbor com um só escaneamento, sem digitar chaves longas.

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

Caminho guiado do kit

  1. Compre um ESP32 e uma DS18B20 à prova d’água: lista de peças (Adafruit / Amazon; o ProbeHarbor não vende hardware).
  2. Crie um dispositivo push em Dashboard → Devices (com um clique; o nome padrão é “Workshop probe”).
  3. Copie ou escaneie o QR de ingestão (visível por 30 minutos depois de criar ou trocar a chave).
  4. Grave o firmware ou aponte o Home Assistant para essa URL: os sensores são importados automaticamente no primeiro POST.
  5. Defina o limite de congelamento (°F) e um e-mail no cartão de primeiro alerta em Devices, ou abra Alerts → When to alert, e depois envie um teste.
  6. Opcional: compartilhe um link ao vivo com a família (incluído no Free).

O que codificar

Depois de criar ou trocar uma chave push em Dashboard → Devices, o quadro da chave mostra um QR com a URL de ingestão completa (visível por 30 minutos, mesmo se você recarregar a página):

https://your-domain/api/ingest/YOUR_DEVICE_KEY

Qualquer pessoa que escanear o QR com o celular vê a URL, então mantenha os dispositivos em local seguro e troque as chaves se uma etiqueta se perder.

Etiquetas NFC (opcional)

Grave a mesma URL de ingestão HTTPS como registro NDEF URI em um adesivo NTAG213/215. Durante a configuração, basta encostar o celular para abrir a URL. Guarde as etiquetas junto com o kit: elas são tão sensíveis quanto um QR impresso. Peças e dicas de impressão: etiquetas QR e NFC do kit.

O QR na página Devices

O QR é gerado dentro do app quando você cria ou troca uma chave push, sem precisar de geradores de QR externos. Nesse quadro, você pode baixar o SVG ou imprimir uma etiqueta simples (nome do dispositivo + QR + URL). Veja também o payload de teste com curl em ingestão e webhooks.

Checklist de primeiros passos

Prefere ver leituras antes de gravar o firmware? Use Try without hardware no Overview para o feed pull de demonstração, explore a demonstração ao vivo pública e depois crie um dispositivo push e escaneie o QR.

O cartão de primeiros passos do painel acompanha a criação do dispositivo, o primeiro POST e os alertas. As chaves dos sensores são importadas automaticamente quando o firmware envia JSON por POST: combine o QR com chaves de payload como temp1 e door1 e, se precisar, renomeie os rótulos em Devices.

Perguntas frequentes

O que o QR code de um kit contém?
Normalmente a URL de ingestão ou um deep link de onboarding desse dispositivo, para que uma leitura com o celular conclua a configuração sem digitar chaves longas.