Compilatore risorse display grafico LCD serie IEC-line

Transcript

1 Compilatore risorse display grafico LCD serie IEC-line aggiornamento: IEC-line by OVERDIGIT overdigit.com

2 1. Il display grafico LCD I PLC della serie IPC-line possono disporre opzionalmente di un display grafico LCD liberamente programmabile mediante un apposita libreria CoDeSys. Fare riferimento alla documentazione dello specifico PLC per verificare la disponibilità e la tipologia del display previsto. 2. Installazione del compilatore di risorse La gestione del display grafico LCD necessita di un file di risorse, da abbinare al programma CoDeSys, contenente tutta la grafica come icone, fonts caratteri e testi multilingua. Dopo aver preparato le immagini, i caratteri ed i testi necessari al proprio applicativo occorre utilizzare un programma apposito di compilazione per creare il file di risorse ed il file dei simboli identificativi. I files necessari al processo di compilazione sono i seguenti: RESOURCE.EXE UNICODE_TABLE.TXT Questi files sono presenti nella cartella Resource del CD di installazione assieme ad alcuni files di esempio di risorse. Si consiglia di copiare manualmente i due files indicati assieme ai files di font di base (FIX6X6.BMP e VAR10X14.BMP) in una cartella sotto ogni specifico progetto CoDeSys. 3. Le risorse del display LCD Il display grafico LCD, per poter operare in tutte le sue funzionalità, necessita di un file, detto file di risorse, contenente i dati di tutti gli oggetti visualizzabili. Gli oggetti attualmente implementati per il display sono di tre tipi: icone, fonts e testi. Le icone sono immagini grafiche fisse di varie dimensioni che possono essere posizionate sullo schermo mediante le apposite funzioni del linguaggio di programmazione. I fonts sono delle speciali icone che contengono al loro interno tutte le immagini dei caratteri di testo utilizzabili nelle funzioni di scrittura. I testi sono degli array di stringhe di caratteri ciascuna delle quali rappresenta lo stesso testo in una specifica lingua. I testi possono utilizzare anche i caratteri internazionali Unicode. 4. Preparazione delle risorse Per creare un file di risorse occorre per prima cosa preparare tutti i files sorgenti relativi ad ogni risorsa che si intende utilizzare. Per le risorse icona i files da preparare sono di tipo Bitmap monocromatico (nero/bianco) con dimensione in genere da pochi pixels fino a tutta l area dello schermo (ad esempio 128x64). Per la creazione di questi files si possono utilizzare programmi semplici come Paint di Windows, oppure più sofisticati come PhotoImpact. In particolare quest ultimo tool permette di disegnare l immagine mediante oggetti grafici, facilmente posizionabili e modificabili, a differenza di Paint dove l immagine è sempre costituita da singoli pixels indipendenti. Per disegnare ad oggetti si utilizzano IEC-line by OVERDIGIT Page 2

3 files sorgenti in formato proprietario (.UFO nel caso di PhotoImpact) e solo alla fine ne viene salvata una copia anche in Bitmap. Normalmente le immagini sono disegnate con penna nera su sfondo bianco. In fase di visualizzazione, i pixels disegnati neri corrispondono all accensione di pixels sullo sfondo del display LCD. Tuttavia con la funzione software Reverse la stessa immagine potrà essere visualizzata in negativo sul display. Un font è una particolare icona che contiene 256 sottoicone corrispondenti a tutti i possibili codici ASCII dei caratteri. Le immagini dei singoli caratteri sono disposte, all interno dell icona complessiva del font, su una matrice di 16x16 elementi. In particolare le prime 8 righe (codici da 0-127) sono prevalentemente utilizzate per il set dei caratteri Latini standard, mentre le successive 8 righe sono normalmente riempite con caratteri Unicode scelti in modo arbitrario. Il file UNICODE_TABLE.TXT, file di testo anch esso Unicode, contiene una tabella di associazione tra uno o più caratteri Unicode ed un singolo codice ASCII del font. L associazione di più caratteri Unicode, simili graficamente, all immagine di un solo carattere, consente la visualizzazione di testi Unicode pur in presenza di un più limitato set di caratteri. I files di font e di conversione Unicode-ASCII sono personalizzabili secondo le specifiche esigenze. Nella cartella Resource del CD di installazione sono forniti dei files di esempio utilizzabili in buona parte dei casi ed in particolare nella visualizzazione di testi con caratteri Latini e Cirillici. Anche per i fonts l utilizzo di sofisticati programmi come PhotoImpact consentono la creazione del file sorgente lavorando ad oggetti e posizionando i caratteri all interno di una griglia di riferimento. I caratteri devono essere disegnati in nero su sfondo bianco e posizionati all interno della relativa area, normalmente con allineamento in alto a sinistra. Per i fonts a spaziatura variabile è necessario inoltre disegnare un singolo pixel nella riga più bassa per diminuire la larghezza dello spazio alla destra dei caratteri più stretti. La colonna dei pixels del carattere marcata con tale punto non è compresa nel carattere stesso. Un esempio di font a spaziatura variabile è riportato nel seguito: IEC-line by OVERDIGIT Page 3

4 Compilatore risorse display grafico LCD Nel font illustrato (VAR10X14.BMP) ogni area corrispondente ad un carattere ha dimensione 10x14 pixels e l intero font ha dimensione 160x224 pixels. I codici ASCII dei caratteri del testo da scrivere indirizzano le relative sottoicone del font le quali sono disegnate sul display in successione. L area bianca attorno al carattere consente di spaziare in senso orizzontale e verticale i caratteri stessi. Nel caso di caratteri a spaziatura variabile la scrittura dei pixels del carattere termina, sulla destra di questo, alla colonna che precede l eventuale punto nell ultima riga. IEC-line by OVERDIGIT Page 4

5 Le risorse di tipo testi sono una collezione di righe di caratteri raggruppate, nelle varie lingue, per lo stesso identificativo di testo. Una risorsa di tipo testi è un intero file che definisce un certo numero di testi nelle varie lingue. Il seguente TEXT_1.TXT è un esempio di file di risorse testi: TEXT_1_ID_0 "FILE TEXT_1: TEXT 0 LANGUAGE 0" "FILE TEXT_1: TEXT 0 LANGUAGE 1" "FILE TEXT_1: TEXT 0 LANGUAGE 2" "FILE TEXT_1: TEXT 0 LANGUAGE 3" TEXT_1_ID_1 "FILE TEXT_1: TEXT 1 LANGUAGE 0" "FILE TEXT_1: TEXT 1 LANGUAGE 1" "FILE TEXT_1: TEXT 1 LANGUAGE 2" "FILE TEXT_1: TEXT 1 LANGUAGE 3" TEXT_1_ID_2 "FILE TEXT_1: TEXT 2 LANGUAGE 0" "FILE TEXT_1: TEXT 2 LANGUAGE 1" "FILE TEXT_1: TEXT 2 LANGUAGE 2" "FILE TEXT_1: TEXT 2 LANGUAGE 3" Ogni testo inizia con una label identificativa ed arbitraria (in questo caso TEXT_1_ID_0 per il primo testo) per poi continuare con l array di stringhe per le varie lingue racchiuse tra due caratteri (doppio apice). La lunghezza dei testi non deve necessariamente essere uguale, ne all interno dello stesso testo nelle varie lingue, ne tra diversi testi. Il file di risorse conterrà una copia di tale testo con le righe a lunghezza fissa pari alla massima trovata e con un riempimento delle righe più corte mediante il carattere di terminazione stringa (codice 0). Il file di risorse testi può contenere anche caratteri Unicode. In tal caso il file deve essere salvato come testo Unicode con codifica a 16 bits. Un valido editor di testi che gestisce i caratteri Unicode è WordPad disponibile negli Accessori del menu di Start del Desktop. Durante la compilazione di un file di risorse testi, se il file è di tipo Unicode, viene utilizzata la tabella di conversione Unicode-ASCII, presente nel file UNICODE_TABLE.TXT, nella quale si fa riferimento ai codici ASCII dei caratteri dei fonts utilizzati. Se non si utilizzano caratteri Unicode si consiglia di creare dei normali file di testo ASCII in quanto questi richiedono solo un byte per ogni carattere invece di due. In tal caso non viene utilizzato il file con la tabella di conversione ed i testi sono trasferiti direttamente nel file di risorse. 5. Compilazione delle risorse I files sorgenti devono essere compilati per creare il file di risorse da inserire sulla memoria della CPU. Per questa operazione si utilizza il programma di utility RESOURCE.EXE disponibile nel CD di installazione. Questo programma necessita anche del file UNICODE_TABLE.TXT per la conversione Unicode-ASCII nel caso di compilazione di testi Unicode. Per informare il compilatore su quali risorse includere si utilizza il file RESOURCE.CFG. Un esempio di file di configurazione è il seguente: IEC-line by OVERDIGIT Page 5

6 ICON ICON_1.BMP FONT FIX6X8.BMP TEXT TEXT_1.TXT Ogni riga del file di configurazione include uno specifico nome di risorsa preceduto da un descrittore del tipo (ICON, FONT e TEXT). I nomi dei files possono anche comprendere il percorso. Il file di configurazione deve essere passato come parametro al programma RESOURCE.EXE predisponendo ad esempio un file.bat contenente la seguente riga di comando: RESOURCE RESOURCE.CFG Per semplificare la preparazione del file di configurazione, il programma RESOURCE.EXE, chiamato senza parametro, scansiona tutti i files presenti nella stessa cartella del programma e crea in automatico un file di configurazione contente tutti i files trovati. In particolare tutti i files.bmp trovati sono associati al descrittore ICON tranne per i files contenenti, nel loro nome, la stringa 0X fino a 9X che sono invece considerati FONT. Inoltre qualsiasi file il cui nome inizia con il carattere _ (underscore) non viene incluso nel file di configurazione. Per maggior semplicità, si consiglia di creare una cartella all interno di ogni progetto CoDeSys, inserendoci tutti i files necessari alla compilazione e tutti i files sorgenti delle risorse. Lanciando l esecuzione del compilatore RESOURCE.EXE senza parametri, saranno automaticamente compilati tutti i files di risorse presenti. A seguito del processo di compilazione vengono generati i seguenti due files: RESOURCE.RES RESOURCE.EXP Il file RESOURCE.RES contiene tutti i dati delle risorse compilate. Questo file deve essere copiato nella cartella della scheda CPU corrispondente al programma IEC (normalmente A:\PLC_PRG ). Questo trasferimento può essere effettuato mediante un collegamento FTP con il disco di sistema oppure mediante il menu di CoDeSys Online>Write file to PLC. La gestione del display può avvenire anche in assenza di uno specifico file di risorse creato dall utente. Infatti il file di default DEFAULT.RES è preinstallato nella cartella A:\SYSTEM del PLC e costituisce un file minimale di risorse grafiche del display LCD (contenente solo il font 6x8 pixels), nel caso che il programma del PLC non ne utilizzi altri. Il file RESOURCE.EXP è un file importabile con il menu Project>Import del tool di sviluppo CoDeSys e permette di definire, all interno del progetto IEC, l insieme delle dichiarazioni degli identificativi costanti sotto forma di VAR_GLOBAL CONSTANT. Queste sono le label identificative delle risorse alle quali si farà riferimento con le funzioni di gestione del display. NOTA: L ambiente di sviluppo CoDeSys mantiene aggiornate in automatico le dichiarazioni degli identificativi mediante un link al file RESOURCE.EXP creato durante la fase di importazione. IEC-line by OVERDIGIT Page 6