Questo articolo fornisce informazioni sul driver Linux per touchscreen Elo - APR (USB) v2.20 e istruzioni per l'installazione

Di seguito sono riportate le istruzioni per l'installazione del driver Linux per touchscreen Elo APR (USB) v2.20.

Questo driver è obsoleto e non è più supportato.                



Driver Linux per touchscreen Elo - APR (USB)

                   Intel i686 (32 bit) o AMD64/Intel (64 bit)
           
                    Istruzioni per l'installazione/disinstallazione

--------------------------------------------------------------------------------         
             
                                  Versione 2.2.0 
                                07 ottobre 2010
                                Elo TouchSystems

================================================================================    

Il pacchetto driver Linux APR Elo contiene driver Linux progettati per il kernel Linux 2.6 
e utilità per il pannello di controllo grafico e da linea di comando per i monitor touch Elo 
APR. Questo driver richiede la libreria libusb-1.0 per funzionare correttamente. Vedi sezione 3 per installare la libreria libusb-1.0.


Questo file readme è organizzato come segue:

  1. Monitor touch supportati e controller touchscreen Elo
  2. Requisiti di sistema
  3. Installazione della libreria libusb-1.0
  4. Installazione del driver touchscreen Elo APR
  5. Opzioni da linea di comando del driver APR e utilizzo
  6. Accesso al pannello di controllo 
  7. Disinstallazione del driver touchscreen Elo APR
  8. Contattare Elo TouchSystems




==========================================================
1. Monitor touch supportati e controller touchscreen Elo
==========================================================

 - Controller Elo APR (USB) (APR 7000/7001/7002)




======================
2. Requisiti di sistema
======================

 - Piattaforma Intel i686 (32 bit) (oppure)   [Visita la sezione download Linux su           
   piattaforma AMD/Intel x86_64 a         www.elotouch.com per scaricare il pacchetto 
                                            per Linux a 32 o 64 bit]    

 - Kernel supportati: 
    Versione del kernel 2.6

 - Versioni libusb supportate:
    libusb 1.0 (libusb-1.0.so.0)

 - Versioni Motif supportate:
    Versione Motif 4.0 (libXm.so.4)
    Versione Motif 3.0 (libXm.so.3)

 - Versioni libusb supportate:
    Versione libusb 1.0 




====================================
3. Installazione della libreria libusb-1.0
====================================

Importante:
==========
a.) È necessario avere diritti di accesso da amministratore sul sistema Linux per installare la 
    libreria libusb-1.0. 
 
b.) Per costruire la libreria libusb-1.0 dal codice sorgente, è necessario un ambiente di sviluppo
    con pacchetti necessari come gcc, make, ecc. Fare riferimento alla documentazione del codice sorgente 
    libusb-1.0 per ulteriori dettagli.

c.) Le funzioni di Libusb-1.0 utilizzano il file system "usbfs" per interagire con il dispositivo usb.
    Assicurati che "usbfs" sia montato e attivo se ricevi errori con le funzioni di libusb-1.0.    

d.) Questo driver NON funzionerà con la vecchia libreria libusb-0.1.   



I componenti del driver touchscreen Linux Elo APR richiedono ora il supporto della libreria libusb-1.0 
(la vecchia libreria libusb-0.1 non funzionerà). Questa libreria libusb-1.0 può essere 
installata da pacchetti binari forniti da varie distribuzioni Linux. La 
libreria può anche essere installata compilando il pacchetto sorgente di libusb-1.0 
disponibile per il download sul sito web di libusb-1.0.



Installa la libreria libusb-1.0 da pacchetti binari
-----------------------------------------------

La maggior parte delle ultime distribuzioni Linux (esempio: OpenSuse 11.1, Ubuntu 9.04, Fedora 10, 
ecc.) hanno iniziato a fornire questa libreria (aggiornamento della popolare libreria libusb-0.1) come parte della loro release standard. Potresti comunque dover selezionare e >installare la libreria dall'immagine CD/DVD o dal repository di pacchetti online.

Si veda di seguito i comandi per installare il pacchetto binario della libreria libusb-1.0 per alcune distribuzioni Linux. 

# yum install libusb1          [ Fedora 10 ]

# apt-get install libusb-1.0-0    [ Ubuntu 9.04 ]    


 
Installa la libreria libusb-1.0 dal codice sorgente
-------------------------------------------

Se la tua distribuzione (esempio: OpenSuse 10.3, Ubuntu 8.04, Fedora 8, ecc.) non dispone di un pacchetto binario per la libreria libusb-1.0, puoi scaricare l'ultima 
versione del codice sorgente per questa libreria dal sito di libusb-1.0, compilarla e installarla 
facilmente.
 
Sito web         - http://libusb.wiki.sourceforge.net/Libusb1.0   
Scarica il sorgente - http://sourceforge.net/projects/libusb/files/libusb-1.0/


Estrai il codice sorgente della libreria e poi esegui i seguenti comandi per >configurare, compilare e installare la libreria dalla cartella principale della libreria.
 
# cd libusb-1.0.0
# ./configure
# make
# make install

Piattaforma Intel 32 bit i686:
- - - - - - - - - - - - -    

# ln  -s  /usr/local/lib/libusb-1.0.so.0  /usr/lib/libusb-1.0.so.0        

(o)

Piattaforma AMD64/Intel 64 bit x86_64:   
- - - - - - - - - - - - - - - - - 

# ln  -s  /usr/local/lib64/libusb-1.0.so.0  /usr/lib64/libusb-1.0.so.0    


Le vecchie distribuzioni Linux potrebbero avere alcune limitazioni nella compilazione di questo codice sorgente della libreria a causa della versione del compilatore gcc. Fare riferimento alla documentazione del codice sorgente di libusb-1.0 per ulteriori dettagli.




============================================
4. Installazione del driver touchscreen Elo APR
============================================

Importante:
==========
a.) È necessario avere diritti di accesso da amministratore sul sistema Linux per installare il 
    driver touchscreen Elo APR. 
 
b.) Assicurati che tutti i precedenti driver Elo siano disinstallati dal sistema.

c.) Non estrarre il pacchetto binario scaricato su un sistema Windows. 

d.) Questo driver funzionerà solo sulla versione del kernel Linux 2.6.

e.) Assicurati che la libreria libusb-1.0 (pacchetto libusb-1_0-0-0.9.3-4.22 o libusb-1.0-0) 
    sia installata prima di procedere con l'installazione del driver touchscreen. 

f.) È necessaria la libreria Motif 4.0 (libXm.so.4) o Motif 3.0 (libXm.so.3) per utilizzare 
    il pannello di controllo basato su interfaccia grafica (GUI) (/etc/opt/elo-apr/cpl). 
    I pacchetti di installazione di Openmotif, libmotif, libopenmotif o lesstif forniscono 
    la libreria richiesta libXm.so.4 o libXm.so.3.

g.) Assicurati che il touchscreen APR sia connesso al sistema durante l'installazione 
    del driver e durante il riavvio dopo l'installazione del driver.    



Passo I:
-------

Copia i file del driver Elo APR dalla cartella binaria "bin-apr" estratta nella 
cartella elo predefinita (/etc/opt/elo-apr).  

  # cp -r ./bin-apr/  /etc/opt/elo-apr
  # cd /etc/opt/elo-apr



Passo II:
--------

Monitor touch APR con file di dati di caratterizzazione esterna (su stick USB):
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Se il monitor touch APR (esempio: 3200L Interactive Digital Signage Display) è arrivato 
con un stick USB, inserisci lo stick USB e montalo sulla tua distribuzione Linux.  
Ora copia il file di dati di caratterizzazione esterno dallo stick USB nella cartella di dati di caratterizzazione APR 
(/etc/opt/elo-apr/ConfigData/APRCalData/) e rinomina il file esattamente come "AprCF.bin"(aprcf.bin non funzionerà). Crea la 
cartella di dati di caratterizzazione se non esiste. Sovrascrivi il file AprCF.bin se è già presente. 

  # mkdir -p /etc/opt/elo-apr/ConfigData/APRCalData/
  # cp -r  / /etc/opt/elo-apr/ConfigData/APRCalData/AprCF.bin

Se lo stick USB è montato su "/media/usbdisk" e se il nome del file di caratterizzazione 
è "F102000120PD_U03", usa il comando sottostante. Modifica il punto di montaggio USB e 
il nome del file come necessario.

  # cp -r /media/usbdisk/F102000120PD_U03 /etc/opt/elo-apr/ConfigData/APRCalData/AprCF.bin

Ora esegui il driver dal terminale per rilevare il nuovo monitor touch APR e 
inizia a lavorare con il nuovo file di dati di caratterizzazione AprCF.bin. 

  # cd /etc/opt/elo-apr
  # ./eloapr

Il driver inizierà a rispondere all'input touch dell'utente per qualsiasi utente (root o 
utente normale). Dopo il successivo riavvio del sistema, il touch dovrebbe essere disponibile anche 
sulla schermata di accesso.

Ora procedi con il Passo III di installazione.


Monitor touch APR con file di dati di caratterizzazione incorporato:
- - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Assicurati che il monitor touch APR sia connesso al sistema e procedi con il 
download del file di dati di caratterizzazione.

Ora esegui il driver dal terminale per rilevare il nuovo monitor touch APR e 
scaricare il file di dati di caratterizzazione. Questo download di dati richiederà alcuni 
minuti per completare ed è effettuato solo una volta per ogni touchscreen. Questi dati, memorizzati su 
disco rigido, sono unici per ogni touchscreen e vengono utilizzati dal driver per 
lavorare con uno specifico touchscreen.

  # cd /etc/opt/elo-apr
  # ./eloapr

Una volta completato il download dei dati, il driver inizierà a rispondere all'input touch dell'utente per qualsiasi utente (root o utente normale). Dopo il successivo riavvio del sistema, 
il touch dovrebbe essere disponibile anche sulla schermata di accesso.



Passo III:
---------

Sistemi OpenSuse e Suse Enterprise Linux:
- - - - - - - - - - - - - - - - - - - - - -
Copia il file delle regole udev del driver Elo APR (99-elotouch-suse.rules) nella cartella delle regole udev "/etc/udev/rules.d/". Se il tuo Xserver non utilizza l'autenticazione X, aggiungi il parametro "--noxauthentication" alla riga di avvio di eloapr, nel file "/etc/udev/rules.d/99-elotouch-suse.rules".

  # ls -l /etc/udev/rules.d/
  # cp /etc/opt/elo-apr/setup/99-elotouch-suse.rules /etc/udev/rules.d/


Disconnetti e riconnetti il monitor touch APR e verifica se il touch è attivo. Se il touch non viene ripristinato, modifica il file delle regole APR UDEV per adattarlo alla distribuzione Linux. Controlla i file delle regole udev disponibili nella cartella /etc/opt/elo-apr/setup e 
/etc/udev/rules.d per possibili modifiche.


Sistemi Debian, Ubuntu e Gentoo:
- - - - - - - - - - - - - - - - - 
Copia il file delle regole udev del driver Elo APR (99-elotouch-ubuntu.rules) nella cartella delle regole udev "/etc/udev/rules.d/". Se il tuo Xserver non utilizza l'autenticazione X, aggiungi il parametro "--noxauthentication" alla riga di avvio di eloapr, nel file "/etc/udev/rules.d/99-elotouch-ubuntu.rules".

  # ls -l /etc/udev/rules.d/
  # cp /etc/opt/elo-apr/setup/99-elotouch-ubuntu.rules /etc/udev/rules.d/


Disconnetti e riconnetti il monitor touch APR e verifica se il touch è attivo. Se il touch non viene ripristinato, modifica il file delle regole APR UDEV per adattarlo alla distribuzione Linux. Controlla i file delle regole udev disponibili nella cartella /etc/opt/elo-apr/setup e 
/etc/udev/rules.d per possibili modifiche.


Sistemi Slackware e Redhat Enterprise Linux:
- - - - - - - - - - - - - - - - - - - - - - - 
Copia il file delle regole udev del driver Elo APR (99-elotouch-rhel.rules) nella cartella delle regole udev "/etc/udev/rules.d/". Se il tuo Xserver non utilizza l'autenticazione X, aggiungi il parametro "--noxauthentication" alla riga di avvio di eloapr, nel file "/etc/udev/rules.d/99-elotouch-rhel.rules".

  # ls -l /etc/udev/rules.d/
  # cp /etc/opt/elo-apr/setup/99-elotouch-rhel.rules /etc/udev/rules.d/


Disconnetti e riconnetti il monitor touch APR e verifica se il touch è attivo. Se il touch non viene ripristinato, modifica il file delle regole APR UDEV per adattarlo alla distribuzione Linux. Controlla i file delle regole udev disponibili nella cartella /etc/opt/elo-apr/setup e 
/etc/udev/rules.d per possibili modifiche.


Sistemi Fedora:
- - - - - - - - 
Copia il file delle regole udev del driver Elo APR (99-elotouch-fedora.rules) nella cartella delle regole udev "/etc/udev/rules.d/". Se il tuo Xserver non utilizza l'autenticazione X, aggiungi il parametro "--noxauthentication" alla riga di avvio di eloapr, nel file "/etc/udev/rules.d/99-elotouch-fedora.rules".

  # ls -l /etc/udev/rules.d/
  # cp /etc/opt/elo-apr/setup/99-elotouch-fedora.rules /etc/udev/rules.d/


Disconnetti e riconnetti il monitor touch APR e verifica se il touch è attivo. Se il touch non viene ripristinato, modifica il file delle regole APR UDEV per adattarlo alla distribuzione Linux. Controlla i file delle regole udev disponibili nella cartella /etc/opt/elo-apr/setup e 
/etc/udev/rules.d per possibili modifiche.


Sistemi Mandriva:
- - - - - - - - -
Copia il file delle regole udev del driver Elo APR (99-elotouch-mandriva.rules) nella cartella delle regole udev "/etc/udev/rules.d/". Se il tuo Xserver non utilizza l'autenticazione X, aggiungi il parametro "--noxauthentication" alla riga di avvio di eloapr, nel file "/etc/udev/rules.d/99-elotouch-mandriva.rules".

  # ls -l /etc/udev/rules.d/
  # cp /etc/opt/elo-apr/setup/99-elotouch-mandriva.rules /etc/udev/rules.d/


Disconnetti e riconnetti il monitor touch APR e verifica se il touch è attivo. Se il touch non viene ripristinato, modifica il file delle regole APR UDEV per adattarlo alla distribuzione Linux. Controlla i file delle regole udev disponibili nella cartella /etc/opt/elo-apr/setup e 
/etc/udev/rules.d per possibili modifiche.



Passo IV:
--------

Assicurati che il touchscreen Elo APR (USB) sia connesso al computer e 
riavvia il sistema. 

  # shutdown -r now




===========================================
5. Opzioni da linea di comando del driver APR e utilizzo
===========================================

Le opzioni da linea di comando del driver APR (eloapr) sono elencate di seguito. Se necessario, modifica il 
file delle regole UDEV Elo per aggiungere opzioni da linea di comando all'avvio del driver eloapr.   

  --nobeepontouch     [ Disabilita la funzionalità di beep al tocco ]

  --noxauthentication   [ Disabilita il processo di autenticazione X per Xorg 
                          Xservers che non richiedono una procedura di autenticazione 
                          per interagire con il server X (sistemi incorporati) ]

  --displaycoordinates    [ Visualizza i dati del tocco, corrispondenti a ciascun tocco,
                          su un terminale. I dati di tocco consistono nello stato del tocco 
              (Tocco/ Flusso/ Nessun tocco) insieme alle coordinate X e Y. Questa opzione è utilizzata per testare il touchscreen APR,
              pertanto i dati di tocco vengono solo visualizzati e 
              non inviati al server X per muovere il puntatore del mouse. ]

  --rotation    [ Avvia il driver APR per supportare le modalità 
                          rotazione video rispettive. Gli angoli di rotazione video supportati sono 0, 
              90, 180 e 270. ]

  --linearinputgain   [ Cambia l'indice di guadagno dell'input lineare. L'intervallo valido
                                per l'indice di guadagno è da 0 a 45. ]

  --aprmode_pos        [ Avvia il driver Elo APR progettato per le applicazioni di Point of Sale 
                          (POS) (modalità predefinita). ]

  --aprmode_general    [ Avvia il driver Elo APR progettato per le applicazioni generali. ]

  --aprmode_signature    [ Avvia il driver Elo APR progettato per le applicazioni di firma. ]

  --aprmode_gaming    [ Avvia il driver Elo APR progettato per le applicazioni di gioco. ]

  --custom_parameters   [ Avvia il driver Elo APR con parametri personalizzati per un' 
                          specifica modalità APR. I parametri personalizzati vengono letti dal 
                          file /etc/opt/elo-apr/setup/customAprParameters.txt. 
                          Contatta il supporto tecnico di Elo per assistenza con i parametri personalizzati, se le 4 modalità APR standard non sono 
              idonee. Il formato dei parametri personalizzati è elencato nel file 
              customAprParameters.txt e l'intervallo valido è 
              da Parameter_0 a Parameter_37.  ]



Esempi di utilizzo:    
---------------

  eloapr --nobeepontouch
  
  eloapr --nobeepontouch --noxauthentication --aprmode_gaming

  eloapr --rotate 90

  eloapr --rotate 180 --displaycoordinates
  
  eloapr --aprmode_signature
  
  eloapr --aprmode_signature --custom_parameters  [ Carica la modalità standard APR Signature 
                                                    e poi sostituisci alcuni 
                            parametri forniti nel 
                            file di parametri personalizzati. ]

  eloapr --custom_parameters                      [ Carica la modalità Standard APR POS 
                                                    (predefinita) e poi sostituisci 
                            alcuni parametri forniti nel 
                            file di parametri personalizzati. ]




==============================
6. Accesso al pannello di controllo 
==============================

L'applicazione del pannello di controllo consente all'utente di impostare facilmente le opzioni di configurazione del driver disponibili. Dopo che il driver è stato installato e caricato, passa alla cartella 
/etc/opt/elo-apr e avvia l'applicazione del pannello di controllo. 


Importante:
==========

Gli utenti devono avere accesso da amministratore o root per eseguire le applicazioni del pannello di controllo.


Passo I:
-------

Esegui l'utilità del pannello di controllo da una finestra di comando in X Windows dalla cartella 
/etc/opt/elo-apr. È necessaria la versione Motif 4.0 (libXm.so.4) o la versione Motif 3.0 
(libXm.so.3) per utilizzare il pannello di controllo basato su GUI 
(/etc/opt/elo-apr/cpl). 

  # cd /etc/opt/elo-apr
  # ./cpl 



Passo II:
--------

Naviga attraverso le varie schede facendo clic su di esse. Ecco una panoramica delle 
informazioni relative a ciascuna scheda.

  Generale    - Informazioni generali sul touchscreen
  Modalità       - Cambia la modalità del touchscreen
  Proprietà - Visualizza dati relativi al monitor touch APR
  Info      - Informazioni sul pacchetto. Fai clic sul pulsante Readme                    
               per aprire questo file readme.txt. 
    


Passo III:
---------

Se Motif non è installato, utilizza la versione da linea di comando dell'applicazione per 
accedere al pannello di controllo. Esegui l'applicazione da linea di comando da una finestra di comando 
in X Windows dalla cartella /etc/opt/elo-apr.

  # cd /etc/opt/elo-apr
  # ./cplcmd




==============================================
7. Disinstallazione del driver touchscreen Elo APR
==============================================


Importante:
==========
a.) È necessario avere diritti di accesso da amministratore sul sistema Linux per disinstallare il 
    driver touchscreen Elo APR.
 
b.) Tutti i dati di caratterizzazione touchscreen che sono stati scaricati sul 
    disco rigido verranno eliminati.  


Passo I:
-------

Rimuovi il file delle regole udev del driver Elo APR (99-elotouch-*.rules) che è stato copiato 
nella cartella delle regole udev "/etc/udev/ruled.d" nel Passo III di installazione.

  # cd /etc/udev/rules.d
  # rm -i /etc/udev/rules.d/99-elotouch-*.rules


Passo II:
--------

Elimina i file e le cartelle del driver Elo APR all'interno della cartella principale del driver Elo APR 
("/etc/opt/elo-apr"), creata nel Passo I di installazione.  

  # cd /etc/opt
  # rm -rf /etc/opt/elo-apr


Riavvia il sistema per completare il processo di disinstallazione.

  # shutdown -r now




==============================
8. Contattare Elo TouchSystems
==============================

Sito web: http://www.elotouch.com


E-mail: customerservice@elotouch.com


Indirizzo postale: 
----------------

  Elo TouchSystems
  Un'azienda Tyco Electronics 
  301 Constitution Drive
  Menlo Park, CA 94025
  USA

  Telefono:   (800) 557-1458
           (650) 361-4800

  Fax:     (650) 361-4722

--------------------------------  

  Elo TouchSystems GmbH & Co. KG
  Haidgraben 6
  D-85521 Ottobrunn
  Germania
         
  Telefono: +49 (0) 89/60822-0
  Fax:   +49 (0) 89/60822-150

--------------------------------  

  Elo TouchSystems, NV
  Diestsesteenweg 692
  B-3010 Kessel-Lo
  Belgio

  Telefono: +32 (16) 35-2100
  Fax:   +32 (16) 35-2101


================================================================================    

                       Copyright (c) 2010 Elo TouchSystems

                              Tutti i diritti riservati.

================================================================================