Kompatibel dengan ChromeOS - Spesifikasi Keyboard v1.0

Versi: 1.0.1
Terakhir Diperbarui: 01-02-2024

Legenda

Kata Kerja Produk Tindakan Pengembangan
"HARUS" Persyaratan produk wajib
"SEharusnya" Rekomendasi opsional
"DAPAT" Opsional

Ringkasan

Dokumen spesifikasi ini menjelaskan kriteria yang dipenuhi Keyboard yang Kompatibel dengan ChromeOS.

Spesifikasi ini mencakup keyboard eksternal yang bukan bagian dari sasis utama perangkat. Keyboard dapat dihubungkan secara nirkabel atau melalui kabel ke perangkat ChromeOS.

Keyboard dapat dijual terpisah sebagai aksesori atau dipaketkan dengan perangkat ChromeOS.

Glosarium

  • Tombol khusus: Tab, Enter, Backspace, Spasi, Disclosure数, 苯 merek, grafis merek<=>judul数, Fn, Halaman Atas, Halaman Turun, Beranda, Akhir, Hapus, Escape, Kunci, Beralih Bahasa.
  • Tombol pengubah: Peluncur, Shift, Control, Alt, Alt Gr, Fn.
  • Kunci karakter: Kunci yang mewakili bahasa tertulis atau operasi matematika, yang mencakup huruf, tanda baca, simbol, dan karakter diakritik.
  • Tombol fungsi: Tombol Fn bernomor, seperti F1, F2, ....
  • Tombol navigasi: Atas, Bawah, Kiri, Kanan.
  • Enam paket: Dalam tata letak yang diperluas, dua baris dari tiga tombol berada di atas tombol Navigasi.
  • Dongle: Adaptor port kecil yang menyediakan komunikasi dengan aksesori dalam format yang tidak didukung secara native oleh perangkat ChromeOS. Dongeng sering kali berisi penerima RF.
  • RF: Frekuensi Radio. Bentuk komunikasi nirkabel yang paling umum.
  • Tombol modal: Caps Lock, Num Lock, Scroll Lock; Tombol yang mengubah perilaku keyboard dan terus berlaku setelah dilepaskan.

Jenis

  • Jika keyboard terhubung ke perangkat ChromeOS melalui koneksi berkabel, keyboard itu HARUS terhubung ke perangkat ChromeOS menggunakan USB.
  • Jika menggunakan koneksi nirkabel, keyboard HARUS terhubung ke perangkat ChromeOS menggunakan Bluetooth atau adaptor USB 2,4 GHz (dongle).

Keamanan

Updater Firmware

Penting untuk memastikan periferal dapat di-patch jika kerentanan ditemukan di masa mendatang. Jika tidak, periferal dengan kerentanan yang diketahui akan diblokir agar tidak terhubung dengan ChromeOS.

  • Keyboard nirkabel Bluetooth HARUS mendukung kemampuan update firmware.
  • Keyboard dongle 2,4 GHz HARUS mendukung kemampuan update firmware.
  • Keyboard HARUS mendukung update firmware melalui fwupd.
    • Catatan: Dengan begitu, update akan berjalan lancar bagi pengguna selama update ChromeOS standar (biasanya setiap 4 minggu).

Konektivitas

  • Keyboard nirkabel HARUS mendukung koneksi dengan perangkat ChromeOS menggunakan salah satu atau kedua cara berikut:
    • Bluetooth
    • Dongle nirkabel 2,4 GHz

Dongle Nirkabel 2,4 GHz

Keyboard yang dilengkapi dengan penerima nirkabel (dongle) 2,4 GHz secara otomatis disambungkan dengan (dan hanya dengan) penerima tersebut. Tindakan pengguna (baik di perangkat maupun melalui aplikasi) diperlukan untuk menyambungkan keyboard dengan penerima lain atau menyambungkan keyboard baru dengan penerima yang sudah ada. Persyaratan berikut menjelaskan fungsi ini.

  • Jika keyboard nirkabel 2,4 GHz dikemas bersama dengan penerima, penerima HARUS mendukung koneksi ke perangkat ChromeOS melalui USB-A atau USB-C.
  • Jika keyboard nirkabel 2,4 GHz dikemas bersama penerima, keyboard HARUS disambungkan secara otomatis dengan penerima yang dikemas dengan keyboard.
  • Keyboard nirkabel 2,4 GHz yang dikemas bersama dengan penerima HARUS disambungkan secara otomatis dengan penerima yang dikemas dengan keyboard.
  • Keyboard 2,4 GHz MUNGKIN memungkinkan pengguna menyambungkan keyboard dengan penerima lain.
  • Penerima MUNGKIN memungkinkan pengguna menyambungkan keyboard 2,4 GHz lain dengan penerima.
  • Keyboard MUNGKIN mengandalkan aplikasi untuk penyambungan yang dimulai pengguna dengan penerima lain.
  • Penerima MUNGKIN mengandalkan aplikasi untuk penyambungan yang dimulai pengguna dengan keyboard lain.
  • Jika aplikasi diperlukan untuk mengubah penyambungan keyboard/penerima, aplikasi HARUS berjalan di ChromeOS.
  • Jika aplikasi penyambungan digunakan, aplikasi penyambungan HARUS merupakan aplikasi native ChromeOS.
    • Catatan: Ekstensi Chrome sering kali digunakan untuk mendukung konfigurasi hardware dan aksesori.
  • Perangkat MUNGKIN mengandalkan progressive web app (PWA) menggunakan WebUSB atau WebHID untuk penyesuaian.
  • Jika aplikasi penyambungan digunakan, aplikasi penyambungan MUNGKIN berupa aplikasi web yang menggunakan WebUSB atau WebHID.
  • Jika penyambungan diterapkan melalui ekstensi, ekstensi HANYA harus memiliki akses ke port USB.
    • Catatan: Skrip konten secara eksplisit tidak diizinkan.

Bluetooth

Konektor

Keyboard Berkabel

  • Keyboard berkabel HARUS mendukung salah satu transmisi USB berikut:
    • Stopkontak USB-C di keyboard
    • Kabel captive dengan colokan USB-A
    • Kabel captive dengan colokan USB-C
  • Jika keyboard berkabel mendukung stopkontak USB-C di perangkat, stopkontak USB-C HARUS mematuhi Bagian 4.5.1.3.2 Model Fungsi Saluran Konfigurasi Sink.
  • Jika keyboard berkabel mendukung stopkontak USB-C di perangkat, stopkontak USB-C HARUS mematuhi Gambar 4-9 Model Fungsional Sink untuk CC1 dan CC2.
  • Jika keyboard berkabel mendukung kabel terikat dengan colokan USB-A, paket produk HARUS menyertakan USB Type-C ke Adaptor Stopkontak Standar-A USB 3.1 (Bagian Spesifikasi USB Tipe-C 3.6.1) yang sesuai.
  • Jika keyboard berkabel mendukung kabel captive dengan colokan USB-C, steker USB-C HARUS mematuhi Spesifikasi USB Type-C Pasal 4.5.2 CC Fungsi dan Persyaratan Perilaku.
    • Catatan: khususnya aturan seputar perangkat yang terhubung langsung atau perangkat dengan kabel captive (Perangkat ini hanya akan menerapkan dan merasakan level tegangan CC pada pin A5).
  • Jika keyboard berkabel mendukung kabel captive dengan colokan USB-C, keyboard HARUS menghilangkan Receptacle USB Type-C pasif ke adaptor USB-A.
    • Alasan: Stopkontak USB Type-C ke adaptor USB-A dilarang oleh Spesifikasi USB Type-C Pasal 2.2.
  • Jika paket produk berisi kabel USB, kabel tersebut HARUS bersertifikasi USB-IF.

Perilaku Kunci

Gerakan mouse N-key

  • Jika keyboard diharapkan dapat disambungkan dengan perangkat yang cocok untuk bermain game, maka keyboard SEHARUS mendukung N-key rollover (NKRO).
    • Catatan: Keyboard yang mendukung NKRO dapat melaporkan berapa pun tombol yang ditekan secara bersamaan.
  • Jika keyboard tidak mendukung NKRO, keyboard HARUS mendukung rollover enam tombol (6KRO) atau yang lebih baik.
    • Catatan: Keyboard yang mendukung 6KRO dapat melaporkan hingga 6 tombol yang ditekan secara bersamaan.
  • Jika keyboard mendukung kurang dari 6KRO, keyboard harus memiliki anti-ghosting atau mekanisme andal lainnya untuk mencegah pencatatan penekanan tombol yang keliru.

Kode HID

  • Keyboard HARUS mengirim deskriptor laporan HID saat dikueri, seperti yang diwajibkan oleh Definisi Class Perangkat untuk HID v1.11.
  • Semua kunci HARUS mengirim kode HID tindakan yang bermakna, yang dipetakan ke kode KEY_ atau BTN_ oleh kernel linux.
    • Catatan: Beberapa keyboard Perangkat ChromeOS eksternal lama mengirim F1, F2, dll. yang tidak cocok dengan glyph pada kunci—ini tidak sesuai standar.

Tombol Fungsi

  • Kunci MUNGKIN memiliki perilaku sekunder sebagai tombol Fungsi.
  • Jika keyboard memiliki tombol dengan perilaku sekunder sebagai Tombol Fungsi, keyboard HARUS memiliki tombol Fn.
  • Jika tombol dengan perilaku sekunder sebagai Tombol Fungsi digabungkan dengan tombol Fn, keyboard HARUS mengirim kode HID Tombol Fungsi.
  • Keyboard MUNGKIN mendedikasikan tombol Fungsi.

Panduan Poster Glyph

Tombol fungsi

  • glyph tindakan utama HARUS tampak lebih jelas secara visual (lebih besar, lebih cerah, atau lebih berat) daripada glyph fungsi sekunder.

Tombol Navigasi adalah Atas, Bawah, Kiri, dan Kanan.

  • Jika keyboard memiliki tombol Navigasi, tombol Navigasi HARUS memiliki glyph panah yang dicetak pada batas tombol.
  • Jika keyboard memiliki tombol Kiri dan tombol Kembali, glyph tombol Kiri SEharusnya berbeda secara visual dari glyph tombol Kembali.
  • Jika keyboard memiliki tombol Kanan dan tombol Forward, glyph tombol Kanan HARUS secara visual berbeda dari glyph tombol Forward.

Baterai dan Daya

  • Jika keyboard berisi baterai, firmware keyboard HARUS melaporkan level baterai melalui HID.
  • Jika keyboard berisi baterai, keyboard MUNGKIN berisi satu atau beberapa dari: tombol terkait daya, indikator daya, dan tombol daya.
  • Jika keyboard berisi baterai yang dapat diisi ulang, keyboard HARUS mendukung pengisian ulang melalui USB.
  • Jika perangkat dipaketkan dengan pengisi daya USB-C, pengisi daya MUNGKIN bersertifikat USB-IF untuk pengiriman daya.

Software

ID Vendor dan Produk

  • ID vendor yang dilaporkan oleh keyboard pada semua protokol HARUS milik produsen.
  • Kombinasi ID vendor/produk yang dilaporkan oleh keyboard HARUS unik dari model keyboard lainnya.
  • Jika ada beberapa varian dari model keyboard yang sama, semuanya HARUS berbagi deskripsi HID yang sama.
  • Jika varian dari model keyboard yang sama memiliki deskripsi HID yang berbeda, setiap variasi deskripsi HID HARUS dipetakan ke ID produk yang unik.

Kernel

  • Jika driver kernel kustom digunakan, driver tersebut HARUS diperiksa ke Linux upstream
  • Jika driver kernel kustom digunakan, driver tersebut HARUS di-backport ke kernel Chromium OS 4.14 dan yang lebih baru.
  • Saat keyboard dimatikan atau terputus, kernel HARUS mengeluarkan keyboard dari kumpulan perangkat input.

Histori Revisi

Tanggal Versi Catatan
2024-02-01 1.0.1 Republik di platform baru
2023-05-18 1.0 Publikasi Situs Partner Awal