AI 驱动文档
您想了解什么?
Node-RED Basics
本页介绍在 OV10i 摄像系统中实现的 Node-RED,解释有助于您创建强大检测工作流的关键概念与特性。
Node-RED 是什么?
Node-RED 是一个基于流的编程工具,提供浏览器内的编辑器,用于可视化连接硬件设备、API 以及在线服务。最初由 IBM 开发,如今已成为一个开源项目,提供低代码的自动化和数据处理方法。
OV10i 摄像系统将 Node-RED 作为其自动化平台,使您能够在尽量少的编码知识下创建复杂的检测工作流。通过简单的拖放界面,您可以快速开发复杂逻辑,否则需要大量编程专业知识。
Node-RED 的关键概念
流程
流程是自动化过程的可视化表示。每个流程由通过导线(线)连接的节点组成,表示数据在系统中的传递方式。OV10i 摄像系统使用流程来处理检测结果并与外部系统通信。
节点
节点是流程的构建块,每个节点代表一个特定的功能或能力:
- 输入节点 - 接收数据(例如,相机触发、HTTP 请求)
- 处理节点 - 转换或分析数据(例如,分类逻辑)
- 输出节点 - 将数据发送到外部系统或触发动作(例如,PLC 通信)
消息
节点通过传递消息相互通信。在 OV10i 系统中,这些消息通常包含:
- 检测结果
- 关于被检测对象的元数据
- 外部系统的命令
- 触发信号
上下文存储
Node-RED 提供了一种存储信息的方法,可以在不同节点之间共享信息,而无需依赖在流程中传递的消息。
特定上下文值的“作用域”决定了谁可以访问它:
| 作用域类型 | 可见性 | 使用场景 |
|---|---|---|
| 节点上下文 | 仅对设定值的节点可见 | 存储节点特定的临时状态信息 |
| 流程上下文 | 对同一流程(tab)中的所有节点可见 | 在同一流程内节点之间共享数据 |
| 全局上下文 | 对所有流程中的所有节点可见 | 应用范围的状态或配置 |
上下文存储的好处
- 数据持久性 - 在消息流之间存储数据
- 作用域灵活性 - 不同级别的数据共享
- 状态管理 - 在节点之间维护应用程序状态
部署按钮
Node-RED 中的部署按钮允许将配置应用并推送到运行时环境。
部署选项:
- 完整部署 - 更新所有节点和流程
- 修改的节点 - 仅更新已更改的节点
- 修改的流程 - 仅更新包含已修改节点的流程
导入与导出
Node-RED 允许将流程配置导出为 JSON 文件并导入,便于:
- 相机配置的备份
- 团队成员之间共享流程
- 在不同相机之间移动配置
导出流程
- 打开相机的 Node-RED 编辑器
- 选择要导出的流程
- 点击菜单按钮并选择“导出”
- 选择 JSON 格式
导入流程
- 打开相机的 Node-RED 编辑器
- 点击菜单按钮并选择“Import”
- 粘贴 JSON 数据或上传 JSON 文件
- 点击“Import”以整合配置
- 部署以应用新的流程
调试
目的与功能
Debug 节点在 Node-RED 编辑器的 Debug 侧边栏显示消息,便于开发和排查检查流程。
主要特性
- 在 Debug 侧边栏中显示结构化消息
- 有关消息时序和来源的详细信息
- 能在工作区中定位源节点
- 能够切换以启用/禁用调试输出
Dashboard 功能
Node-RED Dashboard 提供一个基于网络的界面,通过可自定义的用户界面(UI)来监控和控制您的相机系统。
主要组件
- 布局管理器 - 组织 UI 组件
- UI 节点 - 添加特定界面元素
- 主题自定义 - 个性化外观
常见 UI 元素
- 按钮 - 触发诸如配方变化等操作
- 图表 - 显示随时间变化的检查指标
- 仪表 - 监控在一个区间内的数值
- 文本显示 - 显示当前相机状态
- 滑块 - 实时调整参数
创建仪表板的步骤
- 将 UI 节点添加到流程 - 将调色板中的 UI 节点拖放到您的流程中,以定义要包括在仪表板中的数据和控件
- 配置 UI 节点 - 配置每个 UI 节点的属性,如标签、范围和数据源
- 排列组件 - 使用布局管理器在仪表板上排列 UI 组件,创建逻辑性强、用户友好的布局
- 部署并访问仪表板 - 部署流程并通过导航到相应的 URL 访问仪表板(通常为
http://\{hostname\}/ui)
在 OV10i 中使用 Node-RED
访问编辑器
OV10i 相机中的 Node-RED 编辑器可以通过 UI 访问。
默认流程
OV10i 附带一个预配置的默认流程,用于处理基本检查操作。这可以作为您自定义配置的起点,并演示相机集成的最佳实践。
OV10i 自定义节点
相机通过专门为视觉应用设计的节点来扩展 Node-RED:
- Classification Logic - 处理分类结果
- PLC Format - 为工业控制器格式化数据
- Final Pass/Fail - 确定检查结果
集成能力
OV10i 的 Node-RED 环境支持与各种工业系统的整合:
- 通过 Ethernet/IP、Profinet 或 Modbus 与 PLC 进行通信
- 用于 IoT 应用的 MQTT
- 用于 Web 服务的 HTTP/REST
- 数据库系统用于数据记录
- 用于操作员控制的 HMI 界面
最佳实践
流程组织
- 根据功能对流程进行组织
- 使用注释来记录复杂逻辑
- 清晰命名节点以指示其用途
- 对重复模式使用子流程
性能考量
- 在生产环境中尽量减少调试节点数量
- 评估高频触发的影响
- 高效使用上下文变量
- 部署前进行充分测试
备份策略
- 定期导出并保存您的流程
- 记录您的配置变更
- 建议在团队环境中使用版本控制
- 在投入生产使用前测试已还原的流程
The Integration Builder 可以从纯英文描述生成完整的 Node-RED 流程。与逐个节点构建流程不同,描述您所需要的内容,即可在几秒内获得生产就绪的流程。适用于通知、数据记录和 PLC 通信等常见模式。