Zum Hauptinhalt springen

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​

DateiWas es istImportieren in
ov-tulip-node-red-flow.jsonNode-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.gzTulip-Export der Overview Camera Station-App, ihres HTTP-Connectors (6 Funktionen) und ihrer Ergebnistabelle.Tulip, Apps

Overview Camera Station in Tulip

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​

Tulip Cloud kann Ihre Kamera nicht direkt erreichen

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.

Der Cloud Connector Host weist eine private Kamera-IP zurück

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​

  1. Öffnen Sie die Kamera-UI und aktivieren Sie das Rezept, das Sie verwenden möchten.

  2. Gehen Sie zu Node-RED.

  3. Öffnen Sie das Menü (oben rechts) und wählen Sie Import.

  4. Klicken Sie auf select a file to import, wählen Sie ov-tulip-node-red-flow.json, dann new flow und anschließend Import.

    Import des Flows in den Node-RED-Editor der Kamera

  5. Klicken Sie auf Deploy.

Ein neuer Tab namens Tulip integration erscheint. Er ist in fünf nummerierte Abschnitte unterteilt, einen pro Job:

Der Tab „Tulip integration&quot; nach dem Import

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:

Integrierte README in der Node-RED-Info-Seitenleiste

Importieren Sie den Flow in jedes Rezept, das Tulip verwenden soll

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.

Der Node-RED-Editor bearbeitet immer das aktive Rezept

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": { }
}

Ein Ergebnis in der Node-RED-Debug-Seitenleiste

Endpunkte, die der Flow hinzufügt​

Alle Pfade befinden sich auf der Kamera unter http://CAMERA_IP/node-red/tulip.

AufrufBodyFunktion
POST /triggerOptionales 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 /resultDas 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 /rawAlles, was die Kamera für die letzte Inspektion gemeldet hat. Nützlich, um zusätzliche Felder zum Hinzufügen zu finden.

Ergebnisfelder​

FeldTypHinweise
passbooleanDas endgültige Urteil der Kamera.
judgmenttext"pass" oder "fail".
capture_idintegerFinden Sie das Bild in der Kamera-Library anhand dieser ID.
inspection_idinteger
recipe_id, recipe_nameinteger, textDas ausgeführte Rezept.
inspection_timetextISO 8601-Zeit von der Kamera.
image_datatextEin 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_urltextLink 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_dataobjectDie Felder, die Sie mit dem Trigger gesendet haben, zum Beispiel serial.
metadataobjectAlle Capture Metadata auf dem Bild, einschließlich allem, was das Rezept hinzufügt.
Warum trigger_data getrennt von metadata ist

Wenn 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.

Rezept-ID finden

Ö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​

  1. Gehen Sie in Tulip zu Apps und öffnen Sie den Ordner, in dem Sie die App ablegen möchten.

  2. Öffnen Sie das Menü ... des Ordners und wählen Sie Import.

  3. Klicken Sie auf Import a file und wählen Sie overview-camera-station-tulip-app.tar.gz, dann Import.

    App über das Ordnermenü importieren

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.
Ihre Tulip-Version

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.

  1. Gehen Sie zu Apps → Connectors und öffnen Sie OV Camera (Node-RED template).

  2. Öffnen Sie Edit environments (oder die Verbindungseinstellungen des Connectors) und legen Sie fest:

    EinstellungWert
    Running onIhr Tulip Edge device oder On-Premise Connector Host
    Server addressIhre Kamera-IP, zum Beispiel 192.168.0.100
    Port80
    TLSNo
    Base path/node-red/tulip

    Verbindungseinstellungen des Connectors

  3. Klicken Sie auf Test connection und speichern Sie anschließend.

Der Connector verfügt bereits über diese Funktionen:

Die sechs Connector-Funktionen

FunktionMethode und PfadEingabenAusgaben
Trigger inspectionPOST /triggerserial (text)accepted
Get resultGET /resultpass, judgment, capture_id, recipe_id, recipe_name, inspection_time, image_url, serial
Get result imageGET /resultimage (Image URL aus image_data, für ein Image-Widget)
Switch recipePOST /recipeid (integer)switching_to
Set live modePOST /productionenabled (boolean)production_mode, active_recipe_id, active_recipe_name
Get statusGET /statusproduction_mode, active_recipe_id, active_recipe_name

Zum Beispiel sendet Trigger inspection die Seriennummer in einem JSON-Body und liest accepted zurück:

Die Funktion Trigger inspection

Get result ordnet jedes Feld des Ergebnisses einer Ausgabe zu:

Die Funktion Get result und ihre Ausgaben

Mehr als nur die Seriennummer senden

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).

Die Overview Camera Station App im Tulip Editor

SteuerelementFunktion
Feld Serial NumberDie Seriennummer des Teils. Trigger inspection sendet sie mit dem Trigger.
Trigger inspectionLöst eine Inspektion aus.
Get resultLiest 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 resultSchreibt das Kameraergebnis (Seriennummer, Ergebnis, Station, Bediener, Zykluszeit) in die Ergebnistabelle, sodass es unter Recent Inspections erscheint.
Recipe ID + Switch recipeAktiviert das Rezept mit dieser ID.
Live mode on / offSchaltet den Produktionsmodus ein oder aus.
Refresh statusZeigt an, ob der Live-Modus aktiv ist und welches Rezept gerade verwendet wird.
PASS / FAILDie ursprünglichen manuellen Tasten zum Protokollieren eines Ergebnisses von Hand.
Ergebnisse von der Kamera sind in Kleinbuchstaben

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-Timer laufen maximal alle 30 Sekunden

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.

Ein Tulip Dashboard auf Basis der Ergebnistabelle

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.

TopicRichtungInhalt
ov/<serial>/resultKamera → BrokerDasselbe JSON wie GET /result, für jede Inspektion (QoS 1).
ov/<serial>/statusKamera → 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>/cmdBroker → 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​

  1. Doppelklicken Sie im Tab Tulip integration auf Publish und dann auf das Stiftsymbol neben Server.

  2. 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.

    Set your plant broker in the MQTT broker node

  3. Wählen Sie die Nodes Publish und Commands aus und drücken Sie Strg+E (Cmd+E auf dem Mac), um sie zu aktivieren.

  4. Klicken Sie auf Deploy. Beide Nodes zeigen connected an, wenn der Broker erreichbar ist.

Testen ohne Werks-Broker

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​

  1. 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.

    An MQTT connector for the plant broker

  2. Um Befehle zu senden, fügen Sie write-Funktionen mit dem Topic ov/$camera_serial$/cmd und einer JSON-Nachricht hinzu, zum Beispiel {"action":"trigger","serial":"$part_serial$"}.

    An MQTT write function that triggers the camera

  3. Um Ergebnisse zu empfangen, fügen Sie den Broker als Machine-Datenquelle hinzu, die ov/+/result und ov/+/status abonniert, und verwenden Sie einen Machines & devices-Trigger in Ihrer App.

MQTT-Funktionen in Tulip veröffentlichen nur

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-feed der 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_url ist ein einfacher http-Link zur Kamera. Browser blockieren oder beschädigen http-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-20261013 mit Tulip r393. Endpunkte und Node-Namen können bei anderen Kameramodellen und Firmwareständen abweichen.

Fehlerbehebung​

SymptomUrsache 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 ErgebnisDer 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 RezeptwechselDas Rezept, zu dem Sie gewechselt haben, besitzt keinen Tab Tulip integration. Importieren Sie den Flow auch in dieses Rezept.
GET /result liefert 404Seit dem Deployment des Flows wurde keine Inspektion ausgeführt. Lösen Sie einmal aus.
Seriennummer fehlt in der LibraryDie eigene Capture Metadata des Rezepts hat sie überschrieben. Lesen Sie sie stattdessen aus trigger_data im Ergebnis.
Bild wird in Tulip nicht angezeigtDas 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 disconnectedFalsche Broker-Adresse, falscher Port, TLS oder Login, oder der Broker ist von der Kamera aus nicht erreichbar.

Der Fehler, den ein Bediener sieht, wenn Tulip die Kamera nicht erreichen kann

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.