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

Serie pixxiLCD

*Tamén dispoñible na versión Cover Lens Bezel (CLB).

VARIANTES:
Procesador PIXXI (P2)
Procesador PIXXI (P4)
Non Touch (NT)
Toque capacitivo (CTP)
Táctil capacitivo con bisel de lente de tapa (CTP-CLB)
Esta guía de usuario axudarache a comezar a usar os módulos pixxiLCD-XXP2/P4-CTP/CTP-CLB xunto co IDE WorkShop4. Tamén inclúe unha lista de proxectos imprescindibles exampficheiros e notas de aplicación.

O que hai na caixa

Os documentos de apoio, a folla de datos, os modelos de pasos CAD e as notas de aplicación están dispoñibles en www.4dsystems.com.au

Introdución

Esta guía de usuario é unha introdución para familiarizarse co pixxiLCDXXP2/P4-CT/CT-CLB e o IDE de software asociado a el. Este manual debería ser
tratado só como un punto de partida útil e non como un documento de referencia completo. Consulte as Notas de aplicación para obter unha lista de todos os documentos de referencia detallados.

Nesta guía de usuario, centrarémonos brevemente nos seguintes temas:

• Requisitos de hardware e software
• Conectando o módulo de visualización ao seu PC
• Iniciación a proxectos sinxelos
• Proxectos que utilizan pixxiLCD-XXP2/P4-CT/CT-CLB
• Notas de aplicación
• Documentos de referencia

O pixxiLCD-XXP2/P4-CT/CT-CLB forma parte da serie Pixxi de módulos de visualización deseñados e fabricados por 4D Systems. O módulo presenta unha pantalla LCD TFT de cor redonda de 1.3", 2.0", 2.5" ou 3.9, con táctil capacitivo opcional. Está alimentado polo procesador gráfico 4D Systems Pixxi22/Pixxi44 rico en funcións, que ofrece unha variedade de funcións e opcións para o deseñador/integrador/usuario.
Os módulos de visualización intelixentes son solucións integradas de baixo custo utilizadas en varias aplicacións en industrias médicas, de fabricación, militares, automoción, domótica, electrónica de consumo e outras industrias. De feito, hai moi poucos deseños integrados no mercado hoxe en día que non teñan pantalla. Incluso moitos produtos brancos de consumo e electrodomésticos de cociña incorporan algún tipo de exhibición. Os botóns, selectores rotativos, interruptores e outros dispositivos de entrada están a ser substituídos por pantallas táctiles máis coloridas e fáciles de usar en máquinas industriais, termostatos, dispensadores de bebidas, impresoras 3D, aplicacións comerciais, practicamente calquera aplicación electrónica.
Para que os deseñadores/usuarios poidan crear e deseñar unha interface de usuario para as súas aplicacións que se executará en módulos de visualización intelixente 4D, 4D Systems ofrece un IDE (Entorno de Desenvolvemento Integrado) gratuíto e fácil de usar chamado "Workshop4" ou "WS4". . Este IDE de software explícase con máis detalle na sección "Requisitos do sistema".

Requisitos do sistema

As seguintes subseccións tratan os requisitos de hardware e software para este manual.

Hardware

1. Módulo de visualización intelixente e accesorios
O módulo de visualización intelixente pixxiLCD-xxP2/P4-CT/CT-CLB e os seus accesorios (placa adaptadora e cable flexible plano) están incluídos na caixa, que se entregan despois da súa compra na nosa websitio ou a través dun dos nosos distribuidores. Consulte a sección "O que hai na caixa" para ver imaxes do módulo de visualización e os seus accesorios.
2. Módulo de programación
O módulo de programación é un dispositivo separado necesario para conectar o módulo de visualización a un PC con Windows. 4D Systems ofrece o seguinte módulo de programación:

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

Para utilizar o módulo de programación, primeiro debe instalarse no PC o controlador correspondente.
Podes consultar a páxina do produto do módulo indicado para obter máis información e instrucións detalladas.
NOTA: Este dispositivo está dispoñible por separado de 4D Systems. Consulte as páxinas do produto para obter máis información.

3. Almacenamento multimedia
Workshop4 ten widgets integrados que se poden usar para deseñar a túa interface de usuario. A maioría destes widgets deben almacenarse nun dispositivo de almacenamento, como unha tarxeta microSD ou un flash externo, xunto co outro gráfico. files durante o paso de compilación.
NOTA: A tarxeta microSD e o flash externo son opcionais e só se necesitan con proxectos que utilicen gráficos files.
Teña en conta tamén que non todas as tarxetas microSD do mercado son compatibles con SPI e, polo tanto, non todas as tarxetas poden usarse nos produtos 4D Systems. Compra con confianza, escolle as tarxetas recomendadas por 4D Systems.

4. PC con Windows
Workshop4 só funciona no sistema operativo Windows. Recoméndase usar en Windows 7 ata Windows 10 pero aínda debería funcionar con Windows XP. Algúns sistemas operativos máis antigos, como ME e Vista, non se probaron desde hai moito tempo, pero o software aínda debería funcionar.
Se queres executar o Workshop4 noutros sistemas operativos como Mac ou Linux, recoméndase configurar unha máquina virtual (VM) no teu PC.

Software

1. Taller4 IDE
Workshop4 é un IDE de software completo para Microsoft Windows que ofrece unha plataforma de desenvolvemento de software integrada para toda a familia de procesadores e módulos 4D. O IDE combina o editor, o compilador, o enlazador e o descargador para desenvolver o código de aplicación 4DGL completo. Todo o código da aplicación de usuario desenvólvese dentro do IDE Workshop4.
Workshop4 inclúe tres contornos de desenvolvemento, para que o usuario elixa en función dos requisitos da aplicación ou mesmo do nivel de habilidade do usuario: Designer, ViSi–Genie e ViSi.

Obradoiro 4 Ambientes
Deseñador
Este entorno permite ao usuario escribir código 4DGL na súa forma natural para programar o módulo de visualización.

ViSi - Xenio
Un ambiente avanzado que non require ningunha codificación 4DGL, todo faise automaticamente por ti. Simplemente coloque a pantalla cos obxectos que quere (semellante a ViSi), configure os eventos para que os conduzan e o código escríbese automaticamente. ViSi-Genie ofrece a última experiencia de desenvolvemento rápido de 4D Systems.

Visi
Unha experiencia de programación visual que permite a colocación de obxectos tipo arrastrar e soltar para axudar coa xeración de código 4DGL e permite ao usuario visualizar como
a pantalla verá mentres se desenvolve.

2. Instalar Workshop4
As ligazóns de descarga para o instalador e a guía de instalación de WS4 pódense atopar na páxina do produto Workshop4.

Conexión do módulo de visualización ao ordenador
Esta sección mostra as instrucións completas para conectar a pantalla ao PC. Nesta sección hai tres (3) opcións de instrucións, como se mostra nas imaxes a continuación. Cada opción é específica dun módulo de programación. Siga só as instrucións aplicables ao módulo de programación que está a usar.

Opcións de conexión

Opción A – Usando o 4D-UPA

1. Conecte un extremo do FFC á toma ZIF de 15 vías do pixxiLCD cos contactos metálicos do FFC orientados cara ao pestillo.
2. Conecte o outro extremo do FFC á toma ZIF de 30 vías do 4D-UPA cos contactos metálicos do FFC orientados cara ao pestillo.
3. Conecte o cable USB-Micro-B ao 4D-UPA.
4. Por último, conecte o outro extremo do cable USB-Micro-B ao ordenador.

Opción B - Usando o cable de programación 4D

1. Conecte un extremo do FFC á toma ZIF de 15 vías do pixxiLCD cos contactos metálicos do FFC orientados cara ao pestillo.
2. Conecte o outro extremo do FFC ao enchufe ZIF de 30 vías do gen4-IB cos contactos metálicos do FFC mirando cara ao pestillo.
3. Conecte o conector hembra de 5 pinos do cable de programación 4D ao gen4-IB seguindo a orientación das etiquetas dos cables e dos módulos. Tamén podes facelo coa axuda do cable de cinta que se proporciona.
4. Conecte o outro extremo do cable de programación 4D ao ordenador.

Opción C – Usando o uUSB-PA5-II

1. Conecte un extremo do FFC á toma ZIF de 15 vías do pixxiLCD cos contactos metálicos do FFC orientados cara ao pestillo.
2. Conecte o outro extremo do FFC ao enchufe ZIF de 30 vías do gen4-IB cos contactos metálicos do FFC mirando cara ao pestillo.
3. Conecte o conector femia de 5 pinos do uUSB-PA5-II ao gen4-IB seguindo a orientación das etiquetas dos cables e dos módulos. Tamén podes facelo coa axuda do cable de cinta que se proporciona.
4. Conecte un cable USB-Mini-B ao uUSB-PA5-II.
5. Por último, conecte o outro extremo do uUSB-Mini-B ao ordenador.

Deixa que WS4 identifique o módulo de visualización

Despois de seguir o conxunto apropiado de instrucións da sección anterior, agora cómpre configurar e configurar Workshop4 para asegurarse de que identifica e se conecta ao módulo de visualización correcto.

1. Abre o IDE de Workshop4 e crea un novo proxecto.
2. Seleccione o módulo de visualización que está a usar na lista.
3. Seleccione a orientación desexada para o seu proxecto.
4. Fai clic en seguinte.
5. Escolla un entorno de programación WS4. Só se activará o entorno de programación compatible para o módulo de visualización.
   
6. Fai clic na pestana COMMS, selecciona o porto COM ao que está conectado o módulo de visualización na lista despregable.
7. Fai clic no PUNTO VERMELLO para comezar a buscar o módulo de visualización. Amosarase un punto AMARELO durante a dixitalización. Asegúrese de que o módulo está conectado correctamente.
8. Por último, unha detección exitosa daralle un PUNTO AZUL co nome do módulo de visualización que se mostra xunto a el.
9. Fai clic na pestana Inicio para comezar a crear o teu proxecto.

Comezando cun proxecto sinxelo

Despois de conectar correctamente o módulo de visualización ao PC usando o módulo de programación, agora pode comezar a crear unha aplicación básica. Esta sección mostra como deseñar unha interface de usuario sinxela usando o ambiente ViSi-Genie e utilizando os widgets de control deslizante e indicador.
O proxecto resultante consiste nun control deslizante (un widget de entrada) que controla un indicador (un widget de saída). Os widgets tamén se poden configurar para enviar mensaxes de eventos a un dispositivo host externo a través do porto serie.

Crea un novo proxecto ViSi-Genie
Podes crear un proxecto ViSi-Genie abrindo Workshop e escollendo o tipo de visualización e o ambiente co que queres traballar. Este proxecto utilizará o ambiente ViSi-Genie.

1. Abre Workshop4 facendo dobre clic na icona.
2. Crea un novo proxecto coa nova pestana.
3. Escolla o seu tipo de visualización.
4. Fai clic en Seguinte.
5. Escolla ViSi-Genie Environment.

Engade un widget deslizante
Para engadir un widget deslizante, só tes que facer clic na pestana Inicio e escoller os Widgets de entradas. Na lista, pode escoller o tipo de widget que quere usar. Neste caso, o widget deslizante está seleccionado.

Só tes que arrastrar e soltar o widget cara á sección O que ves é o que obténs (WYSIWYG).

Engade un widget de indicador
Para engadir un widget de indicador, vai á sección Indicadores e escolla o tipo de indicador que quere usar. Neste caso, o widget Coolgauge está seleccionado.

Arrastre e solte cara á sección WYSIWYG para continuar.

Enlace o widget
Os widgets de entrada pódense configurar para controlar un widget de saída. Para facelo, basta con facer clic na entrada (neste example, o widget control deslizante) e vai á súa Sección Inspector de obxectos e fai clic na pestana Eventos.
Hai dous eventos dispoñibles na pestana de eventos dun widget de entrada: OnChanged e OnChanging. Estes eventos desenvólvense mediante accións táctiles realizadas no widget de entrada.
O evento OnChanged desenvólvese cada vez que se libera un widget de entrada. Por outra banda, o evento OnChanging desenvólvese continuamente mentres se toca un widget de entrada. Neste example, úsase o evento OnChanging. Establece o controlador de eventos facendo clic no símbolo de puntos suspensivos para o controlador de eventos OnChanging.

Aparece a xanela de selección do evento. Seleccione coolgauge0Set e prema en Aceptar.

Configure o widget de entrada para enviar mensaxes a un host
Un host externo, conectado ao módulo de visualización a través do porto serie, pódese facer consciente do estado dun widget. Isto pódese conseguir configurando o widget para enviar mensaxes de eventos ao porto serie. Para iso, configure o controlador de eventos OnChanged do widget deslizante en Informar de mensaxe.

Tarxeta microSD / Memoria flash serie integrada
Nos módulos de visualización Pixxi, os datos gráficos dos widgets pódense almacenar na tarxeta microSD/memoria flash serie integrada, á que accederá o procesador gráfico do módulo de visualización durante o tempo de execución. A continuación, o procesador gráfico mostrará os widgets na pantalla.

O PmmC axeitado tamén debe cargarse no módulo Pixxi para usar o dispositivo de almacenamento respectivo. O PmmC para compatibilidade con tarxetas microSD ten o sufixo "-u" mentres que o PmmC para soporte de memoria flash serie incorporada ten o sufixo "-f".
Para cargar manualmente o PmmC, fai clic na pestana Ferramentas e selecciona o cargador PmmC.

Construír e compilar o proxecto
Para crear/cargar o proxecto, fai clic na icona (Construír) Copiar/Cargar.

Copia o Requerido Files a
a tarxeta microSD/memoria flash serie integrada

tarxeta microSD
WS4 xera os gráficos necesarios files e pediralle a unidade na que está montada a tarxeta microSD. Asegúrese de que a tarxeta microSD estea correctamente montada no PC e, a continuación, seleccione a unidade correcta na xanela de confirmación de copia, como se mostra na imaxe de abaixo.

Fai clic en Aceptar despois de files transfírense á tarxeta microSD. Desmonte a tarxeta microSD do PC e insírela na ranura para tarxetas microSD do módulo de visualización.

Memoria flash serie integrada
Ao seleccionar a memoria flash como destino para os gráficos file, asegúrese de que non hai ningunha tarxeta microSD conectada ao módulo
Aparecerá unha xanela de confirmación de copia como se mostra na seguinte mensaxe.

Fai clic en Aceptar e a File A ventá de transferencia aparecerá. Agarde a que remate o proceso e agora os gráficos mostraranse no módulo de visualización.

Proba a aplicación
A aplicación debería executarse agora no módulo de visualización. Agora deberían mostrarse os widgets de control deslizante e indicador. Comeza a tocar e mover o polgar do widget deslizante. Un cambio no seu valor tamén debería producir un cambio no valor do widget indicador, xa que os dous widgets están ligados.

Use a ferramenta GTX para comprobar as mensaxes
Hai unha ferramenta en WS4 que se usa para comprobar as mensaxes de eventos enviadas polo módulo de visualización ao porto serie. Esta ferramenta chámase "GTX", que significa "Genie Test eXecutor". Esta ferramenta tamén se pode considerar como un simulador para un dispositivo host externo. A ferramenta GTX pódese atopar na sección Ferramentas. Fai clic na icona para executar a ferramenta.

Mover e soltar o polgar do control deslizante fará que a aplicación envíe mensaxes de eventos ao porto serie. Estas mensaxes recibiranse e serán impresas pola ferramenta GTX. Para obter máis información sobre os detalles do protocolo de comunicación para as aplicacións ViSiGenie, consulte o Manual de referencia de ViSi-Genie. Este documento descríbese na sección "Documentos de referencia".

Notas de aplicación

Nota da aplicación	Título	Descrición	Ambiente Soportado
4D-AN-00117	Iniciación ao deseñador: primeiro proxecto	Esta nota da aplicación mostra como crear un novo proxecto usando o entorno de deseño. Tamén presenta os conceptos básicos de 4DGL (4D Graphics Language).	Deseñador
4D-AN-00204	ViSi Getting Started - Primeiro proxecto para Pixxi	Esta nota da aplicación mostra como crear un novo proxecto usando o entorno ViSi. Tamén presenta os conceptos básicos de 4DGL (4D Graphics Language e o uso básico da pantalla WYSIWYG (What-You-See-Is-What-You-Get).	Visi
4D-AN-00203	Xenio ViSi Comezando: primeiro proxecto para pantallas Pixxi	O proxecto sinxelo desenvolvido nesta nota da aplicación demostra a funcionalidade táctil básica e a interacción con obxectos usando o ViSi-Genie Medio ambiente. O proxecto ilustra como se configuran os obxectos de entrada para enviar mensaxes a un controlador de host externo e como se interpretan estas mensaxes.	ViSi-Genie

Documentos de referencia

ViSi-Genie é o ambiente recomendado para principiantes. Este ambiente non implica necesariamente codificación, o que o converte na plataforma máis amigable entre os catro ambientes.
Non obstante, ViSi-Genie ten as súas limitacións. Para os usuarios que queiran máis control e flexibilidade durante o deseño e desenvolvemento de aplicacións, recoméndase os contornos Designer ou ViSi. ViSi e Designer permiten aos usuarios escribir o código das súas aplicacións.
A linguaxe de programación utilizada cos procesadores gráficos de 4D Systems chámase "4DGL". A continuación móstranse os documentos de referencia esenciais que se poden utilizar para o estudo dos diferentes ambientes.

Manual de referencia de ViSi-Genie
ViSi-Genie fai toda a codificación en segundo plano, non hai 4DGL que aprender, faino todo por ti. Este documento abarca as funcións ViSi-Genie dispoñibles para os procesadores PIXXI, PICASO e DIABLO16 e o ​​protocolo de comunicacións utilizado coñecido como Protocolo estándar Genie.

Manual de referencia do programador 4DGL
4DGL é unha linguaxe orientada aos gráficos que permite un desenvolvemento rápido de aplicacións. Unha extensa biblioteca de gráficos, textos e file funcións do sistema e a facilidade de uso dunha linguaxe que combina os mellores elementos e estrutura sintáctica de linguaxes como C, Basic, Pascal, etc. Este documento abarca o estilo da linguaxe, a sintaxe e o control de fluxo.

Manual de Funcións Internas
4DGL ten unha serie de funcións internas que se poden usar para facilitar a programación. Este documento abarca as funcións internas (residentes no chip) dispoñibles para o procesador pixxi.

Folla de datos:pixxiLCD-13P2/P2CT-CLB
Este documento contén información detallada sobre os módulos de visualización integrados pixxiLCD-13P2/P2CT-CLB.

Folla de datos:pixxiLCD-20P2/P2CT-CLB
Este documento contén información detallada sobre os módulos de visualización integrados pixxiLCD-20P2/P2CT-CLB.

Folla de datos:pixxiLCD-25P4/P4CT
Este documento contén información detallada sobre os módulos de pantalla integrados pixxiLCD-25P4/P4CT.

Folla de datos:pixxiLCD-39P4/P4CT
Este documento contén información detallada sobre os módulos de pantalla integrados pixxiLCD-39P4/P4CT.

Guía de usuario de Workshop4 IDE
Este documento ofrece unha introdución a Workshop4, o entorno de desenvolvemento integrado de 4D Systems.

NOTA: Para obter máis información sobre Workshop4 en xeral, consulte a Guía de usuario de Workshop4 IDE, dispoñible en www.4dsystems.com.au

GLOSARIO

Hardware

1. Cable de programación 4D: o cable de programación 4D é un cable convertidor UART de USB a Serial-TTL. O cable proporciona un xeito rápido e sinxelo de conectar todos os dispositivos 4D que requiren unha interface serie de nivel TTL a USB.
2. Sistema integrado: un sistema operativo e de control programado cunha función dedicada dentro dun sistema mecánico ou eléctrico máis grande, a miúdo con
   restricións de computación en tempo real. Está incorporado como parte dun dispositivo completo que a miúdo inclúe hardware e pezas mecánicas.
3. Cabecera femia: un conector conectado a un cable, cable ou peza de hardware, que ten un ou máis orificios empotrados con terminais eléctricos no seu interior.
4. FFC: cable plano flexible, ou FFC, refírese a calquera variedade de cable eléctrico que sexa plano e flexible. Servía para conectar a pantalla a un adaptador de programación.
5. gen4 - IB - Unha interface sinxela que converte o cable FFC de 30 vías procedente do seu módulo de visualización gen4, nos 5 sinais comúns utilizados para a programación.
   e interfaz con produtos 4D Systems.
6. gen4-UPA: un programador universal deseñado para funcionar con múltiples módulos de visualización de 4D Systems.
7. Cable micro USB: un tipo de cable usado para conectar a pantalla a un ordenador.
8. Procesador: un procesador é un circuíto electrónico integrado que realiza os cálculos que executan un dispositivo informático. O seu traballo básico é recibir entrada e
   proporcionar a saída adecuada.
9. Adaptador de programación: utilízase para programar módulos de pantalla gen4, conectarse a unha placa de probas para crear prototipos, conectarse a interfaces Arduino e Raspberry Pi.
10. Panel táctil resistivo: unha pantalla de ordenador sensible ao tacto composta por dúas follas flexibles recubertas cun material resistivo e separadas por un espazo de aire ou micropuntos.
11. Tarxeta microSD: un tipo de tarxeta de memoria flash extraíble que se usa para almacenar información.
12. uUSB-PA5-II – Un conversor de ponte UART de USB a Serial-TTL. Proporciona ao usuario datos en serie de velocidades múltiples en baudios de ata 3M de velocidades en baudios e acceso a sinais adicionais como o control de fluxo nun cómodo paquete Dual-In-Line de 10 pins e 2.54 mm (0.1").
13. Forza de inserción cero: a parte na que se insire o cable plano flexible.

Software

1. Comm Port: un porto ou canle de comunicación en serie usado para conectar dispositivos como a súa pantalla.
2. Controlador de dispositivo: unha forma particular de aplicación de software deseñada para permitir a interacción con dispositivos de hardware. Sen o controlador de dispositivo necesario, o dispositivo de hardware correspondente non funciona.
3. Firmware: unha clase específica de software informático que proporciona o control de baixo nivel para o hardware específico do dispositivo.
4. Ferramenta GTX: depurador Genie Test Executor. Ferramenta utilizada para comprobar os datos enviados e recibidos pola pantalla.
5. GUI: unha forma de interface de usuario que permite aos usuarios interactuar con dispositivos electrónicos mediante iconas gráficas e indicadores visuais como notación secundaria,
   en lugar de interfaces de usuario baseadas en texto, etiquetas de comandos escritos ou navegación por texto.
6. Imaxe Files – Son gráficos files xerados tras a compilación do programa que deberían gardarse na tarxeta microSD.
7. Inspector de obxectos: unha sección en Workshop4 onde o usuario pode cambiar as propiedades dun determinado widget. Aquí é onde ocorre a personalización dos widgets e a configuración de eventos.
8. Widget – Obxectos gráficos en Workshop4.
9. WYSIWYG - O que ves é o que obtén. A sección Editor de gráficos en Workshop4 onde o usuario pode arrastrar e soltar widgets.

Visita o noso websitio en: www.4dsystems.com.au
Soporte técnico: www.4dsystems.com.au/support
Soporte de vendas: sales@4dsystems.com.au

Copyright © 4D Systems, 2022, Todos os dereitos reservados.
Todas as marcas rexistradas pertencen aos seus respectivos propietarios e son recoñecidas e recoñecidas.

Documentos/Recursos

4D SYSTEMS pixxiLCD-13P2-CTP-CLB Display Placa de expansión de evaluación de plataforma Arduino [pdfGuía do usuario pixxiLCD-13P2-CTP-CLB, 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