GUIDA PER L'UTENTE
SERIE pixxiLCD
pixxiLCD-13P2/CTP-CLB
pixxiLCD-20P2/CTP-CLB
pixxiLCD-25P4/CTP
pixxiLCD-39P4/CTP
serie pixxiLCD
*Disponibile anche nella versione Cover Lens Bezel (CLB).
VARIANTI:
Processore PIXXI (P2)
Processore PIXXI (P4)
Non touch (NT)
Tocco capacitivo (CTP)
Touch capacitivo con cornice della lente di copertura (CTP-CLB)
Questa guida per l'utente ti aiuterà a iniziare a utilizzare i moduli pixxiLCD-XXP2/P4-CTP/CTP-CLB insieme a WorkShop4 IDE. Include anche un elenco di progetti essenziali esample e note applicative.
Cosa c'è nella scatola
Documenti di supporto, schede tecniche, modelli di fasi CAD e note applicative sono disponibili all'indirizzo www.4dsystems.com.au
Introduzione
Questa Guida per l'utente è un'introduzione per acquisire familiarità con pixxiLCDXXP2/P4-CT/CT-CLB e l'IDE software ad esso associato. Questo manuale dovrebbe essere
trattato solo come un utile punto di partenza e non come un documento di riferimento completo. Fare riferimento alle note applicative per un elenco di tutti i documenti di riferimento dettagliati.
In questa guida per l'utente, ci concentreremo brevemente sui seguenti argomenti:
- Requisiti hardware e software
- Collegamento del modulo display al PC
- Iniziare con progetti semplici
- Progetti che utilizzano pixxiLCD-XXP2/P4-CT/CT-CLB
- Note applicative
- Documenti di riferimento
Il pixxiLCD-XXP2/P4-CT/CT-CLB fa parte della serie Pixxi di moduli display progettati e prodotti da 4D Systems. Il modulo è dotato di un display LCD TFT a colori rotondo da 1.3”, 2.0”, 2.5” o 3.9, con touch capacitivo opzionale. È alimentato dal processore grafico 4D Systems Pixxi22/Pixxi44 ricco di funzionalità, che offre una serie di funzionalità e opzioni per il progettista/integratore/utente.
I moduli display intelligenti sono soluzioni integrate a basso costo utilizzate in varie applicazioni nei settori medico, manifatturiero, militare, automobilistico, domotico, dell'elettronica di consumo e di altri settori. In effetti, oggi sul mercato ci sono pochissimi design incorporati che non dispongono di un display. Anche molti elettrodomestici e elettrodomestici da cucina di consumo incorporano una qualche forma di display. Pulsanti, selettori rotanti, interruttori e altri dispositivi di input vengono sostituiti da display touch screen più colorati e facili da usare in macchine industriali, termostati, distributori di bevande, stampanti 3D, applicazioni commerciali, praticamente qualsiasi applicazione elettronica.
Affinché i progettisti/utenti possano creare e progettare un'interfaccia utente per le loro applicazioni che verranno eseguite su moduli di visualizzazione intelligenti 4D, 4D Systems fornisce un software IDE (Integrated Development Environment) gratuito e intuitivo chiamato "Workshop4" o "WS4" . Questo IDE software è discusso in modo più dettagliato nella sezione "Requisiti di sistema".
Requisiti di sistema
Le seguenti sottosezioni illustrano i requisiti hardware e software per questo manuale.
Hardware
1. Modulo display intelligente e accessori
Il modulo display intelligente pixxiLCD-xxP2/P4-CT/CT-CLB e i suoi accessori (scheda adattatore e cavo flessibile piatto) sono inclusi nella confezione, consegnati dopo l'acquisto dal nostro websito o tramite uno dei nostri distributori. Fare riferimento alla sezione “Cosa c'è nella confezione” per le immagini del modulo display e dei suoi accessori.
2. Modulo di programmazione
Il modulo di programmazione è un dispositivo separato necessario per collegare il modulo display a un PC Windows. 4D Systems offre il seguente modulo di programmazione:
- Cavo di programmazione 4D
- uAdattatore di programmazione USB-PA5-II
- 4D-UPA
Per utilizzare il modulo di programmazione, è necessario prima installare il driver corrispondente nel PC.
È possibile fare riferimento alla pagina del prodotto del modulo fornito per ulteriori informazioni e istruzioni dettagliate.
NOTA: Questo dispositivo è disponibile separatamente da 4D Systems. Si prega di fare riferimento alle pagine del prodotto per ulteriori informazioni.
3. Archiviazione multimediale
Workshop4 ha widget integrati che possono essere utilizzati per progettare la tua interfaccia utente di visualizzazione. La maggior parte di questi widget deve essere archiviata in un dispositivo di archiviazione, come una scheda microSD o una flash esterna, insieme all'altro elemento grafico files durante la fase di compilazione.
NOTA: la scheda microSD e il flash esterno sono opzionali e sono necessari solo con i progetti che utilizzano la grafica files.
Si noti inoltre che non tutte le schede microSD sul mercato sono compatibili con SPI e quindi non tutte le schede possono essere utilizzate nei prodotti 4D Systems. Acquista con fiducia, scegli le carte consigliate da 4D Systems.
4. PC Windows
Workshop4 funziona solo su sistema operativo Windows. Si consiglia di essere utilizzato su Windows 7 fino a Windows 10, ma dovrebbe comunque funzionare con Windows XP. Alcuni sistemi operativi precedenti come ME e Vista non sono stati testati per un po' di tempo, tuttavia, il software dovrebbe comunque funzionare.
Se desideri eseguire Workshop4 su altri sistemi operativi come Mac o Linux, ti consigliamo di configurare una macchina virtuale (VM) sul tuo PC.
Software
1. IDE Workshop4
Workshop4 è un IDE software completo per Microsoft Windows che fornisce una piattaforma di sviluppo software integrata per tutta la famiglia di processori e moduli 4D. L'IDE combina Editor, Compiler, Linker e Downloader per sviluppare il codice completo dell'applicazione 4DGL. Tutto il codice dell'applicazione utente è sviluppato all'interno dell'IDE Workshop4.
Workshop4 include tre ambienti di sviluppo, che l'utente può scegliere in base ai requisiti dell'applicazione o anche al livello di abilità dell'utente: Designer, ViSi–Genie e ViSi.
Workshop4 Ambienti
Designer
Questo ambiente consente all'utente di scrivere il codice 4DGL nella sua forma naturale per programmare il modulo di visualizzazione.
ViSi – Genio
Un ambiente avanzato che non richiede alcuna codifica 4DGL, tutto viene eseguito automaticamente per te. Disponi semplicemente il display con gli oggetti che desideri (simile a ViSi), imposta gli eventi per guidarli e il codice viene scritto automaticamente per te. ViSi-Genie offre l'ultima esperienza di sviluppo rapido di 4D Systems.
Visi
Un'esperienza di programmazione visiva che consente il posizionamento di oggetti con trascinamento della selezione per assistere con la generazione di codice 4DGL e consente all'utente di visualizzare come
il display apparirà durante lo sviluppo.
2. Installa Workshop4
I collegamenti per il download del programma di installazione WS4 e della guida all'installazione sono disponibili nella pagina del prodotto Workshop4.
Collegamento del modulo display al PC
In questa sezione sono riportate le istruzioni complete per il collegamento del display al PC. Ci sono tre (3) opzioni di istruzioni in questa sezione, come mostrato nelle immagini sottostanti. Ciascuna opzione è specifica per un modulo di programmazione. Seguire solo le istruzioni applicabili al modulo di programmazione in uso.
Opzioni di connessione
Opzione A – Utilizzo del 4D-UPA
- Collegare un'estremità dell'FFC alla presa ZIF a 15 vie del pixxiLCD con i contatti metallici sull'FFC rivolti verso il fermo.
- Collegare l'altra estremità dell'FFC alla presa ZIF a 30 vie sul 4D-UPA con i contatti metallici sull'FFC rivolti verso il fermo
- Collegare il cavo USB-Micro-B al 4D-UPA.
- Infine, collegare l'altra estremità del cavo USB-Micro-B al computer.
Opzione B – Utilizzo del cavo di programmazione 4D
- Collegare un'estremità dell'FFC alla presa ZIF a 15 vie del pixxiLCD con i contatti metallici sull'FFC rivolti verso il fermo.
- Collegare l'altra estremità dell'FFC alla presa ZIF a 30 vie su gen4-IB con i contatti metallici sull'FFC rivolti verso il fermo.
- Collegare l'intestazione femmina a 5 pin del cavo di programmazione 4D a gen4-IB seguendo l'orientamento sia sul cavo che sulle etichette del modulo. Puoi farlo anche con l'assistenza del cavo a nastro in dotazione.
- Collegare l'altra estremità del cavo di programmazione 4D al computer.
Opzione C – Utilizzo di uUSB-PA5-II
- Collegare un'estremità dell'FFC alla presa ZIF a 15 vie del pixxiLCD con i contatti metallici sull'FFC rivolti verso il fermo.
- Collegare l'altra estremità dell'FFC alla presa ZIF a 30 vie su gen4-IB con i contatti metallici sull'FFC rivolti verso il fermo.
- Collegare l'intestazione femmina a 5 pin di uUSB-PA5-II a gen4-IB seguendo l'orientamento sia sul cavo che sulle etichette del modulo. Puoi farlo anche con l'assistenza del cavo a nastro in dotazione.
- Collegare un cavo USB-Mini-B all'uUSB-PA5-II.
- Infine, collega l'altra estremità dell'uUSB-Mini-B al computer.
Lascia che WS4 identifichi il modulo di visualizzazione
Dopo aver seguito il set di istruzioni appropriato nella sezione precedente, ora è necessario configurare e impostare Workshop4 per assicurarsi che identifichi e si colleghi al modulo di visualizzazione corretto.
- Apri Workshop4 IDE e crea un nuovo progetto.
- Seleziona il modulo di visualizzazione che stai utilizzando dall'elenco.
- Seleziona l'orientamento desiderato per il tuo progetto.
- Fare clic su Avanti.
- Scegli un ambiente di programmazione WS4. Verrà abilitato solo l'ambiente di programmazione compatibile per il modulo display.
- Fare clic sulla scheda COMMS, selezionare la porta COM a cui è collegato il modulo display dall'elenco a discesa.
- Fare clic sul punto ROSSO per avviare la scansione del modulo display. Durante la scansione verrà visualizzato un punto GIALLO. Assicurati che il tuo modulo sia collegato correttamente.
- Infine, un rilevamento riuscito ti darà un Punto BLU con il nome del modulo display visualizzato a fianco.
- Fai clic sulla scheda Home per iniziare a creare il tuo progetto.
Iniziare con un progetto semplice
Dopo aver collegato correttamente il modulo display al PC utilizzando il modulo di programmazione, è ora possibile iniziare a creare un'applicazione di base. Questa sezione mostra come progettare una semplice interfaccia utente utilizzando l'ambiente ViSi-Genie e utilizzando i widget slider e gauge.
Il progetto risultante consiste in uno slider (un widget di input) che controlla un indicatore (un widget di output). I widget possono anche essere configurati per inviare messaggi di eventi a un dispositivo host esterno tramite la porta seriale.
Crea un nuovo progetto ViSi-Genie
Puoi creare un progetto ViSi-Genie aprendo Workshop e scegliendo il tipo di visualizzazione e l'ambiente con cui vuoi lavorare. Questo progetto utilizzerà l'ambiente ViSi-Genie.
- Aprire Workshop4 facendo doppio clic sull'icona.
- Crea un nuovo progetto con la nuova scheda.
- Scegli il tipo di visualizzazione.
- Fare clic su Avanti.
- Scegli Ambiente ViSi-Genie.
Aggiungi un widget dispositivo di scorrimento
Per aggiungere un widget slider, fai semplicemente clic sulla scheda Home e scegli Input Widget. Dall'elenco, puoi scegliere il tipo di widget che desideri utilizzare. In questo caso, il widget di scorrimento è selezionato.
Basta trascinare e rilasciare il widget nella sezione What-You-See-Is-What-You-Get (WYSIWYG).
Aggiungi un widget Indicatore
Per aggiungere un widget indicatore, vai alla sezione Indicatori e scegli il tipo di indicatore che desideri utilizzare. In questo caso è selezionato il widget Coolgauge.
Trascinalo e rilascialo verso la sezione WYSIWYG per procedere.
Collega il widget
I widget di input possono essere configurati per controllare un widget di output. Per fare ciò, basta cliccare sull'input (in questo example, il widget di scorrimento) e vai alla sua sezione Ispettore oggetti e fai clic sulla scheda Eventi.
Sono disponibili due eventi nella scheda eventi di un widget di input: OnChanged e OnChanging. Questi eventi vengono attivati da azioni touch eseguite sul widget di input.
L'evento OnChanged viene attivato ogni volta che viene rilasciato un widget di input. D'altra parte, l'evento OnChanging viene attivato continuamente mentre viene toccato un widget di input. In questo esample, viene utilizzato l'evento OnChanging. Impostare il gestore dell'evento facendo clic sul simbolo dei puntini di sospensione per il gestore dell'evento OnChanging.
Viene visualizzata la finestra di selezione dell'evento. Selezionare coolgauge0Set, quindi fare clic su OK.
Configura il widget di input per inviare messaggi a un host
Un host esterno, collegato al modulo display tramite la porta seriale, può essere informato dello stato di un widget. Ciò può essere ottenuto configurando il widget per inviare messaggi di eventi alla porta seriale. Per fare ciò, imposta il gestore dell'evento OnChanged del widget slider su Segnala messaggio.
Scheda microSD / Memoria flash seriale integrata
Sui moduli display Pixxi, i dati grafici per i widget possono essere archiviati nella scheda microSD/memoria flash seriale integrata, a cui il processore grafico del modulo display accederà durante il runtime. Il processore grafico visualizzerà quindi i widget sul display.
Il PmmC appropriato deve anche essere caricato sul modulo Pixxi per utilizzare il rispettivo dispositivo di archiviazione. Il PmmC per il supporto della scheda microSD ha il suffisso “-u” mentre il PmmC per il supporto della memoria flash seriale integrata ha il suffisso “-f”.
Per caricare manualmente il PmmC, fare clic sulla scheda Strumenti e selezionare il caricatore PmmC.
Costruisci e compila il progetto
Per creare/caricare il progetto, fare clic sull'icona (Crea) Copia/Carica.
Copia il Richiesto Fileda a
la scheda microSD/memoria flash seriale integrata
scheda microSD
WS4 genera la grafica richiesta files e ti chiederà l'unità su cui è montata la scheda microSD. Assicurati che la scheda microSD sia montata correttamente sul PC, quindi seleziona l'unità corretta nella finestra di conferma della copia, come mostrato nell'immagine seguente.
Fare clic su OK dopo il fileI messaggi vengono trasferiti sulla scheda microSD. Smontare la scheda microSD dal PC e inserirla nello slot per schede microSD del modulo display.
Memoria flash seriale integrata
Quando si seleziona la memoria flash come destinazione per la grafica file, assicurarsi che nessuna scheda microSD sia collegata al modulo
Verrà visualizzata una finestra di conferma della copia come mostrato nel messaggio seguente.
Fare clic su OK e a File Verrà visualizzata la finestra di trasferimento. Attendi che il processo finisca e la grafica verrà ora visualizzata sul modulo display.
Testare l'applicazione
L'applicazione dovrebbe ora essere eseguita sul modulo di visualizzazione. Ora dovrebbero essere mostrati i widget del dispositivo di scorrimento e dell'indicatore. Inizia a toccare e spostare il pollice del widget di scorrimento. Una modifica del suo valore dovrebbe comportare anche una modifica del valore del widget indicatore, poiché i due widget sono collegati.
Usa lo strumento GTX per controllare i messaggi
C'è uno strumento in WS4 utilizzato per controllare i messaggi di evento inviati dal modulo display alla porta seriale. Questo strumento si chiama "GTX", che sta per "Genie Test eXecutor". Questo strumento può anche essere pensato come un simulatore per un dispositivo host esterno. Lo strumento GTX può essere trovato nella sezione Strumenti. Fare clic sull'icona per eseguire lo strumento.
Spostando e rilasciando il pollice del dispositivo di scorrimento, l'applicazione invierà messaggi di evento alla porta seriale. Questi messaggi verranno quindi ricevuti e stampati da GTX Tool. Per maggiori informazioni sui dettagli del protocollo di comunicazione per le applicazioni ViSiGenie, fare riferimento al Manuale di riferimento ViSi-Genie. Questo documento è descritto nella sezione “Documenti di riferimento”.
Note applicative
Nota applicativa | Titolo | Descrizione | Ambiente supportato |
4D-AN-00117 | Designer per iniziare – Primo progetto | Questa nota applicativa mostra come creare un nuovo progetto utilizzando Designer Environment. Introduce anche le basi del 4DGL (4D Graphics Language). | Designer |
4D-AN-00204 | ViSi Getting Started – Primo progetto per Pixxi | Questa nota applicativa mostra come creare un nuovo progetto utilizzando l'ambiente ViSi. Introduce anche le basi del 4DGL (linguaggio grafico 4D e l'uso di base della schermata WYSIWYG (What-You-See-Is-What-You-Get). | Visi |
4D-AN-00203 | Genio ViSi Per iniziare: primo progetto per i display Pixxi |
Il semplice progetto sviluppato in questa nota applicativa mostra le funzionalità touch di base e l'interazione con gli oggetti utilizzando ViSi-Genie Ambiente. Il progetto illustra come gli oggetti di input sono configurati per inviare messaggi a un controller host esterno e come questi messaggi vengono interpretati. |
ViSi-Genio |
Documenti di riferimento
ViSi-Genie è l'ambiente consigliato ai principianti. Questo ambiente non implica necessariamente la codifica, il che lo rende la piattaforma più intuitiva tra i quattro ambienti.
Tuttavia, ViSi-Genie ha i suoi limiti. Per gli utenti che desiderano maggiore controllo e flessibilità durante la progettazione e lo sviluppo dell'applicazione, si consiglia l'ambiente Designer o ViSi. ViSi e Designer consentono agli utenti di scrivere il codice per le loro applicazioni.
Il linguaggio di programmazione utilizzato con i processori grafici 4D Systems si chiama “4DGL”. Di seguito sono elencati i documenti di riferimento essenziali che possono essere utilizzati per ulteriori studi sui diversi ambienti.
Manuale di riferimento ViSi-Genie
ViSi-Genie fa tutta la codifica in background, nessun 4DGL da imparare, fa tutto per te. Questo documento riguarda le funzioni ViSi-Genie disponibili per i Processori PIXXI, PICASO e DIABLO16 e il protocollo di comunicazione utilizzato noto come Genie Standard Protocol.
Manuale di riferimento del programmatore 4DGL
4DGL è un linguaggio orientato alla grafica che consente un rapido sviluppo di applicazioni. Una vasta libreria di grafica, testo e file funzioni di sistema e la facilità d'uso di un linguaggio che combina i migliori elementi e la struttura sintattica di linguaggi come C, Basic, Pascal, ecc. Questo documento copre lo stile del linguaggio, la sintassi e il controllo del flusso.
Manuale delle funzioni interne
4DGL ha una serie di funzioni interne che possono essere utilizzate per una programmazione più semplice. Questo documento copre le funzioni interne (residenti su chip) disponibili per il processore pixxi.
Scheda tecnica pixxiLCD-13P2/P2CT-CLB
Questo documento contiene informazioni dettagliate sui moduli di visualizzazione integrati pixxiLCD-13P2/P2CT-CLB.
Scheda tecnica pixxiLCD-20P2/P2CT-CLB
Questo documento contiene informazioni dettagliate sui moduli di visualizzazione integrati pixxiLCD-20P2/P2CT-CLB.
Scheda tecnica pixxiLCD-25P4/P4CT
Questo documento contiene informazioni dettagliate sui moduli di visualizzazione integrati pixxiLCD-25P4/P4CT.
Scheda tecnica pixxiLCD-39P4/P4CT
Questo documento contiene informazioni dettagliate sui moduli di visualizzazione integrati pixxiLCD-39P4/P4CT.
Workshop4 IDE Guida per l'utente
Questo documento fornisce un'introduzione all'ambiente di sviluppo integrato di Workshop4, 4D Systems.
NOTA: Per ulteriori informazioni su Workshop4 in generale, fare riferimento alla Guida per l'utente di Workshop4 IDE, disponibile all'indirizzo www.4dsystems.com.au
GLOSSARIO
Hardware
- Cavo di programmazione 4D - Il cavo di programmazione 4D è un cavo convertitore UART da USB a seriale-TTL. Il cavo fornisce un modo rapido e semplice per collegare tutti i dispositivi 4D che richiedono un'interfaccia seriale di livello TTL a USB.
- Sistema integrato: un sistema operativo e di controllo programmato con una funzione dedicata all'interno di un sistema meccanico o elettrico più ampio, spesso con
vincoli di calcolo in tempo reale. È incorporato come parte di un dispositivo completo che spesso include hardware e parti meccaniche. - Intestazione femmina: un connettore collegato a un filo, cavo o hardware, con uno o più fori incassati con terminali elettrici all'interno.
- FFC - Cavo piatto flessibile, o FFC, si riferisce a qualsiasi varietà di cavo elettrico che sia sia piatto che flessibile. Utilizzato per collegare il display a un adattatore di programmazione.
- gen4 – IB – Una semplice interfaccia che converte il cavo FFC a 30 vie proveniente dal tuo modulo display gen4, nei comuni 5 segnali utilizzati per la programmazione
e interfacciamento ai prodotti 4D Systems. - gen4-UPA – Un programmatore universale progettato per funzionare con più moduli di visualizzazione 4D Systems.
- Cavo micro USB – Un tipo di cavo utilizzato per collegare il display a un computer.
- Processore – Un processore è un circuito elettronico integrato che esegue i calcoli che eseguono un dispositivo informatico. Il suo lavoro di base è quello di ricevere input e
fornire l'output appropriato. - Adattatore di programmazione: utilizzato per programmare moduli display gen4, interfacciarsi a una breadboard per la prototipazione, interfacciarsi con interfacce Arduino e Raspberry Pi.
- Pannello touch resistivo – Un display per computer sensibile al tocco composto da due fogli flessibili rivestiti con un materiale resistivo e separati da un'intercapedine d'aria o micropunti.
- Scheda microSD – Un tipo di scheda di memoria flash rimovibile utilizzata per memorizzare le informazioni.
- uUSB-PA5-II – Un convertitore bridge UART da USB a seriale-TTL. Fornisce all'utente dati seriali multi baud rate fino a 3M baud rate e accesso a segnali aggiuntivi come il controllo del flusso in un comodo pacchetto Dual-In-Line a 10 pin con passo da 2.54 mm (0.1").
- Forza di inserimento zero: la parte in cui viene inserito il cavo piatto flessibile.
Software
- Porta di comunicazione: una porta o un canale di comunicazione seriale utilizzato per collegare dispositivi come il display.
- Driver di dispositivo: una forma particolare di applicazione software progettata per consentire l'interazione con i dispositivi hardware. Senza il driver di dispositivo richiesto, il dispositivo hardware corrispondente non funziona.
- Firmware: una classe specifica di software per computer che fornisce il controllo di basso livello per l'hardware specifico del dispositivo.
- Strumento GTX – debugger Genie Test Executor. Uno strumento utilizzato per controllare i dati inviati e ricevuti dal display.
- GUI – Una forma di interfaccia utente che consente agli utenti di interagire con i dispositivi elettronici tramite icone grafiche e indicatori visivi come la notazione secondaria,
invece di interfacce utente basate su testo, etichette di comandi digitate o navigazione testuale. - Immagine Files – Sono grafici fileViene generato durante la compilazione del programma che deve essere salvato nella scheda microSD.
- Ispettore oggetti – Una sezione in Workshop4 in cui l'utente può modificare le proprietà di un determinato widget. È qui che avvengono la personalizzazione dei widget e la configurazione degli eventi.
- Widget – Oggetti grafici in Workshop4.
- WYSIWYG – Quello che vedi è quello che ottieni. La sezione Editor grafico in Workshop4 in cui l'utente può trascinare e rilasciare i widget.
Visita il nostro websito a: www.4dsystems.com.au
Supporto tecnico: www.4dsystems.com.au/support
Supporto alle vendite: vendite@4dsystems.com.au
Copyright © 4D Systems, 2022, Tutti i diritti riservati.
Tutti i marchi appartengono ai rispettivi proprietari e sono riconosciuti e riconosciuti.
Documenti / Risorse
![]() |
4D SYSTEMS pixxiLCD-13P2-CTP-CLB Display Scheda di espansione di valutazione della piattaforma Arduino [pdf] Guida utente pixxiLCD-13P2-CTP-CLB, Display Scheda di espansione di valutazione della piattaforma Arduino, Scheda di espansione di valutazione della piattaforma, Scheda di espansione di valutazione, pixxiLCD-13P2-CTP-CLB, Scheda di espansione |