BrewForge Docs

Fehlerbehebung bei Geräten

Was du prüfst, wenn eine Spindel oder ein Sensor keine Daten an BrewForge schickt, Messwerte nicht beim Sud ankommen oder Werte falsch aussehen.

Fang auf der Seite des Geräts an: Letzte Daten listet die Payloads, die BrewForge gespeichert hat, und wohin jede ging. Ein Klick auf eine Zeile zeigt die Payload genau so, wie sie ankam, und bei einem Eigenen Datenstrom, wie jedes Feld gelesen wurde.

Das Gerät bleibt bei „Wartet auf den ersten Messwert“

BrewForge hat noch keine einzige gültige Anfrage bekommen.

  • Prüf die URL. Kopier sie erneut mit ⋯ → Webhook-URL kopieren (oder dem Kopier-Button unter Einrichtung) und füge die komplette URL ein, inklusive ?key=…. Ein fehlender oder falscher Schlüssel wird abgelehnt.
  • Prüf den Gerätetyp. Ein Tilt, der als iSpindel angelegt ist (oder umgekehrt), wird im falschen Format gelesen. Der Typ lässt sich nicht ändern; lösch das Gerät und leg es mit dem richtigen Typ neu an.
  • Prüf die Internetverbindung des Geräts oder der Bridge. Bei einer RAPT Pill müssen die Messwerte zuerst im RAPT Portal auftauchen.
  • Starte das Gerät neu, nachdem du seine Einstellungen gespeichert hast (iSpindel und GravityMon übernehmen Push-Einstellungen erst nach einem Neustart).
  • Warte ein Intervall ab. Viele Geräte senden nur alle 15 bis 60 Minuten. Die Geräteseite aktualisiert sich von selbst, sobald der erste Messwert ankommt.

„Kein Messwert seit …“ oder „Punkte prüfen“

Ein Gerät, das mit einem Sud oder Keg verbunden ist und seit mehr als einem Tag keinen Messwert geschickt hat, wird markiert: In seiner Zeile auf der Seite Geräte steht kein Messwert seit …, die Seite zeigt eine Zeile Punkte prüfen, und auf der Geräteseite steht Seit über einem Tag kein Messwert, obwohl mit … verbunden. Meist ist der Akku leer, das Gerät hat sein WLAN verloren oder wurde aus dem Gärbehälter genommen, ohne es zu trennen. Bring das Gerät wieder zum Laufen, oder trenne es, wenn die Gärung vorbei ist.

Ein Gerät ist Offline (grauer Punkt), sobald sein letzter gespeicherter Messwert älter als 30 Minuten ist; das allein ist bei Geräten mit langem Intervall normal.

Das Gerät ist online, aber der Sud bekommt keine Messwerte

  • Verbinde das Gerät mit dem Sud. Verbunden mit auf der Geräteseite muss den Sud nennen. Bei einer Tilt Bridge verbindest du das Farbgerät (zum Beispiel Tilt Black), nicht die Bridge.
  • Prüf, ob der Messwert Extrakt enthält. Nur Messwerte mit Extrakt (oder Blasen pro Minute) werden einem Sud hinzugefügt. Ein Eigener Datenstrom, der nur Temperatur zuordnet, speichert Messwerte am Gerät, fügt dem Sud aber keine hinzu.
  • Prüf Status und Tarif des Suds. Nur aktive Sude (Brautag, In Gärung, Lagerung) lassen sich auswählen. Im kostenlosen Tarif sind Sude über dem Limit von 20 Suden gesperrt und bekommen keine Messwerte von Geräten.

Nicht jeder Messwert taucht auf

BrewForge speichert pro Gerät höchstens einen Messwert alle 14 Minuten. Das ist so gewollt, siehe Speicherintervall.

Werte sehen falsch aus

SymptomWahrscheinliche UrsacheLösung
Temperatur ist viel zu niedrig (etwa −7 °C bei Zimmertemperatur)Eine Tilt-Bridge sendet °C, ohne es anzugeben; BrewForge liest Tilt-Temperaturen als °FLass die Bridge °F senden oder temp_units: "C" mitschicken
Extrakt fehlt, obwohl das Gerät einen sendetDer Wert liegt nach der Umrechnung außerhalb von 0,800–1,200 SG, zum Beispiel Plato ohne EinheitSchick die Einheit mit (gravity-unit: "P") oder ordne sie im Eigenen Datenstrom zu
Extrakt weicht immer um denselben Betrag abKalibrierungKalibrier-Offset setzen
Extrakt weicht bei verschiedenen Werten unterschiedlich abDie Kalibrierkurve des GerätsGerät neu kalibrieren (iSpindel-Polynom, Tilt-Kalibrierung)
Payloads eines Eigenen Datenstroms zeigen Nichts passtDie Pfade der Zuordnung passen nicht zur PayloadÖffne die Payload in Letzte Daten, vergleiche sie mit So wurde sie gelesen und korrigiere die Pfade über Zuordnung bearbeiten; verschachteltes JSON braucht Pfade mit Punkten

Fehlerantworten

Wenn du die HTTP-Antwort sehen kannst (Eigener Datenstrom, curl, Node-RED, Test-Payload senden), sagt sie dir, was schiefging:

StatusMeldungBedeutung
401Missing device credentialKein key in der URL und kein Authorization: Bearer-Header.
401Invalid API keyDer Schlüssel gehört zu keinem Gerät, zum Beispiel weil das Gerät gelöscht wurde.
401Conflicting device credentialsSchlüssel in der URL und Bearer-Token sind verschieden.
400Invalid payloadDer Body ist kein gültiges JSON und keine gültigen Formulardaten.
400Missing Tilt color in payloadEine Anfrage an eine Tilt Bridge ohne color.
413Payload too large (max 64 KB)Der Body ist größer als 64 KB.

Kommst du nicht weiter? Melde unter Posteingang & Tickets (Bereich Hilfe in der Seitenleiste) ein Problem und gib den Gerätetyp an und was Letzte Daten zeigt.

Auf dieser Seite