蓝牙 Apple Magic Keyboard 的 Fn 键 (2015)

Question 1

在上述提示的帮助下，我们能够创建一个补丁，使 Fn 键在通过蓝牙连接 Apple Magic Keyboard 键盘时起作用。

部分问题是 Magic Keyboard 显示的供应商 ID 为 0x004c（Apple 的蓝牙供应商 ID），而 hid-apple 只查找 0x05ac（Apple USB 供应商 ID），因此使用了 hid-generic 模块而不是 hid-apple。

第二个问题最初来自git 日志apple_input_mapping中的代码。hidinput_configure_usage

补丁发布在这里：https://bugzilla.kernel.org/show_bug.cgi?id=99881#c41

Answer

在上述提示的帮助下，我们能够创建一个补丁，使 Fn 键在通过蓝牙连接 Apple Magic Keyboard 键盘时起作用。

部分问题是 Magic Keyboard 显示的供应商 ID 为 0x004c（Apple 的蓝牙供应商 ID），而 hid-apple 只查找 0x05ac（Apple USB 供应商 ID），因此使用了 hid-generic 模块而不是 hid-apple。

第二个问题最初来自git 日志apple_input_mapping中的代码。hidinput_configure_usage

补丁发布在这里：https://bugzilla.kernel.org/show_bug.cgi?id=99881#c41

Question 2

部分答案：了解 HID 基础设施和 HID 原始数据

（免责声明：我只针对 USB 完成了所有这些操作，但我认为它将以与蓝牙相同或类似的方式应用）。

HID 设备可以以明确定义的格式发送和接收报告。特定设备的格式由以下给出HID 描述符，对于 USB 而言，它与其他 USB 描述符非常相似（例如，lsusb如果未绑定，则可以列出它们）。详细信息（USB）可以在人机接口设备 (HID) 的设备类定义 PDF文档。

可以找到 HID 的内核文档Documentation/hid。正如所hiddev.txt解释的，事件的数据流如下：

 usb.c --> hid-core.c --> hid-input.c --> input-subsystem

在中drivers/hid/hid-input.c，特别是在例程中hidinput_configure_usage，根据 HID 描述符解析报告。

因此，如果您看不到Fn钥匙，那就是出了问题的地方。

看到的输出hidraw0看起来很可疑，就像有几种具有不同 ID 的报告（此报告的 ID 为 1，普通键盘报告的 ID 为 0）。

但为了确保这一点，我们需要 HID 描述符。 HID 描述符可通过设备上的 ioctl 获得hidraw。例如，您可以使用https://github.com/DIGImend/usbhid-dump获取描述符（仅限 USB）并https://github.com/DIGImend/hidrd解析它。内核源代码中还有一个/samples/hidraw/hid-example.c文件展示了如何通过 ioctl 获取 HID 描述符；可以轻松修改它以生成类似于的十六进制转储usbhid-dump。您必须将其用于蓝牙，所以我将其放在帕斯特宾。编译用make.

（如果您不习惯编译外部项目：下载两者的zip文件，将每个文件解压到一个空目录中，，，，./bootstrap。./configure现在make您可以直接使用二进制文件，添加它们$PATH等）

现在您可以使用解析描述符

sudo ./hid-desc /dev/hidraw0 | tail -n+3 | head -1 | hidrd-convert -ihex -ospec

除了提供此输出（或十六进制转储，如果有任何功能不起作用）之外，请测试hidraw如果Fn与其他各种键（字母、箭头）组合按下会发生什么。还要测试正常按键时会发生什么。

如果无法使内核识别特殊报告，我不确定继续进行的最佳方法。也许最简单的方法是编写一个 C 程序来分析事件hidraw并生成额外的输入事件，类似于输入创建。

更新：HID 描述符00末尾包含一个额外的内容。如果删除它，它会解析为

Usage Page (Desktop),                           ; Generic desktop controls (01h)
Usage (Keyboard),                               ; Keyboard (06h, application collection)
Collection (Application),
    Report ID (1),                      ; +00 report id
    Usage Page (Keyboard),                      ; Keyboard/keypad (07h)
    Logical Minimum (0),
    Logical Maximum (1),
    Usage Minimum (KB Leftcontrol),             ; Keyboard left control (E0h, dynamic value)
    Usage Maximum (KB Right GUI),               ; Keyboard right GUI (E7h, dynamic value)
    Report Size (1),
    Report Count (8),
    Input (Variable),                   ; +01 modifier
    Report Count (5),
    Report Size (1),
    Usage Page (LED),                           ; LEDs (08h)
    Usage Minimum (01h),
    Usage Maximum (05h),
    Output (Variable),
    Report Count (1),
    Report Size (3),
    Output (Constant, Variable),
    Report Count (8),
    Report Size (1),
    Logical Minimum (0),
    Logical Maximum (1),
    Usage Page (FF00h),                         ; FF00h, vendor-defined
    Usage (03h),
    Input (Constant, Variable),         ; +02 vendor
    Report Count (6),
    Report Size (8),
    Logical Minimum (0),
    Logical Maximum (101),
    Usage Page (Keyboard),                      ; Keyboard/keypad (07h)
    Usage Minimum (None),                       ; No event (00h, selector)
    Usage Maximum (KB Application),             ; Keyboard Application (65h, selector)
    Input,                              ; +03 6 keysym bytes
    Report Count (1),
    Report Size (1),
    Logical Minimum (0),
    Logical Maximum (1),
    Usage Page (Consumer),                      ; Consumer (0Ch)
    Usage (Eject),                              ; Eject (B8h, one-shot control)
    Input (Variable),                   : +09.0
    Report Count (1),
    Report Size (1),
    Usage Page (FF00h),                         ; FF00h, vendor-defined
    Usage (03h),
    Input (Variable),                   ; +09.1
    Report Count (1),
    Report Size (6),
    Input (Constant, Variable),         : +09.2-7
    Usage Page (FF02h),                         ; FF02h, vendor-defined
    Usage (55h),
    Report ID (85),
    Logical Minimum (0),
    Logical Maximum (255),
    Report Size (8),
    Report Count (64),
    Feature (Variable, No Preferred, Volatile),
End Collection,
Usage Page (FF00h),                             ; FF00h, vendor-defined
Usage (14h),
Collection (Application),
    Report ID (144),
    Usage Page (Power Device),                  ; Power device (84h, power page)
    Report Size (1),
    Report Count (3),
    Logical Minimum (0),
    Logical Maximum (1),
    Usage (61h),
    Usage Page (Power Batsys),                  ; Power battery system (85h, power page)
    Usage (44h),
    Usage (46h),
    Input (Variable),
    Report Count (5),
    Input (Constant),
    Report Size (8),
    Report Count (1),
    Logical Minimum (0),
    Logical Maximum (255),
    Usage (65h),
    Input (Variable),
End Collection

有一份 id hex 的输入事件报告01、一份 id hex 的电池状态报告90、一项用于照常设置 LED 的输出，以及一项供应商特定的功能控制。

我标记了输入事件报告的字节。有几个供应商定义的字段，我们不知道他们做什么，只能猜测。

输入事件报告由 10 个字节组成，您的示例解码如下：

ID MM VA K1 K2 K3 K4 K5 K6 VB

01 00 00 00 00 00 00 00 00 02  ; press? Fn 
01 00 00 00 00 00 00 00 00 00  ; release? Fn

01 00 00 3b 00 00 00 00 00 00  ; press F2
01 00 00 00 00 00 00 00 00 00  ; release

01 00 00 00 00 00 00 00 00 00  ;
01 00 00 00 00 00 00 00 00 02  ; press Fn?
01 00 00 3b 00 00 00 00 00 02  ; press F2
01 00 00 00 00 00 00 00 00 02  ; release F2 (but not Fn?)

ID就是报告吧。MM是标准的 8 个修饰符位，没有空间容纳Fn键。K1toK6最多可同时按下 6 个键。VA并且VB是特定于供应商的。假设您在上一个示例中按住Fn并刚刚按下并释放F2，我的猜测是位 1VB代表修饰符Fn（或至少与它相关的东西）。

用于hexdump -e '10/1 "%02X ""\n"'获取每行 9 个字节的输出，并通过Fn与多个键组合（包括您最终想要重新定义的组合）来测试此假设。

更新：为了完整性和将来的参考，尽管我认为它与这种特殊情况不再相关：可以使用 UHID 注入 HID 事件，请参阅Documentation/hid/uhid.txt内核samples/uhid/uhid-example.c。

Answer