Mise en service du kit par QR code

Collez sur le boîtier un QR code contenant l’URL d’ingestion pour ajouter l’appareil à ProbeHarbor en un scan, sans saisir de longues clés.

Gros plan de câbles Ethernet Cat-5e blancs avec connecteurs RJ45
Le JSON des sondes quitte généralement le LAN par Ethernet ou via un relais proche, pas directement par Internet. Photo : DiscDepotDundee.co.uk. CC BY-SA 4.0

Parcours guidé du kit

  1. Achetez un ESP32 et une DS18B20 étanche : liste des pièces (Adafruit / Amazon ; ProbeHarbor ne vend pas de matériel).
  2. Créez un appareil push dans Dashboard → Devices (en un clic ; nommé « Workshop probe » par défaut).
  3. Copiez ou scannez le QR d’ingestion (visible 30 minutes après création ou rotation).
  4. Flashez le firmware ou pointez Home Assistant vers cette URL : les capteurs s’importent automatiquement au premier POST.
  5. Définissez le seuil de gel (°F) et un e-mail dans la carte de première alerte de Devices, ou ouvrez Alerts → When to alert, puis envoyez un test.
  6. Facultatif : partagez un lien en direct avec la famille (inclus dans Free).

Ce qu’il faut encoder

Après avoir créé ou renouvelé une clé push dans Dashboard → Devices, l’encadré de la clé affiche un QR contenant l’URL d’ingestion complète (visible 30 minutes, même après actualisation) :

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

Toute personne qui scanne le QR avec un téléphone voit l’URL : gardez les appareils en lieu sûr et renouvelez les clés si une étiquette est perdue.

Étiquettes NFC (facultatif)

Écrivez la même URL d’ingestion HTTPS sous forme d’enregistrement NDEF URI sur un autocollant NTAG213/215. Pendant l’installation, il suffit d’approcher le téléphone pour ouvrir l’URL. Gardez les étiquettes avec le kit : elles sont aussi sensibles qu’un QR imprimé. Pièces et conseils d’impression : étiquettes QR et NFC du kit.

Le QR dans la page Devices

Le QR est généré dans l’application quand vous créez ou renouvelez une clé push, sans générateur de QR externe. Depuis cet encadré, vous pouvez télécharger le SVG ou imprimer une étiquette simple (nom de l’appareil + QR + URL). Voir aussi le payload de test curl dans ingestion et webhooks.

Check-list de démarrage

Vous préférez voir des mesures avant de flasher le firmware ? Utilisez Try without hardware dans Overview pour le flux pull de démonstration, parcourez la démo en direct publique, puis créez un appareil push et scannez le QR.

La carte de démarrage du tableau de bord suit la création de l’appareil, le premier POST et les alertes. Les clés des capteurs s’importent automatiquement quand le firmware envoie du JSON en POST : associez le QR à des clés de payload comme temp1 ou door1, puis renommez les libellés dans Devices si besoin.

FAQ

Que contient le QR code d’un kit ?
En général, l’URL d’ingestion ou le lien profond d’activation de cet appareil, pour qu’un scan au téléphone termine la configuration sans saisir de longues clés.