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