Bluetooth Apple Magic Keyboard用Fnキー（2015）

上記のヒントの助けを借りて、Apple Magic KeyboardをBluetoothに接続するときにFnキーが機能するようにするパッチを作成できました。

問題のいくつかは、Magic KeyboardがベンダーID 0x004c（AppleのBluetoothベンダーID）を表示しているのに対し、hid-appleは0x05ac（Apple USBベンダーID）のみを見つけるため、hid-appleの代わりにhid-genericモジュールが使用されることです。です。 。

2番目の問題は、元のapple_input_mappinggitログのコードで発生しました。hidinput_configure_usage

パッチはここに掲載されています：https://bugzilla.kernel.org/show_bug.cgi?id=99881#c41

部分的な答え: HIDインフラストラクチャとHID生データの理解

（免責事項：USBに対してのみこれをすべて行ったが、Bluetoothにも同じまたは同様の方法で適用されると仮定します。）

HIDデバイスは、明確に定義された形式でレポートを送受信できます。特定のデバイスの形式は次のとおりです。HID記述子、USBの場合は、他のUSB記述子と非常によく似ています（lsusbバインドされていない場合はリストできます）。詳細（USB）は以下で確認できます。HID (Human Interface Device) のデバイスクラスの定義 PDF文書。

HIDのカーネル文書を見つけることができますDocumentation/hid。説明したように、hiddev.txtイベントのデータフローは次のとおりです。

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

特に、drivers/hid/hid-input.cルーチン内では、レポートはhidinput_configure_usageHID記述子に基づいて解析されます。

Fnしたがって、鍵が見えない場合は、何か間違っています。

hidraw0異なるIDを持つ複数のレポートがあるかのように表示される出力は疑わしいようです（このレポートのIDは1、通常のキーボードレポートのIDは0です）。

ただし、これを保証するにはHID記述子が必要です。 HID記述子はデバイスのioctlを介して使用できますhidraw。たとえば、https://github.com/DIGImend/usbhid-dumpget descriptor（USBのみ）を使用してhttps://github.com/DIGImend/hidrd解析できます。/samples/hidraw/hid-example.cioctlでHID記述子を取得する方法を示すファイルもカーネルソースコードにあります。このファイルは簡単に変更して同様の16進ダンプを生成できますusbhid-dump。 Bluetoothで書く必要があります。ペーストビン。コンパイル用make。

（外部プロジェクトのコンパイルに慣れていない場合：両方のファイルのzipファイルをダウンロードし、各ファイルの圧縮を空のディレクトリ（、、、）./bootstrapに解凍します。バイナリで直接作業して追加できます。）./configuremake$PATH

これで、以下を使用して記述子を解析できます。

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

この出力（または機能しない場合は16進ダンプ）を提供することに加えて、さまざまな他のキー（文字、矢印）を押して何が起こるかをテストしhidrawてくださいFn。また、キーを正常に押したときに何が起こるかをテストしてみてください。

カーネルに特別なレポートを認識させることができない場合は、進める最善の方法がわかりません。おそらく最も簡単な方法は、イベントを分析hidrawして追加の入力イベントを生成するCプログラムを書くことです。生成入力。

修正する：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

01id hexの入力イベントレポート、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。最大6つのキーを同時に押すことができますK1。ベンダーによって異なります。前の例では、を押してを押してから離したと仮定すると、ビット1は修飾子（または少なくともそれに関連するもの）を表すようです。K6VAVBFnF2VBFn

hexdump -e '10/1 "%02X ""\n"'出力ラインごとに9バイトを取得し、Fn最終的に上書きしたいキーの組み合わせを含む、複数のキーの組み合わせでこの仮説をテストするために使用します。

修正する：完全性と今後の参考のために、もはやこの特定のケースとは関係がないと思います。 HIDイベントはUHIDを使用して注入できます。Documentation/hid/uhid.txtカーネルを参照してくださいsamples/uhid/uhid-example.c。