Este artigo fornece informações sobre o Driver de Tela Touch Elo para Linux - APR (USB) v2.20 e Instruções de Instalação

Abaixo estão as Instruções de Instalação do Driver Touchscreen Linux APR (USB) v2.20.

Este driver está obsoleto e não é mais suportado.                



Driver Touchscreen Linux Elo - APR (USB)

                   Intel i686 (32 bits) ou AMD64/Intel (64 bits)
           
                    Instruções de Instalação/Desinstalação

--------------------------------------------------------------------------------         
             
                                  Versão 2.2.0 
                                07 de Outubro de 2010
                                Elo TouchSystems

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

O pacote do Driver Linux APR contém drivers Linux projetados para o kernel 2.6 
do Linux, painel de controle gráfico e utilitários de painel de controle por linha de comando para os monitores touch APR da Elo. Este driver requer a biblioteca libusb-1.0 para funcionar corretamente. Consulte a seção 3 para a instalação da biblioteca libusb-1.0.


Este arquivo readme está organizado como segue:

  1. Monitores Touch suportados e Controladores Touchscreen Elo
  2. Requisitos de Sistema
  3. Instalando a biblioteca libusb-1.0
  4. Instalando o Driver Touchscreen Elo APR
  5. Opções de Linha de Comando do Driver APR e Uso
  6. Acessando o Painel de Controle 
  7. Desinstalando o Driver Touchscreen Elo APR
  8. Contatando a Elo TouchSystems




==========================================================
1. Monitores Touch suportados e Controladores Touchscreen Elo
==========================================================

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




======================
2. Requisitos de Sistema
======================

 - Plataforma Intel i686 (x86) de 32 bits (ou)   [Visite a seção de downloads Linux em           
   plataforma AMD/Intel x86_64 de 64 bits         www.elotouch.com para baixar o pacote de driver para o seu Linux de 32 ou 64 bits]    

 - Kernels suportados: 
    Versão do kernel 2.6

 - Versões suportadas da Libusb:
    libusb 1.0 (libusb-1.0.so.0)

 - Versões suportadas do Motif:
    Versão do Motif 4.0 (libXm.so.4)
    Versão do Motif 3.0 (libXm.so.3)

 - Versões suportadas da libusb:
    Versão 1.0 da libusb 




====================================
3. Instalando a biblioteca libusb-1.0
====================================

Importante:
==========
a.) Deve ter direitos de acesso de administrador no sistema Linux para instalar a 
    biblioteca libusb-1.0. 
 
b.) Para compilar a biblioteca libusb-1.0 a partir do código-fonte, é necessário um ambiente de desenvolvimento
    com pacotes necessários como gcc, make, etc. Consulte a documentação do código-fonte da libusb-1.0
    para mais detalhes.

c.) As funções da Libusb-1.0 usam o sistema de arquivos "usbfs" para interagir com o dispositivo usb.
    Certifique-se de que "usbfs" esteja montado e ativo se você receber erros com as funções da libusb-1.0.    

d.) Este driver NÃO funcionará com a biblioteca libusb-0.1 mais antiga.   



Os componentes do driver touchscreen Linux Elo APR agora requerem suporte da biblioteca libusb-1.0
(a biblioteca libusb-0.1 mais antiga não funcionará). Esta biblioteca libusb-1.0 pode ser
instalada a partir de pacotes binários fornecidos por várias distribuições Linux. A 
biblioteca também pode ser instalada compilando o pacote fonte da libusb-1.0 
disponível para download no site da libusb-1.0.



Instalar a biblioteca libusb-1.0 a partir de pacotes binários
-----------------------------------------------

A maioria das distribuições Linux mais recentes (exemplo: OpenSuse 11.1, Ubuntu 9.04, Fedora 10, 
etc) começou a fornecer essa biblioteca (atualização da popular biblioteca libusb-0.1)
como parte de seu lançamento padrão. Você ainda pode precisar selecionar e 
instalar a biblioteca a partir da imagem do CD/DVD ou do repositório de pacotes online. 

Consulte os comandos para instalar o pacote binário da biblioteca libusb-1.0 para algumas distribuições Linux, fornecidos abaixo. 

# yum install libusb1        [ Fedora 10 ]

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


 
Instalar a biblioteca libusb-1.0 a partir do código-fonte
-------------------------------------------

Se sua distribuição (exemplo: OpenSuse 10.3, Ubuntu 8.04, Fedora 8, etc) não tiver um pacote binário para a biblioteca libusb-1.0, você pode baixar o código-fonte mais recente 
desta biblioteca no site da libusb-1.0, compilar e instalá-la facilmente.
 
Website         - http://libusb.wiki.sourceforge.net/Libusb1.0   
Baixar Fonte - http://sourceforge.net/projects/libusb/files/libusb-1.0/


Extraia o código-fonte da biblioteca e, em seguida, execute os seguintes comandos para 
configurar, compilar e instalar a biblioteca a partir da pasta principal da biblioteca.
 
# cd libusb-1.0.0
# ./configure
# make
# make install

Plataforma Intel 32bits i686:
- - - - - - - - - - - - -    

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

(ou)

Plataforma AMD64/Intel 64bits x86_64:   
- - - - - - - - - - - - - - - - - 

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


Distribuições Linux mais antigas podem ter algumas limitações para compilar o código-fonte dessa biblioteca devido à versão do compilador gcc. Consulte a documentação do código-fonte da libusb-1.0 para mais detalhes.




============================================
4. Instalando o Driver Touchscreen Elo APR
============================================

Importante:
==========
a.) Deve ter direitos de acesso de administrador no sistema Linux para instalar o 
    Driver Touchscreen Elo APR. 
 
b.) Assegure-se de que todos os drivers Elo anteriores estejam desinstalados do sistema.

c.) Não extraia o pacote binário baixado em um sistema Windows. 

d.) Este driver funcionará apenas na versão do kernel Linux 2.6.

e.) Assegure-se de que a biblioteca libusb-1.0 (pacote libusb-1_0-0-0.9.3-4.22 ou libusb-1.0-0) esteja instalada antes de prosseguir com a instalação do driver touchscreen. 

f.) A biblioteca Motif 4.0 (libXm.so.4) ou Motif 3.0 (libXm.so.3) é necessária para usar o 
    painel de controle baseado na Interface Gráfica do Usuário (GUI) (/etc/opt/elo-apr/cpl). 
    Pacotes de instalação Openmotif, libmotif, libopenmotif ou lesstif fornecem 
    a biblioteca necessária libXm.so.4 ou libXm.so.3.

g.) Assegure-se de que o touchscreen APR esteja conectado ao sistema durante a instalação 
    do driver e durante a reinicialização após a instalação do driver.    



Passo I:
-------

Copie os arquivos do driver Elo APR da pasta binária extraída "bin-apr" para a 
pasta padrão elo (/etc/opt/elo-apr).  

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



Passo II:
--------

Monitores touch APR com arquivo de dados de caracterização externo (no pendrive):
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Se o monitor touchscreen APR (exemplo: Display Interativo Digital 3200L) veio 
com um pendrive, conecte o pendrive e monte-o na sua distribuição Linux.  
Agora copie o arquivo de dados de caracterização externo do pendrive para a pasta de dados de caracterização do APR (/etc/opt/elo-apr/ConfigData/APRCalData/) e 
renomeie o arquivo exatamente como "AprCF.bin"(aprcf.bin não funcionará). Crie a 
pasta de dados de caracterização se ela não existir. Substitua o arquivo AprCF.bin
se ele já existir. 

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

Se o pendrive estiver montado em "/media/usbdisk" e se o nome do arquivo de caracterização 
for "F102000120PD_U03", use o comando abaixo. Modifique o ponto de montagem do USB e 
o nome do arquivo conforme necessário.

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

Agora execute o driver a partir do terminal para detectar o novo touchscreen APR e 
comece a trabalhar com o novo arquivo de dados de caracterização AprCF.bin. 

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

O driver começará a responder ao toque do usuário para qualquer usuário (root ou 
usuário normal). Após a próxima reinicialização do sistema, o toque deve estar disponível na 
tela de login também. 

Agora prossiga para a Etapa de Instalação III.


Monitores touch APR com arquivo de dados de caracterização embutido:
- - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Assegure-se de que o monitor touchscreen APR esteja conectado ao sistema e prossiga com o 
download do arquivo de dados de caracterização. 

Agora execute o driver a partir do terminal para detectar o novo touchscreen APR e 
baixar o arquivo de dados de caracterização. Este download de dados levará alguns minutos 
para ser concluído e deve ser feito apenas uma vez por touchscreen. Esses dados, armazenados no 
disco rígido, são exclusivos para cada touchscreen e são usados pelo driver para 
trabalhar com um touchscreen específico.

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

Uma vez que o download dos dados esteja completo, o driver começará a responder ao toque do usuário 
para qualquer usuário (root ou usuário normal). Após a próxima reinicialização do sistema, 
o toque deve estar disponível na tela de login também. 



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

Sistemas OpenSuse e Suse Enterprise Linux:
- - - - - - - - - - - - - - - - - - - - - -
Copie o arquivo de regras udev do driver Elo APR (99-elotouch-suse.rules) para a pasta de regras udev "/etc/udev/rules.d/". Se o seu Xserver não usar autenticação X, adicione o parâmetro de linha de comando "--noxauthentication" à linha de inicialização do eloapr, no arquivo "/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/


Desconecte e reconecte o touchscreen APR e verifique se o toque está ativo. Se o toque não for
restaurado, modifique o arquivo de regras APR UDEV para adequá-lo à distribuição Linux. Consulte os arquivos de regras udev disponíveis na pasta /etc/opt/elo-apr/setup e na 
/etc/udev/rules.d para possíveis modificações. 


Sistemas Debian, Ubuntu e Gentoo:
- - - - - - - - - - - - - - - - - 
Copie o arquivo de regras udev do driver Elo APR (99-elotouch-ubuntu.rules) para a pasta de regras udev "/etc/udev/rules.d/". Se o seu Xserver não usar autenticação X, adicione o parâmetro de linha de comando "--noxauthentication" à linha de inicialização do eloapr, no arquivo "/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/


Desconecte e reconecte o touchscreen APR e verifique se o toque está ativo. Se o toque não for
restaurado, modifique o arquivo de regras APR UDEV para adequá-lo à distribuição Linux. Consulte os arquivos de regras udev disponíveis na pasta /etc/opt/elo-apr/setup e na 
/etc/udev/rules.d para possíveis modificações. 


Sistemas Slackware e Redhat Enterprise Linux:
- - - - - - - - - - - - - - - - - - - - - - - 
Copie o arquivo de regras udev do driver Elo APR (99-elotouch-rhel.rules) para a pasta de regras udev "/etc/udev/rules.d/". Se o seu Xserver não usar autenticação X, adicione o parâmetro de linha de comando "--noxauthentication" à linha de inicialização do eloapr, no arquivo "/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/


Desconecte e reconecte o touchscreen APR e verifique se o toque está ativo. Se o toque não for
restaurado, modifique o arquivo de regras APR UDEV para adequá-lo à distribuição Linux. Consulte os arquivos de regras udev disponíveis na pasta /etc/opt/elo-apr/setup e na 
/etc/udev/rules.d para possíveis modificações. 


Sistemas Fedora:
- - - - - - - - 
Copie o arquivo de regras udev do driver Elo APR (99-elotouch-fedora.rules) para a pasta de regras udev "/etc/udev/rules.d/". Se o seu Xserver não usar autenticação X, adicione o parâmetro de linha de comando "--noxauthentication" à linha de inicialização do eloapr, no arquivo "/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/


Desconecte e reconecte o touchscreen APR e verifique se o toque está ativo. Se o toque não for
restaurado, modifique o arquivo de regras APR UDEV para adequá-lo à distribuição Linux. Consulte os arquivos de regras udev disponíveis na pasta /etc/opt/elo-apr/setup e na 
/etc/udev/rules.d para possíveis modificações. 


Sistemas Mandriva:
- - - - - - - - -
Copie o arquivo de regras udev do driver Elo APR (99-elotouch-mandriva.rules) para a pasta de regras udev "/etc/udev/rules.d/". Se o seu Xserver não usar autenticação X, adicione o parâmetro de linha de comando "--noxauthentication" à linha de inicialização do eloapr, no arquivo "/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/


Desconecte e reconecte o touchscreen APR e verifique se o toque está ativo. Se o toque não for
restaurado, modifique o arquivo de regras APR UDEV para adequá-lo à distribuição Linux. Consulte os arquivos de regras udev disponíveis na pasta /etc/opt/elo-apr/setup e na 
/etc/udev/rules.d para possíveis modificações. 



Passo IV:
--------

Assegure-se de que o touchscreen Elo APR (USB) esteja conectado ao computador e 
reinicie seu sistema. 

  # shutdown -r now




===========================================
5. Opções de Linha de Comando do Driver APR e Uso
===========================================

As opções de linha de comando do driver APR (eloapr) estão listadas abaixo. Se necessário, modifique o 
arquivo de regras UDEV da Elo para adicionar opções de linha de comando à inicialização do driver eloapr.   

  --nobeepontouch     [ Desativar o recurso de beep ao tocar ]

  --noxauthentication   [ Desativar o processo de autenticação X para Xorg
                          Xservers que não requerem procedimento de autenticação
                          para interagir com o Xserver (sistemas embarcados) ]

  --displaycoordinates    [ Exibir os dados do toque, correspondentes a cada toque, 
                          no terminal. Os dados do toque consistem no estado do toque 
              (Toque/ Stream/ Não Tocar) junto com as coordenadas X e Y.
              Esta opção é usada para testar o touchscreen APR, portanto, os dados de toque são apenas exibidos e 
              não enviados ao Xserver para mover o ponteiro do mouse. ]

  --rotation    [ Iniciar o driver APR para suportar o respectivo modo de 
                          rotação de vídeo. Os ângulos de rotação de vídeo suportados são 0, 
              90, 180 e 270. ]

  --linearinputgain   [ Alterar o índice de ganho de entrada linear. O intervalo válido  
                                para o índice de ganho é de 0 a 45. ]

  --aprmode_pos        [ Iniciar o driver Elo APR adaptado para aplicações de Ponto de Venda 
                          (POS) (modo padrão). ]

  --aprmode_general    [ Iniciar o driver Elo APR adaptado para aplicações Gerais. ]

  --aprmode_signature    [ Iniciar o driver Elo APR adaptado para aplicações de Assinatura. ]

  --aprmode_gaming    [ Iniciar o driver Elo APR adaptado para aplicações de Jogos. ]

  --custom_parameters   [ Iniciar o driver Elo APR com parâmetros personalizados para um 
                          modo APR específico. Os parâmetros personalizados são lidos a partir do 
                          arquivo /etc/opt/elo-apr/setup/customAprParameters.txt. 
                          Contate o suporte técnico da Elo para ajuda com parâmetros personalizados, se os 4 modos padrão da APR não forem 
              adequados. O formato dos parâmetros personalizados está listado no 
              arquivo customAprParameters.txt e o intervalo válido é 
              de Parameter_0 a Parameter_37.  ]



Exemplos de Uso:    
---------------

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

  eloapr --rotate 90

  eloapr --rotate 180 --displaycoordinates
  
  eloapr --aprmode_signature
  
  eloapr --aprmode_signature --custom_parameters  [ Carregar Modo de Assinatura APR Padrão 
                                                    e, em seguida, substituir alguns 
                            parâmetros fornecidos no 
                            arquivo de parâmetros personalizados. ]

  eloapr --custom_parameters                      [ Carregar o Modo APR POS Padrão 
                                                    (padrão) e, em seguida, substituir 
                            alguns parâmetros fornecidos em 
                            arquivo de parâmetros personalizados. ]




==============================
6. Acessando o Painel de Controle 
==============================

O aplicativo do painel de controle permite que o usuário configure facilmente as opções de configuração disponíveis do driver. Após a instalação e carregamento do driver, mude para a pasta 
/etc/opt/elo-apr e execute o aplicativo do painel de controle.


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

Os usuários devem ter acesso de administrador ou root para executar os aplicativos do painel de controle.


Passo I:
-------

Execute a utilidade do painel de controle a partir de uma janela de comando no X Windows na 
pasta /etc/opt/elo-apr. A versão 4.0 do Motif (libXm.so.4) ou a versão 3.0 do Motif 
(libXm.so.3) é necessária para usar o painel de controle baseado na GUI 
(/etc/opt/elo-apr/cpl). 

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



Passo II:
--------

Navegue pelas várias abas clicando nelas. Aqui está uma visão geral das 
informações relacionadas a cada aba.

  Geral    - Informações gerais do touchscreen 
  Modo       - Mudar o modo do touchscreen
  Propriedades - Exibir dados relacionados ao monitor touch APR
  Sobre      - Informações sobre o pacote. Clique no botão Readme                    
               para abrir este arquivo readme.txt. 
    


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

Se o Motif não estiver instalado, use a versão da linha de comando do aplicativo para 
acessar o painel de controle. Execute o aplicativo de linha de comando 
a partir de uma janela de comando no X Windows na pasta /etc/opt/elo-apr.

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




==============================================
7. Desinstalando o Driver Touchscreen Elo APR
==============================================


Importante:
==========
a.) Deve ter direitos de acesso de administrador no sistema Linux para desinstalar o 
    Driver Touchscreen Elo APR.
 
b.) Todos os dados de caracterização do touchscreen que foram baixados para o 
    disco rígido serão apagados.  


Passo I:
-------

Remova o arquivo de regras udev do driver Elo APR (99-elotouch-*.rules) que foi copiado 
para a pasta de regras udev "/etc/udev/ruled.d" na Etapa de Instalação III.

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


Passo II:
--------

Delete os arquivos e pastas do driver Elo APR dentro da pasta principal do driver Elo APR 
"/etc/opt/elo-apr", criada na Etapa de Instalação I.  

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


Reinicie o sistema para concluir o processo de desinstalação.

  # shutdown -r now




==============================
8. Contatando a Elo TouchSystems
==============================

Website: http://www.elotouch.com


E-mail: customerservice@elotouch.com


Endereço para Correspondência: 
----------------

  Elo TouchSystems
  A Tyco Electronics Business 
  301 Constitution Drive
  Menlo Park, CA 94025
  EUA

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

  Fax:     (650) 361-4722

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

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

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

  Elo TouchSystems, NV
  Diestsesteenweg 692
  B-3010 Kessel-Lo
  Bélgica

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


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

                       Copyright (c) 2010 Elo TouchSystems

                              Todos os direitos reservados.

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