Notas de la versión 5.6.1 del SDK de In-Sight®

Revision: 5.6.1.4, 09/14/2018

Resumen

Este documento describe el kit de desarrollo de software (SDK) de In-Sight para Microsoft^® Windows^®. Contiene los siguientes temas:

Acerca del SDK de In-Sight
Requisitos del sistema
Instalación
Proyectos de ejemplo
Modificaciones en la interfaz de programación de aplicaciones (API)
Problemas conocidos

Consulte también las notas de la versión de In-Sight Display Control para obtener información específica sobre el control CvsInSightDisplay.

Acerca del SDK de In-Sight

El SDK de In-Sight es una plataforma de desarrollo de aplicaciones personalizadas que interactúan con los sistemas de visión In-Sight en una red. Los programas desarrollados con el SDK de In-Sight pueden variar en complejidad, desde un simple In-Sight Display Control acoplado a un formulario hasta potentes aplicaciones con carga de tareas, almacenamiento de imágenes y comunicación a través de varios canales de entrada y salida.

Visite el Centro de asistencia en línea de In-Sight para descargar las notas de la versión y la documentación más recientes, incluidas las versiones localizadas.

Nota: Las series In-Sight Micro 1020, In-Sight 2000 e In-Sight 7020, 7010, 7230, 7430 y 7432 no son compatibles con el SDK de In-Sight.

Requisitos del sistema

Esta sección describe los requisitos del sistema para el SDK de In-Sight.

Requisitos de hardware mínimos para PC

Los siguientes requisitos mínimos de hardware se refieren a los PC que conecte a un único sistema de visión In-Sight de baja resolución que se ejecute a una velocidad de producción lenta:

Procesador Intel^® Celeron^® 1000M con una velocidad de 1,8 GHz (o equivalente)
2 GB de memoria RAM disponible
4 GB de espacio libre en disco duro
Tarjeta de vídeo con una resolución de 1024 x 768 puntos y una profundidad de color de 24 bits (el ajuste de pantalla DPI debe ajustarse a 96 DPI)
Tarjeta de interfaz de red (de al menos 100 Mbps) para conectarse a un sistema de visión In-Sight

Requisitos de hardware recomendados para PC

Los siguientes requisitos de hardware recomendados se refieren a los PC a los que conecte simultáneamente hasta cuatro sistemas de visión In-Sight:

Procesador Intel Core™ i7 con una velocidad de 2,7 GHz (o equivalente)
4 GB de memoria RAM disponibles
8 GB de espacio libre en disco duro
Tarjeta de vídeo con una resolución de 1920 x 1080 puntos y una profundidad de color de 32 bits (el ajuste de pantalla DPI debe ajustarse a 96 DPI)
Tarjeta de red Gigabit para la conexión a sistemas de visión In-Sight

Requisitos del sistema operativo

El software In-Sight ha sido probado en los siguientes sistemas operativos:

Microsoft Windows 10 Professional (versión de 64 bits)
Microsoft Windows 7 Professional, Service Pack 1 (versión de 64 bits)
Microsoft Windows Server 2016

Aunque el SDK de In-Sight puede funcionar en otros sistemas operativos, los sistemas que no cumplan los requisitos indicados no han sido probados y no se consideran compatibles.

Idiomas disponibles

Chino (simplificado)
Inglés
Francés
Alemán
Japonés
Coreano
Español (europeo)

Compatibilidad con versiones de firmware

El software In-Sight 5.6.1 contiene tres versiones de firmware:

In-Sight 5.6.1
In-Sight 5.2.2
In-Sight 4.10.5

Los sistemas de visión In-Sight que tengan versiones de firmware anteriores pueden funcionar correctamente. Sin embargo, algunas funciones no son compatibles con versiones de firmware anteriores y no han sido probadas de forma exhaustiva. Para disfrutar de un rendimiento óptimo, actualice los sistemas de visión que ejecuten algún firmware anterior a las versiones de firmware compatibles más recientes. Para ver una lista completa de los modelos y las versiones de firmware compatibles, véase el tema Versiones de firmware del archivo Ayuda de In-Sight^® Explorer.

Firmware de In-Sight, versión 5.6.1

Sensores de visión In-Sight de la serie 2000
Sistemas de visión In-Sight 5705 y 5705C
Sistemas de visión In-Sight de la serie 7000 Gen2
Sistemas de visión In-Sight de la serie 8000
Sistema de visión de exploración por líneas In-Sight 9902L

Firmware de In-Sight, versión 5.2.2

Motor de ventajas de In-Sight

Firmware de In-Sight, versión 4.10.5

Sistemas de visión In-Sight de la serie Micro 1000
Sistemas de visión In-Sight de la serie 5000 (excepto los sistemas de visión In-Sight 5705 y 5705C)
Sistemas de visión In-Sight de la serie 7000 (salvo sistemas de visión In-Sight de la serie 7000 Gen2)

Nota:

Las series In-Sight Micro 1020, In-Sight 2000 e In-Sight 7020, 7010, 7230, 7430 y 7432 no son compatibles con el SDK de In-Sight.
Durante la comunicación con sistemas de visión In-Sight con firmware de las versiones 5.1.0 y posteriores de In-Sight, los usuarios deben enviar un mensaje al sistema de visión para obtener la imagen y los resultados más recientes. Si se utiliza CvsInSightDisplay y está visible, esto se gestiona de forma automática. De no ser así, los usuarios deben llamar a CvsInSight.AcceptUpdate() o CvsInSightDisplay.AcceptUpdate() cuando estén listos para recibir resultados nuevos.
La comunicación con los sistemas de visión In-Sight con firmware de la versión 4.x.x de In-Sight no ha cambiado. No es necesario llamar a CvsInSight.AcceptUpdate() ni tampoco tendrá efecto en la recepción de las imágenes y los resultados.

Microsoft .NET Framework 4.5

El software In-Sight requiere Microsoft .NET Framework 4.5. Si el programa de instalación del software de In-Sight no detecta Microsoft .NET Framework 4.5, intentará descargarlo e instalarlo.

Entornos de desarrollo compatibles

Microsoft Visual Studio 2013
Microsoft Visual Studio 2012

Nota:

Microsoft Visual Basic 6.0, Rockwell Automation FactoryTalk® View Site Edition (SE) y las aplicaciones host de ActiveX compatibles admiten los controles ActiveX.
Para crear herramientas de ToolBuilder para EasyBuilder, también se necesita la utilidad de generación de GUID (guidgen.exe). Esta utilidad está incluida en Microsoft Visual Studio. Para obtener más información sobre guidgen.exe, consulte el portal de MSDN.

Asistencia técnica de ToolBuilder

El SDK de In-Sight permite crear herramientas EasyBuilder personalizadas (para más información, consulte la Guía de Referencia del Programador de ToolBuilder). Todas las herramientas para EasyBuilder creadas con ToolBuilder deben colocarse en el siguiente directorio para que la aplicación In-Sight Explorer pueda encontrarlas: C:\Program Files (x86)\Cognex\In-Sight\In-Sight Explorer 5.x.x\AddIns. Al crear herramientas para EasyBuilder con ToolBuilder, la DLL de la herramienta debe colocarse en el directorio In-Sight Explorer 5.x.x\AddIns. Copie al directorio AddIns todos los archivos DLL de ToolBuilder creados anteriormente.

Instalación

Para poder instalar el SDK de In-Sight, es necesario haber iniciado sesión como usuario con privilegios administrativos completos.

Nota: Las aplicaciones COM/ActiveX desarrolladas con cualquier otra versión del SDK de In-Sight o de In-Sight Display Control son incompatibles con esta versión y no funcionarán correctamente. Para que dichas aplicaciones personalizadas funcionen, será necesario volver a compilarlas específicamente para esta versión, o bien volver a instalar la versión original. (CR# 5084)

Proyectos de ejemplo

Los proyectos de ejemplo del SDK de In-Sight se instalan en la siguiente carpeta: C:\Users\Public\Documents\Cognex\In-Sight\In-Sight Sample Projects 5.x.x. El menú Inicio contiene un acceso directo para facilitar el acceso a esta ubicación.

Problemas conocidos

Nota: Las notas de versión incluyen (donde corresponda) números de solicitud de modificación (CR#) para mejorar el seguimiento de problemas conocidos y tratados por la Asistencia técnica de Cognex. Para obtener información sobre problemas conocidos relacionados con In-Sight Display Control (CvsInSightDisplay) de Cognex, consulte las notas de la versión de In-Sight Display Control.

CR#	Problema
31753	Los elementos del SDK de In-Sight (por ejemplo, CvsInSightDisplay) que necesiten actualizarse solo solicitarán actualizaciones si están visibles, no si están ocultos o minimizados. Solución alternativa: Si en este supuesto fuera necesario realizar actualizaciones, debe añadirse una llamada a CvsInSight.AcceptUpdate() y/o a CvsInSightDisplay.AcceptUpdate() cuando deban recuperarse resultados nuevos del sistema de visión In-Sight. Se recomienda adjuntar un controlador al evento CvsInSight.ResultsChanged y, una vez controlados los resultados, llamar a CvsInSight.AcceptUpdate.
15264	Al compilar una aplicación del SDK de In-Sight en un sistema operativo de 64 bits, debe ajustar la plataforma de destino a x86. Si la plataforma de destino tiene asignado el valor Cualquier CPU o x64, puede que su aplicación se interrumpa con una excepción FileNotFoundException o BadImageFormatException. Solución alternativa: Para configurar su aplicación para una plataforma de destino x86 en Visual Studio: En Explorador de soluciones, haga clic con el botón derecho en su proyecto y seleccione Propiedades. Seleccione la ficha Generar. En la lista desplegable Plataforma de destino, elija x86. Nota: Para averiguar cómo resolver este problema en los diferentes tipos de proyecto, consulte el archivo de ayuda Referencia del SDK de In-Sight.
11930	Se recomienda asegurarse de que el sistema de visión esté desconectado antes de ejecutar el método SetExpression.

CR#

Problema

31753

Los elementos del SDK de In-Sight (por ejemplo, CvsInSightDisplay) que necesiten actualizarse solo solicitarán actualizaciones si están visibles, no si están ocultos o minimizados.

Solución alternativa: Si en este supuesto fuera necesario realizar actualizaciones, debe añadirse una llamada a CvsInSight.AcceptUpdate() y/o a CvsInSightDisplay.AcceptUpdate() cuando deban recuperarse resultados nuevos del sistema de visión In-Sight. Se recomienda adjuntar un controlador al evento CvsInSight.ResultsChanged y, una vez controlados los resultados, llamar a CvsInSight.AcceptUpdate.

15264

Al compilar una aplicación del SDK de In-Sight en un sistema operativo de 64 bits, debe ajustar la plataforma de destino a x86. Si la plataforma de destino tiene asignado el valor Cualquier CPU o x64, puede que su aplicación se interrumpa con una excepción FileNotFoundException o BadImageFormatException.

Solución alternativa: Para configurar su aplicación para una plataforma de destino x86 en Visual Studio:

En Explorador de soluciones, haga clic con el botón derecho en su proyecto y seleccione Propiedades.
Seleccione la ficha Generar.
En la lista desplegable Plataforma de destino, elija x86.

Nota: Para averiguar cómo resolver este problema en los diferentes tipos de proyecto, consulte el archivo de ayuda Referencia del SDK de In-Sight.

11930

Se recomienda asegurarse de que el sistema de visión esté desconectado antes de ejecutar el método SetExpression.