Zgodność z ChromeOS – specyfikacja myszy w wersji 1.0

Wersja: 1.0.1
Ostatnia aktualizacja: 31.01.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, które spełnia mysz zgodna z ChromeOS. Tej specyfikacji nie należy używać w przypadku produktów WWCB ani produktów zaprojektowanych i certyfikowanych razem z Chromebookiem.

Dokument dotyczy tylko myszy i nie zawiera trackpadów ani kulek.

Wymagania dotyczące bezpieczeństwa

Aktualizator oprogramowania układowego

  • Jeśli mysz bezprzewodowa obsługuje Bluetooth, POWINIEN obsługiwać aktualizację oprogramowania.
  • Jeśli mysz bezprzewodowa obsługuje klucz 2,4 GHz, POWINIEN obsługiwać aktualizację oprogramowania.
  • Mysz POWINNA aktualizować oprogramowanie przez Fwupd.
    • Uzasadnienie: dzięki temu aktualizacje ChromeOS są płynne dla użytkownika podczas standardowej aktualizacji ChromeOS (zwykle co 6 tygodni).
    • Uwaga: należy zadbać o możliwość zastosowania poprawek do urządzeń peryferyjnych, jeśli w przyszłości zostaną wykryte luki w zabezpieczeniach. Uwaga: łączenie się z urządzeniami z ChromeOS przez urządzenie peryferyjne ze znanymi lukami w zabezpieczeniach nie będzie możliwe.
    • Uwaga: myszy przewodowe, które nie obsługują Bluetootha ani wtyczki 2,4 GHz, nie muszą być objęte możliwością aktualizacji oprogramowania.

Połączenia

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

Bezprzewodowa wtyczka 2,4 GHz

Myszy z bezprzewodowym odbiornikiem 2,4 GHz (dongle) automatycznie się z nim paruje (i tylko z nim). W przypadku sparowania myszy z innym odbiornikiem lub sparowania nowych myszy z istniejącym odbiornikiem wymagane jest działanie (na urządzeniu lub w aplikacji). Poniższe wymagania opisują tę funkcję.

  • Mysz bezprzewodowa 2, 4 GHz jest w pakiecie z odbiornikiem.Odbiornik MUSI umożliwiać połączenie z urządzeniem z ChromeOS przez USB-A lub USB-C.
  • Mysz bezprzewodowa 2, 4 GHz jest w pakiecie z odbiornikiem.Myszy MUSZĄ zostać automatycznie sparowane z odbiornikiem dołączonym do myszy.
  • Mysz bezprzewodowa 2,4 GHz w pakiecie z odbiornikiem MUSI być automatycznie parowana tylko z odbiornikiem dołączonym do myszy.
  • Myszy 2,4 GHz MOGĄ umożliwiać użytkownikowi sparowanie myszy z innym odbiornikiem.
  • Odbiornik MOŻE pozwolić użytkownikowi na sparowanie z nim innej myszy 2,4 GHz.
  • Myszy MOGĄ korzystać z aplikacji do inicjowanego przez użytkownika parowania z innymi odbiornikami.
  • Odbiornik MOŻE zainicjować inicjowane przez użytkownika parowanie z innymi myszami za pomocą aplikacji.
  • Jeśli do zmiany parowania myszy/odbiornika wymagana jest aplikacja, MUSI ona działać 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 implementowane za pomocą rozszerzenia, MOŻE ono mieć TYLKO dostęp do portów USB.

Bluetooth

  • Jeśli klawiatura bezprzewodowa obsługuje Bluetooth, klawiatura bezprzewodowa MUSI spełniać wymagania opisane w wymaganiach dotyczących Bluetootha zgodnych z ChromeOS. Chodzi o te sekcje:
    • Ogólne wymagania dotyczące Bluetootha
    • Wymagania dotyczące urządzeń wejściowych Bluetooth

Oprogramowanie sprzęgające

Myszy przewodowe

  • Mysz przewodowa MUSI obsługiwać jeden z tych transferów USB:
    • Gniazdo USB-C w myszce
    • Kabel przechwytujący z wtyczką USB-A
    • Kabel przechwytujący z wtyczką USB-C
  • Jeśli mysz przewodowa obsługuje gniazdo USB-C na urządzeniu, gniazdo USB-C MUSI być zgodne z artykułem 4.5.1.3.2 model funkcjonalny kanału konfiguracji ujścia.
  • Jeśli mysz przewodowa obsługuje gniazdo USB-C na urządzeniu, gniazdo USB-C MUSI być zgodne z rysunkiem 4–9 modelu funkcjonalnego ujścia CC1 i CC2.
  • Jeśli mysz 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łączem USB (w sekcji specyfikacji 3.6.1).
  • Jeśli mysz przewodowa obsługuje kabel przechwytujący z wtyczką USB-C, wtyczka USB-C MUSI być zgodna z sekcją 4.5.2 wymagań dotyczących działania i działania w specyfikacji USB typu C.

    • Uwaga: zasady dotyczące bezpośredniego łączenia urządzeń i urządzeń za pomocą kabla przechwytującego.

    (Urządzenia te wykrywają poziomy napięcia CC tylko na styku A5).

  • Jeśli mysz przewodowa obsługuje kabel przechwytujący z wtyczką USB-C, mysz NIE MOŻE zawierać pasywnego gniazda 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.

Projektowanie sprzętowe i wizualne

Mechanizm przewijania

  • Mysz MOŻE mieć mechanizm przewijania.
    • Uwaga: mechanizm przewijania obejmuje kółko do przewijania, powierzchnię wielodotykową itp.

Przyciski

  • Mysz POWINNA mieć możliwość generowania kliknięć lewym i prawym przyciskiem myszy za pomocą 2 osobnych przycisków lub pojedynczej powierzchni dotykowej/dotykowej.
  • Mysz MOŻE zawierać przyciski wykonujące działania wymienione w naszej uniwersalnej bibliotece kodów klawiszowych.

Śledzenie powierzchni

  • Jeśli CPI dla myszy jest stały, CPI musi być równy 800 CPI.
  • Jeśli CPI dla myszy jest zmienny, opcja CPI powinna mieć wartość z zakresu od 800 do 1500.

Tryb oszczędzania baterii

  • Gdy mysz przez pewien czas nie jest aktywna, POWINNA przejść w tryb mniejszej mocy.
    • Uwaga: zmniejszenie częstotliwości skanowania pozwala uzyskać niższy tryb zużycia energii.
  • Gdy użytkownik porusza myszą, POWINIEN przekazać informacje o zdarzeniach ruchu do urządzenia z ChromeOS w ciągu 30 ms.
    • Uzasadnienie: 30 ms jest uważany za dobry maksymalny czas odpowiedzi, zanim zmniejszy się wygodę użytkownika.

Oprogramowanie

Identyfikatory dostawcy i produktu

  • Identyfikator dostawcy wskazany po najechaniu kursorem na wszystkie protokoły MUSI należeć do producenta.
  • Kombinacje identyfikatorów dostawcy i produktu zgłaszane przez mysz MUSZĄ być unikalne w stosunku do innych modeli myszy.
  • Jeśli istnieje kilka wariantów z tym samym modelem myszy, wszystkie POWINNY mieć ten sam deskryptor HID.
  • Jeśli wersje tego samego modelu myszy 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.4 lub nowszej.
  • Gdy mysz jest wyłączona lub odłączona, jądro MUSI usunąć mysz ze zbioru urządzeń wejściowych.

Przyciski

  • Lewy przycisk MUSI zgłosić BTN_LEFT.
  • Środkowy przycisk MUSI zgłaszać BTN_MIDDLE.
  • Prawy przycisk MUSI zgłosić BTN_RIGHT.
  • Jeśli mysz zawiera przycisk z funkcją domyślną, MUSI ona zgłosić tę funkcję za pomocą odpowiedniego kodu KEY_ lub BTN_ opisanego w jądrorze Linuxa.
    • Mysz POWINNY Zgłaszać klucz tylko wtedy, gdy jest on fizycznie umieszczony w myszy lub można ją zmapować za pomocą narzędzia konfiguracji
  • Mysz nie MOŻE zgłaszać pełnego interfejsu klawiatury składającej się ze 104 klawiszy.

Ładowanie

Myszki przewodowe zwykle nie wymagają ładowania, więc ta sekcja dotyczy tylko myszy bezprzewodowych.

  • Jeśli mysz jest wyposażona w baterię akumulatorową, POWINNA obsługiwać ładowanie przez port USB-C lub Micro-USB.
  • Jeśli mysz jest wyposażona w ładowarkę USB-C, powinna ona mieć certyfikat USB-IF.
  • Jeśli mysz jest wyposażona w kabel USB-C, POWINIEN mieć certyfikat USB-IF.

Historia zmian

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