Файлы макета ключей

Файлы макета клавиш (файлы .kl ) сопоставляют коды клавиш и коды осей Linux с кодами клавиш и кодами осей Android и указывают соответствующие флаги политики. Файлы раскладки клавиш для конкретного устройства:

  • Требуется для внутренних (встроенных) устройств ввода с клавишами, включая специальные клавиши, такие как громкость, питание и мультимедийные клавиши гарнитуры.
  • Необязательно для других устройств ввода, но рекомендуется для специальных клавиатур и джойстиков.

Если файл раскладки клавиш для конкретного устройства недоступен, система вместо этого выбирает значение по умолчанию.

Расположение

Файлы раскладки клавиш расположены по производителю USB, идентификатору продукта (и, возможно, версии) или по имени устройства ввода. Следующие пути консультируются по порядку:

  • /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

При построении пути к файлу, который содержит имя устройства, все символы в имени устройства, кроме «0»-«9», «a»-«z», «A»-«Z», «-» или «_», заменены на «_».

Общий файл макета ключа

Система предоставляет специальный встроенный общий файл макета ключей под названием Generic.kl . Эта раскладка клавиш предназначена для поддержки множества стандартных внешних клавиатур и джойстиков. Не изменяйте общую раскладку клавиш!

Синтаксис

Файл макета клавиш — это обычный текстовый файл, состоящий из объявлений клавиш или осей и флагов.

Ключевые объявления

Объявления ключей состоят из ключевого слова key , за которым следует кодовый номер ключа Linux и кодовое имя ключа Android, или использование ключевого слова, за которым следует использование HID и кодовое имя ключа Android. Использование HID представлено в виде 32-битного целого числа, где старшие 16 бит представляют страницу использования HID, а младшие 16 бит представляют идентификатор использования HID. За любым объявлением может следовать необязательный набор флагов политики, разделенных пробелами.

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

Распознаются следующие флаги политики:

  • FUNCTION : Клавиша должна интерпретироваться так, как если бы также была нажата клавиша ФУНКЦИЯ.
  • GESTURE : клавиша, сгенерированная жестом пользователя, например касанием сенсорного экрана ладонью.
  • VIRTUAL : Клавиша представляет собой виртуальную программную клавишу (емкостную кнопку), расположенную рядом с основным сенсорным экраном. Это приводит к включению специальной логики устранения дребезга (см. ниже).

Объявления осей

Каждое объявление оси состоит из ключевого слова axis , за которым следует кодовый номер оси Linux и квалификаторы, управляющие поведением оси, включая как минимум одно кодовое имя оси Android.

Основные оси

Базовая ось просто сопоставляет код оси Linux с кодовым названием оси Android. Следующее объявление сопоставляет ABS_X (обозначается 0x00 ) с AXIS_X (обозначается X ).

axis 0x00 X

В приведенном выше примере, если значение ABS_X равно 5 , то AXIS_X устанавливается равным 5 .

Разделить оси

Разделенная ось сопоставляет код оси Linux с двумя именами кода оси Android, так что значения, меньшие или превышающие пороговое значение, при сопоставлении разделяются по двум разным осям. Это сопоставление полезно, когда одна физическая ось, сообщаемая устройством, кодирует две разные взаимоисключающие логические оси.

Следующее объявление отображает значения оси ABS_Y (обозначенной как 0x01 ) в AXIS_GAS если меньше 0x7f или в AXIS_BRAKE , если больше 0x7f .

axis 0x01 split 0x7f GAS BRAKE

В приведенном выше примере, если значение ABS_Y равно 0x7d , тогда AXIS_GAS устанавливается на 2 ( 0x7f - 0x7d ), а AXIS_BRAKE устанавливается на 0 . И наоборот, если значение ABS_Y равно 0x83 , тогда AXIS_GAS устанавливается на 0 , а AXIS_BRAKE устанавливается на 4 ( 0x83 - 0x7f ). Наконец, если значение ABS_Y равно значению разделения 0x7f то и AXIS_GAS , и AXIS_BRAKE устанавливаются в 0 .

Перевернутые оси

Перевернутая ось инвертирует знак значения оси. Следующее объявление сопоставляет ABS_RZ (обозначается 0x05 ) с AXIS_BRAKE (обозначается BRAKE ) и инвертирует вывод, отрицая его.

axis 0x05 invert BRAKE

В приведенном выше примере, если значение ABS_RZ равно 2 , то AXIS_BRAKE устанавливается равным -2 .

Вариант с центральной квартирой

Устройство с джойстиком может сообщать о событиях ввода, даже если джойстик не используется из-за шума. Этот шум обычно исходит от левого и / или правого джойстиков и заставляет водителя сообщать значение положения, близкое к 0. Значение «центральное плоское» указывает количество шума, ожидаемого от контроллера в состоянии покоя.

Протокол ввода Linux позволяет драйверам устройств ввода указывать центральное плоское значение осей джойстика, но не все драйверы сообщают об этом, а некоторые из них предоставляют неверные значения. Чтобы решить эту проблему, за объявлением оси может следовать flat параметр, указывающий ширину области вокруг центрального положения оси, которую следует рассматривать как центрированную.

Например, если драйвер устройства сообщает значения для AXIS_X от 0 до 100, то 0 будет сопоставлено с -1, а 100 будет сопоставлено с 1 системой ввода Android. Центр диапазона будет равен 50 в немасштабированных координатах и ​​0 в масштабированных координатах. Если плоское значение равно 10, то разработчики должны предположить, что любое значение AXIS_X от -0,1 до 0,1 (между 40 и 60 в немасштабированных координатах) является шумом, и рассматривать эти значения, поступающие от джойстика, как нулевые.

Примечание . В то время как файл макета клавиш указывает значение для координатного пространства драйвера, значение, сообщаемое android.view.InputDevice.MotionRange#getFlat(), находится в координатном пространстве Android.

axis 0x03 Z flat 4096

В приведенном выше примере центральное плоское значение установлено на 4096 .

Комментарии

Строки комментариев начинаются с # и продолжаются до конца строки:

# A comment!

Пустые строки игнорируются.

Примеры

Клавиатура

# 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...

Системные элементы управления

# 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

Емкостные кнопки

# 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

Элементы управления мультимедиа разъема для гарнитуры

# 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

Джойстик

# 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

Виртуальные программные клавиши

Система ввода предоставляет специальные функции для реализации виртуальных программных клавиш в следующих случаях использования:

  1. Если виртуальные программные клавиши графически отображаются на экране (например, на Galaxy Nexus), они реализуются компонентом «Панель навигации» в пакете системного пользовательского интерфейса. Поскольку графические виртуальные программные клавиши реализованы на верхнем уровне системы, файлы раскладки клавиш не используются, и следующая информация не применяется.
  2. Если виртуальные программные клавиши реализованы в виде расширенной сенсорной области, которая является частью основного сенсорного экрана (например, на Nexus One), система ввода использует файл сопоставления виртуальных клавиш для преобразования сенсорных координат X/Y в коды клавиш Linux. затем использует файл раскладки клавиш для преобразования кодов клавиш Linux в коды клавиш Android (подробности о файлах сопоставления виртуальных клавиш см. в разделе Touch Devices ). Файл раскладки клавиш для устройства ввода с сенсорным экраном должен указывать соответствующее сопоставление клавиш и включать флаг VIRTUAL для каждой клавиши.
  3. Если виртуальные программные клавиши реализованы как емкостные кнопки, отдельные от основного сенсорного экрана (например, на Nexus S), драйвер устройства или прошивка ядра отвечает за преобразование касаний в коды клавиш Linux, которые система ввода затем переводит в коды клавиш Android. с помощью файла раскладки ключей. Файл раскладки клавиш для устройства ввода с емкостной кнопкой должен указывать соответствующее сопоставление клавиш и включать флаг VIRTUAL для каждой клавиши.

Когда виртуальные программные клавиши расположены внутри или в непосредственной физической близости от сенсорного экрана, пользователям легко случайно нажать кнопку при прикосновении к нижней части экрана или при перемещении пальца сверху вниз или снизу вверх. сверху на экране. Чтобы предотвратить это, система ввода применяет небольшое устранение дребезга, так что нажатия виртуальных программных клавиш игнорируются в течение короткого периода времени после последнего касания сенсорного экрана (эта задержка называется временем молчания виртуальной клавиши ).

Чтобы включить устранение дребезга виртуальных программных клавиш:

  1. Предоставьте файл раскладки клавиш для сенсорного экрана или устройства ввода с емкостной кнопкой с установленным флагом VIRTUAL для каждой клавиши.
    key 139    MENU           VIRTUAL
key 172    HOME           VIRTUAL
key 158    BACK           VIRTUAL
key 217    SEARCH         VIRTUAL
  2. Установите значение времени ожидания виртуального ключа в наложении ресурсов для ресурса framework config.xml .
    <!-- 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>

Проверка

Вы должны проверить свои файлы раскладки ключей с помощью инструмента Validate Keymaps .