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 输出。