Arquivos de configuração do dispositivo de entrada

Os arquivos de configuração do dispositivo de entrada (arquivos .idc ) contêm propriedades de configuração específicas do dispositivo que afetam o comportamento dos dispositivos de entrada.

Os arquivos de configuração do dispositivo de entrada geralmente não são necessários para periféricos padrão, como teclados e mouses HID, pois o comportamento padrão do sistema geralmente garante que eles funcionem imediatamente. Por outro lado, dispositivos embutidos embutidos, particularmente telas sensíveis ao toque, quase sempre requerem arquivos de configuração de dispositivo de entrada para especificar seu comportamento.

Justificativa

O Android detecta e configura automaticamente a maioria dos recursos do dispositivo de entrada com base nos tipos de eventos e propriedades relatados pelo driver de dispositivo de entrada do kernel Linux associado.

Por exemplo, se um dispositivo de entrada suportar o tipo de evento EV_REL e os códigos REL_X e REL_Y , bem como o tipo de evento EV_KEY e BTN_MOUSE , o Android classificará o dispositivo de entrada como um mouse. O comportamento padrão de um mouse é apresentar um cursor na tela que rastreia os movimentos do mouse e simula toques quando o mouse é clicado. Embora o mouse possa ser configurado de forma diferente, o comportamento padrão geralmente é suficiente para periféricos de mouse padrão.

Certas classes de dispositivos de entrada são mais ambíguas. Por exemplo, telas de toque multitoque e touch pads suportam o tipo de evento EV_ABS e códigos ABS_MT_POSITION_X e ABS_MT_POSITION_Y no mínimo. No entanto, os usos pretendidos desses dispositivos são bastante diferentes e nem sempre podem ser determinados automaticamente. Além disso, são necessárias informações adicionais para entender as informações de pressão e tamanho relatadas pelos dispositivos de toque. Portanto, os dispositivos de toque, especialmente as telas de toque integradas, geralmente precisam de arquivos IDC.

Localização

Os arquivos de configuração do dispositivo de entrada estão localizados por fornecedor USB, ID do produto (e opcionalmente versão) ou pelo nome do dispositivo de entrada.

Os seguintes caminhos são consultados em ordem.

  • /odm/usr/idc/Vendor_XXXX_Product_XXXX_Version_XXXX.idc
  • /vendor/usr/idc/Vendor_XXXX_Product_XXXX_Version_XXXX.idc
  • /system/usr/idc/Vendor_XXXX_Product_XXXX_Version_XXXX.idc
  • /data/system/devices/idc/Vendor_XXXX_Product_XXXX_Version_XXXX.idc
  • /odm/usr/idc/Vendor_XXXX_Product_XXXX.idc
  • /vendor/usr/idc/Vendor_XXXX_Product_XXXX.idc
  • /system/usr/idc/Vendor_XXXX_Product_XXXX.idc
  • /data/system/devices/idc/Vendor_XXXX_Product_XXXX.idc
  • /odm/usr/idc/ device-name .idc
  • /vendor/usr/idc/ device-name .idc
  • /system/usr/idc/ device-name .idc
  • /data/system/devices/idc/ device-name .idc

Ao construir um caminho de arquivo que contém o nome do dispositivo, todos os caracteres no nome do dispositivo diferentes de '0'-'9', 'a'-'z', 'A'-'Z', '-' ou '_' são substituídos por '_'.

Sintaxe

Um arquivo de configuração de dispositivo de entrada é um arquivo de texto simples que consiste em atribuições de propriedades e comentários.

Propriedades

As atribuições de propriedade consistem em um nome de propriedade, um = , um valor de propriedade e uma nova linha. Assim:

property = value

Os nomes de propriedade são identificadores de texto literal não vazios. Eles não devem conter espaços em branco. Cada componente do sistema de entrada define um conjunto de propriedades que são utilizadas para configurar sua função.

Os valores de propriedade são literais de string não vazias, inteiros ou números de ponto flutuante. Eles não devem conter espaços em branco ou os caracteres reservados \ ou " .

Os nomes e valores de propriedade diferenciam maiúsculas de minúsculas.

Comentários

As linhas de comentários começam com '#' e continuam até o final da linha. Assim:

# A comment!

As linhas em branco são ignoradas.

Exemplo

# This is an example of an input device configuration file.
# It might be used to describe the characteristics of a built-in touch screen.

# This is an internal device, not an external peripheral attached to the USB
# or Bluetooth bus.
device.internal = 1

# The device should behave as a touch screen, which uses the same orientation
# as the built-in display.
touch.deviceType = touchScreen
touch.orientationAware = 1

# Additional calibration properties...
# etc...

Propriedades comuns

A propriedade a seguir é comum a todas as classes de dispositivos de entrada.

Consulte a documentação de cada classe de dispositivo de entrada para obter informações sobre as propriedades especiais usadas por cada classe.

device.internal

Definição: device.internal = 0 | 1

Especifica se o dispositivo de entrada é um componente interno embutido em oposição a um periférico conectado externamente (provavelmente removível).

  • Se o valor for 0 , o dispositivo é externo.

  • Se o valor for 1 , o dispositivo é interno.

  • Se o valor não for especificado, o valor padrão será 0 para todos os dispositivos no barramento USB (BUS_USB) ou Bluetooth (BUS_BLUETOOTH), caso contrário, 1 .

Essa propriedade determina as decisões de política padrão em relação aos eventos de ativação.

Os dispositivos de entrada internos geralmente não ativam a tela do modo de suspensão, a menos que configurados explicitamente para isso no arquivo de layout de chave ou em uma regra de política codificada. Essa distinção impede que pressionamentos de teclas e toques despertem seu telefone de forma espúria quando ele estiver no bolso. Normalmente, há apenas um pequeno punhado de teclas de ativação definidas.

Por outro lado, os dispositivos de entrada externos geralmente despertam o dispositivo de forma mais agressiva, porque se supõe que estejam desligados ou não conectados durante o transporte. Por exemplo, pressionar qualquer tecla em um teclado externo é um bom indicador de que o usuário deseja que o dispositivo acorde e responda.

É importante garantir que o valor da propriedade device.internal esteja configurado corretamente para todos os dispositivos de entrada internos.

Validação

Certifique-se de validar seus arquivos de configuração do dispositivo de entrada usando a ferramenta Validar Mapas de Teclas.