DOCUMENTACIÓN CON IA
¿Qué desea saber?
Fundamentos de Node-RED
Esta página ofrece una introducción a Node-RED tal como se implementa en el sistema de cámaras OV20i, explicando conceptos y características clave que le permiten crear flujos de inspección potentes.
¿Qué es Node-RED?
Node-RED es una herramienta de programación basada en flujos que proporciona un editor basado en navegador para conectar visualmente dispositivos de hardware, APIs y servicios en línea. Originalmente desarrollado por IBM, se ha convertido en un proyecto de código abierto que ofrece un enfoque de bajo código para la automatización y el procesamiento de datos.
La cámara OV20i aprovecha Node-RED como su plataforma de automatización, lo que le permite crear flujos de inspección sofisticados con un mínimo conocimiento de programación. A través de una interfaz de arrastrar y soltar simple, puede desarrollar rápidamente lógica compleja que de otro modo requeriría una amplia experiencia en programación.
Conceptos clave de Node-RED
Flujos
Los flujos son las representaciones visuales de sus procesos automatizados. Cada flujo consta de nodos conectados por cables que representan cómo se mueven los datos a través del sistema. La cámara OV20i utiliza flujos para procesar los resultados de inspección y comunicarse con sistemas externos.
Nodos
Los nodos son los bloques de construcción de sus flujos, cada uno representando una función o capacidad específica:
- Input nodes - Reciben datos (p. ej., disparadores de la cámara, solicitudes HTTP)
- Processing nodes - Transforman o analizan datos (p. ej., lógica de clasificación)
- Output nodes - Envían datos a sistemas externos o activan acciones (p. ej., comunicación con PLC)
Mensajes
Los nodos se comunican pasándose mensajes entre sí. En el sistema OV20i, estos mensajes suelen contener:
- Resultados de inspección
- Metadatos sobre objetos inspeccionados
- Comandos para sistemas externos
- Señales de activación
Almacenamiento de Contexto
Node-RED ofrece un método para almacenar información que puede compartirse entre diferentes nodos sin depender de mensajes que pasen por un flujo.
El 'alcance' de un valor de contexto particular determina quién puede acceder a él:
| Scope Type | Visibility | Use Case |
|---|---|---|
| Node Context | Visible solo para el nodo que estableció el valor | Almacenar información de estado temporal específica del nodo |
| Flow Context | Visible para todos los nodos del mismo flujo (pestaña) | Compartir datos entre nodos dentro del mismo flujo |
| Global Context | Visible para todos los nodos a través de todos los flujos | Estado o configuración a nivel de la aplicación |
Beneficios del Almacenamiento de Contexto
- Data Persistence - Almacenar datos entre flujos de mensajes
- Scope Flexibility - Diferentes niveles de compartición de datos
- State Management - Mantener el estado de la aplicación entre nodos
Botón de Despliegue
El botón Despliegue en Node-RED le permite aplicar y enviar configuraciones al entorno de ejecución.
Opciones de Despliegue:
- Full Deploy - Actualiza todos los nodos y flujos
- Modified Nodes - Actualiza solo los nodos que se han modificado
- Modified Flows - Actualiza solo los flujos que contienen nodos modificados
Importar y Exportar
Node-RED le permite exportar e importar configuraciones de flujos como archivos JSON, lo que permite:
- Copia de seguridad de las configuraciones de la cámara
- Compartir flujos entre los miembros del equipo
- Mover configuraciones entre diferentes cámaras
Proceso de Exportación
- Abra el Editor de Node-RED de la cámara
- Seleccione los flujos que desea exportar
- Haga clic en el menú y seleccione "Exportar"
- Elija el formato JSON
Proceso de Importación
- Abra el Editor de Node-RED de la cámara
- Haga clic en el menú y seleccione "Importar"
- Pegue los datos JSON o cargue el archivo JSON
- Haga clic en "Importar" para integrar la configuración
- Despliegue para aplicar los nuevos flujos
Depuración
Propósito y Funcionalidad
El nodo Debug muestra mensajes en la barra lateral Debug del editor de Node-RED, facilitando el desarrollo y la solución de problemas de los flujos de inspección.
Funciones Clave
- Vista estructurada de mensajes en la barra lateral Debug
- Información detallada sobre la temporización y la fuente de los mensajes
- Capacidad para localizar nodos fuente en el espacio de trabajo
- Capacidad de alternar para habilitar/deshabilitar la salida de depuración
Capacidades del Dashboard
El Node-RED Dashboard proporciona una interfaz basada en la web para monitorear y controlar su sistema de cámaras a través de una interfaz de usuario personalizable.
Componentes Clave
- Layout Manager - Organizar componentes de UI
- UI Nodes - Agregar elementos de interfaz de usuario específicos
- Theme Customization - Personalización del tema
Elementos comunes de UI
- Buttons - Disparan acciones como cambios de recetas
- Charts - Visualizan métricas de inspección a lo largo del tiempo
- Gauges - Monitorean valores dentro de un rango
- Text displays - Muestran el estado actual de la cámara
- Sliders - Ajustan parámetros en tiempo real
Pasos para crear un dashboard
- Agregar nodos de UI a los flujos - Arrastre y suelte nodos de UI desde la paleta en sus flujos para definir los datos y controles que desea incluir en el dashboard
- Configurar nodos de UI - Configurar las propiedades de cada nodo de UI, como etiquetas, rangos y fuentes de datos
- Organizar componentes - Utilice el Layout Manager para organizar los componentes de UI en el dashboard, creando una distribución lógica y fácil de usar
- Desplegar y acceder al dashboard - Despliegue sus flujos y acceda al dashboard navegando a la URL adecuada (típicamente
http://{hostname}/ui)
Trabajando con Node-RED en el OV20i
Acceso al Editor
El editor de Node-RED en su cámara OV20i se puede acceder a través de la interfaz de usuario.
Flujo predeterminado
El OV20i viene con un flujo predeterminado preconfigurado que maneja operaciones de inspección básicas. Esto sirve como punto de partida para sus configuraciones personalizadas y demuestra las mejores prácticas para la integración de la cámara.
Nodos personalizados de OV20i
La cámara extiende Node-RED con nodos especializados diseñados para aplicaciones de visión:
- Classification Logic - Procesar resultados de clasificación
- PLC Format - Formatear datos para controladores industriales
- Final Pass/Fail - Determinar los resultados de la inspección
Capacidades de Integración
El entorno Node-RED en el OV20i admite la integración con diversos sistemas industriales:
- PLCs vía Ethernet/IP, Profinet o Modbus
- MQTT para aplicaciones IoT
- HTTP/REST para servicios web
- Sistemas de bases de datos para el registro de datos
- Interfaces HMI para control de operador
Mejores Prácticas
Organización de Flujos
- Mantenga los flujos organizados por función
- Use comentarios para documentar lógica compleja
- Nombre de nodos claramente para indicar su propósito
- Use subflows para patrones repetitivos
Consideraciones de Rendimiento
- Minimice la cantidad de nodos de depuración en producción
- Considere el impacto de disparos de alta frecuencia
- Utilice de manera eficiente las variables de contexto
- Pruebe a fondo antes del despliegue
Estrategia de Copia de Seguridad
- Exporte y guarde sus flujos regularmente
- Documente los cambios de configuración
- Considere control de versiones para entornos de equipo
- Pruebe flujos restaurados antes de su uso en producción
El Integration Builder puede generar flujos completos de Node-RED a partir de una descripción en lenguaje natural. En lugar de construir flujos nodo por nodo, describa lo que desea y obtenga un flujo listo para producción en segundos. Ideal para patrones comunes como notificaciones, registro de datos y comunicación con PLC.