跳到主要內容

AI 驅動文件

您想了解什麼?

連線到 Tulip

Tulip 是一個面向一線運營應用的無程式碼平臺。本指南通過現成的套件將 OV80i 連線到 Tulip,使 Tulip 中的操作員工作站能夠:

  • 觸發檢測,並隨之傳送零件序列號(或任何其他欄位)。
  • 讀取結果:pass/fail、程式、捕獲 ID、時間和捕獲的影象。
  • 產品更換時切換程式。
  • 開啟和關閉實時(生產)模式。
  • 將每個結果記錄到 Tulip 表格中,並在儀表板上繪製圖表。

您無需手動構建任何內容。下載下方兩個檔案,匯入它們,將其指向您的相機,即可執行。

下載套件​

檔案簡介匯入至
ov-tulip-node-red-flow.json相機的 Node-RED 流程。新增用於觸發、結果、程式切換、實時模式和狀態的 HTTP 端點,以及可選的 MQTT。內建 README。相機的 Node-RED 編輯器
overview-camera-station-tulip-app.tar.gzOverview Camera Station 應用的 Tulip 匯出檔案,包括其 HTTP 聯結器(6 個函式)及其結果表。Tulip,Apps

在 Tulip 中執行的 Overview Camera Station

整體架構​

 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 通過 HTTP 聯結器呼叫相機。相機上的 Node-RED 流程響應這些呼叫、觸發檢測,並將相機的結果轉換為簡單、扁平的 JSON,Tulip 可以直接將其對映到變數中。

開始之前​

Tulip Cloud 無法直接訪問您的相機

在 Tulip 的 Cloud Connector Host 上執行的聯結器會拒絕私有地址,例如 10.x.x.x 或 192.168.x.x。連線測試會失敗並提示 "Address 10.250.0.100 resolved to 10.250.0.100, which is forbidden",應用按鈕則會顯示 "Connector function failed to connect to its target server"。

要訪問工廠網路中的相機,您需要在與相機相同的網路上具備以下之一:

  • Tulip Edge 裝置(Edge IO、Edge MC),或
  • On-Premise Connector Host。

然後將聯結器的 Running on 設定為該主機。如果不確定您擁有哪種裝置,請諮詢您的 Tulip 管理員。

Cloud Connector Host 拒絕私有相機 IP

您還需要:

  • 一臺可以通過瀏覽器訪問的 OV80i,及其 IP 地址。
  • 您希望通過 Tulip 驅動的程式,其觸發器設定為 Node-RED。如果程式使用其他觸發模式,則流程的 Trigger 節點將不起作用。
  • 一個可以建立應用和聯結器的 Tulip 賬戶。

第一步:在相機上匯入 Node-RED 流程​

  1. 開啟相機 UI 並啟用您要使用的程式。

  2. 轉到 Node-RED。

  3. 開啟選單(右上角)並選擇 Import。

  4. 點選 select a file to import,選擇 ov-tulip-node-red-flow.json,選擇 new flow,然後點選 Import。

    將流程匯入相機的 Node-RED 編輯器

  5. 點選 Deploy。

一個名為 Tulip integration 的新標籤頁將出現。它按五個編號部分佈局,每個部分對應一個任務:

匯入後的 Tulip integration 標籤頁

該標籤頁自帶的 README(選擇該標籤頁,然後開啟 info 側邊欄)列出了所有端點,方便後續開啟該流程的人瞭解其功能:

Node-RED info 側邊欄中的內建 README

將流程匯入到每個將使用 Tulip 的程式中

每個程式都有自己的 Node-RED 流程。當啟用某個程式時,相機會用該程式的流程重新載入 Node-RED。如果您從 Tulip 切換到沒有 Tulip integration 標籤頁的程式,相機將停止響應 Tulip,直到您切換回來。請在您計劃切換使用的每個程式中匯入並部署該流程。

Node-RED 編輯器始終編輯當前活動的程式

要將流程新增到另一個程式,請先啟用該程式,然後再次開啟 Node-RED。

驗證是否正常工作​

從相機網路上的任意計算機執行:

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

觸發器會立即返回 202。結果如下所示,相同的物件也會顯示在 Node-RED 除錯側邊欄中:

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

Node-RED 除錯側邊欄中的結果

該流程新增的端點​

所有路徑都在相機上,位於 http://CAMERA_IP/node-red/tulip 之下。

呼叫請求體功能
POST /trigger可選的扁平 JSON,例如 {"serial":"SN-1","operator":"line-2"}觸發一次檢測。字串和數字欄位將作為 Capture Metadata 與捕獲一起儲存。立即回覆 202,幷包含 {accepted, at, result_url}。
GET /result最新結果,已為 Tulip 扁平化(欄位如下)。在第一次檢測之前返回 404。
POST /recipe{"id": 5}切換程式。先回復 202,然後進行切換。使用 GET /status 確認(約 2.5 秒)。
POST /production{"enabled": true}開啟或關閉實時(生產)模式並返回新狀態。
GET /status{production_mode, active_recipe_id, active_recipe_name, last_result}
GET /raw相機報告的上一次檢測的所有內容。用它來查詢可新增的額外欄位。

結果欄位​

欄位型別說明
passboolean相機的最終判定結果。
judgmenttext"pass" 或 "fail"。
capture_idinteger通過此 ID 在相機庫中查詢影象。
inspection_idinteger
recipe_id, recipe_nameinteger, text執行的程式。
inspection_timetext來自相機的 ISO 8601 時間。
image_datatext結果中捕獲的 640 px JPEG 影象,格式為 data:image/jpeg;base64,... 值(約 13 KB)。這是 Tulip 應用顯示的內容:無需與相機建立額外連線,可在 Tulip 的 https 頁面上工作。
image_urltext指向相機上完整尺寸影象的連結,根據您呼叫的地址生成。使用純 http,因此僅在相機網路上的裝置上開啟,不在 Tulip 內部開啟(請參閱限制)。
trigger_dataobject您隨觸發一起傳送的欄位,例如 serial。
metadataobject影象上的所有 Capture Metadata,包括程式新增的任何內容。
為什麼 trigger_data 與 metadata 分開

如果程式自身的流程也寫入 Capture Metadata,則最後一次寫入將覆蓋之前的內容,您的序列號可能不會顯示在庫中。trigger_data 始終準確儲存 Tulip 傳送的內容,因此請從中讀取序列號。

查詢程式 ID

開啟所有程式並選擇程式。ID 是位址列中的數字,例如 /recipes/5/...。

第二步:匯入 Tulip 應用​

  1. 在 Tulip 中,轉到應用並開啟要放置應用的資料夾。

  2. 開啟資料夾的 ... 選單並選擇匯入。

  3. 點選匯入檔案並選擇 overview-camera-station-tulip-app.tar.gz,然後點選匯入。

    從資料夾選單匯入應用

匯入將建立:

  • Overview Camera Station 應用,
  • 帶有六個功能的 OV Camera (Node-RED template) HTTP 聯結器,
  • Overview AI Inspection Results 表。
您的 Tulip 版本

Tulip 僅將檔案匯入到版本匹配的例項中。如果匯入被拒絕,請使用第三步中的表格和下面的截圖手動構建聯結器;本頁頂部顯示了應用佈局。

第三步:將聯結器指向您的相機​

匯出內容不包含主機或憑據,因此聯結器需要您的相機地址。

  1. 轉到應用 → 聯結器並開啟 OV Camera (Node-RED template)。

  2. 開啟編輯環境(或聯結器的連線設定)並設定:

    設定值
    執行於您的 Tulip Edge device 或 On-Premise Connector Host
    伺服器地址您的相機 IP,例如 192.168.0.100
    埠80
    TLS否
    基本路徑/node-red/tulip

    聯結器連線設定

  3. 點選測試連線,然後儲存。

聯結器已有以下功能:

六個聯結器功能

功能方法和路徑輸入輸出
觸發檢測POST /triggerserial (text)accepted
獲取結果GET /resultpass, judgment, capture_id, recipe_id, recipe_name, inspection_time, image_url, serial
獲取結果影象GET /resultimage(來自 image_data 的影象 URL,用於影象控制元件)
切換程式POST /recipeid (integer)switching_to
設定實時模式POST /productionenabled (boolean)production_mode, active_recipe_id, active_recipe_name
獲取狀態GET /statusproduction_mode, active_recipe_id, active_recipe_name

例如,觸發檢測在 JSON 正文中傳送序列號並讀回 accepted:

觸發檢測功能

獲取結果將結果的每個欄位對映到一個輸出:

獲取結果功能及其輸出

傳送序列號以外的內容

要在每次觸發時傳遞工單、操作員或工位資訊,請向觸發檢測新增更多輸入,並將它們新增到 JSON 正文中。任何字串或數字欄位都會與影象一起儲存,並通過 trigger_data 返回。

第四步:執行工站​

開啟 Overview Camera Station 並點選 Run(或點選 Test 在編輯器中試用)。

Tulip 編輯器中的 Overview Camera Station 應用

控制元件功能
Serial Number 欄位零件序列號。Trigger inspection 會將其與觸發訊號一起傳送。
Trigger inspection觸發一次檢測。
Get result讀取最新結果以及一張 640 px 的捕獲影象到左側面板。該面板每 30 秒也會自動重新整理一次。這是最後一次捕獲的影象,而非實時影片。
Log camera result將相機的結果(序列號、結果、工站、操作員、迴圈時間)寫入結果表,使其顯示在 Recent Inspections 下。
Recipe ID + Switch recipe啟用具有該 ID 的程式。
Live mode on / off開啟或關閉生產模式。
Refresh status顯示實時模式是否開啟以及哪個程式處於活動狀態。
PASS / FAIL原始手動按鈕,用於手工記錄結果。
相機返回的結果為小寫

相機寫入 pass / fail;手動按鈕寫入 PASS / FAIL。如果您在 Result 列上進行計數或篩選,請同時考慮這兩種情況,或修改按鈕以保持一致。

Tulip 定時器最短執行間隔為 30 秒

Tulip 不允許定時器短於 30 秒,因此自動重新整理可能存在延遲。觸發後按 Get result 可立即獲取結果,或使用 MQTT(見下文),它會在每個結果就緒後立即推送。

新增儀表板​

要監控整個班次的質量,請基於結果表構建 Tulip 儀表板。例如:

  • Pass vs Fail:環形圖,按 Result 分組,操作為 Count of Records。
  • Results by station:柱狀圖,按 Station / Camera 和 Result 分組,Count of Records。
  • Inspections per hour:折線圖,按記錄的建立時間分組,Count of Records。

下面的示例以同樣的方法構建在帶有布林通過列的結果表上,這也允許顯示 Pass rate 單值(Percent Where True)。

基於結果表構建的 Tulip 儀表板

可選:使用 MQTT 替代輪詢​

MQTT 比 HTTP 輪詢具有更低的延遲:每個結果在觸發後約 1.3 秒即釋出,無需輪詢。該流程的第 5 部分負責處理這一功能。預設情況下已禁用。

主題方向內容
ov/<serial>/result相機 → 代理與 GET /result 相同的 JSON,適用於每次檢測(QoS 1)。
ov/<serial>/status相機 → 代理{production_mode, active_recipe_id, active_recipe_name, at},保留訊息。流程啟動時釋出,因此每次切換程式後也會發布。
ov/<serial>/cmd代理 → 相機{"action":"trigger","serial":"SN-1"}、{"action":"recipe","id":5} 或 {"action":"production","enabled":true}

<serial> 是相機 UI 頂部欄中顯示的相機序列號。傳送給其他序列號的命令將被忽略,因此多臺相機可以共享同一個代理。

在相機上開啟 MQTT​

  1. 在 Tulip integration 選項卡中,雙擊 Publish,然後點選 Server 旁邊的鉛筆圖示。

  2. 設定您的 broker 地址、埠、TLS 和登入資訊(模板使用 broker.example.local:1883)。點選 Update,然後點選 Done。

    在 MQTT broker 節點中設定您的工廠 broker

  3. 選中 Publish 和 Commands 節點,按 Ctrl+E(Mac 上為 Cmd+E)啟用它們。

  4. 點選 Deploy。當 broker 可達時,兩個節點都會顯示 connected。

不使用工廠 broker 進行測試

相機在埠 1883 上執行自己的 MQTT broker。將 server 設定為 127.0.0.1,可在工廠 broker 準備就緒前試用此流程。請勿將其用於生產環境。

Tulip 端​

  1. 建立一個 MQTT 聯結器,使用您的 broker 地址和埠,QoS 1,執行在相同的 Edge 裝置或 On-Premise Connector Host 上。

    用於工廠 broker 的 MQTT 聯結器

  2. 要傳送命令,新增 write 函式,主題為 ov/$camera_serial$/cmd,並使用 JSON 訊息,例如 {"action":"trigger","serial":"$part_serial$"}。

    用於觸發相機的 MQTT write 函式

  3. 要接收結果,將 broker 新增為 Machine 資料來源,訂閱 ov/+/result 和 ov/+/status,並在您的應用中使用 Machines & devices 觸發器。

Tulip 中的 MQTT 函式只能釋出

Tulip MQTT 聯結器函式可以傳送訊息,但無法讀取訊息。結果和狀態通過 Machine 資料來源傳入。

侷限性​

在將套件部署到產線之前,請了解以下幾點:

  • Tulip 中無實時影片。 面板顯示最後捕獲的影象(640 px 圖片),在操作員按下 Get result 時以及通過 30 秒計時器重新整理。相機自身的實時檢視是繪製在相機網頁中的 H.264 流,沒有 MJPEG 或快照 URL 可供 Tulip Image 小部件顯示。嵌入相機的 http://CAMERA_IP/live-feed 頁面需要 Tulip 的 Web Page 小部件(由 Tulip 支援啟用)以及相機的 https 地址,因為 Tulip 頁面是 https,而相機僅提供普通 http。
  • 全尺寸影象無法在 Tulip 內開啟。 image_url 是指向相機的普通 http 連結。瀏覽器會阻止或破壞 Tulip https 頁面上的 http 影象,iPad Player 也會拒絕它們。請從相機網路上的裝置使用它,或在相機前面放置一個 https 反向代理。
  • Tulip 需要通往相機的路徑。 Tulip Cloud Connector Host 上的聯結器無法訪問私有地址。請使用 Tulip Edge 裝置或相機網路上的 On-Premise Connector Host。
  • 重新整理率。 Tulip 計時器最快每 30 秒執行一次。要在結果就緒後立即獲取,請在觸發後按 Get result 或使用 MQTT。
  • 每個程式一個流程。 該流程必須匯入到 Tulip 切換到的每個程式中,否則切換後端點將消失。
  • 結果大小。 嵌入的圖片會給每個結果(包括 MQTT 訊息)增加約 13 KB。對於使用預設限制的 Tulip 變數和 broker 來說這沒有問題。
  • 測試環境。 OV80i 韌體 dev-20261013 搭配 Tulip r393。在其他相機型號和韌體上,端點和節點名稱可能不同。

故障排除​

症狀原因及修復
聯結器測試失敗,提示 "... which is forbidden"聯結器正在 Cloud Connector Host 上執行。將 Running on 設定為您的 Tulip Edge 裝置或 On-Premise Connector Host。
應用顯示 "Connector function failed to connect to its target server"同上,或相機已關閉或聯結器主機無法訪問。檢查相機 IP,並從該網路執行 curl 測試。
觸發器返回 202 但沒有新結果程式的觸發器未設定為 Node-RED,或程式未載入。檢查相機頂部欄和程式的觸發器設定,然後再次觸發。
切換程式後端點返回 404您切換到的程式沒有 Tulip integration 選項卡。請將流程也匯入該程式中。
GET /result 返回 404自流程部署以來未執行任何檢測。觸發一次。
庫中缺少序列號程式自身的 Capture Metadata 覆蓋了它。請改為從結果中的 trigger_data 讀取。
影象未在 Tulip 中顯示影象來自 image_data,在每次檢測後填充。檢查 Get result image 是否返回以 data:image/jpeg;base64 開頭的值。如果為空,請重新匯入流程(舊版本僅返回 image_url,Tulip 的 https 頁面無法從相機載入該內容)。
MQTT 節點顯示 disconnectedbroker 地址、埠、TLS 或登入資訊錯誤,或相機無法訪問 broker。

當 Tulip 無法連線到相機時操作員看到的錯誤

下一步​