קבצי פריסת מפתח

קובצי פריסת מפתח (קבצי .kl ) ממפים קודי מפתחות וקודי ציר של לינוקס לקודי מפתחות וקודי ציר של 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 מורכבות ממפתח מילת המפתח ואחריו מספר קוד מפתח לינוקס ושם קוד מפתח אנדרואיד, או שימוש במילת מפתח ואחריו שימוש ב-HID ושם קוד מפתח אנדרואיד. השימוש ב-HID מיוצג כמספר שלם של 32 סיביות, כאשר 16 הסיביות הגבוהות מייצגות את דף השימוש ב-HID ו-16 הסיביות הנמוכות מייצגות את מזהה השימוש ב-HID. כל אחת מההצהרות יכולה להיות מלווה בקבוצה אופציונלית של דגלי מדיניות מופרדים ברווחים לבנים.

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

דגלי המדיניות הבאים מוכרים:

  • FUNCTION : יש לפרש את המקש כאילו גם מקש FUNCTION נלחץ.
  • GESTURE : המפתח שנוצר על ידי מחוות משתמש, כגון משיכה במסך המגע.
  • VIRTUAL : המפתח הוא מקש רך וירטואלי (כפתור קיבולי) צמוד למסך המגע הראשי. זה גורם להפעלת היגיון מיוחד של ביטול יציאה (ראה להלן).

הצהרות ציר

הצהרות ציר מורכבות כל אחת axis מילת המפתח ואחריו מספר קוד של ציר לינוקס ומסמכים השולטים בהתנהגות הציר, כולל שם קוד אחד של ציר אנדרואיד לפחות.

צירים בסיסיים

ציר בסיסי פשוט ממפה קוד ציר לינוקס לשם קוד ציר אנדרואיד. ההכרזה הבאה ממפה ABS_X (מסומן ב 0x00 ) ל- AXIS_X (מסומן ב- X ).

axis 0x00 X

בדוגמה שלמעלה, אם הערך של ABS_X הוא 5 אז AXIS_X מוגדר ל 5 .

צירים מפוצלים

ציר מפוצל ממפה קוד ציר לינוקס לשני שמות קוד של ציר אנדרואיד, כך שערכים הנמוכים או גדולים מסף מפוצלים על פני שני צירים שונים בעת מיפוי. מיפוי זה שימושי כאשר ציר פיזי בודד המדווח על ידי המכשיר מקודד שני צירים לוגיים שונים זה מזה.

ההצהרה הבאה ממפה ערכים של ציר 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. הערך "מרכז שטוח" מציין את כמות הרעש הצפויה מהבקר במנוחה.

פרוטוקול הקלט של לינוקס מספק דרך למנהלי התקני קלט לציין את הערך השטוח המרכזי של צירי הג'ויסטיק, אך לא כל מנהלי ההתקנים מדווחים על כך וחלקם מספקים ערכים שגויים. כדי לפתור בעיה זו, הצהרת ציר עשויה להיות מלווה באופציה 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 לקודי מקשי לינוקס, לאחר מכן משתמש בקובץ פריסת המפתחות כדי לתרגם קודי מפתחות של לינוקס לקודי מפתחות של אנדרואיד (לפרטים על קובצי מפת מפתח וירטואליים, ראה התקני מגע ). קובץ פריסת המפתח עבור התקן הקלט של מסך המגע חייב לציין את מיפוי המקשים המתאים ולכלול את הדגל VIRTUAL עבור כל מקש.
  3. אם המקשים הרכים הוירטואליים מיושמים כלחצנים קיבוליים נפרדים ממסך המגע הראשי (כגון ב-Nexus S), מנהל ההתקן או הקושחה של הליבה אחראים על תרגום הנגיעות לקודי מפתחות של לינוקס, שאותם מערכת הקלט מתרגמת לקודי מפתחות אנדרואיד. באמצעות קובץ פריסת המפתח. קובץ פריסת המפתח עבור התקן קלט לחצן קיבולי חייב לציין את מיפוי המפתח המתאים ולכלול את הדגל 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 .