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

Файлы раскладки клавиш (файлы .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 (подробную информацию о файлах сопоставления виртуальных клавиш см. в разделе Сенсорные устройства ). Файл раскладки клавиш для устройства ввода с сенсорным экраном должен указывать соответствующее сопоставление клавиш и включать флаг 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. Установите значение времени молчания виртуального ключа в наложении ресурса для ресурса 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>

Валидация

Вам следует проверить файлы раскладки клавиш с помощью инструмента «Проверка раскладок клавиш» .