Einrichtung per QR-Code am Kit

Einen QR-Code mit der Ingest-URL aufs Fühlergehäuse kleben und das Gerät in ProbeHarbor mit einem Scan einrichten, ohne lange Schlüssel abzutippen.

Nahaufnahme weißer Cat-5e-Ethernet-Kabel mit RJ45-Steckern
Das Fühler-JSON verlässt das LAN meist über Ethernet oder ein nahes Relay, nicht direkt übers öffentliche Internet. Foto: DiscDepotDundee.co.uk. CC BY-SA 4.0

Geführter Weg mit dem Kit

  1. Kauf einen ESP32 und einen wasserdichten DS18B20: Teileliste (Adafruit / Amazon; ProbeHarbor verkauft keine Hardware).
  2. Lege unter Dashboard → Devices ein Push-Gerät an (ein Klick; heißt standardmäßig „Workshop probe“).
  3. Kopiere oder scanne den Ingest-QR-Code (nach dem Anlegen oder Rotieren 30 Minuten lang sichtbar).
  4. Flashe die Firmware oder richte Home Assistant auf diese URL: Sensoren werden beim ersten POST automatisch übernommen.
  5. Leg auf der Erstalarm-Karte unter Devices die Frostschwelle (°F) und eine E-Mail-Adresse fest oder öffne Alerts → When to alert und sende dann einen Test.
  6. Optional: Teile einen Live-Link mit der Familie (in Free enthalten).

Was im QR-Code steht

Nachdem du unter Dashboard → Devices einen Push-Schlüssel angelegt oder rotiert hast, zeigt der Schlüsselhinweis einen QR-Code mit der vollständigen Ingest-URL (30 Minuten sichtbar, auch nach dem Neuladen):

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

Wer den QR-Code mit dem Handy scannt, sieht die URL. Bewahre die Geräte also sicher auf und rotiere die Schlüssel, falls ein Aufkleber verloren geht.

NFC-Tags (optional)

Schreib dieselbe HTTPS-Ingest-URL als NDEF-URI-Eintrag auf einen NTAG213/215-Aufkleber. Bei der Einrichtung genügt es dann, das Handy daranzuhalten, um die URL zu öffnen. Bewahre die Tags beim Kit auf, sie sind genauso sensibel wie ein gedruckter QR-Code. Teile und Drucktipps: QR- und NFC-Etiketten fürs Kit.

QR-Code auf der Devices-Seite

Der QR-Code wird direkt in der App erzeugt, wenn du einen Push-Schlüssel anlegst oder rotierst, ganz ohne externe QR-Generatoren. In diesem Hinweis kannst du das SVG herunterladen oder ein einfaches Etikett drucken (Gerätename + QR-Code + URL). Den curl-Test-Payload findest du außerdem unter Ingest und Webhooks.

Checkliste für den Start

Willst du Messwerte sehen, bevor du Firmware flashst? Nutze Try without hardware in Overview für den Demo-Pull-Feed, sieh dir die öffentliche Live-Demo an und lege dann ein Push-Gerät an und scanne den QR-Code.

Die Erste-Schritte-Karte im Dashboard verfolgt das Anlegen des Geräts, den ersten POST und die Alarme. Sensorschlüssel werden automatisch übernommen, sobald die Firmware JSON per POST sendet: Kombiniere den QR-Code mit Payload-Schlüsseln wie temp1 oder door1 und benenne die Bezeichnungen bei Bedarf unter Devices um.

Häufige Fragen

Was enthält der QR-Code eines Kits?
In der Regel die Ingest-URL oder einen Onboarding-Deeplink für dieses Gerät, damit ein Scan mit dem Smartphone die Einrichtung abschließt, ohne lange Schlüssel abzutippen.