Compatible con ChromeOS: Especificación del teclado v1.0

Versión: 1.0.1
Última actualización: 1/2/2024

Leyenda

Verbo del producto Acción de desarrollo
"DEBE" Requisito de producto obligatorio
“DEBE” Recomendación opcional
“MAYO” Deseables

Descripción general

En este documento de especificaciones, se describen los criterios que cumple un teclado compatible con ChromeOS.

Esta especificación abarca un teclado externo que no forma parte del chasis principal del dispositivo. El teclado se puede conectar de forma inalámbrica o por cable a un dispositivo ChromeOS.

El teclado se puede vender por separado como un accesorio o incluido en un dispositivo ChromeOS.

Glosario

  • Teclas especiales: Tab, Intro, Retroceso, Espacio, 数, obtengan alojamiento, mencionó<=>ꕰ, Fn, Page Up, Page Down, Home, End, Escape, Escape, Lock, Language Switch.
  • Teclas modificadoras: Selector, Mayúsculas, Control, Alt, Alt Gr, Fin.
  • Claves de caracteres: Claves que representan el lenguaje escrito o las operaciones matemáticas, como letras, puntuación, símbolos y caracteres diacríticos.
  • Teclas de función: Teclas de función numeradas, como F1, F2...
  • Teclas de navegación: Arriba, Abajo, Izquierda y Derecha.
  • Paquete de seis: En el diseño extendido, las dos filas de las tres teclas se encuentran sobre las teclas de navegación.
  • Llave: Es un adaptador de puerto pequeño que se comunica con un accesorio en un formato que el dispositivo ChromeOS no admite de forma nativa. A menudo, una llave contiene un receptor de RF.
  • RF: Radiofrecuencia. La forma más común de comunicación inalámbrica.
  • Teclas modales: Bloq Mayús, Bloq Num, Bloqueo de desplazamiento. Teclas que cambian el comportamiento del teclado y siguen teniendo efecto después de que se sueltan.

Tipo

  • Si el teclado se conecta al dispositivo ChromeOS con una conexión por cable, se DEBE conectar al dispositivo ChromeOS mediante USB.
  • Si el teclado usa una conexión inalámbrica, DEBE conectarse al dispositivo ChromeOS a través de Bluetooth o un adaptador USB de 2.4 GHz (llave).

Seguridad

Actualizador de firmware

Es importante asegurarse de que los periféricos puedan tener parches en caso de que se descubran vulnerabilidades en el futuro. De lo contrario, los periféricos con vulnerabilidades conocidas no podrán conectarse con ChromeOS.

  • Un teclado inalámbrico Bluetooth DEBE admitir la actualización de firmware.
  • Un teclado dongle de 2.4 GHz DEBE admitir la capacidad de actualización del firmware.
  • El teclado DEBE admitir actualizaciones de firmware a través de fwupd.
    • Nota: Esto permitirá que las actualizaciones sean fluidas para el usuario durante una actualización estándar de ChromeOS (por lo general, cada 4 semanas).

Conectividad

  • El teclado inalámbrico DEBE admitir la conexión con el dispositivo ChromeOS a través de una de las siguientes opciones o ambas:
    • Bluetooth
    • Llave inalámbrica de 2.4 GHz

Adaptador inalámbrico de 2.4 GHz

Un teclado que incluye un receptor inalámbrico de 2.4 GHz (llave) se sincroniza automáticamente con ese receptor (y solo con él). Se requiere la acción del usuario (en el dispositivo o desde una app) para vincular el teclado con otro receptor o vincular un teclado nuevo con uno existente. En los siguientes requisitos, se detalla esta funcionalidad.

  • Cuando un teclado inalámbrico de 2.4 GHz se empaqueta junto con un receptor, el receptor DEBE admitir la conexión al dispositivo ChromeOS mediante USB-A o USB-C.
  • Si se empaqueta un teclado inalámbrico de 2.4 GHz junto con un receptor, el teclado DEBE sincronizarse automáticamente con el receptor incluido con el teclado.
  • Un teclado inalámbrico de 2.4 GHz que viene empaquetado con un receptor DEBE sincronizarse automáticamente solo con el receptor incluido con el teclado.
  • El teclado de 2.4 GHz PUEDE permitir al usuario vincular el teclado con otro receptor.
  • El receptor PUEDE permitirle al usuario vincular otro teclado de 2.4 GHz con el receptor.
  • Es posible que el teclado dependa de una app para la vinculación iniciada por el usuario con otros receptores.
  • Es posible que el receptor dependa de una app para la vinculación iniciada por el usuario con otros teclados.
  • Si se requiere una app para alterar la vinculación del teclado/receptor, se DEBE ejecutar en ChromeOS.
  • Si se usa una app de vinculación, esta DEBE ser una aplicación nativa de ChromeOS.
    • Nota: Las extensiones de Chrome a menudo se usan para admitir la configuración de hardware y accesorios.
  • Es posible que el dispositivo dependa de una app web progresiva (AWP) que use WebUSB o WebHID para personalizarlo.
  • Si se usa una app de vinculación, puede que sea una app web que use WebUSB o WebHID.
  • Si la vinculación se implementa a través de una extensión, esta SOLO DEBE tener acceso a puertos USB.
    • Nota: Las secuencias de comandos de contenido no están permitidas explícitamente.

Bluetooth

  • Si un teclado inalámbrico admite Bluetooth, este DEBE cumplir con los requisitos que se indican en los Requisitos de Bluetooth compatibles con ChromeOS. En particular, las siguientes secciones:
    • Requisitos genéricos de Bluetooth
    • Requisitos del dispositivo de entrada Bluetooth

Conectores

Teclados con cable

Comportamiento clave

Sustitución de teclas N

  • Si se espera que el teclado esté vinculado con dispositivos compatibles con juegos, DEBE admitir la sustitución de teclas N (NKRO).
    • Nota: Un teclado compatible con NKRO puede informar cualquier cantidad de teclas que se presionen al mismo tiempo.
  • Si el teclado no admite NKRO, DEBERÍA admitir desplazamiento de seis teclas (6KRO) o mejor.
    • Nota: Un teclado compatible con 6KRO puede informar que se presionan hasta 6 teclas al mismo tiempo.
  • Si el teclado admite menos de 6KRO, DEBE tener un mecanismo antifantasma u otros mecanismos confiables para evitar que se registren pulsaciones de teclas erróneas.

Códigos HID

  • El teclado DEBE enviar un descriptor de informe de HID cuando se lo consulta, según se requiere en la Definición de clase de dispositivo para HID v1.11.
  • Todas las claves DEBEN enviar códigos HID de acción significativos, asignados a un código KEY_ o BTN_ por el kernel de Linux.
    • Nota: Algunos teclados de dispositivos ChromeOS externos heredados envían F1, F2, etc., que no coinciden con el glifo de la tecla, ya que no cumplen con las políticas.

Claves de funciones

  • Las claves PUEDEN tener un comportamiento secundario como las claves de Función.
  • Si los teclados tienen teclas con un comportamiento secundario como las teclas de función, el teclado DEBE tener una tecla de función.
  • Si una tecla con un comportamiento secundario como tecla de función está conectada con una tecla Fn, el teclado DEBE enviar un código HID de tecla de función.
  • El teclado MAYÚS dedicado a las teclas de Función.

Lineamientos para el material gráfico de los glifos

Teclas de función

  • Los glifos de acción principal DEBEN verse más prominentes (más grandes, más brillantes o más pesados) que los glifos de la función secundaria.

Las teclas de navegación son las siguientes: Arriba, Abajo, Izquierda y Derecha.

  • Si el teclado tiene teclas de navegación, estas DEBEN tener glifos de flecha impresos en las mayúsculas.
  • Si el teclado tiene las teclas Izquierda y Atrás, el glifo de la tecla Izquierda DEBE ser visualmente distinto del glifo de la tecla Atrás.
  • Si el teclado tiene una tecla Derecha y una de Avanzar, el glifo de la tecla Derecha DEBE ser visualmente distinto del glifo de la tecla Avanzar.

Batería y alimentación

  • Si el teclado contiene una batería, el firmware del teclado DEBE informar el nivel de batería mediante HID.
  • Si el teclado contiene baterías, ES POSIBLE que incluya una o más de las siguientes teclas relacionadas con el encendido, un indicador de encendido y un interruptor de encendido.
  • Si el teclado contiene una batería recargable, entonces el teclado DEBE admitir la recarga por USB.
  • Si el dispositivo está incluido en un cargador USB-C, es posible que el cargador tenga la certificación USB-IF para la entrega de energía.

Software

IDs del producto y del proveedor

  • El ID de proveedor que informa el teclado en todos los protocolos DEBE pertenecer al fabricante.
  • Las combinaciones de ID del proveedor y del producto informadas por el teclado DEBEN ser únicas en otros modelos de teclado.
  • Si existen múltiples variantes del mismo modelo de teclado, todas DEBEN compartir el mismo descriptor HID.
  • Si las variantes del mismo modelo de teclado tienen diferentes descriptores HID, cada variación del descriptor HID DEBE asignar a un ID de producto único.

Kernel

  • Si se utiliza un controlador de kernel personalizado, se DEBE registrar en Linux ascendente
  • Si se usa un controlador de kernel personalizado, DEBE tener portabilidad a versiones anteriores de los kernels de Chromium OS 4.14 y versiones posteriores.
  • Cuando se apaga o se desconecta un teclado, el kernel DEBE quitar el teclado de la colección de dispositivos de entrada.

Historial de revisión

Fecha Versión Notas
2024-02-01 1.0.1 La república en una nueva plataforma
2023-05-18 1.0 Publicación inicial del sitio del socio