GUÍA DEL USUARIO
SERIE pixxiLCD
pixxiLCD-13P2/CTP-CLB
pixxiLCD-20P2/CTP-CLB
pixxiLCD-25P4/CTP
pixxiLCD-39P4/CTP

Serie pixxiLCD

*También disponible en la versión Cover Lens Bezel (CLB).

VARIANTES:
Procesador PIXXI (P2)
Procesador PIXXI (P4)
No táctil (NT)
Toque capacitivo (CTP)
Táctil capacitivo con bisel de lente de cubierta (CTP-CLB)
Esta guía del usuario lo ayudará a comenzar a usar los módulos pixxiLCD-XXP2/P4-CTP/CTP-CLB junto con WorkShop4 IDE. También incluye una lista de proyectos esenciales examparchivos y notas de aplicación.

¿Qué hay en la caja?

Los documentos de respaldo, la hoja de datos, los modelos de pasos CAD y las notas de aplicación están disponibles en www.4dsystems.com.au

Introducción

Esta Guía del usuario es una introducción para familiarizarse con el pixxiLCDXXP2/P4-CT/CT-CLB y el software IDE asociado con él. Este manual debe ser
tratado solo como un punto de partida útil y no como un documento de referencia completo. Consulte las Notas de aplicación para obtener una lista de todos los documentos de referencia detallados.

En esta Guía del usuario, nos centraremos brevemente en los siguientes temas:

• Requisitos de hardware y software
• Conexión del módulo de visualización a su PC
• Primeros pasos con proyectos simples
• Proyectos que utilizan pixxiLCD-XXP2/P4-CT/CT-CLB
• Notas de aplicación
• Documentos de referencia

El pixxiLCD-XXP2/P4-CT/CT-CLB es parte de la serie Pixxi de módulos de visualización diseñados y fabricados por 4D Systems. El módulo cuenta con una pantalla TFT LCD redonda de 1.3”, 2.0”, 2.5” o 3.9 colores, con toque capacitivo opcional. Está alimentado por el procesador de gráficos 4D Systems Pixxi22/Pixxi44 rico en funciones, que ofrece una variedad de funciones y opciones para el diseñador/integrador/usuario.
Los módulos de visualización inteligente son soluciones integradas de bajo costo que se utilizan en diversas aplicaciones en las industrias médica, manufacturera, militar, automotriz, domótica, electrónica de consumo y otras. De hecho, hay muy pocos diseños integrados en el mercado hoy en día que no tengan una pantalla. Incluso muchos electrodomésticos de consumo y electrodomésticos de cocina incorporan algún tipo de pantalla. Los botones, selectores giratorios, interruptores y otros dispositivos de entrada están siendo reemplazados por pantallas táctiles más coloridas y fáciles de usar en máquinas industriales, termostatos, dispensadores de bebidas, impresoras 3D, aplicaciones comerciales, prácticamente cualquier aplicación electrónica.
Para que los diseñadores/usuarios puedan crear y diseñar una interfaz de usuario para sus aplicaciones que se ejecutará en módulos de visualización inteligente 4D, 4D Systems proporciona un software IDE (Entorno de desarrollo integrado) gratuito y fácil de usar llamado "Workshop4" o "WS4". . Este software IDE se analiza con más detalle en la sección "Requisitos del sistema".

Requisitos del sistema

Las siguientes subsecciones tratan los requisitos de hardware y software para este manual.

Hardware

1. Módulo de pantalla inteligente y accesorios
El módulo de pantalla inteligente pixxiLCD-xxP2/P4-CT/CT-CLB y sus accesorios (placa adaptadora y cable flexible plano) están incluidos en la caja, que se le entrega después de su compra en nuestro websitio o a través de uno de nuestros distribuidores. Consulte la sección "Qué hay en la caja" para obtener imágenes del módulo de visualización y sus accesorios.
2. Módulo de programación
El módulo de programación es un dispositivo separado que se requiere para conectar el módulo de visualización a una PC con Windows. 4D Systems ofrece el siguiente módulo de programación:

• Cable de programación 4D
• Adaptador de programación uUSB-PA5-II
• 4D-UPA

Para utilizar el módulo de programación, primero se debe instalar el controlador correspondiente en la PC.
Puede consultar la página del producto del módulo dado para obtener más información e instrucciones detalladas.
NOTA: Este dispositivo está disponible por separado de 4D Systems. Consulte las páginas del producto para obtener más información.

3. Almacenamiento de medios
Workshop4 tiene widgets incorporados que se pueden usar para diseñar la interfaz de usuario de su pantalla. La mayoría de estos widgets deben almacenarse en un dispositivo de almacenamiento, como una tarjeta microSD o un flash externo, junto con el otro gráfico. files durante el paso de compilación.
NOTA: la tarjeta microSD y el flash externo son opcionales y solo se necesitan con proyectos que utilizan gráficos files.
Tenga en cuenta también que no todas las tarjetas microSD del mercado son compatibles con SPI y, por lo tanto, no todas las tarjetas se pueden utilizar en los productos de 4D Systems. Compre con confianza, elija las tarjetas recomendadas por 4D Systems.

4. PC con Windows
Workshop4 solo se ejecuta en el sistema operativo Windows. Se recomienda su uso en Windows 7 hasta Windows 10, pero aún debería funcionar con Windows XP. Algunos sistemas operativos más antiguos, como ME y Vista, no se han probado durante bastante tiempo; sin embargo, el software aún debería funcionar.
Si desea ejecutar Workshop4 en otros sistemas operativos como Mac o Linux, se recomienda configurar una máquina virtual (VM) en su PC.

Software

1. Taller4 IDE
Workshop4 es un IDE de software completo para Microsoft Windows que proporciona una plataforma de desarrollo de software integrada para toda la familia de procesadores y módulos de 4D. El IDE combina el Editor, el Compilador, el Enlazador y el Descargador para desarrollar un código de aplicación 4DGL completo. Todo el código de la aplicación del usuario se desarrolla dentro del IDE de Workshop4.
Workshop4 incluye tres entornos de desarrollo, para que el usuario elija según los requisitos de la aplicación o incluso el nivel de habilidad del usuario: Designer, ViSi–Genie y ViSi.

Workshop4 Ambientes
Diseñador
Este entorno permite al usuario escribir código 4DGL en su forma natural para programar el módulo de visualización.

ViSi – Genio
Un entorno avanzado que no requiere ninguna codificación 4DGL en absoluto, todo se hace automáticamente para usted. Simplemente coloque la pantalla con los objetos que desee (similar a ViSi), configure los eventos para controlarlos y el código se escribirá automáticamente. ViSi-Genie proporciona la última experiencia de desarrollo rápido de 4D Systems.

Vi Si
Una experiencia de programación visual que permite la colocación de objetos del tipo arrastrar y soltar para ayudar con la generación de código 4DGL y permite al usuario visualizar cómo
la pantalla se verá mientras se revela.

2. Instalar Taller4
Los enlaces de descarga para el instalador de WS4 y la guía de instalación se pueden encontrar en la página del producto de Workshop4.

Conexión del módulo de pantalla a la PC
Esta sección muestra las instrucciones completas para conectar la pantalla a la PC. Hay tres (3) opciones de instrucciones en esta sección, como se muestra en las imágenes a continuación. Cada opción es específica de un módulo de programación. Siga únicamente las instrucciones aplicables al módulo de programación que está utilizando.

Opciones de conexión

Opción A: uso de 4D-UPA

1. Conecte un extremo del FFC al zócalo ZIF de 15 vías del pixxiLCD con los contactos metálicos del FFC mirando hacia el pestillo.
2. Conecte el otro extremo del FFC al enchufe ZIF de 30 vías en el 4D-UPA con los contactos metálicos del FFC mirando hacia el pestillo
3. Conecte el cable USB-Micro-B al 4D-UPA.
4. Por último, conecte el otro extremo del cable USB-Micro-B a la computadora.

Opción B: uso del cable de programación 4D

1. Conecte un extremo del FFC al zócalo ZIF de 15 vías del pixxiLCD con los contactos metálicos del FFC mirando hacia el pestillo.
2. Conecte el otro extremo del FFC al enchufe ZIF de 30 vías en el gen4-IB con los contactos metálicos del FFC mirando hacia el pestillo.
3. Conecte el cabezal hembra de 5 pines del cable de programación 4D al gen4-IB siguiendo la orientación de las etiquetas del cable y del módulo. También puede hacerlo con la ayuda del cable plano suministrado.
4. Conecte el otro extremo del cable de programación 4D a la computadora.

Opción C: uso del uUSB-PA5-II

1. Conecte un extremo del FFC al zócalo ZIF de 15 vías del pixxiLCD con los contactos metálicos del FFC mirando hacia el pestillo.
2. Conecte el otro extremo del FFC al enchufe ZIF de 30 vías en el gen4-IB con los contactos metálicos del FFC mirando hacia el pestillo.
3. Conecte el cabezal hembra de 5 pines del uUSB-PA5-II al gen4-IB siguiendo la orientación en las etiquetas del cable y del módulo. También puede hacerlo con la ayuda del cable plano suministrado.
4. Conecte un cable USB-Mini-B al uUSB-PA5-II.
5. Por último, conecta el otro extremo del uUSB-Mini-B a la computadora.

Deje que WS4 identifique el módulo de visualización

Después de seguir el conjunto apropiado de instrucciones en la sección anterior, ahora necesita configurar Workshop4 para asegurarse de que identifique y se conecte al módulo de visualización correcto.

1. Abra Workshop4 IDE y cree un nuevo proyecto.
2. Seleccione el módulo de visualización que está utilizando de la lista.
3. Seleccione la orientación deseada para su proyecto.
4. Haga clic en siguiente.
5. Elija un entorno de programación WS4. Solo se habilitará el entorno de programación compatible para el módulo de pantalla.
   
6. Haga clic en la pestaña COMMS, seleccione el puerto COM al que está conectado el módulo de visualización en la lista desplegable.
7. Haga clic en el Punto ROJO para comenzar a buscar el módulo de visualización. Aparecerá un punto AMARILLO durante el escaneo. Asegúrese de que su módulo esté conectado correctamente.
8. Por último, una detección exitosa le dará un punto AZUL con el nombre del módulo de visualización que se muestra junto a él.
9. Haga clic en la pestaña Inicio para comenzar a crear su proyecto.

Comenzando con un proyecto simple

Después de conectar con éxito el módulo de pantalla a la PC usando su módulo de programación, ahora puede comenzar a crear una aplicación básica. Esta sección muestra cómo diseñar una interfaz de usuario simple utilizando el entorno de ViSi-Genie y utilizando los controles deslizantes y de calibre.
El proyecto resultante consta de un control deslizante (un widget de entrada) que controla un indicador (un widget de salida). Los widgets también se pueden configurar para enviar mensajes de eventos a un dispositivo host externo a través del puerto serie.

Crear un nuevo proyecto ViSi-Genie
Puede crear un proyecto de ViSi-Genie abriendo Workshop y eligiendo el tipo de pantalla y el entorno con el que desea trabajar. Este proyecto utilizará el entorno ViSi-Genie.

1. Abra Workshop4 haciendo doble clic en el icono.
2. Crear nuevo proyecto con la nueva pestaña.
3. Elija su tipo de visualización.
4. Haga clic en Siguiente.
5. Elija el entorno ViSi-Genie.

Agregar un widget de control deslizante
Para agregar un control deslizante, simplemente haga clic en la pestaña Inicio y elija los widgets de entrada. De la lista, puede elegir el tipo de widget que desea utilizar. En este caso, se selecciona el control deslizante.

Simplemente arrastre y suelte el widget hacia la sección Lo que ve es lo que obtiene (WYSIWYG).

Agregar un widget de indicador
Para agregar un widget de indicador, vaya a la sección Indicadores y elija el tipo de indicador que desea usar. En este caso, se selecciona el widget Coolgauge.

Arrástrelo y suéltelo en la sección WYSIWYG para continuar.

Vincular el widget
Los widgets de entrada se pueden configurar para controlar un widget de salida. Para hacer esto, simplemente haga clic en la entrada (en este ej.ample, el control deslizante) y vaya a su sección Inspector de objetos y haga clic en la pestaña Eventos.
Hay dos eventos disponibles en la pestaña de eventos de un widget de entrada: OnChanged y OnChanging. Estos eventos se activan mediante acciones táctiles realizadas en el widget de entrada.
El evento OnChanged se activa cada vez que se libera un widget de entrada. Por otro lado, el evento OnChanging se activa continuamente mientras se toca un widget de entrada. en este example, se utiliza el evento OnChanging. Configure el controlador de eventos haciendo clic en el símbolo de puntos suspensivos para el controlador de eventos OnChanging.

Aparece la ventana de selección en el evento. Seleccione coolgauge0Set, luego haga clic en Aceptar.

Configurar el widget de entrada para enviar mensajes a un anfitrión
Un host externo, conectado al módulo de visualización a través del puerto serie, puede conocer el estado de un widget. Esto se puede lograr configurando el widget para enviar mensajes de eventos al puerto serie. Para hacer esto, establezca el controlador de eventos OnChanged del control deslizante en Mensaje de informe.

Tarjeta microSD/memoria flash serie integrada
En los módulos de visualización Pixxi, los datos gráficos de los widgets se pueden almacenar en la tarjeta microSD/memoria flash serial integrada, a la que accederá el procesador de gráficos del módulo de visualización durante el tiempo de ejecución. Luego, el procesador de gráficos mostrará los widgets en la pantalla.

El PmmC apropiado también debe cargarse en el módulo Pixxi para usar el dispositivo de almacenamiento respectivo. El PmmC para compatibilidad con tarjetas microSD tiene el sufijo "-u", mientras que el PmmC para compatibilidad con memoria flash serie integrada tiene el sufijo "-f".
Para cargar manualmente el PmmC, haga clic en la pestaña Herramientas y seleccione PmmC Loader.

Construir y compilar el proyecto
Para compilar/cargar el proyecto, haga clic en el icono (Crear) Copiar/Cargar.

Copie lo requerido Filede s a
la tarjeta microSD/memoria flash serie integrada

Tarjeta micro SD
WS4 genera los gráficos requeridos files y le pedirá la unidad en la que está montada la tarjeta microSD. Asegúrese de que la tarjeta microSD esté instalada correctamente en la PC, luego seleccione la unidad correcta en la ventana Confirmación de copia, como se muestra en la imagen a continuación.

Haga clic en Aceptar después de la fileLos correos electrónicos se transfieren a la tarjeta microSD. Desmonte la tarjeta microSD de la PC e insértela en la ranura para tarjeta microSD del módulo de visualización.

Memoria flash en serie integrada
Al seleccionar la memoria Flash como destino de los gráficos file, asegúrese de que no haya ninguna tarjeta microSD conectada en el módulo
Aparecerá una ventana de confirmación de copia como se muestra en el mensaje a continuación.

Haga clic en Aceptar y un File Aparecerá la ventana de transferencia. Espere a que finalice el proceso y los gráficos ahora se mostrarán en el módulo de visualización.

Prueba la aplicación
La aplicación ahora debería ejecutarse en el módulo de visualización. Ahora deberían mostrarse los widgets de control deslizante y de indicador. Comience a tocar y mover el pulgar del control deslizante. Un cambio en su valor también debería resultar en un cambio en el valor del widget de indicador, ya que los dos widgets están vinculados.

Use la herramienta GTX para verificar los mensajes
Hay una herramienta en WS4 que se utiliza para comprobar los mensajes de eventos que envía el módulo de visualización al puerto serie. Esta herramienta se llama "GTX", que significa "Genie Test eXecutor". Esta herramienta también se puede considerar como un simulador para un dispositivo host externo. La herramienta GTX se puede encontrar en la sección Herramientas. Haga clic en el icono para ejecutar la herramienta.

Mover y soltar el pulgar del control deslizante hará que la aplicación envíe mensajes de eventos al puerto serie. Estos mensajes serán recibidos e impresos por la herramienta GTX. Para obtener más información sobre los detalles del protocolo de comunicación para las aplicaciones de ViSiGenie, consulte el Manual de referencia de ViSi-Genie. Este documento se describe en la sección “Documentos de referencia”.

Notas de aplicación

Nota de aplicación	Título	Descripción	Entorno compatible
4D-AN-00117	Primeros pasos del diseñador: primer proyecto	Esta nota de aplicación muestra cómo crear un nuevo proyecto usando Designer Environment. También presenta los conceptos básicos de 4DGL (Lenguaje de gráficos 4D).	Diseñador
4D-AN-00204	Primeros pasos con ViSi: primer proyecto para Pixxi	Esta nota de aplicación muestra cómo crear un nuevo proyecto utilizando el entorno ViSi. También presenta los conceptos básicos de 4DGL (Lenguaje de gráficos 4D) y el uso básico de la pantalla WYSIWYG (lo que ves es lo que obtienes).	Vi Si
4D-AN-00203	Genio ViSi Primeros pasos: primer proyecto para pantallas Pixxi	El proyecto simple desarrollado en esta nota de aplicación demuestra la funcionalidad táctil básica y la interacción de objetos usando el ViSi-Genie Ambiente. El proyecto ilustra cómo se configuran los objetos de entrada para enviar mensajes a un controlador de host externo y cómo se interpretan estos mensajes.	ViSi-Genio

Documentos de referencia

ViSi-Genie es el entorno recomendado para principiantes. Este entorno no implica necesariamente la codificación, lo que lo convierte en la plataforma más fácil de usar entre los cuatro entornos.
Sin embargo, ViSi-Genie tiene sus limitaciones. Para los usuarios que desean más control y flexibilidad durante el diseño y desarrollo de aplicaciones, se recomiendan los entornos Designer o ViSi. ViSi y Designer permiten a los usuarios escribir el código de sus aplicaciones.
El lenguaje de programación utilizado con los procesadores gráficos de 4D Systems se llama “4DGL”. A continuación se enumeran los documentos de referencia esenciales que se pueden utilizar para un estudio más profundo de los diferentes entornos.

Manual de referencia de ViSi-Genie
ViSi-Genie hace toda la codificación de fondo, no necesita aprender 4DGL, lo hace todo por usted. Este documento cubre las funciones de ViSi-Genie disponibles para los procesadores PIXXI, PICASO y DIABLO16 y el protocolo de comunicaciones utilizado conocido como Genie Standard Protocol.

Manual de referencia del programador 4DGL
4DGL es un lenguaje orientado a gráficos que permite un rápido desarrollo de aplicaciones. Una extensa biblioteca de gráficos, texto y file funciones del sistema y la facilidad de uso de un lenguaje que combina los mejores elementos y estructura sintáctica de lenguajes como C, Basic, Pascal, etc. Este documento cubre el estilo del lenguaje, la sintaxis y el control de flujo.

Manual de funciones internas
4DGL tiene una serie de funciones internas que se pueden utilizar para facilitar la programación. Este documento cubre las funciones internas (residentes en chip) disponibles para el procesador pixxi.

pixxiLCD-13P2/P2CT-CLB Hoja de datos
Este documento contiene información detallada sobre los módulos de visualización integrados pixxiLCD-13P2/P2CT-CLB.

pixxiLCD-20P2/P2CT-CLB Hoja de datos
Este documento contiene información detallada sobre los módulos de visualización integrados pixxiLCD-20P2/P2CT-CLB.

Hoja de datos de pixxiLCD-25P4/P4CT
Este documento contiene información detallada sobre los módulos de visualización integrados pixxiLCD-25P4/P4CT.

Hoja de datos de pixxiLCD-39P4/P4CT
Este documento contiene información detallada sobre los módulos de visualización integrados pixxiLCD-39P4/P4CT.

Workshop4 IDE Guía del usuario
Este documento proporciona una introducción a Workshop4, el entorno de desarrollo integrado de 4D Systems.

NOTA: Para obtener más información sobre Workshop4 en general, consulte la Guía del usuario de Workshop4 IDE, disponible en www.4dsystems.com.au

GLOSARIO

Hardware

1. Cable de programación 4D: el cable de programación 4D es un cable convertidor de USB a serie-TTL UART. El cable proporciona una forma rápida y sencilla de conectar todos los dispositivos 4D que requieren una interfaz serie de nivel TTL a USB.
2. Sistema integrado: un sistema operativo y de control programado con una función dedicada dentro de un sistema mecánico o eléctrico más grande, a menudo con
   Restricciones de computación en tiempo real. Está integrado como parte de un dispositivo completo que a menudo incluye hardware y piezas mecánicas.
3. Cabezal hembra: un conector conectado a un alambre, cable o pieza de hardware que tiene uno o más orificios empotrados con terminales eléctricos en el interior.
4. FFC: cable plano flexible, o FFC, se refiere a cualquier variedad de cable eléctrico que sea tanto plano como flexible. Solía ​​conectar la pantalla a un adaptador de programación.
5. gen4 – IB – Una interfaz simple que convierte el cable FFC de 30 vías proveniente de su módulo de pantalla gen4, en las 5 señales comunes utilizadas para la programación
   y la interfaz con los productos de 4D Systems.
6. gen4-UPA: un programador universal diseñado para trabajar con múltiples módulos de visualización de 4D Systems.
7. Cable micro USB: un tipo de cable que se utiliza para conectar la pantalla a una computadora.
8. Procesador: un procesador es un circuito electrónico integrado que realiza los cálculos que ejecutan un dispositivo informático. Su trabajo básico es recibir información y
   proporcionar la salida adecuada.
9. Adaptador de programación: se utiliza para programar módulos de pantalla gen4, conectarse a una placa de prueba para crear prototipos, conectarse a las interfaces Arduino y Raspberry Pi.
10. Panel táctil resistivo: una pantalla de computadora sensible al tacto compuesta por dos láminas flexibles recubiertas con un material resistivo y separadas por un espacio de aire o micropuntos.
11. Tarjeta microSD: un tipo de tarjeta de memoria flash extraíble que se utiliza para almacenar información.
12. uUSB-PA5-II: un convertidor de puente USB a Serial-TTL UART. Proporciona al usuario datos en serie de velocidad de transmisión múltiple hasta una velocidad de transmisión de 3M y acceso a señales adicionales, como control de flujo, en un conveniente paquete dual en línea de 10 pines y paso de 2.54 mm (0.1").
13. Fuerza de inserción cero: la parte donde se inserta el cable plano flexible.

Software

1. Puerto de comunicación: un puerto o canal de comunicación en serie que se utiliza para conectar dispositivos como su pantalla.
2. Controlador de dispositivo: una forma particular de aplicación de software diseñada para permitir la interacción con dispositivos de hardware. Sin el controlador de dispositivo requerido, el dispositivo de hardware correspondiente no funciona.
3. Firmware: una clase específica de software de computadora que proporciona control de bajo nivel para el hardware específico del dispositivo.
4. Herramienta GTX: depurador Genie Test Executor. Una herramienta utilizada para verificar los datos enviados y recibidos por la pantalla.
5. GUI: una forma de interfaz de usuario que permite a los usuarios interactuar con dispositivos electrónicos a través de iconos gráficos e indicadores visuales como notación secundaria,
   en lugar de interfaces de usuario basadas en texto, etiquetas de comando escritas o navegación de texto.
6. Imagen Files – Son gráficos files generados en la compilación del programa que deben guardarse en la tarjeta microSD.
7. Inspector de objetos: una sección en Workshop4 donde el usuario puede cambiar las propiedades de un determinado widget. Aquí es donde ocurre la personalización de widgets y la configuración de eventos.
8. Widget – Objetos gráficos en Workshop4.
9. WYSIWYG – Lo que ves es lo que obtienes. La sección del editor de gráficos en Workshop4 donde el usuario puede arrastrar y soltar widgets.

Visita nuestra websitio en: www.4dsystems.com.au
Apoyo técnico: www.4dsystems.com.au/support
Soporte de ventas: ventas@4dsystems.com.au

Copyright © 4D Systems, 2022, Todos los derechos reservados.
Todas las marcas comerciales pertenecen a sus respectivos dueños y son reconocidas y reconocidas.

Documentos / Recursos

4D SYSTEMS pixxiLCD-13P2-CTP-CLB Display Placa de expansión de evaluación de plataforma Arduino [pdf] Guía del usuario pixxiLCD-13P2-CTP-CLB, Display Placa de expansión de evaluación de plataforma Arduino, Placa de expansión de evaluación de plataforma, Placa de expansión de evaluación, pixxiLCD-13P2-CTP-CLB, Placa de expansión

Referencias

• Manual de usuario