KI-GESTÜTZTE DOKUMENTATION
Was möchten Sie wissen?
Verbindung mit Tulip herstellen
Tulip ist eine No-Code-Plattform für Apps im Bereich Frontline Operations. Diese Anleitung verbindet einen OV80i mit Tulip über ein fertiges Kit, sodass eine Bedienstation in Tulip Folgendes ermöglicht:
- Trigger einer Inspektion und Senden einer Teileseriennummer (oder eines beliebigen anderen Feldes).
- Ergebnis lesen: pass/fail, Rezept, Capture-ID, Zeit und das aufgenommene Bild.
- Rezepte wechseln, wenn sich das Produkt ändert.
- Live-Modus (Produktion) ein- und ausschalten.
- Jedes Ergebnis in einer Tulip-Tabelle protokollieren und in einem Dashboard darstellen.
Sie müssen nichts davon selbst erstellen. Laden Sie die beiden Dateien unten herunter, importieren Sie sie, richten Sie sie auf Ihre Kamera aus – und schon läuft alles.
Kit herunterladen
| Datei | Was es ist | Importieren in |
|---|---|---|
| ov-tulip-node-red-flow.json | Node-RED-Flow für die Kamera. Fügt HTTP-Endpunkte für Trigger, Ergebnis, Rezeptwechsel, Live-Modus und Status hinzu, plus optional MQTT. Enthält eine integrierte README. | Den Node-RED-Editor der Kamera |
| overview-camera-station-tulip-app.tar.gz | Tulip-Export der Overview Camera Station-App, ihres HTTP-Connectors (6 Funktionen) und ihrer Ergebnistabelle. | Tulip, Apps |

So greifen die Komponenten ineinander
Tulip app (operator station) OV80i camera
┌──────────────────────────┐ ┌───────────────────────────────┐
│ Trigger / Get result / │ HTTP │ Node-RED "Tulip integration" │
│ Switch recipe / Live │ ─────────────▶ │ tab: /node-red/tulip/... │
│ mode buttons │ ◀───────────── │ Trigger node, Capture │
│ │ JSON result │ Metadata, All Block Outputs │
└──────────────────────────┘ └───────────────────────────────┘
▲ │
│ runs through a Tulip Edge device or │ optional MQTT:
│ On-Premise Connector Host on the ▼ ov/<serial>/result
│ camera's network plant MQTT broker
Tulip ruft die Kamera über einen HTTP-Connector auf. Der Node-RED-Flow auf der Kamera beantwortet diese Aufrufe, löst Inspektionen aus und wandelt die Ergebnisse der Kamera in einfaches, flaches JSON um, das Tulip direkt in Variablen mappen kann.
Bevor Sie beginnen
Ein Connector, der auf dem Cloud Connector Host von Tulip läuft, weist private Adressen wie 10.x.x.x oder 192.168.x.x zurück. Der Verbindungstest schlägt fehl mit "Address 10.250.0.100 resolved to 10.250.0.100, which is forbidden", und App-Buttons zeigen "Connector function failed to connect to its target server".
Um eine Kamera im Werksnetzwerk zu erreichen, benötigen Sie eines der folgenden Elemente im selben Netzwerk wie die Kamera:
- ein Tulip Edge-Gerät (Edge IO, Edge MC) oder
- einen On-Premise Connector Host.
Stellen Sie dann Running on des Connectors auf diesen Host ein. Fragen Sie Ihren Tulip-Administrator, falls Sie nicht sicher sind, was Sie haben.

Sie benötigen außerdem:
- Einen OV80i, den Sie im Browser erreichen können, sowie seine IP-Adresse.
- Das Rezept, das Sie von Tulip aus steuern möchten, mit dem Trigger auf Node-RED eingestellt. Wenn das Rezept einen anderen Trigger-Modus verwendet, hat der Trigger-Node des Flows keine Wirkung.
- Ein Tulip-Konto, das Apps und Connectors erstellen kann.
Schritt 1: Node-RED-Flow auf der Kamera importieren
-
Öffnen Sie die Kamera-UI und aktivieren Sie das Rezept, das Sie verwenden möchten.
-
Gehen Sie zu Node-RED.
-
Öffnen Sie das Menü (oben rechts) und wählen Sie Import.
-
Klicken Sie auf select a file to import, wählen Sie
ov-tulip-node-red-flow.json, dann new flow und anschließend Import.
-
Klicken Sie auf Deploy.
Ein neuer Tab namens Tulip integration erscheint. Er ist in fünf nummerierte Abschnitte unterteilt, einen pro Job:

Die eigene README des Tabs (Tab auswählen, dann die info-Seitenleiste öffnen) listet jeden Endpunkt auf, sodass jeder, der den Flow später öffnet, weiß, was er tut:

Jedes Rezept hat seinen eigenen Node-RED-Flow. Wenn ein Rezept aktiviert wird, lädt die Kamera Node-RED mit dem Flow dieses Rezepts neu. Wenn Sie von Tulip zu einem Rezept wechseln, das den Tab Tulip integration nicht hat, reagiert die Kamera nicht mehr auf Tulip, bis Sie zurückwechseln. Importieren und deployen Sie den Flow in jedem Rezept, zwischen denen Sie wechseln möchten.
Um den Flow zu einem anderen Rezept hinzuzufügen, aktivieren Sie zunächst dieses Rezept und öffnen Sie dann Node-RED erneut.
Prüfen, ob es funktioniert
Führen Sie von einem beliebigen Computer im Netzwerk der Kamera aus:
curl -X POST http://CAMERA_IP/node-red/tulip/trigger \
-H "Content-Type: application/json" \
-d '{"serial":"SN-24-118734","operator":"line-2"}'
# about 1.5 seconds later
curl http://CAMERA_IP/node-red/tulip/result
Der Trigger liefert sofort 202 zurück. Das Ergebnis sieht wie folgt aus, und dasselbe Objekt wird in der Node-RED-Debug-Seitenleiste angezeigt:
{
"pass": false,
"judgment": "fail",
"capture_id": 1923,
"inspection_id": 12,
"recipe_id": 5,
"recipe_name": "Recipe 1 (copy)",
"inspection_time": "2026-11-09T05:45:02.710681Z",
"image_data": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ...",
"image_url": "http://CAMERA_IP/edge/v2/files/library_captures/1794203102931.jpg",
"trigger_data": { "serial": "SN-24-118734", "operator": "line-2" },
"metadata": { }
}

Endpunkte, die der Flow hinzufügt
Alle Pfade befinden sich auf der Kamera unter http://CAMERA_IP/node-red/tulip.
| Aufruf | Body | Funktion |
|---|---|---|
POST /trigger | Optionales flaches JSON, zum Beispiel {"serial":"SN-1","operator":"line-2"} | Löst eine Inspektion aus. String- und Zahlenfelder werden mit der Aufnahme als Capture Metadata gespeichert. Antwortet sofort mit 202 und {accepted, at, result_url}. |
GET /result | Das neueste Ergebnis, abgeflacht für Tulip (Felder unten). 404 bis zur ersten Inspektion. | |
POST /recipe | {"id": 5} | Wechselt das Rezept. Antwortet zuerst mit 202, dann wird gewechselt. Bestätigen Sie mit GET /status (ca. 2,5 Sekunden). |
POST /production | {"enabled": true} | Schaltet den Live-Modus (Produktionsmodus) ein oder aus und gibt den neuen Status zurück. |
GET /status | {production_mode, active_recipe_id, active_recipe_name, last_result} | |
GET /raw | Alles, was die Kamera für die letzte Inspektion gemeldet hat. Nützlich, um zusätzliche Felder zum Hinzufügen zu finden. |
Ergebnisfelder
| Feld | Typ | Hinweise |
|---|---|---|
pass | boolean | Das endgültige Urteil der Kamera. |
judgment | text | "pass" oder "fail". |
capture_id | integer | Finden Sie das Bild in der Kamera-Library anhand dieser ID. |
inspection_id | integer | |
recipe_id, recipe_name | integer, text | Das ausgeführte Rezept. |
inspection_time | text | ISO 8601-Zeit von der Kamera. |
image_data | text | Ein 640 px großes JPEG der Aufnahme innerhalb des Ergebnisses, als data:image/jpeg;base64,...-Wert (ca. 13 KB). Dies wird in der Tulip-App angezeigt: Es benötigt keine zusätzliche Verbindung zur Kamera und funktioniert auf den https-Seiten von Tulip. |
image_url | text | Link zum Bild in voller Größe auf der Kamera, aufgebaut aus der aufgerufenen Adresse. Einfaches http, daher öffnet es sich nur auf einem Gerät im Netzwerk der Kamera und nicht innerhalb von Tulip (siehe Einschränkungen). |
trigger_data | object | Die Felder, die Sie mit dem Trigger gesendet haben, zum Beispiel serial. |
metadata | object | Alle Capture Metadata auf dem Bild, einschließlich allem, was das Rezept hinzufügt. |
trigger_data getrennt von metadata istWenn der eigene Ablauf des Rezepts ebenfalls Capture Metadata schreibt, gewinnt der letzte Schreibvorgang und Ihre Seriennummer wird möglicherweise nicht in der Library angezeigt. trigger_data enthält immer genau das, was Tulip gesendet hat, lesen Sie die Seriennummer also von dort.
Öffnen Sie All Recipes und wählen Sie das Rezept aus. Die ID ist die Nummer in der Adresszeile, zum Beispiel /recipes/5/....
Schritt 2: Tulip-App importieren
-
Gehen Sie in Tulip zu Apps und öffnen Sie den Ordner, in dem Sie die App ablegen möchten.
-
Öffnen Sie das Menü ... des Ordners und wählen Sie Import.
-
Klicken Sie auf Import a file und wählen Sie
overview-camera-station-tulip-app.tar.gz, dann Import.
Der Import erstellt:
- die Overview Camera Station-App,
- den OV Camera (Node-RED template) HTTP-Connector mit sechs Funktionen,
- die Tabelle Overview AI Inspection Results.
Tulip importiert eine Datei nur in eine Instanz mit übereinstimmender Version. Falls der Import abgelehnt wird, erstellen Sie den Connector manuell anhand der Tabelle in Schritt 3 und der Screenshots unten; das App-Layout wird oben auf dieser Seite gezeigt.
Schritt 3: Connector auf Ihre Kamera ausrichten
Exporte enthalten niemals Hosts oder Anmeldedaten, daher benötigt der Connector die Adresse Ihrer Kamera.
-
Gehen Sie zu Apps → Connectors und öffnen Sie OV Camera (Node-RED template).
-
Öffnen Sie Edit environments (oder die Verbindungseinstellungen des Connectors) und legen Sie fest:
Einstellung Wert Running on Ihr Tulip Edge device oder On-Premise Connector Host Server address Ihre Kamera-IP, zum Beispiel 192.168.0.100Port 80TLS No Base path /node-red/tulip
-
Klicken Sie auf Test connection und speichern Sie anschließend.
Der Connector verfügt bereits über diese Funktionen:

| Funktion | Methode und Pfad | Eingaben | Ausgaben |
|---|---|---|---|
| Trigger inspection | POST /trigger | serial (text) | accepted |
| Get result | GET /result | pass, judgment, capture_id, recipe_id, recipe_name, inspection_time, image_url, serial | |
| Get result image | GET /result | image (Image URL aus image_data, für ein Image-Widget) | |
| Switch recipe | POST /recipe | id (integer) | switching_to |
| Set live mode | POST /production | enabled (boolean) | production_mode, active_recipe_id, active_recipe_name |
| Get status | GET /status | production_mode, active_recipe_id, active_recipe_name |
Zum Beispiel sendet Trigger inspection die Seriennummer in einem JSON-Body und liest accepted zurück:

Get result ordnet jedes Feld des Ergebnisses einer Ausgabe zu:

Um Arbeitsauftrag, Bediener oder Station mit jedem Trigger zu übergeben, fügen Sie weitere Eingaben zu Trigger inspection hinzu und ergänzen Sie diese im JSON-Body. Jedes String- oder Zahlenfeld wird mit dem Bild gespeichert und kommt in trigger_data zurück.
Schritt 4: Die Station ausführen
Öffnen Sie Overview Camera Station und klicken Sie auf Run (oder Test, um es im Editor auszuprobieren).

| Steuerelement | Funktion |
|---|---|
| Feld Serial Number | Die Seriennummer des Teils. Trigger inspection sendet sie mit dem Trigger. |
| Trigger inspection | Löst eine Inspektion aus. |
| Get result | Liest das aktuellste Ergebnis sowie ein 640-px-Bild der Aufnahme in das linke Panel ein. Das Panel aktualisiert sich außerdem automatisch alle 30 Sekunden. Dies ist das zuletzt erfasste Bild, kein Live-Video. |
| Log camera result | Schreibt das Kameraergebnis (Seriennummer, Ergebnis, Station, Bediener, Zykluszeit) in die Ergebnistabelle, sodass es unter Recent Inspections erscheint. |
| Recipe ID + Switch recipe | Aktiviert das Rezept mit dieser ID. |
| Live mode on / off | Schaltet den Produktionsmodus ein oder aus. |
| Refresh status | Zeigt an, ob der Live-Modus aktiv ist und welches Rezept gerade verwendet wird. |
| PASS / FAIL | Die ursprünglichen manuellen Tasten zum Protokollieren eines Ergebnisses von Hand. |
Die Kamera schreibt pass / fail; die manuellen Tasten schreiben PASS / FAIL. Wenn Sie Werte in der Spalte Result zählen oder filtern, berücksichtigen Sie beide Varianten oder passen Sie die Tasten entsprechend an.
Tulip erlaubt keinen Timer, der kürzer als 30 Sekunden ist, daher kann die automatische Aktualisierung verzögert sein. Drücken Sie nach einem Trigger Get result für ein sofortiges Ergebnis oder verwenden Sie MQTT (siehe unten), das jedes Ergebnis sofort nach Verfügbarkeit überträgt.
Ein Dashboard hinzufügen
Um die Qualität über eine Schicht hinweg zu beobachten, erstellen Sie ein Tulip Dashboard auf Basis der Ergebnistabelle. Zum Beispiel:
- Pass vs Fail: Donut, gruppiert nach Result, Operation Count of Records.
- Results by station: Balken, gruppiert nach Station / Camera und Result, Count of Records.
- Inspections per hour: Linie, gruppiert nach dem Erstellungszeitpunkt des Datensatzes, Count of Records.
Das folgende Beispiel wurde auf die gleiche Weise auf einer Ergebnistabelle mit einer booleschen Pass-Spalte erstellt, was auch einen Einzelwert Pass rate (Percent Where True) ermöglicht.

Optional: MQTT anstelle von Polling verwenden
MQTT bietet eine geringere Latenz als HTTP-Polling: Jedes Ergebnis wird etwa 1,3 Sekunden nach dem Trigger veröffentlicht, ohne Polling. Abschnitt 5 des Flows übernimmt dies. Es ist standardmäßig deaktiviert.
| Topic | Richtung | Inhalt |
|---|---|---|
ov/<serial>/result | Kamera → Broker | Dasselbe JSON wie GET /result, für jede Inspektion (QoS 1). |
ov/<serial>/status | Kamera → Broker | {production_mode, active_recipe_id, active_recipe_name, at}, retained. Wird veröffentlicht, wenn der Flow startet, und somit auch nach jedem Rezeptwechsel. |
ov/<serial>/cmd | Broker → Kamera | {"action":"trigger","serial":"SN-1"}, {"action":"recipe","id":5} oder {"action":"production","enabled":true} |
<serial> ist die Kamera-Seriennummer, die in der oberen Leiste der Kamera-UI angezeigt wird. Befehle, die an eine andere Seriennummer gerichtet sind, werden ignoriert, sodass sich mehrere Kameras einen Broker teilen können.
MQTT an der Kamera aktivieren
-
Doppelklicken Sie im Tab Tulip integration auf Publish und dann auf das Stiftsymbol neben Server.
-
Legen Sie die Adresse, den Port, TLS und die Anmeldedaten Ihres Brokers fest (die Vorlage verwendet
broker.example.local:1883). Klicken Sie auf Update und dann auf Done.
-
Wählen Sie die Nodes Publish und Commands aus und drücken Sie Strg+E (Cmd+E auf dem Mac), um sie zu aktivieren.
-
Klicken Sie auf Deploy. Beide Nodes zeigen connected an, wenn der Broker erreichbar ist.
Die Kamera betreibt einen eigenen MQTT-Broker auf Port 1883. Setzen Sie den Server auf 127.0.0.1, um den Flow zu testen, bevor Ihr Werks-Broker bereit ist. Nicht für den Produktivbetrieb verwenden.
Tulip-Seite
-
Erstellen Sie einen MQTT-Connector mit der Adresse und dem Port Ihres Brokers, QoS 1, der auf demselben Edge-Gerät oder On-Premise Connector Host läuft.

-
Um Befehle zu senden, fügen Sie write-Funktionen mit dem Topic
ov/$camera_serial$/cmdund einer JSON-Nachricht hinzu, zum Beispiel{"action":"trigger","serial":"$part_serial$"}.
-
Um Ergebnisse zu empfangen, fügen Sie den Broker als Machine-Datenquelle hinzu, die
ov/+/resultundov/+/statusabonniert, und verwenden Sie einen Machines & devices-Trigger in Ihrer App.
Eine Tulip-MQTT-Connector-Funktion kann Nachrichten senden, aber nicht lesen. Ergebnisse und Status kommen über die Machine-Datenquelle herein.
Einschränkungen
Beachten Sie diese Punkte, bevor Sie das Kit an einer Linie ausrollen:
- Kein Live-Video in Tulip. Das Panel zeigt das zuletzt aufgenommene Bild (ein 640-px-Bild), das aktualisiert wird, wenn der Bediener Get result drückt oder alle 30 Sekunden per Timer. Die kameraeigene Live-Ansicht ist ein H.264-Stream, der in der Webseite der Kamera dargestellt wird, ohne MJPEG- oder Snapshot-URL, die ein Tulip-Image-Widget anzeigen könnte. Das Einbetten der Seite
http://CAMERA_IP/live-feedder Kamera erfordert das Web-Page-Widget von Tulip (durch den Tulip-Support aktiviert) und eine https-Adresse für die Kamera, da Tulip-Seiten https sind und die Kamera nur reines http bereitstellt. - Bilder in voller Größe lassen sich nicht in Tulip öffnen.
image_urlist ein einfacherhttp-Link zur Kamera. Browser blockieren oder beschädigenhttp-Bilder auf den https-Seiten von Tulip, und der iPad-Player lehnt sie ab. Verwenden Sie den Link von einem Gerät im Netzwerk der Kamera, oder stellen Sie einen https-Reverse-Proxy vor die Kamera. - Tulip benötigt einen Pfad zur Kamera. Connectoren auf dem Cloud Connector Host von Tulip können keine privaten Adressen erreichen. Verwenden Sie ein Tulip-Edge-Gerät oder einen On-Premise Connector Host im Netzwerk der Kamera.
- Aktualisierungsrate. Tulip-Timer laufen höchstens alle 30 Sekunden. Für Ergebnisse, sobald sie verfügbar sind, drücken Sie nach einem Trigger auf Get result oder verwenden Sie MQTT.
- Ein Flow pro Rezept. Der Flow muss in jedes Rezept importiert werden, zu dem Tulip wechselt, sonst verschwinden die Endpunkte nach einem Wechsel.
- Ergebnisgröße. Das eingebettete Bild fügt jedem Ergebnis etwa 13 KB hinzu, einschließlich MQTT-Nachrichten. Das ist für Tulip-Variablen und Broker mit Standardlimits unproblematisch.
- Getestet auf. OV80i-Firmware
dev-20261013mit Tulip r393. Endpunkte und Node-Namen können bei anderen Kameramodellen und Firmwareständen abweichen.
Fehlerbehebung
| Symptom | Ursache und Lösung |
|---|---|
| Connector-Test schlägt fehl mit "... which is forbidden" | Der Connector läuft auf dem Cloud Connector Host. Setzen Sie Running on auf Ihr Tulip Edge-Gerät oder den On-Premise Connector Host. |
| App zeigt "Connector function failed to connect to its target server" | Wie oben, oder die Kamera ist ausgeschaltet bzw. vom Connector-Host aus nicht erreichbar. Prüfen Sie die Kamera-IP und testen Sie mit curl aus diesem Netzwerk. |
Trigger liefert 202, aber kein neues Ergebnis | Der Trigger des Rezepts ist nicht auf Node-RED gesetzt, oder das Rezept ist nicht geladen. Prüfen Sie die obere Leiste der Kamera und die Trigger-Einstellung des Rezepts und lösen Sie erneut aus. |
Endpunkte liefern 404 nach einem Rezeptwechsel | Das Rezept, zu dem Sie gewechselt haben, besitzt keinen Tab Tulip integration. Importieren Sie den Flow auch in dieses Rezept. |
GET /result liefert 404 | Seit dem Deployment des Flows wurde keine Inspektion ausgeführt. Lösen Sie einmal aus. |
| Seriennummer fehlt in der Library | Die eigene Capture Metadata des Rezepts hat sie überschrieben. Lesen Sie sie stattdessen aus trigger_data im Ergebnis. |
| Bild wird in Tulip nicht angezeigt | Das Bild stammt aus image_data und wird nach jeder Inspektion befüllt. Prüfen Sie, dass Get result image einen Wert zurückgibt, der mit data:image/jpeg;base64 beginnt. Ist er leer, importieren Sie den Flow erneut (ältere Versionen gaben nur image_url zurück, das von den https-Seiten in Tulip nicht von der Kamera geladen werden kann). |
| MQTT-Nodes zeigen disconnected | Falsche Broker-Adresse, falscher Port, TLS oder Login, oder der Broker ist von der Kamera aus nicht erreichbar. |

Wie geht es weiter
- Environment Variables: Halten Sie deployment-spezifische Einstellungen aus dem Flow heraus.
- Setting Up Outputs: Wie sich Node-RED in den Pass/Fail-Flow einfügt und PLC-Ausgänge neben Tulip verwendet werden.