Alta del kit por código QR

Pega en la carcasa de la sonda un código QR con la URL de ingesta para dar de alta el dispositivo en ProbeHarbor con un escaneo, sin teclear claves largas.

Primer plano de cables Ethernet Cat-5e blancos con conectores RJ45
El JSON de las sondas suele salir de la LAN por Ethernet o por un relay cercano, no directamente a internet. Foto: DiscDepotDundee.co.uk. CC BY-SA 4.0

Ruta guiada del kit

  1. Compra un ESP32 y una DS18B20 impermeable: lista de piezas (Adafruit / Amazon; ProbeHarbor no vende hardware).
  2. Crea un dispositivo push en Dashboard → Devices (con un clic; se llama «Workshop probe» por defecto).
  3. Copia o escanea el QR de ingesta (visible durante 30 minutos tras crear o rotar la clave).
  4. Flashea el firmware o apunta Home Assistant a esa URL: los sensores se importan solos con el primer POST.
  5. Define el umbral de congelación (°F) y un correo en la tarjeta de primera alerta de Devices, o abre Alerts → When to alert, y envía una prueba.
  6. Opcional: comparte un enlace en vivo con la familia (incluido en Free).

Qué codificar

Después de crear o rotar una clave push en Dashboard → Devices, el recuadro de la clave muestra un QR con la URL de ingesta completa (visible durante 30 minutos, aunque recargues la página):

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

Cualquiera que escanee el QR con el móvil verá la URL, así que guarda los dispositivos en un lugar seguro y rota las claves si se pierde una etiqueta.

Etiquetas NFC (opcional)

Graba la misma URL de ingesta HTTPS como registro NDEF URI en una pegatina NTAG213/215. Durante la configuración, basta con acercar el móvil para abrir la URL. Guarda las etiquetas con el kit: son tan sensibles como un QR impreso. Piezas y consejos de impresión: etiquetas QR y NFC del kit.

El QR en la página Devices

El QR se genera dentro de la app al crear o rotar una clave push, sin generadores de QR externos. Desde ese recuadro puedes descargar el SVG o imprimir una etiqueta sencilla (nombre del dispositivo + QR + URL). Consulta también el payload de prueba con curl en ingesta y webhooks.

Lista de puesta en marcha

¿Prefieres ver lecturas antes de flashear el firmware? Usa Try without hardware en Overview para el feed pull de demostración, explora la demo en vivo pública y luego crea un dispositivo push y escanea el QR.

La tarjeta de primeros pasos del panel sigue la creación del dispositivo, el primer POST y las alertas. Las claves de los sensores se importan solas cuando el firmware envía JSON por POST: combina el QR con claves de payload como temp1 o door1 y, si hace falta, cambia las etiquetas en Devices.

Preguntas frecuentes

¿Qué contiene el código QR de un kit?
Normalmente la URL de ingesta o el enlace profundo de alta de ese dispositivo, para que al escanearlo con el móvil se complete la configuración sin teclear claves largas.