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

Revision: 5.7.3.5, 06/18/2019

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 mínimos y recomendados para el hardware del PC

Notas:

Los siguientes requisitos mínimos de hardware se refieren a los PC que estén conectados a un único sistema de visión In-Sight de baja resolución que se ejecute a una velocidad de producción lenta.
Los siguientes requisitos de hardware recomendados se refieren a los PC que estén conectados simultáneamente hasta a cuatro sistemas de visión In-Sight.

Mínimo	Recomendado
Procesador Intel^® Celeron^® 1000M con una velocidad de 1,8 GHz (o equivalente)	Procesador Intel Core™ i7 con una velocidad de 2,7 GHz (o equivalente)
2 GB de memoria RAM disponible	4 GB de memoria RAM disponibles
4 GB de espacio libre en disco duro	8 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 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 interfaz de red (de al menos 100 Mbps) para conectarse a un sistema de visión In-Sight	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.7.3 contiene dos versiones de firmware:

In-Sight 5.7.3
In-Sight 4.10.5 PR1

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.7.3

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
Sistemas de visión In-Sight de la serie 9000
Motor de ventajas de In-Sight

Firmware de In-Sight, versión 4.10.5 PR1

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.

Nota: Si intenta instalar SDK de In-Sight en un sistema con Microsoft .NET Framework 3.5 deshabilitado cuando se están instalando actualizaciones de Windows, puede salirle el siguiente mensaje de error: Error al instalar Microsoft .NET Framework; código de error 0x800f081f. Si le ocurre eso, espere a que se completen las actualizaciones de Windows reinicie si es necesario y, acto seguido, instale SDK de In-Sight.

Entornos de desarrollo compatibles

Microsoft Visual Studio 2013
Microsoft Visual Studio 2015

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 problemas 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.

N.º problema	Problema
82151	El SDK de In-Sight no logra cargar una tarea desde un PC local en un sistema de visión usando la función CvsInSightDisplay.InSight.File.LoadJobFileLocally (). Solución alternativa: para cargar una tarea desde un PC local su un sistema de visión, siga estos pasos: Use CvsInSightDisplay.InSight.File.SendFileToInSight () para enviar la tarea desde su PC hasta el sistema de visión. Use CvsInSightDisplay.InSight.File.LoadJobFile () para cargar la tarea desde su sistema de visión.
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: di 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.
11930	Se recomienda asegurarse de que el sistema de visión esté desconectado antes de ejecutar el método SetExpression.

N.º problema

Problema

82151

El SDK de In-Sight no logra cargar una tarea desde un PC local en un sistema de visión usando la función CvsInSightDisplay.InSight.File.LoadJobFileLocally ().

Solución alternativa: para cargar una tarea desde un PC local su un sistema de visión, siga estos pasos:

Use CvsInSightDisplay.InSight.File.SendFileToInSight () para enviar la tarea desde su PC hasta el sistema de visión.
Use CvsInSightDisplay.InSight.File.LoadJobFile () para cargar la tarea desde su sistema de visión.

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: di 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.

11930

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