版本：1.0.1
上次更新时间：2024 年 2 月 1 日
图例
| 产品动词 | 开发操作 |
|---|---|
| “必须” | 强制性产品要求 |
| “应该” | 可选建议 |
| “可以” | 建议条件 |
概览
本规范文档介绍了 ChromeOS 兼容键盘满足的条件。
本规范涵盖不属于设备主机箱的外接键盘。键盘可通过无线方式或有线方式连接到 ChromeOS 设备。
键盘可以作为配件单独出售，也可以与 ChromeOS 设备捆绑销售。
术语库
- 特殊键：Tab、Enter、退格、空格、英数、ACTIVITY Na、也是如此 等英数、Fn、Page Up、Page Down、Home、End、Delete、Esc、Lock、语言切换。
- 辅助键：启动器键、Shift、Control、Alt、Alt Gr、Fn。
- 字符键：表示书面语言或数学运算的键，包括字母、标点、符号和变音符号。
- 功能键：带编号的 Fn 键，如 F1、F2 等。
- 导航键：向上、向下、向左、向右。
- Six-pack：在扩展布局中，三行按键位于导航键上方。
- 加密狗：一种小型端口适配器，能够以 ChromeOS 设备原生不支持的格式与配件通信。加密狗通常包含射频接收器。
- RF：射频。最常见的无线通信形式。
- 模态键：Caps Lock、Num Lock、Scroll Lock；可更改键盘行为并在释放后继续生效的键。
类型
- 如果键盘通过有线连接连接到 ChromeOS 设备，则应使用 USB 连接到 ChromeOS 设备。
- 如果键盘使用无线连接，则应使用蓝牙或 2.4 GHz USB 适配器（加密狗）连接到 ChromeOS 设备。
安全性
固件更新程序
请务必确保可以修补外围设备，以防未来发现漏洞。否则，系统将阻止具有已知漏洞的外围设备与 ChromeOS 连接。
- 蓝牙无线键盘应支持固件更新性。
- 2.4 GHz 加密狗键盘应支持固件更新。
- 键盘应通过 fwupd 支持固件更新。
- 注意：这将使用户在标准 ChromeOS 更新期间（通常是每 4 周）无缝更新。
连接性
- 无线键盘应支持使用以下任一或全部选项与 ChromeOS 设备连接：
- 蓝牙
- 2.4 GHz 无线加密狗
2.4 GHz 无线加密狗
附带 2.4 GHz 无线接收器（加密狗）的键盘会自动与该接收器配对（且仅能与其配对）。需要用户执行操作（在设备上或通过应用）才能将键盘与其他接收器配对或将新键盘与现有接收器配对。以下要求详细介绍了此功能。
- 如果 2.4 GHz 无线键盘与接收器打包在一起，接收器必须支持通过 USB-A 或 USB-C 连接到 ChromeOS 设备。
- 如果 2.4 GHz 无线键盘与接收器打包在一起，键盘必须自动与与该键盘打包的接收器配对。
- 与接收器打包在一起的 2.4 GHz 无线键盘必须仅与与该键盘一起打包的接收器自动配对。
- 2.4 GHz 键盘可以允许用户将键盘与其他接收器配对。
- 接收器可以允许用户将其他 2.4 GHz 键盘与接收器配对。
- 键盘可以依赖于应用来由用户发起与其他接收器的配对。
- 接收器可以依赖于应用来由用户发起与其他键盘的配对。
- 如果应用需要更改键盘/接收器配对，则该应用应在 ChromeOS 上运行。
- 如果使用配对应用，配对应用应为 ChromeOS 原生应用。
- 注意：Chrome 扩展程序通常用于支持硬件和配件的配置。
- 设备可以依赖使用 WebUSB 或 WebHID 的渐进式 Web 应用 (PWA) 进行自定义。
- 如果使用配对应用，配对应用可以是使用 WebUSB 或 WebHID 的 Web 应用。
- 如果通过扩展实现配对，该扩展必须仅有权访问 USB 端口。
- 注意：明确禁止使用内容脚本。
蓝牙
- 如果无线键盘支持蓝牙，无线键盘必须符合 ChromeOS 兼容蓝牙的要求中的要求。具体而言，请参阅以下部分：
- 通用蓝牙要求
- 蓝牙输入设备要求
连接器
有线键盘
- 有线键盘应支持以下 USB 传输方式之一：
- 键盘 USB-C 接口
- 带 USB-A 型插头的强制使用线
- 带 USB-C 型插头的强制数据线
- 如果有线键盘支持设备自带的 USB-C 接口，则 USB-C 接口必须符合第 4.5.1.3.2 节“接收器配置声道功能模型”的要求。
- 如果有线键盘支持设备自带的 USB-C 型接口，则 USB-C 型接口必须符合图 4-9 CC1 和 CC2 的接收器功能模型的要求。
- 如果有线键盘支持带 USB A 型插头的固定式数据线，则相应产品套装应包含符合要求的 USB C 型转 USB 3.1 标准 A 型插口适配器（USB C 型规范第 3.6.1 节）。
- 如果有线键盘支持带 USB C 型插头的强制线缆，则 USB C 型插头必须符合 USB C 型规范 第 4.5.2 节 CC 功能和行为要求。
- 注意：具体而言，关于直接连接设备或带有强制使用线的设备的规则（这些设备应仅在引脚 A5 上应用和检测 CC 电压级）。
- 如果有线键盘支持带 USB-C 型插头的固定式数据线，则键盘必须省略无源 USB C 型插口转 USB-A 适配器。
- 说明：USB C 型规范第 2.2 节禁止使用 USB C 型插口转 USB A 适配器。
- 如果商品套装包含 USB 数据线，该数据线应经过 USB-IF 认证。
主要行为
N 键滚动
- 如果键盘应与适合游戏的设备配对，则它应支持 N 键翻转 (NKRO)。
- 注意：支持 NKRO 的键盘可以报告同时按下的任意数量的按键。
- 如果键盘不支持 NKRO，则应支持六键翻转 (6KRO) 或更佳。
- 注意：支持 6KRO 的键盘最多可同时报告 6 个按键。
- 如果键盘支持低于 6KRO，则它应具有防重影或其他可靠的机制，以防止注册错误的按键操作。
HID 代码
- 根据HID v1.11 的设备类定义的要求，键盘必须在被查询时发送 HID 报告描述符。
- 所有按键都必须发送有意义的操作 HID 代码，这些代码由 Linux 内核映射到 KEY_ 或 BTN_ 代码。
- 注意：一些旧版 ChromeOS 设备键盘发送的 F1、F2 等与按键上的字形不匹配，因此不符合规定。
功能键
- 按键可以具有作为功能键的次要行为。
- 如果键盘具有具有次要行为作为功能键的按键，则键盘必须具有 Fn 键。
- 如果具有辅助行为作为功能键的按键与 Fn 键和键，键盘必须发送功能键 HID 代码。
- 键盘可以专用功能键。
字形海报图片指南
功能键
- 主要操作字形应比次要功能字形在视觉上更醒目（粗细更大、更亮或更重）。
导航键
导航键为向上键、向下键、向左键和向右键。
- 如果键盘有导航键，导航键的按键盖上应显示箭头字形。
- 如果键盘具有向左键和返回键，则向左键字形应在视觉上与返回键字形不同。
- 如果键盘具有向右键和前进键，那么向右键的字形应在视觉上与前进键的字形不同。
电池与电源
- 如果键盘包含电池，键盘固件应通过 HID 报告电池电量。
- 如果键盘包含电池，则键盘可以包含一个或多个：电源相关键、电源指示灯和电源开关。
- 如果键盘包含可充电电池，则键盘应支持通过 USB 充电。
- 如果设备捆绑了 USB-C 充电器，则该充电器可以通过 USB-IF 电源交付认证。
软件
供应商 ID 和产品 ID
- 键盘通过所有协议报告的供应商 ID 必须属于制造商。
- 键盘报告的供应商/产品 ID 组合必须与其他键盘型号不同。
- 如果同一键盘型号存在多个变体，则这些变体应都共用同一个 HID 描述符。
- 如果同一键盘模型的变体具有不同的 HID 描述符，则每个 HID 描述符变体都必须映射到唯一的产品 ID。
内核
- 如果使用自定义内核驱动程序，必须将其签入上游 Linux
- 如果使用自定义内核驱动程序，必须将其向后移植到 Chromium 操作系统内核 4.14 及更高版本。
- 当键盘关闭或断开连接时，内核必须从输入设备集合中移除该键盘。
修订历史记录
| 日期 | 版本 | 备注 |
|---|---|---|
| 2024-02-01 | 1.0.1 | 新平台上的共和党 |
| 2023-05-18 | 1.0 | 初始合作伙伴网站发布内容 |