跳到主要内容

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 无法连接到相机时操作员看到的错误

下一步​