Zgodność z ChromeOS – specyfikacja klawiatury w wersji 1.0

Wersja: 1.0.1
Ostatnia aktualizacja: 01.02.2024

Legenda

Czasownik produktu Działanie programistyczne
„MUSI” Obowiązkowe wymagania dotyczące produktu
„POWINNY” Opcjonalna rekomendacja
„MAJ” Przydatne

Przegląd

Ten dokument specyfikacji opisuje kryteria, jakie spełnia klawiatura zgodna z ChromeOS.

Ta specyfikacja dotyczy klawiatury zewnętrznej, która nie jest częścią głównej obudowy urządzenia. Klawiaturę można podłączyć bezprzewodowo lub przewodowo do urządzenia z ChromeOS.

Klawiaturę można kupić osobno jako akcesorium lub w pakiecie z urządzeniem z ChromeOS.

Glosariusz

  • Klawisze specjalne: Tab, Enter, Backspace, Spacja, 英数, すん, みん<=>英数, Fn, Page Up, Page Down, Home, End, Delete, Escape, Lock, Przełącznik języka.
  • Klawisze modyfikujące: Menu z aplikacjami, Shift, Control, Alt, Alt Gr, Fn.
  • Klawisze znaków: klucze reprezentujące język pisany lub działania matematyczne, w tym litery, znaki interpunkcyjne, symbole i znaki diakrytyczne.
  • Klawisze funkcyjne: numerowane klawisze Fn, np. F1, F2, ...
  • Klawisze nawigacyjne: w górę, w dół, w lewo, w prawo.
  • 6 pakietów: w rozszerzonym układzie dwa rzędy 3 klawiszy umieszczone nad klawiszami nawigacyjnymi.
  • Klucz sprzętowy: mały przejściówka, która zapewnia komunikację z akcesoriami w formacie nieobsługiwanym natywnie przez urządzenie z ChromeOS. Wtyczka często zawiera odbiornik częstotliwości radiowej.
  • RF: fala radiowa. Najpopularniejsza forma komunikacji bezprzewodowej.
  • Klawisze modyfikujące: Caps Lock, Num Lock, Scroll Lock; klawisze, które zmieniają działanie klawiatury i nadal działają po zwolnieniu.

Typ

  • Jeśli klawiatura łączy się z urządzeniem z ChromeOS przez połączenie przewodowe, POWINNO ją połączyć z urządzeniem z ChromeOS przez USB.
  • Jeśli klawiatura łączy się bezprzewodowo, POWINIEN połączyć się z urządzeniem z ChromeOS przez Bluetooth lub przejściówkę USB 2,4 GHz (klucza).

Bezpieczeństwo

Aktualizator oprogramowania układowego

Ważne jest, aby zapewnić możliwość instalacji poprawek urządzeń peryferyjnych na wypadek wykrycia luk w zabezpieczeniach w przyszłości. W przeciwnym razie łączenie się z ChromeOS urządzeń peryferyjnych ze znanymi lukami w zabezpieczeniach nie będzie możliwe.

  • Bezprzewodowa klawiatura Bluetooth POWINIEN obsługiwać aktualizacje oprogramowania.
  • Klawiatura z wtyczką 2,4 GHz POWINIEN obsługiwać aktualizacje oprogramowania.
  • Klawiatura POWINNA obsługiwać aktualizacje oprogramowania przez Fwupd.
    • Uwaga: dzięki temu użytkownicy będą mogli bezproblemowo korzystać z aktualizacji podczas standardowej aktualizacji ChromeOS (zwykle co 4 tygodnie).

Połączenia

  • Klawiatura bezprzewodowa POWINNO obsługiwać połączenia z urządzeniem z ChromeOS przy użyciu:
    • Bluetooth
    • Bezprzewodowa wtyczka 2,4 GHz

Bezprzewodowa wtyczka 2,4 GHz

Klawiatura z bezprzewodowym odbiornikiem 2,4 GHz automatycznie się z nim paruje (i tylko z nim). W celu sparowania klawiatury z innym odbiornikiem lub sparowania nowej klawiatury z istniejącym odbiornikiem wymagane jest działanie użytkownika (na urządzeniu lub w aplikacji). Poniższe wymagania zawierają szczegółowe informacje na temat tej funkcji.

  • Jeśli klawiatura bezprzewodowa 2,4 GHz jest w pakiecie z odbiornikiem, odbiornik MUSI obsługiwać połączenie z urządzeniem z ChromeOS przez USB-A lub USB-C.
  • Jeśli klawiatura bezprzewodowa 2,4 GHz w pakiecie z odbiornikiem, MUSI zostać automatycznie sparowana z odbiornikiem dołączonym do klawiatury.
  • Bezprzewodowa klawiatura 2,4 GHz w pakiecie z odbiornikiem MUSI zostać automatycznie sparowana tylko z urządzeniem dostarczanym razem z klawiaturą.
  • Klawiatura 2,4 GHz MOŻE umożliwić użytkownikowi sparowanie klawiatury z innym odbiornikiem.
  • Odbiornik MOŻE umożliwić użytkownikowi sparowanie z nim innej klawiatury 2,4 GHz.
  • Klawiatura MOŻE zainicjować inicjowane przez użytkownika parowanie z innymi odbiornikami przez aplikację.
  • Odbiornik MOŻE zainicjować inicjowane przez użytkownika parowanie z innymi klawiaturami za pomocą aplikacji.
  • Jeśli aplikacja wymaga zmiany parowania klawiatury i odbiornika, POWINIEN uruchomić ją w ChromeOS.
  • Jeśli używasz aplikacji do parowania, POWINIEN być to aplikacja natywna na ChromeOS.
    • Uwaga: rozszerzenia do Chrome są często używane do obsługi konfiguracji sprzętu i akcesoriów.
  • Do dostosowywania urządzenie MOŻE korzystać z progresywnej aplikacji internetowej (PWA) korzystającej z WebUSB lub WebHID.
  • Jeśli używana jest aplikacja do parowania, MOŻE to być aplikacja internetowa korzystająca z WebUSB lub WebHID.
  • Jeśli parowanie jest zaimplementowane za pomocą rozszerzenia, MUSI ono TYLKO mieć dostęp do portów USB.
    • Uwaga: skrypty treści są jawnie niedozwolone.

Bluetooth

Oprogramowanie sprzęgające

Klawiatury przewodowe

  • Klawiatura przewodowa POWINNA obsługiwać jeden z tych portów USB:
    • Gniazdo USB-C na klawiaturze
    • Kabel przechwytujący z wtyczką USB-A
    • Kabel przechwytujący z wtyczką USB-C
  • Jeśli klawiatura przewodowa obsługuje gniazdo USB-C na urządzeniu, gniazdo USB-C MUSI być zgodne z sekcją 4.5.1.3.2 Model funkcjonalny kanału konfiguracji ujścia.
  • Jeśli klawiatura przewodowa obsługuje gniazdo USB-C na urządzeniu, gniazdo USB-C MUSI być zgodne z Rys. 4–9 Model funkcjonalny ujścia CC1 i CC2.
  • Jeśli klawiatura przewodowa obsługuje kabel przechwytujący z wtyczką USB-A, pakiet produktów POWINIEN zawierać zgodny ze standardem USB typu C przejściówkę z portem USB typu C na przejściówkę USB typu A ze złącza USB 3.1 (specyfikację USB typu C, artykuł 3.6.1).
  • Jeśli klawiatura przewodowa obsługuje kabel przechwytujący z wtyczką USB-C, wtyczka USB-C MUSI być zgodna z sekcją 4.5.2 specyfikacji dotyczących funkcji i działania w specyfikacji USB typu C.
    • Uwaga: w szczególności zasady dotyczące urządzeń i urządzeń podłączanych bezpośrednio kablem przechwytującym (urządzenia te mają zastosowanie i wykrywają poziomy napięcia CC tylko na styku A5).
  • Jeśli klawiatura przewodowa obsługuje kabel przechwytujący z wtyczką USB-C, MUSI pominąć pasywną przejściówkę USB typu C na przejściówkę USB-A.
    • Uzasadnienie: przejściówki z portu USB typu C na USB-A są zabronione zgodnie z sekcją 2.2 specyfikacji USB typu C.
  • Jeśli pakiet produktów zawiera kabel USB, POWINIEN być on certyfikowany.

Kluczowe działanie

Przeniesienie za pomocą klawisza N

  • Jeśli klawiatura ma być sparowana z urządzeniami do gier, POWINIEN obsługiwać nawigowanie po naciśnięciu klawisza NKRO.
    • Uwaga: klawiatura z obsługą NKRO może zgłosić dowolną liczbę klawiszy naciśniętych jednocześnie.
  • Jeśli klawiatura nie obsługuje formatu NKRO, POWINIEN obsługiwać 6-klawiszowe najechanie kursorem (6KRO) lub lepszą.
    • Uwaga: klawiatura z obsługą 6KRO może zgłosić maksymalnie 6 naciśnięć jednocześnie klawiszy.
  • Jeśli klawiatura obsługuje mniej niż 6 KRO, POWINIEN mieć w niej mechanizm anti-ghosting lub inny niezawodny mechanizm zapobiegający rejestrowaniu błędnych naciśnięć klawiszy.

Kody HID

  • W przypadku zapytania klawiatura MUSI wysyłać deskryptor raportu HID. Jest to wymagane przez definicję klasy urządzenia dla HID w wersji 1.11.
  • Wszystkie klucze MUSZĄ wysyłać istotne kody HID działań zmapowane na kod KEY_ lub BTN_ przez jądro Linux.
    • Uwaga: niektóre starsze zewnętrzne klawiatury urządzeń z ChromeOS wysyłają klawisze F1, F2 itp., które nie pasują do glifu na kluczu i są niezgodne.

Klawisze funkcyjne

  • Klawisze MOGĄ mieć dodatkowe działanie jak klawisze funkcyjne.
  • Jeśli klawiatury mają dodatkowe funkcje, takie jak klawisze funkcyjne, MUSI ona mieć klawisz Fn.
  • Jeśli klawisz działający jako klawisz funkcyjny jest połączony z klawiszem Fn, klawiatura MUSI wysyłać kod HID klawisza funkcyjnego.
  • Klawiatura MOŻE dedykowane klawisze funkcyjne.

Wytyczne dotyczące elementów graficznych glifów

Klawisze funkcyjne

  • Glify głównego działania POWINNY BYĆ wyraźniej widoczne (większe, jaśniejsze lub cięższe) niż glify funkcji drugorzędnych.

Do klawiszy nawigacyjnych można używać klawiszy strzałek w górę, w dół, w lewo i w prawo.

  • Jeśli klawiatura ma klawisze nawigacyjne, POWINNO mieć nadrukowane glify strzałek.
  • Jeśli klawiatura ma klawisz Lewy i Wstecz, glif lewego klawisza POWINNY być wizualnie wyróżniony od glifu klawisza Wstecz.
  • Jeśli klawiatura ma klawisz w prawo i do przodu, glif klawisza w prawo POWINNY być wizualnie wyróżniony od glifu klawisza do przodu.

Bateria i zasilanie

  • Jeśli klawiatura jest wyposażona w baterię, oprogramowanie klawiatury POWINIENIE informować o stanie baterii przez HID.
  • Jeśli klawiatura zawiera baterie, może ona zawierać co najmniej 1 klawisz zasilania, wskaźnik zasilania i przełącznik zasilania.
  • Jeśli klawiatura jest wyposażona w baterię wielokrotnego ładowania, musi ona umożliwiać ładowanie przez USB.
  • Jeśli do urządzenia dołączona jest ładowarka USB-C, ładowarka MOŻE mieć certyfikat USB-IF do dostarczania energii.

Oprogramowanie

Identyfikatory dostawcy i produktu

  • Identyfikator dostawcy zgłoszony przez klawiaturę w przypadku wszystkich protokołów MUSI należeć do producenta.
  • Kombinacje identyfikatorów dostawcy i produktu raportowane przez klawiaturę MUSZĄ być unikalne od innych modeli klawiatur.
  • Jeśli istnieje kilka wariantów z tym samym modelem klawiatury, wszystkie POWINNY mieć ten sam deskryptor HID.
  • Jeśli wersje tego samego modelu klawiatury mają różne deskryptory HID, każda odmiana deskryptora HID MUSI mapować się na unikalny identyfikator produktu.

Jądro

  • Jeśli używany jest niestandardowy sterownik jądra, MUSI być sprawdzony w systemie Linux.
  • Jeśli używany jest niestandardowy sterownik jądra, MUSI być uaktualniony do wersji jądra systemu operacyjnego Chromium w wersji 4.14 lub nowszej.
  • Gdy klawiatura jest wyłączona lub odłączona, jądro MUSI usunąć ją ze zbioru urządzeń wejściowych.

Historia zmian

Data Wersja Uwagi
2024-02-01 1.0.1 Republika na nowej platformie
2023-05-18 1.0 Początkowa publikacja w witrynie partnera