Archivos de diseño de teclas

Los archivos de diseño de claves (archivos .kl ) asignan códigos de clave y códigos de eje de Linux a códigos de clave y códigos de eje de Android y especifican indicadores de políticas asociados. Los archivos de diseño de teclas específicos del dispositivo son:

  • Requerido para dispositivos de entrada internos (integrados) con teclas, incluidas teclas especiales como volumen, encendido y teclas multimedia de auriculares.
  • Opcional para otros dispositivos de entrada, pero recomendado para teclados y joysticks de uso especial.

Si no hay disponible ningún archivo de diseño de teclas específico del dispositivo, el sistema elige un valor predeterminado.

Ubicación

Los archivos de diseño de claves se ubican por proveedor de USB, ID de producto (y opcionalmente versión) o por nombre de dispositivo de entrada. Se consultan en orden las siguientes rutas:

  • /odm/usr/keylayout/Vendor_XXXX_Product_XXXX_Version_XXXX.kl
  • /vendor/usr/keylayout/Vendor_XXXX_Product_XXXX_Version_XXXX.kl
  • /system/usr/keylayout/Vendor_XXXX_Product_XXXX_Version_XXXX.kl
  • /data/system/devices/keylayout/Vendor_XXXX_Product_XXXX_Version_XXXX.kl
  • /odm/usr/keylayout/Vendor_XXXX_Product_XXXX.kl
  • /vendor/usr/keylayout/Vendor_XXXX_Product_XXXX.kl
  • /system/usr/keylayout/Vendor_XXXX_Product_XXXX.kl
  • /data/system/devices/keylayout/Vendor_XXXX_Product_XXXX.kl
  • /odm/usr/keylayout/DEVICE_NAME.kl
  • /vendor/usr/keylayout/DEVICE_NAME.kl
  • /system/usr/keylayout/DEVICE_NAME.kl
  • /data/system/devices/keylayout/DEVICE_NAME.kl
  • /odm/usr/keylayout/Generic.kl
  • /vendor/usr/keylayout/Generic.kl
  • /system/usr/keylayout/Generic.kl
  • /data/system/devices/keylayout/Generic.kl

Al construir una ruta de archivo que contiene el nombre del dispositivo, todos los caracteres del nombre del dispositivo que no sean '0'-'9', 'a'-'z', 'A'-'Z', '-' o '_' se reemplazan por '_'.

Archivo de diseño de clave genérico

El sistema proporciona un archivo de diseño de teclas genérico integrado especial llamado Generic.kl . Esta distribución de teclas está diseñada para admitir una variedad de teclados y joysticks externos estándar. ¡No modifique la distribución de teclas genérica!

Sintaxis

Un archivo de diseño de claves es un archivo de texto sin formato que consta de indicadores y declaraciones de claves o ejes.

Declaraciones clave

Las declaraciones de clave constan de la key clave seguida de un número de código de clave de Linux y un nombre de código de clave de Android, o el uso de la palabra clave seguido de un uso de HID y un nombre de código de clave de Android. El uso de HID se representa como un entero de 32 bits, donde los 16 bits superiores representan la página de uso de HID y los 16 bits bajos representan el ID de uso de HID. Cualquiera de las declaraciones puede ir seguida de un conjunto opcional de indicadores de política delimitados por espacios en blanco.

key 1     ESCAPE
key 114   VOLUME_DOWN
key 16    Q                 VIRTUAL
key usage 0x0c006F          BRIGHTNESS_UP

Se reconocen las siguientes banderas de política:

  • FUNCTION : La tecla debe interpretarse como si también se hubiera pulsado la tecla FUNCIÓN.
  • GESTURE : La clave generada por un gesto del usuario, como tocar la pantalla táctil.
  • VIRTUAL : La tecla es una tecla programable virtual (botón capacitivo) adyacente a la pantalla táctil principal. Esto hace que se habilite una lógica antirrebote especial (ver más abajo).

Declaraciones del eje

Cada una de las declaraciones de eje consta de la palabra clave axis seguida de un número de código de eje de Linux y calificadores que controlan el comportamiento del eje, incluido al menos un nombre de código de eje de Android.

Ejes basicos

Un eje básico simplemente asigna un código de eje de Linux a un nombre de código de eje de Android. La siguiente declaración asigna ABS_X (indicado por 0x00 ) a AXIS_X (indicado por X ).

axis 0x00 X

En el ejemplo anterior, si el valor de ABS_X es 5 , entonces AXIS_X se establece en 5 .

Ejes divididos

Un eje dividido asigna un código de eje de Linux a dos nombres de código de eje de Android, de modo que los valores menores o mayores que un umbral se dividen en dos ejes diferentes cuando se asignan. Este mapeo es útil cuando un único eje físico informado por el dispositivo codifica dos ejes lógicos diferentes mutuamente excluyentes.

La siguiente declaración asigna valores del eje ABS_Y (indicado por 0x01 ) a AXIS_GAS cuando es menor que 0x7f o a AXIS_BRAKE cuando es mayor que 0x7f .

axis 0x01 split 0x7f GAS BRAKE

En el ejemplo anterior, si el valor de ABS_Y es 0x7d , entonces AXIS_GAS se establece en 2 ( 0x7f - 0x7d ) y AXIS_BRAKE se establece en 0 . Por el contrario, si el valor de ABS_Y es 0x83 , entonces AXIS_GAS se establece en 0 y AXIS_BRAKE se establece en 4 ( 0x83 - 0x7f ). Finalmente, si el valor de ABS_Y es igual al valor dividido de 0x7f , entonces tanto AXIS_GAS como AXIS_BRAKE se establecen en 0 .

ejes invertidos

Un eje invertido invierte el signo del valor del eje. La siguiente declaración asigna ABS_RZ (indicado por 0x05 ) a AXIS_BRAKE (indicado por BRAKE ) e invierte la salida negándola.

axis 0x05 invert BRAKE

En el ejemplo anterior, si el valor de ABS_RZ es 2 , entonces AXIS_BRAKE se establece en -2 .

Opción piso central

Un dispositivo de joystick puede informar eventos de entrada incluso cuando el joystick no se está utilizando, debido al ruido. Este ruido generalmente proviene de los joysticks izquierdo y/o derecho y hace que el conductor informe un valor de posición cercano a 0. El valor "centro plano" especifica la cantidad de ruido que se espera del controlador en reposo.

El protocolo de entrada de Linux proporciona una manera para que los controladores de dispositivos de entrada especifiquen el valor plano central de los ejes del joystick, pero no todos los controladores lo informan y algunos de ellos proporcionan valores incorrectos. Para resolver este problema, una declaración de eje puede ir seguida de una opción flat que especifica el ancho de la región alrededor de la posición central del eje que debe considerarse centrada.

Por ejemplo, si un controlador de dispositivo informa valores para AXIS_X entre 0 y 100, el sistema de entrada de Android asignará 0 a -1 y 100 a 1. El centro del rango será 50 en las coordenadas sin escala y 0 en las coordenadas escaladas. Si un valor plano es igual a 10, entonces los desarrolladores deben asumir que cualquier valor AXIS_X informado entre -0,1 y 0,1 (entre 40 y 60 en coordenadas sin escala) es ruido y tratar esos valores provenientes del joystick como cero.

Nota : si bien el archivo de diseño de claves especifica el valor para el espacio de coordenadas del controlador, el valor informado por android.view.InputDevice.MotionRange#getFlat() está en el espacio de coordenadas de Android.

axis 0x03 Z flat 4096

En el ejemplo anterior, el valor plano central se establece en 4096 .

Comentarios

Las líneas de comentarios comienzan con # y continúan hasta el final de la línea:

# A comment!

Se ignoran las líneas en blanco.

Ejemplos

Teclado

# This is an example of a key layout file for a keyboard.

key 1     ESCAPE
key 2     1
key 3     2
key 4     3
key 5     4
key 6     5
key 7     6
key 8     7
key 9     8
key 10    9
key 11    0
key 12    MINUS
key 13    EQUALS
key 14    DEL

# etc...

Controles del sistema

# This is an example of a key layout file for basic system controls,
# such as volume and power keys which are typically implemented as GPIO pins
# the device decodes into key presses.

key 114   VOLUME_DOWN
key 115   VOLUME_UP
key 116   POWER

Botones capacitivos

# This is an example of a key layout file for a touch device with capacitive buttons.

key 139    MENU           VIRTUAL
key 172    HOME           VIRTUAL
key 158    BACK           VIRTUAL
key 217    SEARCH         VIRTUAL

Controles multimedia del conector para auriculares

# This is an example of a key layout file for headset mounted media controls.
# A typical headset jack interface might have special control wires or detect known
# resistive loads as corresponding to media functions or volume controls.
# This file assumes that the driver decodes these signals and reports media
# controls as key presses.

key 163   MEDIA_NEXT
key 165   MEDIA_PREVIOUS
key 226   HEADSETHOOK

Palanca de mando

# This is an example of a key layout file for a joystick.

# These are the buttons that the joystick supports, represented as keys.
key 304   BUTTON_A
key 305   BUTTON_B
key 307   BUTTON_X
key 308   BUTTON_Y
key 310   BUTTON_L1
key 311   BUTTON_R1
key 314   BUTTON_SELECT
key 315   BUTTON_START
key 316   BUTTON_MODE
key 317   BUTTON_THUMBL
key 318   BUTTON_THUMBR

# Left and right stick.
# The reported value for flat is 128 in a range of -32767 to 32768, which is absurd.
# This confuses applications that rely on the flat value because the joystick
# actually settles in a flat range of +/- 4096 or so. We override it here.
axis 0x00 X flat 4096
axis 0x01 Y flat 4096
axis 0x03 Z flat 4096
axis 0x04 RZ flat 4096

# Triggers.
axis 0x02 LTRIGGER
axis 0x05 RTRIGGER

# Hat.
axis 0x10 HAT_X
axis 0x11 HAT_Y

Teclas programables virtuales

El sistema de entrada proporciona características especiales para implementar teclas programables virtuales en los siguientes casos de uso:

  1. Si las teclas programables virtuales se muestran gráficamente en la pantalla (como en el Galaxy Nexus), se implementan mediante el componente de la barra de navegación en el paquete de interfaz de usuario del sistema. Debido a que las teclas programables virtuales gráficas se implementan en una capa superior del sistema, los archivos de diseño de teclas no están involucrados y la siguiente información no se aplica.
  2. Si las teclas programables virtuales se implementan como una región táctil extendida que forma parte de la pantalla táctil principal (como en el Nexus One), el sistema de entrada utiliza un archivo de mapa de teclas virtuales para traducir las coordenadas táctiles X/Y en códigos de teclas de Linux. luego usa el archivo de diseño de claves para traducir códigos de claves de Linux a códigos de claves de Android (para obtener detalles sobre los archivos de mapas de claves virtuales, consulte Dispositivos táctiles ). El archivo de diseño de teclas para el dispositivo de entrada de pantalla táctil debe especificar la asignación de teclas adecuada e incluir el indicador VIRTUAL para cada tecla.
  3. Si las teclas programables virtuales se implementan como botones capacitivos separados de la pantalla táctil principal (como en el Nexus S), el controlador o firmware del dispositivo kernel es responsable de traducir los toques en códigos de teclas de Linux que el sistema de entrada luego traduce a códigos de teclas de Android. utilizando el archivo de diseño de claves. El archivo de diseño de teclas para el dispositivo de entrada de botón capacitivo debe especificar la asignación de teclas adecuada e incluir el indicador VIRTUAL para cada tecla.

Cuando las teclas programables virtuales están ubicadas dentro o muy cerca de la pantalla táctil, es fácil para los usuarios presionar accidentalmente un botón cuando tocan cerca de la parte inferior de la pantalla o cuando deslizan un dedo de arriba hacia abajo o de abajo hacia abajo. arriba en la pantalla. Para evitar esto, el sistema de entrada aplica un poco de rebote, de modo que las pulsaciones de teclas programables virtuales se ignoran durante un breve período de tiempo después del toque más reciente en la pantalla táctil (este retraso se denomina tiempo de silencio de la tecla virtual ).

Para habilitar la eliminación de rebotes de teclas programables virtuales:

  1. Proporcione un archivo de diseño de teclas para la pantalla táctil o el dispositivo de entrada de botones capacitivos con el indicador VIRTUAL configurado para cada tecla.
    key 139    MENU           VIRTUAL
    key 172    HOME           VIRTUAL
    key 158    BACK           VIRTUAL
    key 217    SEARCH         VIRTUAL
    
  2. Establezca el valor del tiempo de silencio de la clave virtual en una superposición de recursos para el recurso config.xml del marco.
    <!-- Specifies the amount of time to disable virtual keys after the screen
    is touched to filter out accidental virtual key presses due to swiping gestures
    or taps near the edge of the display. May be 0 to disable the feature.
    It is recommended that this value be no more than 250 ms.
    This feature should be disabled for most devices. -->
    
    <integer name="config_virtualKeyQuietTimeMillis">250</integer>
    

Validación

Debe validar sus archivos de diseño de teclas utilizando la herramienta Validar mapas de teclas .