תאימות ל-ChromeOS – מפרט מקלדת גרסה 1.0

גרסה: 1.0.1
עדכון אחרון: 1 בפברואר 2024

מקרא

פועל המוצר פעולת פיתוח
'חובה' דרישה למוצר חובה
'אמור' המלצה אופציונלית
"מאי" מומלץ

סקירה כללית

מסמך המפרט הזה מתאר את הקריטריונים של מקלדת תואמת ל-ChromeOS.

המפרט הזה כולל מקלדת חיצונית שאינה חלק מהמארז הראשי של המכשיר. יכול להיות שהמקלדת מחוברת באופן אלחוטי או באמצעות כבל למכשיר ChromeOS.

אפשר למכור את המקלדת בנפרד כאביזר או בחבילה עם מכשיר ChromeOS.

מילון מונחים

  • מקשים מיוחדים: Tab, Enter, Backspace, Space, 英数, 年, か月<=>英数, Fn, Page Up, Page Down, Home, End, מחיקה, Escape, נעילה, החלפת שפה.
  • מקשי צירוף: מרכז האפליקציות, Shift, Control, Alt, Alt Grand, Fn.
  • מפתחות תווים: מפתחות שמייצגים שפה כתובה או פעולות מתמטיות, כולל אותיות, סימני פיסוק, סמלים ותווים דיאקריטיים.
  • מקשי פונקציות: מקשי Fn ממוספרים, כמו F1, F2, ....
  • מקשי ניווט: למעלה, למטה, שמאלה, ימינה.
  • Six-pack: בפריסה מורחבת, שתי השורות של שלושה מקשים ממוקמות מעל מקשי הניווט.
  • מתאם: מתאם יציאה קטן שמספק תקשורת עם אביזר בפורמט שלא נתמך במקור על ידי מכשיר ChromeOS. לרוב, מתאם מכיל מקלט RF.
  • RF: תדר רדיו. השיטה הנפוצה ביותר לתקשורת אלחוטית.
  • מקשים מודאליים: Caps Lock, Num Lock, Scroll Lock; מקשים שמשנים את התנהגות המקלדת וממשיכים להשפיע אחרי שחרורם.

סוג

  • אם המקלדת מתחברת למכשיר ChromeOS דרך חיבור קווי, היא אמורה להתחבר למכשיר ChromeOS באמצעות USB.
  • אם המקלדת משתמשת בחיבור אלחוטי, היא צריכה להתחבר למכשיר ChromeOS באמצעות Bluetooth או מתאם USB של 2.4GHz (מתאם).

אבטחה

עדכון קושחה

חשוב לוודא שאפשר לתקן את הציוד ההיקפי במקרה שיתגלו נקודות חולשה בעתיד. אחרת, לא ניתן יהיה להתחבר ל-ChromeOS לציוד היקפי עם נקודות חולשה ידועות.

  • מקלדת Bluetooth אלחוטית אמורה לתמוך ביכולת עדכון הקושחה.
  • מקלדת מתאם במהירות 2.4 GHz אמורה לתמוך באפשרות עדכון קושחה.
  • המקלדת אמורה לתמוך בעדכוני קושחה דרך fwupd.
    • הערה: כך העדכונים יהיו חלק למשתמש במהלך עדכון רגיל של ChromeOS (בדרך כלל כל 4 שבועות).

קישוריות

  • המקלדת האלחוטית אמורה לתמוך בהתחברות למכשיר ChromeOS באמצעות אחת או יותר מהאפשרויות הבאות:
    • Bluetooth
    • מתאם אלחוטי של 2.4 GHz

מתאם אלחוטי של 2.4 GHz

מקלדת שכלולה במקלט אלחוטי (מתאם) במהירות של 2.4GHz, מותאמת באופן אוטומטי עם המקלט הזה (ורק עם). נדרשת פעולה מצד המשתמש (במכשיר או באמצעות אפליקציה) כדי להתאים את המקלדת למקלט אחר או כדי להתאים מקלדת חדשה למקלט קיים. הדרישות הבאות מפרטות את הפונקציונליות הזו.

  • כשמקלדת אלחוטית של 2.4 GHz ארוזה עם מקלט, המקבל חייב לתמוך בחיבור למכשיר ChromeOS באמצעות USB-A או USB-C.
  • אם מקלדת אלחוטית של 2.4 GHz ארוזה יחד עם מקלט, יש לבצע התאמה אוטומטית של המקלדת עם המקלט הארוז בחבילה.
  • מקלדת אלחוטית של 2.4 GHz הכלולה באריזה עם מקלט חייבת לבצע התאמה אוטומטית רק עם המקלט שנכלל באריזה עם המקלדת.
  • המקלדת של 2.4 GHz עשויה לאפשר למשתמש להתאים את המקלדת למקלט אחר.
  • המקלט עשוי לאפשר למשתמש להתאים מקלדת אחרת של 2.4GHz למקלט.
  • מומלץ להשתמש באפליקציה כדי להתאים בין מכשירים ביוזמת המשתמש לבין מקלטים אחרים.
  • המקבל עשוי להסתמך על אפליקציה להתאמה ביוזמת המשתמש למקלדות אחרות.
  • אם נדרשת אפליקציה כדי לשנות את ההתאמה של המקלדת והמקלט, האפליקציה אמורה לפעול ב-ChromeOS.
  • אם משתמשים באפליקציית התאמה, אפליקציית ההתאמה אמורה להיות אפליקציה מקורית של ChromeOS.
    • הערה: תוספים ל-Chrome בדרך כלל תומכים בהגדרה של חומרה ואביזרים.
  • ניתן להשתמש ב-Progressive Web App (PWA) במכשיר באמצעות WebUSB או WebHID להתאמה אישית.
  • אם משתמשים באפליקציית התאמה, יכול להיות שאפליקציית ההתאמה תהיה אפליקציית אינטרנט שמשתמשת ב-WebUSB או ב-WebHID.
  • אם ההתאמה מוטמעת באמצעות תוסף, לתוסף צריכה להיות רק גישה ליציאות USB.
    • הערה: השימוש בסקריפטים של תוכן אסור באופן מפורש.

Bluetooth

  • אם מקלדת אלחוטית תומכת ב-Bluetooth, המקלדת האלחוטית חייבת לעמוד בדרישות שמפורטות במאמר דרישות Bluetooth שתואמות ל-ChromeOS. באופן ספציפי, את הקטעים הבאים:
    • דרישות Bluetooth כלליות
    • דרישות לגבי מכשיר לקליטת נתונים בחיבור Bluetooth

מחברים

מקלדות חוטיות

התנהגות מפתח

גלילת עכבר N-key

  • אם אתם צפויים להתאים את המקלדת למכשירים ידידותיים לגיימינג, היא אמורה לתמוך בגלילת עכבר על מקש N-KRO.
    • הערה: מקלדת שתומכת ב-NKRO יכולה לדווח על כל מספר של מקשים בלחיצה בו-זמנית.
  • אם המקלדת לא תומכת ב-NKRO, היא אמורה לתמוך בגלילת עכבר של שישה מקשים (6KRO) ומעלה.
    • הערה: מקלדת שתומכת ב-6KRO יכולה לדווח על עד 6 מקשים בלחיצה בו-זמנית.
  • אם המקלדת תומכת בפחות מ-6KRO, היא צריכה לכלול הגנה מפני צללים או מנגנונים אמינים אחרים שמונעים רישום של לחיצות שגויות על מקשים.

קודי HID

  • המקלדת חייבת לשלוח מתאר של דוח HID כשמתבצעת שאילתה, בהתאם לדרישות של הגדרת סיווג מכשיר עבור HID v1.11.
  • כל המפתחות חייבים לשלוח קודי HID של פעולה משמעותיים, שממופים לקוד KEY_ או BTN_ על ידי הליבה של Linux.
    • הערה: חלק מהמקלדות החיצוניות של מכשירי ChromeOS שולחות את המקשים F1, F2 וכו' שאינן תואמות לגליף שבמקש – הן לא תואמות.

מקשי פונקציות

  • למקשים עשויים להיות התנהגות משנית בתור מקשי פונקציות.
  • אם במקלדות יש מקשים עם התנהגות משנית כמקשי פונקציות, למקלדת חייב להיות מקש Fn.
  • אם מקש עם התנהגות משנית כמקש פונקציות מתואם עם מקש Fn, המקלדת חייבת לשלוח קוד HID של מקש פונקציות.
  • ייתכן שהמקלדת תשתמש במקשי פונקציות ייעודיים.

הנחיות ליצירת גרפיקה עבור Glyph

מקשי פונקציות

  • הגליפים של פעולות ראשוניות אמורים להופיע באופן בולט יותר (גדולים יותר, בהירים יותר או כבדים יותר) מאשר גליפים בפונקציה משנית.

מקשי הניווט הם למעלה, למטה, שמאלה וימינה.

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

סוללה וחשמל

  • אם המקלדת מכילה סוללה, קושחת המקלדת אמורה לדווח על רמת הסוללה באמצעות ממשק אנושי (HID).
  • אם המקלדת מכילה סוללות, היא עשויה לכלול אחד או יותר מהמקשים הקשורים להפעלה, מחוון הפעלה ומתג הפעלה.
  • אם המקלדת מכילה סוללה נטענת, היא אמורה לתמוך בטעינה באמצעות USB.
  • אם המכשיר מגיע עם מטען USB-C, יכול להיות שלמטען יש אישור USB-IF להספק כוח.

תוכנות

מזהי מוצרים וספקים

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

ליבה

  • אם נעשה שימוש במנהל התקן ליבה בהתאמה אישית, יש לבדוק אותו ב-upstream Linux
  • אם נעשה שימוש במנהל התקן ליבה מותאם אישית, יש להחזיר אותו לליבות של מערכת ההפעלה Chromium מגרסה 4.14 ואילך.
  • כשמכבים או מנתקים מקלדת, הליבה חייבת להסיר אותה מאוסף מכשירי הקלט.

היסטוריית גרסאות

תאריך גרסה הערות
2024-02-01 1.0.1 רפובליקה בפלטפורמה חדשה
2023-05-18 1.0 פרסום ראשוני של אתר שותף