Configuración de la cámara FLIR BlackFly S GigE en SwingCatalyst

Cómo usar las cámaras de visión artificial FLiR Blackfly S (GigE) en SwingCatalyst

Este artículo explica cómo usar cámaras GigE Vision compatibles con Spinnaker en SwingCatalyst.

Algunos modelos más antiguos también son compatibles, como la Blackfly GigE (variantes no S); este artículo puede servir como guía de referencia para esas cámaras. Existen diferencias entre modelos en cuanto a las configuraciones y funciones disponibles, por lo que es posible que este artículo no coincida exactamente con lo que ves en tu pantalla.

Note: Spinnaker solo es compatible con SwingCatalyst versiones 9.4 en adelante.

Temas relacionados y recomendaciones:

Recomendamos encarecidamente que te familiarices con nuestras recomendaciones antes de adquirir cámaras o un sistema informático. Se recomienda disponer de una tarjeta de red dedicada para el sistema de cámaras.

Este artículo está dividido en diferentes secciones

Configuración del hardware físico (cámara y objetivo).

Configuración del software (configuración de IP).

Configuración del software (configuración de la cámara).

Cómo mejorar la calidad de imagen.

Consejos para solución de problemas.

Temas relacionados y recomendaciones:

Recomendamos encarecidamente que te familiarices con nuestras recomendaciones antes de adquirir cámaras o un sistema informático. El USB 3.0 puede presentar problemas de estabilidad y, en general, no es algo que nosotros (SwingCatalyst) recomendemos para instalaciones de cámaras fijas.

Configuración de la cámara FLIR Blackfly S GigE en SwingCatalyst

Artículos anteriores: Point Grey Blackfly GigE en SwingCatalyst (para versiones antiguas de SwingCatalyst)

Primeros pasos: Configuración del hardware

Fija el adaptador para trípode al cuerpo de la cámara usando los 4 tornillos negros de cabeza Phillips incluidos con la cámara.

Imagen de montaje del adaptador para trípode Imagen de montaje del adaptador para trípode

Desempaqueta el objetivo y asegúrate de retirar las tapas protectoras de plástico del objetivo.

Imagen del objetivo con tapas protectoras Imagen del objetivo con tapas protectoras

Retira la tapa del sensor de la cámara:

Imagen de la tapa del sensor Imagen de la tapa del sensorImagen del sensor al descubierto Imagen del sensor al descubierto

Colocación del objetivo en la cámara

GIF de montaje del objetivo GIF de montaje del objetivo

Ajuste del objetivo de la cámara:

Imagen del objetivo con sus ajustes Imagen del objetivo con sus ajustes

Este objetivo tiene tres ajustes, de arriba a abajo:

  • Enfoque (ajustar hacia el símbolo ∞ pondrá en foco los objetos más lejanos en el fondo)

  • Apertura (ajuste del Iris; regula la cantidad de luz que puede pasar a través del objetivo; una apertura más cerrada producirá una imagen más nítida).

  • Zoom (ajusta el zoom del objetivo entre gran angular y teleobjetivo).

Instalación de la tarjeta de red de doble puerto

Importante: Es fundamental que la tarjeta de red esté configurada según las recomendaciones.

gige-network-setup.md

Primeros pasos: Instalación de Drivers

Haz clic para descargar los Drivers (Si usas Chrome, haz clic derecho y selecciona “guardar enlace como”)

Una vez descargado, haz clic en el ejecutable y sigue el asistente de instalación.

  • Elige “Camera Evaluation”.

  • Deja marcada la casilla “I will use GigE Cameras”.

Imagen del asistente de instalación Imagen del asistente de instalación

Configuración de IP

Tras la instalación de los Drivers, debería aparecer un mensaje para ejecutar AdapterConfigGUI. Si no es así, puedes encontrarlo en C:\Program Files\FLIR Systems\Spinnaker\shortcuts\utilities

La utilidad de configuración del adaptador tendrá este aspecto:

Imagen de la ventana AdapterConfigGUI Imagen de la ventana AdapterConfigGUI

Haz clic en “Start” y selecciona los adaptadores “Intel(R) 82574L” que aparezcan.

Imagen de selección de adaptadores Imagen de selección de adaptadores

Haz clic en “Smart Config” y la utilidad realizará el resto automáticamente.

Configuración de la cámara en los ajustes de SwingCatalyst

Asegúrate de que la cámara esté conectada al ordenador y de que el LED en la parte trasera de la cámara parpadee en verde.

Inicia SwingCatalyst y haz clic en Configuración -> Cámaras. Imagen del menú de configuración de cámaras Imagen del menú de configuración de cámaras

Las cámaras Spinnaker aparecen identificadas con la palabra Spinnaker en la lista de cámaras.

Haz clic en Avanzado…

Imagen de la ventana de configuración avanzada de cámara Imagen de la ventana de configuración avanzada de cámara

La ventana de Configuración Avanzada de Cámara muestra todas las configuraciones que pueden resultar útiles; veamos cada ajuste individualmente.

Los ajustes que se muestran arriba son los de la cámara por defecto. Ten en cuenta que la mayoría están en modo Auto; podemos modificarlos para tener un mayor control sobre la calidad de imagen para el análisis deportivo.

Imagen de los ajustes avanzados de cámara Imagen de los ajustes avanzados de cámara

Cambio de la velocidad de fotogramas:

Marcar la casilla de habilitación del control de velocidad de fotogramas te permitirá establecerla manualmente. Si esta casilla no está marcada, la velocidad de fotogramas se ajusta esencialmente en Auto (nota: la velocidad de fotogramas máxima de esta cámara es de 78 FPS; para alcanzar la velocidad máxima, todos los ajustes deben configurarse en manual).

La velocidad de fotogramas puede estar limitada por la velocidad de obturación y los ajustes de rendimiento del enlace del dispositivo. En este caso, para alcanzar la velocidad de fotogramas completa, debemos aumentar el rendimiento (más información al respecto más adelante).

Imagen del ajuste de velocidad de fotogramas Imagen del ajuste de velocidad de fotogramas

Cambio de la velocidad de obturación:

A menos que estemos al aire libre con luz solar, es mejor usar una velocidad de obturación manual; de lo contrario, es probable que el vídeo resulte demasiado borroso para el análisis deportivo. Para reducir el desenfoque de movimiento, recomendamos una velocidad de obturación inferior a 2 ms (2000 μs); con una iluminación adecuada, la velocidad de obturación puede ser inferior a 1 ms (1000 μs).

Imagen del ajuste de velocidad de obturación Imagen del ajuste de velocidad de obturación

El brillo de la imagen de vídeo depende de la combinación entre la velocidad de obturación, los ajustes de Gain, la apertura del objetivo y la cantidad de luz disponible.

Cambio del Gain de la cámara:

Tener el Gain en Auto es preferible en condiciones de luz cambiante, pero si trabajas en un entorno cerrado, configurar el Gain en manual es la mejor opción.

Cuanto mayor sea el valor en dB, más brillante será la imagen; sin embargo, también habrá más ruido como resultado, lo que puede hacer que la calidad general del vídeo parezca peor. A veces vale la pena tener un Gain ligeramente más alto a costa del ruido, con el fin de reducir la velocidad de obturación y obtener un vídeo nítido fotograma a fotograma de un objeto (p. ej., el palo en el Impacto, un bate de béisbol, etc.).

Imagen del ajuste de Gain Imagen del ajuste de Gain

Cambio de Gamma y niveles de negro:

El nivel de negro puede considerarse una forma de ajuste de brillo, donde el nivel de negro corresponde al valor mínimo que cualquier píxel del sensor de la cámara puede devolver.

Al aumentar el valor del nivel de negro podemos hacer la imagen más brillante.

Nuestra recomendación es dejar estos valores en los ajustes predeterminados.

Imagen del ajuste de Gamma y nivel de negro Imagen del ajuste de Gamma y nivel de negro

Para más detalles sobre cómo mejorar la imagen de vídeo, consulta este artículo de soporte que incluye fotos comparativas: improving-image-quality.md

Cambio del balance de blancos de la cámara:

Imagen del ajuste de balance de blancos Imagen del ajuste de balance de blancos

Normalmente recomendamos dejar este ajuste en Auto (continuo), pero para alcanzar la velocidad de fotogramas máxima también es necesario desactivarlo.

El balance de blancos afecta a la temperatura de color de la imagen de vídeo, y si el balance de blancos es muy incorrecto, la imagen no tendrá buen aspecto, dejándola con un tono demasiado rojo o verde con frecuencia.

Al activar el balance de blancos automático sacrificamos algo de velocidad de fotogramas, quedándonos en 200 FPS en lugar de los 226 FPS máximos de la cámara.

Rendimiento del enlace del dispositivo:

En las cámaras GigE, el rendimiento del enlace del dispositivo y el tamaño del paquete están relacionados entre sí, en el sentido de que para usar el mayor rendimiento posible, el tamaño del paquete debe establecerse en 9000. Para alcanzar la velocidad de fotogramas completa, esto debe hacerse obligatoriamente.

Imagen del ajuste de rendimiento del enlace del dispositivo Imagen del ajuste de rendimiento del enlace del dispositivo

Aplicación de la Region of Interest (ROI):

Imagen del ajuste de Region of Interest Imagen del ajuste de Region of Interest

La Region of Interest es una forma de reducir el tamaño de la imagen y, por extensión, también el ancho de banda necesario para cada imagen. Al reducir el tamaño de la imagen, podemos aumentar la velocidad de fotogramas, ya que el requisito total de lectura de píxeles es menor.

Reducir la altura y el ancho puede tener un efecto positivo en la velocidad de fotogramas y en la reducción de los requisitos de ancho de banda.

Para cambiar la Region of Interest, podemos arrastrar el control deslizante de altura hacia la izquierda para reducir la altura de la imagen.

GIF de ajuste de la ROI GIF de ajuste de la ROI

Como hemos cambiado la altura de la imagen, ahora también podemos modificar el desplazamiento en Y, lo que puede ser útil como alternativa a mover físicamente la cámara debido al tamaño reducido de la imagen.

GIF de ajuste del desplazamiento Y GIF de ajuste del desplazamiento Y

Si volvemos a la pestaña de Cámara y miramos la velocidad de fotogramas, ahora vemos que la velocidad de fotogramas máxima puede aumentarse; esto se debe a que hemos aplicado una Region of Interest reduciendo la altura del sensor de la cámara.

Imagen de la pestaña de cámara con la nueva velocidad de fotogramas Imagen de la pestaña de cámara con la nueva velocidad de fotogramas

Solución de problemas

Consulta nuestras recomendaciones sobre GigE Vision / Gigabit Ethernet:

gige-network-setup.md

**Note: **Recomendamos a todos los usuarios de los modelos Blackfly BFS-PGE-04S2C que actualicen el firmware de cada cámara:

Instrucciones de FLIR sobre cómo actualizar el firmware: http://softwareservices.flir.com/BFS-U3-50S5-BD2/latest/Family/Firmware.htm

Archivo de firmware para descargar: https://flir.app.boxcn.net/s/jr65evml5bkuqnh29sx49lm3clf7nr0k

Fotogramas perdidos:

Aunque la mayoría de las cámaras GigE son muy fiables, dependiendo de la configuración de red y de la cámara puede ser necesario ajustar los parámetros para evitar la pérdida de fotogramas.

Asegúrate de que el tamaño del paquete esté configurado en 9000; esto es fundamental para un buen Rendimiento, de lo contrario existe una posibilidad real de perder fotogramas. También es importante que el adaptador de red esté configurado para usar tramas jumbo de 9 kB, de modo que tanto la cámara como el adaptador de red coincidan.

Imagen del ajuste de tamaño de paquete Imagen del ajuste de tamaño de paquete

Una cámara GigE con una resolución de 1440 x 1200 a 78 FPS utilizará aproximadamente 134 MB/s por cámara. Por ello, es importante disponer de una tarjeta controladora de red dedicada, según nuestras recomendaciones, para configuraciones con varias cámaras (en la mayoría de los casos). Si has adquirido una cámara GigE a través de nosotros, dispondrás de una tarjeta de red de doble puerto PCI Express para instalar.

Normalmente no recomendamos conectar más de una cámara a un mismo adaptador de red.

Filtro de Driver:

..

Region of Interest (ROI):

Usar una Region of Interest (o área de interés) reducirá el tamaño total de la imagen y aumentará los FPS; además, puede ayudar a reducir el uso de ancho de banda, lo que a su vez podría disminuir la pérdida de fotogramas (consulta más arriba cómo utilizar la ROI).

Otros problemas:

Dependiendo del hardware, puede que no sea conveniente tener activados los filtros de nitidez y reducción de ruido; desactivarlos reducirá algo el uso de CPU y GPU. Puedes encontrar los filtros de cámara en la pestaña Filtros de la Configuración Avanzada de Cámara. Más información sobre los filtros aquí: improving-image-quality.md

Explicación de los indicadores de estado

LEDSignificadoRecomendación
Sin luzSin alimentación, o el LED está en estado inactivo, o el LED está en estado de error sin ningún errorIntenta desconectar y volver a conectar la cámara; si el problema persiste, comprueba el cable o la fuente de alimentación
Parpadeo verde (1 parpadeo)El dispositivo está configurado para usar una Dirección de enlace local (LLA)No es un problema
Parpadeo verde (2 parpadeos)Dirección IP persistenteEl dispositivo está configurado con IP persistente
Parpadeo verde (3 parpadeos)Dirección IP DHCPEl dispositivo está configurado para usarse con DHCP (generalmente no recomendado; recomendamos establecer una IP estática / persistente)
Verde fijoAdquisición iniciadaLa cámara está transmitiendo vídeo
Parpadeo verde rápidoActualización de firmwareHay una actualización de firmware en curso
Parpadeo verde y rojoError generalLa cámara está en estado de error; intenta reiniciar la cámara cortando la alimentación

Última actualización: 2025-05-07 | Ver en el sitio de soporte oficial