DOCUMENTACIÓN CON IA
¿Qué desea saber?
Node-RED Conceptos básicos
Esta página ofrece una introducción a Node-RED tal como se implementa en el sistema de cámaras OV10i, explicando conceptos y características clave que le ayudan a 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 OV10i utiliza Node-RED como su plataforma de automatización, lo que le permite crear flujos de inspección sofisticados con un conocimiento mínimo 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 en 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 OV10i 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 que representa una función o capacidad específica:
- Input nodes - Reciben datos (p. ej., disparadores de 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 desencadenan acciones (p. ej., comunicación con PLC)
Mensajes
Los nodos se comunican al pasar mensajes entre sí. En el sistema OV10i, estos mensajes suelen contener:
- Resultados de inspección
- Metadatos sobre objetos inspeccionados
- Comandos para sistemas externos
- Señales de disparo
Almacenamiento de contexto
Node-RED proporciona un método para almacenar información que puede compartirse entre diferentes nodos sin depender de mensajes que pasan a través de un flujo.
El 'alcance' de un valor de contexto determina quién puede acceder a él:
| Tipo de Alcance | Visibilidad | Caso de uso |
|---|---|---|
| Contexto de Nodo | Visible únicamente para el nodo que estableció el valor | Almacenamiento de información de estado temporal específica del nodo |
| Contexto de Flujo | Visible para todos los nodos en el mismo flujo (pestaña) | Compartir datos entre nodos dentro del mismo flujo |
| Contexto Global | Visible para todos los nodos en todos los flujos | Estado o configuración a nivel de aplicación |
Ventajas del almacenamiento de contexto
- Persistencia de datos - Almacenar datos entre flujos de mensajes
- Flexibilidad de alcance - Diferentes niveles de compartición de datos
- Gestión de estado - Mantener el estado de la aplicación entre nodos
Botón de Despliegue
El botón Desplegar en Node-RED le permite aplicar y enviar configuraciones al entorno de ejecución.
Opciones de Despliegue:
- Despliegue completo - Actualiza todos los nodos y flujos
- Nodos modificados - Actualiza solo los nodos que han sido modificados
- Flujos modificados - Actualiza solo los flujos que contienen nodos modificados
Importación y Exportación
Node-RED le permite exportar e importar configuraciones de flujo como archivos JSON, lo que facilita:
- Respaldo de las configuraciones de la cámara
- Compartir flujos entre miembros del equipo
- Trasladar 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 botón de menú y seleccione "Export"
- Elija el formato JSON
Proceso de Importación
- Abra el Editor de Node-RED de la cámara
- Haga clic en el botón de menú y seleccione "Import"
- Pegue los datos JSON o cargue el archivo JSON
- Haga clic en "Import" 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 resolución de problemas de los flujos de inspección.
Funciones Clave
- Vista estructurada de mensajes en la barra lateral Debug
- Información detallada sobre el momento y la fuente de los mensajes
- Capacidad para localizar nodos fuente en el espacio de trabajo
- Capacidad de conmutar para habilitar/deshabilitar la salida de depuración
Capacidades del Node-RED Dashboard
El Node-RED Dashboard proporciona una interfaz basada en la web para supervisar y controlar su sistema de cámaras a través de una UI personalizable.
Componentes Clave
- Layout Manager - Organizar componentes de la UI
- UI Nodes - Añadir elementos específicos de la interfaz
- Theme Customization - Personalizar la apariencia
Elementos comunes de la UI
- Buttons - Activar acciones como cambios de receta
- Charts - Visualizar métricas de inspección a lo largo del tiempo
- Gauges - Monitorear valores dentro de un rango
- Text displays - Mostrar el estado actual de la cámara
- Sliders - Ajustar parámetros en tiempo real
Pasos para crear un panel
- Añadir nodos UI a los flujos - Arrastre y suelte nodos UI desde la paleta a sus flujos para definir los datos y controles que desea incluir en el panel
- Configurar nodos UI - Configurar las propiedades de cada nodo UI, tales como etiquetas, rangos y fuentes de datos
- Organizar Componentes - Utilice el Layout Manager para organizar los componentes de la UI en el panel, creando una distribución lógica y fácil de usar
- Desplegar y Acceder al Panel - Despliegue sus flujos y acceda al panel navegando a la URL correspondiente (típicamente
http://{hostname}/ui)
Trabajando con Node-RED en el OV10i
Acceso al Editor
El editor de Node-RED en su cámara OV10i se puede acceder a través de la UI.
Flujo Predeterminado
El OV10i viene con un flujo predeterminado preconfigurado que maneja operaciones básicas de inspección. 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 OV10i
La cámara amplía 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 inspección
Capacidades de Integración
El entorno Node-RED en el OV10i ofrece integración con varios sistemas industriales:
- PLCs a través de Ethernet/IP, Profinet o Modbus
- MQTT para aplicaciones IoT
- HTTP/REST para servicios web
- Sistemas de bases de datos para registro de datos
- Interfaces HMI para control del operador
Mejores Prácticas
Organización de Flujos
- Mantenga los flujos organizados por función
- Use comentarios para documentar lógicas complejas
- Nome los nodos con claridad para indicar su propósito
- Use subflujos para patrones repetidos
Consideraciones de Rendimiento
- Minimize la cantidad de nodos de depuración en producción
- Considere el impacto de disparadores de alta frecuencia
- Utilice variables de contexto de forma eficiente
- Pruebe a fondo antes del despliegue
Estrategia de Copias de Seguridad
- Exporte y guarde sus flujos regularmente
- Documente sus cambios de configuración
- Considere control de versiones para entornos de equipo
- Pruebe los 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.