/* * Copyright (c) 2020 The ZMK Contributors * * SPDX-License-Identifier: MIT */ #pragma once #include #include #include #include #include #include #define COLLECTION_REPORT 0x03 #define ZMK_HID_KEYBOARD_NKRO_SIZE 6 #define ZMK_HID_CONSUMER_NKRO_SIZE 6 static const uint8_t zmk_hid_report_desc[] = { /* USAGE_PAGE (Generic Desktop) */ HID_GI_USAGE_PAGE, HID_USAGE_GD, /* USAGE (Keyboard) */ HID_LI_USAGE, HID_USAGE_GD_KEYBOARD, /* COLLECTION (Application) */ HID_MI_COLLECTION, COLLECTION_APPLICATION, /* REPORT ID (1) */ HID_GI_REPORT_ID, 0x01, /* USAGE_PAGE (Keyboard/Keypad) */ HID_GI_USAGE_PAGE, HID_USAGE_KEY, /* USAGE_MINIMUM (Keyboard LeftControl) */ HID_LI_USAGE_MIN(1), HID_USAGE_KEY_KEYBOARD_LEFTCONTROL, /* USAGE_MAXIMUM (Keyboard Right GUI) */ HID_LI_USAGE_MAX(1), HID_USAGE_KEY_KEYBOARD_RIGHT_GUI, /* LOGICAL_MINIMUM (0) */ HID_GI_LOGICAL_MIN(1), 0x00, /* LOGICAL_MAXIMUM (1) */ HID_GI_LOGICAL_MAX(1), 0x01, /* REPORT_SIZE (1) */ HID_GI_REPORT_SIZE, 0x01, /* REPORT_COUNT (8) */ HID_GI_REPORT_COUNT, 0x08, /* INPUT (Data,Var,Abs) */ HID_MI_INPUT, 0x02, /* USAGE_PAGE (Keyboard/Keypad) */ HID_GI_USAGE_PAGE, HID_USAGE_KEY, /* REPORT_SIZE (8) */ HID_GI_REPORT_SIZE, 0x08, /* REPORT_COUNT (1) */ HID_GI_REPORT_COUNT, 0x01, /* INPUT (Cnst,Var,Abs) */ HID_MI_INPUT, 0x03, /* USAGE_PAGE (Keyboard/Keypad) */ HID_GI_USAGE_PAGE, HID_USAGE_KEY, /* LOGICAL_MINIMUM (0) */ HID_GI_LOGICAL_MIN(1), 0x00, /* LOGICAL_MAXIMUM (0xFF) */ HID_GI_LOGICAL_MAX(1), 0xFF, /* USAGE_MINIMUM (Reserved) */ HID_LI_USAGE_MIN(1), 0x00, /* USAGE_MAXIMUM (Keyboard Application) */ HID_LI_USAGE_MAX(1), 0xFF, /* REPORT_SIZE (1) */ HID_GI_REPORT_SIZE, 0x08, /* REPORT_COUNT (ZMK_HID_KEYBOARD_NKRO_SIZE) */ HID_GI_REPORT_COUNT, ZMK_HID_KEYBOARD_NKRO_SIZE, /* INPUT (Data,Ary,Abs) */ HID_MI_INPUT, 0x00, /* END_COLLECTION */ HID_MI_COLLECTION_END, /* USAGE_PAGE (Consumer) */ HID_GI_USAGE_PAGE, HID_USAGE_CONSUMER, /* USAGE (Consumer Control) */ HID_LI_USAGE, HID_USAGE_CONSUMER_CONSUMER_CONTROL, /* Consumer Page */ HID_MI_COLLECTION, COLLECTION_APPLICATION, /* REPORT ID (1) */ HID_GI_REPORT_ID, 0x02, /* USAGE_PAGE (Consumer) */ HID_GI_USAGE_PAGE, HID_USAGE_CONSUMER, /* LOGICAL_MINIMUM (0) */ HID_GI_LOGICAL_MIN(1), 0x00, /* LOGICAL_MAXIMUM (0xFFFF) */ HID_GI_LOGICAL_MAX(2), 0xFF, 0xFF, HID_LI_USAGE_MIN(1), 0x00, /* USAGE_MAXIMUM (0xFFFF) */ HID_LI_USAGE_MAX(2), 0xFF, 0xFF, /* INPUT (Data,Ary,Abs) */ /* REPORT_SIZE (16) */ HID_GI_REPORT_SIZE, 0x10, /* REPORT_COUNT (ZMK_HID_CONSUMER_NKRO_SIZE) */ HID_GI_REPORT_COUNT, ZMK_HID_CONSUMER_NKRO_SIZE, HID_MI_INPUT, 0x00, /* END COLLECTION */ HID_MI_COLLECTION_END, /* USAGE_PAGE (Generic Desktop) */ HID_GI_USAGE_PAGE, HID_USAGE_GD, /* USAGE (Mouse) */ HID_LI_USAGE, HID_USAGE_GD_MOUSE, /* COLLECTION (Application) */ HID_MI_COLLECTION, COLLECTION_APPLICATION, /* REPORT ID (4) */ HID_GI_REPORT_ID, 0x04, /* USAGE (Pointer) */ HID_LI_USAGE, HID_USAGE_GD_POINTER, /* COLLECTION (Physical) */ HID_MI_COLLECTION, COLLECTION_PHYSICAL, /* USAGE_PAGE (Button) */ HID_GI_USAGE_PAGE, HID_USAGE_BUTTON, /* USAGE_MINIMUM (0x1) (button 1?) */ HID_LI_USAGE_MIN(1), 0x1, /* USAGE_MAXIMUM (0x10) (button 5? Buttons up to 8 still work) */ HID_LI_USAGE_MAX(1), 0x10, /* LOGICAL_MINIMUM (0) */ HID_GI_LOGICAL_MIN(1), 0x00, /* LOGICAL_MAXIMUM (1) */ HID_GI_LOGICAL_MAX(1), 0x01, /* REPORT_SIZE (1) */ HID_GI_REPORT_SIZE, 0x01, /* REPORT_COUNT (16) */ HID_GI_REPORT_COUNT, 0x10, /* INPUT (Data,Var,Abs) */ HID_MI_INPUT, 0x02, /* USAGE_PAGE (Generic Desktop) */ HID_GI_USAGE_PAGE, HID_USAGE_GD, /* LOGICAL_MINIMUM (-32767) */ HID_GI_LOGICAL_MIN(2), 0x01, 0x80, /* LOGICAL_MAXIMUM (32767) */ HID_GI_LOGICAL_MAX(2), 0xFF, 0x7F, /* REPORT_SIZE (16) */ HID_GI_REPORT_SIZE, 0x10, /* REPORT_COUNT (2) */ HID_GI_REPORT_COUNT, 0x02, /* USAGE (X) */ // Vertical scroll HID_LI_USAGE, HID_USAGE_GD_X, /* USAGE (Y) */ HID_LI_USAGE, HID_USAGE_GD_Y, /* Input (Data,Var,Rel) */ HID_MI_INPUT, 0x06, /* LOGICAL_MINIMUM (-127) */ HID_GI_LOGICAL_MIN(1), 0x81, /* LOGICAL_MAXIMUM (127) */ HID_GI_LOGICAL_MAX(1), 0x7F, /* REPORT_SIZE (8) */ HID_GI_REPORT_SIZE, 0x08, /* REPORT_COUNT (1) */ HID_GI_REPORT_COUNT, 0x01, /* USAGE (Wheel) */ HID_LI_USAGE, HID_USAGE_GD_WHEEL, /* Input (Data,Var,Rel) */ HID_MI_INPUT, 0x06, /* USAGE_PAGE (Consumer) */ // Horizontal scroll HID_GI_USAGE_PAGE, HID_USAGE_CONSUMER, /* USAGE (AC Pan) */ 0x0A, 0x38, 0x02, /* LOGICAL_MINIMUM (-127) */ HID_GI_LOGICAL_MIN(1), 0x81, /* LOGICAL_MAXIMUM (127) */ HID_GI_LOGICAL_MAX(1), 0x7F, /* REPORT_COUNT (1) */ HID_GI_REPORT_COUNT, 0x01, /* Input (Data,Var,Rel) */ HID_MI_INPUT, 0x06, /* END COLLECTION */ HID_MI_COLLECTION_END, /* END COLLECTION */ HID_MI_COLLECTION_END, }; // struct zmk_hid_boot_report // { // uint8_t modifiers; // uint8_t _unused; // uint8_t keys[6]; // } __packed; struct zmk_hid_keyboard_report_body { zmk_mod_flags_t modifiers; uint8_t _reserved; uint8_t keys[ZMK_HID_KEYBOARD_NKRO_SIZE]; } __packed; struct zmk_hid_keyboard_report { uint8_t report_id; struct zmk_hid_keyboard_report_body body; } __packed; struct zmk_hid_consumer_report_body { uint16_t keys[ZMK_HID_CONSUMER_NKRO_SIZE]; } __packed; struct zmk_hid_consumer_report { uint8_t report_id; struct zmk_hid_consumer_report_body body; } __packed; struct zmk_hid_mouse_report_body { zmk_mouse_button_flags_t buttons; int16_t x; int16_t y; int8_t scroll_y; int8_t scroll_x; } __packed; struct zmk_hid_mouse_report { uint8_t report_id; struct zmk_hid_mouse_report_body body; } __packed; zmk_mod_flags_t zmk_hid_get_explicit_mods(); int zmk_hid_register_mod(zmk_mod_t modifier); int zmk_hid_unregister_mod(zmk_mod_t modifier); int zmk_hid_register_mods(zmk_mod_flags_t explicit_modifiers); int zmk_hid_unregister_mods(zmk_mod_flags_t explicit_modifiers); int zmk_hid_implicit_modifiers_press(zmk_mod_flags_t implicit_modifiers); int zmk_hid_implicit_modifiers_release(); int zmk_hid_keyboard_press(zmk_key_t key); int zmk_hid_keyboard_release(zmk_key_t key); void zmk_hid_keyboard_clear(); int zmk_hid_consumer_press(zmk_key_t key); int zmk_hid_consumer_release(zmk_key_t key); void zmk_hid_consumer_clear(); int zmk_hid_mouse_button_press(zmk_mouse_button_t button); int zmk_hid_mouse_button_release(zmk_mouse_button_t button); int zmk_hid_mouse_buttons_press(zmk_mouse_button_flags_t buttons); int zmk_hid_mouse_buttons_release(zmk_mouse_button_flags_t buttons); void zmk_hid_mouse_movement_set(int16_t x, int16_t y); void zmk_hid_mouse_scroll_set(int8_t x, int8_t y); void zmk_hid_mouse_movement_update(int16_t x, int16_t y); void zmk_hid_mouse_scroll_update(int8_t x, int8_t y); void zmk_hid_mouse_clear(); struct zmk_hid_keyboard_report *zmk_hid_get_keyboard_report(); struct zmk_hid_consumer_report *zmk_hid_get_consumer_report(); struct zmk_hid_mouse_report *zmk_hid_get_mouse_report();