Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

--- software:qpaint-runtime:qpaint-runtime-2 [2024/01/15 09:22] – creata qem214
+++ software:qpaint-runtime:qpaint-runtime-2 [2024/01/15 10:05] (versione attuale) – [1. Informazioni] qem214
@@ Linea 1: / Linea 1: @@
-lorem ipsum
+====== S1-QPaint-Runtime-2 ======
+<WRAP center round box 60%>
+| {{:varie:logo_qem_documentazione.png?200&direct}}                                                                                               ||||
+^ Documento:                                         | **ms_qpaint-runtime-2**  PRELIMINARE-                                                       |||
+^ Descrizione:                                       | Manuale del software QPaint-Runtime-2 ver. 1.0                                              |||
+^ Redattore:                                         | Denis Dal Ronco                                                                             |||
+^ Approvatore                                        | Giuliano Tognon                                                                             |||
+^ Link:                                              | https://wiki.qem.it/doku.php/software/qpaint-runtime/qpaint-runtime-2                       |||
+^ Lingua:                                            | Italiano                                                                                    |||
+|                                                                                                                                                 ||||
+^ Release documento                                  ^ Descrizione                                                            ^ Note  ^ Data         ^
+|  01                                                | Nuovo manuale                                                          |       |  15/01/2024  |
+</WRAP>
+----
+====== - Informazioni ======
+{{:software:qpaint-runtime:qpaintruntime2-logo.png?nolink&800}}
+<html><tocpagebreak></html>
+===== - Descrizione =====
+PRELIMINARE-
+**QPaint Runtime 2** è un software creato per FIXME [[https://it.wikipedia.org/wiki/Microsoft_Windows|Microsoft Windows]] per eseguire la parte [[https://it.wikipedia.org/wiki/Interfaccia_uomo-macchina|HMI]] di un applicativo Qmove.
+Si può dunque utilizzare un qualsiasi PC come [[https://it.wikipedia.org/wiki/Interfaccia_uomo-macchina|interfaccia uomo-macchina HMI]].
+È compatibile con le seguenti versioni del sistema operativo Windows: Windows 7, Windows 8, Windows 8.1, Windows 10. FIXME
+----
+{{:software:qpaint-runtime:qpaint-runtime_pc-r44_01.png?nolink|{{:software:qpaint-runtime:qpaint-runtime_pc-r44_01.png?nolink|}}
+===== - Releases =====
+==== - Release 2.0.1 (coming soon) ====
+Questa release introduce la possibilità di eseguire il programma su diversi sistemi operativi, tra i quali GNU/Linux.
+Vedere la sezione [[software:qpaint-runtime:qpaint-runtime-2]] per i settaggi. FIXME
+<WRAP center round download 30%>
+{{ :software:qpaint-runtime:link_esempi_qpaintruntime.zip |}}
+DELETEME OBSOLETO-
+</WRAP>
+Estrarre i files e cliccare col tasto DX e modificare a piacere i parametri.
+Per eseguire in questo modo QPaint Runtime sarà sufficiente trascinare il file .BIN su uno di questi collegamenti (DRAG AND DROP).
+===== - Download =====
+Il software è scaricabile al seguente indirizzo:
+<WRAP center round download 60%>
+https://www.qemservice.it/Download/Prog/Qwork/QPaintRuntime-1.0.6-install-pack.exe.zip
+DELETEME OBSOLETO-
+</WRAP>
+===== - Licenza =====
+FIXME
+Il software funziona in modalità **DEMO**, è necessario acquistare una chiave hardware di licenza per il funzionamento completo.
+:help:
+==== - Modalità DEMO ====
+{{:software:qpaint-runtime:qpaintruntime-demo.png?nolink|}}
+==== - Modalità Completa ====
+Questa applicazione richiede una chiavetta XLight programmata con il codice di licenza. Se la chiavetta
+non è presente il software si avvia in modalità dimostrativa e funziona per 10 minuti
+senza limitazioni, dopodiché si chiude.
+----
+{{:software:qpaint-runtime:s1-qpaint-runtime_02.jpeg?400|}}
+<WRAP center round info 60%>
+La chiavetta __non richiede__ l'installazione di **driver**, viene riconosciuta dal sistema operativo automaticamente. È consigliato fare almeno un riavvio dopo il primo inserimento.
+</WRAP>
+<WRAP center round important 60%>
+Verificare che all'inserimento della chiavetta hardware USB nel computer compaia nel gestore risorse di Windows, vedi immagine seguente:
+</WRAP>
+{{:software:qpaint-runtime:qpaintruntime-hid_usb_key.png?nolink|}}
+<pagebreak>
+====== - Caratteristiche generali ======
+QPaint Runtime è un HMI per PLC che viene eseguito dal sistema operativo Windows.
+È retrocompatibile con i prodotti della gamma QMove+ e QPanel+.
+====== - Creazione programma HMI ======
+ La programmazione HMI si esegue con il software QPaint presente nella suite QWorkBench scaricabile [[https://www.qemservice.it/Download/Prog/Qwork/QWorkBench-1.1.8-install-pack.zip|a questo indirizzo]].
+Dal menù "Progetto" scegliere "Configurazione del Target"
+{{:software:qpaint-runtime:qpaintruntime-configurazione_target.png?nolink&1200}}
+Selezionare la risoluzione appropriata tra una delle seguenti:
+  * SVGA (800x600)
+  * XVGA (1024x768)
+  * WXGA 16:10 (1280x800)
+  * HD (1366x768)
+  * FullHD (1920x1080)
+{{:software:qpaint-runtime:qpaintruntime-configurazione_target_2.png?nolink}}
+Creare il programma HMI seguendo le istruzioni del software QPaint.
+Dopo aver effettuato il savataggio del file è necessario produrre il file binario che sarà eseguito da QPaint Runtime, per fare ciò cliccare sull'icona come nell'imagine di esempio:
+{{:software:qpaint-runtime:qpaintruntime-download_to_file_icon.png?nolink&1200|}}
+Salvare il file <code>appqtp00.BIN</code> nella cartella:
+<code>C:\</code>
+{{:software:qpaint-runtime:qpaintruntime-save_file.png?nolink&600|}}
+<pagebreak>
+====== - Configurazione ======
+Il file di configurazione si trova al percorso:
+<wrap hi>%APPDATA%\QPaintRuntime-1\qpaintruntime.cfg</wrap>
+{{:software:qpaint-runtime:qpaintruntime-file_configurazione.png?nolink&1200}}
+Qui un file di esempio scaricabile:
+<WRAP center round download 25%>
+{{ :software:qpaint-runtime:qpaintruntime.zip |}}
+</WRAP>
+===== - Parametri =====
+=== Descrizione parametri ===
+^ parametro    ^ descrizione                                                                                   ^
+| /border      | Se abilitato, la finestra dell'applicazione mostra il normale bordo                           |
+| /cursor      | Se abilitato, il puntatore del mouse risulta visibile                                         |
+| /stayontop   | Se abilitato, il focus di Windows rimane sempre sulla finestra del programma                  |
+| /port0       | Numero di porta seriale per la USER port                                                      |
+| /port1       | Numero di porta seriale per la PROG port                                                      |
+| /baud0       | Velocità in baud della USER port                                                              |
+| /baud1       | Velocità in baud della PROG port                                                              |
+| /tpcip0      | Indirizzo IP della USER port                                                                  |
+| /tcpipport0  | Porta (IP) della USER port                                                                    |
+| /width       | Stiramento orizzontale. Se impostato, la risoluzione dello schermo viene espansa (larghezza)  |
+| /height      | Striramento verticale. Se impostato, la risoluzione dello schermo viene espansa (altezza)     |
+| /app         | Percorso del file binario da eseguire                                                         |
+<pagebreak>
+<WRAP center round info 60%>
+NOTA: se definisci sia /port0 che /tcpip0, verrà usato il canale ethernet.
+</WRAP>
+<WRAP center round info 60%>
+NOTA: /port0 /port1 e /port2 usano un numero che è il numero standard di Windows COM
+Esempio: /port0=2 significa COM2.
+</WRAP>
+====== - Utilizzo ======
+Per avviare il software cliccare sull'icona
+{{:software:qpaint-runtime:qpaintruntime.png|}}
+===== - Tastiera =====
+Comandi da tastiera:
+^  tasto         ^  comando                                          ^
+|  <code>q</code>         | esce dall'applicazione                            |
+|  <code>d</code>         | mostra il pannello informativo                    |
+|  <code>p</code>         | effettua uno screenshot                           |
+|  <code>F4+F5+F6</code>  | mostra il tempo di refresh dello schermo in msec  |
+| <code>F2+F4+F6</code>  | mostra il menù delle opzioni                      |
+===== - Risoluzione =====
+La dimensione dell'applicazione dipende dalla configurazione di QPaint in esecuzione. Se si migra da un
+vecchio progetto è anche possibile usare la risoluzione originale del display (se è disponibile su
+configurazione di QPaint) e allungare la dimensione per adattarla alla risoluzione del monitor usando le opzioni <code>/width</code>
+e <code>/height</code> Questa non è una buona soluzione ma si può evitare di modificare gli
+oggetti grafici.
+<wrap hi><wrap em>Se si utilizza la modalità di scaling del sistema operativo la risoluzione peggiorerà, risulterà leggermente sgranata.</wrap>
+</wrap>
+<pagebreak>
+FIXME PRELIMINARE-
+===== - Gestione data e ora =====
+QPaintruntime usa il calendario del sistema operativo per aggiornare le sue $HOUR $SEC $TIME
+$DATE $MONTH $YEAR. Poiché tipicamente il calendario Qmove ha una deriva, puoi usare un
+evento rilassato QPaint per aggiornare il calendario Qmove. Il calendario di Windows può infatti
+essere aggiornato per il tempo solare o mantenuto accurato da una connessione Internet.
+Di seguito una schermata di esempio: \\ \\
+{{:software:qpaint-runtime:qpaintruntime-time_variables.png?nolink|}}
+===== - Screenshot =====
+Per effettuare uno screenshot premere il tasto <code>p</code>
+Gli screenshot effettuati vengono salvati nella cartella
+<code>D:\</code>
+Ad ogni operazione vengono creati tre files:
+<code>background.bmp</code>
+<code>graphicarea.bmp</code>
+<code>keyboardarea.bmp</code>
+<WRAP center round info 60%>
+Se non fosse presente la partizione D: si può sopperire collegando una chiavetta USB e assegnadogli la lettera D.
+</WRAP>
+<pagebreak>
+====== - I/O con IQ023 ======
+Opzionalmente si possono avere ingressi/uscite digitali, ingressi analogici e ingressi di conteggio acquistando l'accessorio [[https://wiki.qem.it/doku.php/strumenti/accessori/iq023|IQ023]].
+{{:strumenti:accessori:iq023:iq023.png?nolink&800|}}
+<WRAP center round important 60%>
+Nota: può capitare che al primo collegamento della periferica al computer, il mouse e/o la tastiera funzionino in modo anomalo.
+È necessario **riavviare** almeno una volta **il sistema operativo** dopo il primo collegamento della periferica.
+</WRAP>
+<pagebreak>
+====== - Utilizzo delle variabili ======
+<WRAP center round box 60%>
+Di seguito la spiegazione di come mappare le variabili per l'utilizzo.
+</WRAP>
+Per utilizzare gli ingressi e le uscite dell'accessorio fare riferimento alla seguente tabella:
+^  variabile         ^  utilizzo                                                                                                                                                                                          ^
+| $INPL1 bit 0 ÷ 23  | riflettono gli ingressi digitali D1÷ D24                                                                                                                                                           |
+| $INPL1 bit 24      | indica lo stato della connessione con IQ023: \\  1 -> connesso, 0 -> disconnesso                                                                                                                   |
+| $INPL1 bit 25      | toggle bit 3 s ON and 3 s OFF                                                                                                                                                                      |
+| $AI1 ÷ $AI8        | riflettono i valori degli ingressi analogici A0 ÷ A7, il range dei valori va da -512 a +512                                                                                                        |
+| $CNT01 ÷ CNT04     | riflettono i valori degli ingressi di conteggio E1 ÷ E4                                                                                                                                            |
+| $CNT08             | numero seriale del dispositivo IQ023                                                                                                                                                               |
+| $CONTRAST          | Se Windows ha il salvaschermo attivo, impostare 100 indica a Windows di reimpostare il tempo del salvaschermo. \\ Di conseguenza, se il display era in stato di risparmio, si riaccende di nuovo.  |
+| $HOUR              | ore                                                                                                                                                                                                |
+| $SEC               | secondi                                                                                                                                                                                            |
+| $TIME              | orario                                                                                                                                                                                             |
+| $MONTH             | mese                                                                                                                                                                                               |
+| $YEAR              | anno                                                                                                                                                                                               |
+<pagebreak>
+====== - Menù configurazione ======
+<wrap center hi 70%>Per accedere al menù di setup premere contemporaneamente i tasti **F2+F4+F6**, apparirà una schermata come quella seguente:
+</wrap>
+----
+{{:software:qpaint-runtime:qpaintruntime-setup_page.png?nolink|}}
+----
+<pagebreak>
+<WRAP center round box 60%>
+Entrando nel menù di configurazione viene mostrata una schermata come la seguente. \\
+Qui è possibile abilitare l'opzione IQ023.
+</WRAP>
+----
+{{:software:qpaint-runtime:qpaintruntime-config_page.png?nolink|}}
+----
+<pagebreak>
+====== - Tasti funzione  ======
+I tasti funzione presenti sul pannello HMI da F1 a F8 sono mappati su quelli della tastiera del computer.
+Si possono usare degli ingressi digitali come tasti funzione, vedere la dicitura seguente:
+<WRAP center round info 60%>
+Se in configurazione si imposta il **parametro** **IQ023** su **ON**, gli ingressi digitali da **D17** a **D24** sono usati anche per simulare la **funzione della tastiera** **F1** a **F8**. \\
+</WRAP>
+<WRAP center round box 30%>
+{{:software:qpaint-runtime:qpaintruntime-iq023_parameter.png?nolink|}}
+</WRAP>
+<pagebreak>
+====== - Appendice A: compatibilità ======
+===== - Qmove+ =====
+Il software è compatibile con i prodotti [[https://wiki.qem.it/doku.php/strumenti/qmoveplus#retroquadro|"Retroquadro"]] della gamma [[https://wiki.qem.it/doku.php/strumenti/qmoveplus|Qmove+]] (Plus).
+===== - Qmove =====
+Il software è compatibile con i prodotti [[https://wiki.qem.it/doku.php/strumenti/qmove/c1|"Compatto"]] della gamma [[https://wiki.qem.it/doku.php/strumenti/qmove|Qmove]] __solo se è disponbibile__ il protocollo "BIN1".
+Il protocollo binario "BIN1" può non essere presente oppure può essere presente al protocollo ASCII; in quest'ultimo caso sullo strumento è presente un DIP switch per la selezione di uno dei due protocolli. Occorre accertarsi che il canale binario non sia già impegnato con altro software.
+Fare riferimento al manuale dello strumento per ottenere le informazioni necessarie.