ATmega 32u4を使ったマウス応用同様、キーボードもレポート形式でデータを送信する事で複雑な制御が出来る。
ただ、マウス同様HID-Projectのライブラリそのままではレポート形式での送信が出来ないので、ライブラリに少し手を加える。
HID-Project\src\HID-APIs\KeyboardAPI.h を編集し、sSendReportの関数をpublicの所に追加する。
// Needs to be implemented in a lower level
virtual size_t removeAll(void) = 0;
virtual int send(void) = 0;
inline void sSendReport(void* data, int length) { HID().SendReport(HID_REPORTID_KEYBOARD, data, length); };
private:
virtual size_t set(KeyboardKeycode k, bool s) = 0;
inline size_t set(uint8_t k, bool s);
};
キーボードのレポートのデータ形式は下記の通り、キーは同時に6つまで＋モディファイアキーを送信できる。
typedef union{
struct{
uint8_t modifiers;
uint8_t reserved;
KeyboardKeycode keycodes[6];
};
} HID_KeyboardReport_Data_t;
モディファイアは下記の通り。
| 値 | キー |
| 0x01 | 左Control |
| 0x02 | 左Shift |
| 0x04 | 左Alt |
| 0x08 | 左Win |
| 0x10 | 右Control |
| 0x20 | 右Shift |
| 0x40 | 右Alt |
| 0x80 | 右Win |
キーの定義は下記を参照。
https://github.com/NicoHood/HID/blob/master/src/KeyboardLayouts/ImprovedKeylayouts.h
HID_KeyboardReport_Data_t のデータ構造体に押しているキーの情報を設定し、レポート送信する。もう一度空のデータを送信する事で、押して離した動作となる。
以下は、スケッチ開始5秒後にWin + R キーを押して離した後（ファイル名を指定して実行のウィンドウが開く）、notepad.exeを入力して改行を押すサンプル。上手く動けばメモ帳が開く。
#include <HID-Project.h> //HID-Project by NicoHood
#define MOD_CTL 0x01
#define MOD_SHFT 0x02
#define MOD_ALT 0x04
#define MOD_WIN 0x08
void setup() {
delay(5000);
Keyboard.begin();
HID_KeyboardReport_Data_t report;
memset(&report, 0, sizeof(HID_KeyboardReport_Data_t));
report.keycodes[0] = KEY_R;
report.modifiers = MOD_WIN;
Keyboard.sSendReport(&report, sizeof(report)); //press
delay(50);
memset(&report, 0, sizeof(HID_KeyboardReport_Data_t));
Keyboard.sSendReport(&report, sizeof(report)); //release
delay(2000);
Keyboard.print("notepad.exe\n");
}
void loop() {
}
