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.gz | Overview Camera Station 應用的 Tulip 匯出檔案,包括其 HTTP 聯結器(6 個函式)及其結果表。 | Tulip,Apps |

整體架構
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 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 管理員。

您還需要:
- 一臺可以通過瀏覽器訪問的 OV80i,及其 IP 地址。
- 您希望通過 Tulip 驅動的程式,其觸發器設定為 Node-RED。如果程式使用其他觸發模式,則流程的 Trigger 節點將不起作用。
- 一個可以建立應用和聯結器的 Tulip 賬戶。
第一步:在相機上匯入 Node-RED 流程
-
開啟相機 UI 並啟用您要使用的程式。
-
轉到 Node-RED。
-
開啟選單(右上角)並選擇 Import。
-
點選 select a file to import,選擇
ov-tulip-node-red-flow.json,選擇 new flow,然後點選 Import。
-
點選 Deploy。
一個名為 Tulip integration 的新標籤頁將出現。它按五個編號部分佈局,每個部分對應一個任務:

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

每個程式都有自己的 Node-RED 流程。當啟用某個程式時,相機會用該程式的流程重新載入 Node-RED。如果您從 Tulip 切換到沒有 Tulip integration 標籤頁的程式,相機將停止響應 Tulip,直到您切換回來。請在您計劃切換使用的每個程式中匯入並部署該流程。
要將流程新增到另一個程式,請先啟用該程式,然後再次開啟 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": { }
}

該流程新增的端點
所有路徑都在相機上,位於 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 | 相機報告的上一次檢測的所有內容。用它來查詢可新增的額外欄位。 |
結果欄位
| 欄位 | 型別 | 說明 |
|---|---|---|
pass | boolean | 相機的最終判定結果。 |
judgment | text | "pass" 或 "fail"。 |
capture_id | integer | 通過此 ID 在相機庫中查詢影象。 |
inspection_id | integer | |
recipe_id, recipe_name | integer, text | 執行的程式。 |
inspection_time | text | 來自相機的 ISO 8601 時間。 |
image_data | text | 結果中捕獲的 640 px JPEG 影象,格式為 data:image/jpeg;base64,... 值(約 13 KB)。這是 Tulip 應用顯示的內容:無需與相機建立額外連線,可在 Tulip 的 https 頁面上工作。 |
image_url | text | 指向相機上完整尺寸影象的連結,根據您呼叫的地址生成。使用純 http,因此僅在相機網路上的裝置上開啟,不在 Tulip 內部開啟(請參閱限制)。 |
trigger_data | object | 您隨觸發一起傳送的欄位,例如 serial。 |
metadata | object | 影象上的所有 Capture Metadata,包括程式新增的任何內容。 |
trigger_data 與 metadata 分開如果程式自身的流程也寫入 Capture Metadata,則最後一次寫入將覆蓋之前的內容,您的序列號可能不會顯示在庫中。trigger_data 始終準確儲存 Tulip 傳送的內容,因此請從中讀取序列號。
開啟所有程式並選擇程式。ID 是位址列中的數字,例如 /recipes/5/...。
第二步:匯入 Tulip 應用
-
在 Tulip 中,轉到應用並開啟要放置應用的資料夾。
-
開啟資料夾的 ... 選單並選擇匯入。
-
點選匯入檔案並選擇
overview-camera-station-tulip-app.tar.gz,然後點選匯入。
匯入將建立:
- Overview Camera Station 應用,
- 帶有六個功能的 OV Camera (Node-RED template) HTTP 聯結器,
- Overview AI Inspection Results 表。
Tulip 僅將檔案匯入到版本匹配的例項中。如果匯入被拒絕,請使用第三步中的表格和下面的截圖手動構建聯結器;本頁頂部顯示了應用佈局。
第三步:將聯結器指向您的相機
匯出內容不包含主機或憑據,因此聯結器需要您的相機地址。
-
轉到應用 → 聯結器並開啟 OV Camera (Node-RED template)。
-
開啟編輯環境(或聯結器的連線設定)並設定:
設定 值 執行於 您的 Tulip Edge device 或 On-Premise Connector Host 伺服器地址 您的相機 IP,例如 192.168.0.100埠 80TLS 否 基本路徑 /node-red/tulip
-
點選測試連線,然後儲存。
聯結器已有以下功能:

| 功能 | 方法和路徑 | 輸入 | 輸出 |
|---|---|---|---|
| 觸發檢測 | POST /trigger | serial (text) | accepted |
| 獲取結果 | GET /result | pass, judgment, capture_id, recipe_id, recipe_name, inspection_time, image_url, serial | |
| 獲取結果影象 | GET /result | image(來自 image_data 的影象 URL,用於影象控制元件) | |
| 切換程式 | POST /recipe | id (integer) | switching_to |
| 設定實時模式 | POST /production | enabled (boolean) | production_mode, active_recipe_id, active_recipe_name |
| 獲取狀態 | GET /status | production_mode, active_recipe_id, active_recipe_name |
例如,觸發檢測在 JSON 正文中傳送序列號並讀回 accepted:

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

要在每次觸發時傳遞工單、操作員或工位資訊,請向觸發檢測新增更多輸入,並將它們新增到 JSON 正文中。任何字串或數字欄位都會與影象一起儲存,並通過 trigger_data 返回。
第四步:執行工站
開啟 Overview Camera Station 並點選 Run(或點選 Test 在編輯器中試用)。

| 控制元件 | 功能 |
|---|---|
| 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 秒,因此自動重新整理可能存在延遲。觸發後按 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)。

可選:使用 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
-
在 Tulip integration 選項卡中,雙擊 Publish,然後點選 Server 旁邊的鉛筆圖示。
-
設定您的 broker 地址、埠、TLS 和登入資訊(模板使用
broker.example.local:1883)。點選 Update,然後點選 Done。
-
選中 Publish 和 Commands 節點,按 Ctrl+E(Mac 上為 Cmd+E)啟用它們。
-
點選 Deploy。當 broker 可達時,兩個節點都會顯示 connected。
相機在埠 1883 上執行自己的 MQTT broker。將 server 設定為 127.0.0.1,可在工廠 broker 準備就緒前試用此流程。請勿將其用於生產環境。
Tulip 端
-
建立一個 MQTT 聯結器,使用您的 broker 地址和埠,QoS 1,執行在相同的 Edge 裝置或 On-Premise Connector Host 上。

-
要傳送命令,新增 write 函式,主題為
ov/$camera_serial$/cmd,並使用 JSON 訊息,例如{"action":"trigger","serial":"$part_serial$"}。
-
要接收結果,將 broker 新增為 Machine 資料來源,訂閱
ov/+/result和ov/+/status,並在您的應用中使用 Machines & devices 觸發器。
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 節點顯示 disconnected | broker 地址、埠、TLS 或登入資訊錯誤,或相機無法訪問 broker。 |

下一步
- Environment Variables:將特定於部署的設定從流程中分離出來。
- Setting Up Outputs:Node-RED 如何融入通過/失敗流程,以及與 Tulip 並行的 PLC 輸出。