8000 Keyboard HID descriptor has too low a maximum · Issue #2761 · adafruit/circuitpython · GitHub
[go: up one dir, main page]
Skip to content

Keyboard HID descriptor has too low a maximum #2761

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Closed
larsks opened this issue Apr 11, 2020 · 1 comment · Fixed by #2764
Closed

Keyboard HID descriptor has too low a maximum #2761

larsks opened this issue Apr 11, 2020 · 1 comment · Fixed by #2764
Assignees
@dhalbert
Labels
usb
Milestone
5.x.x - Bug Fixes

Comments

@larsks
Copy link
larsks commented Apr 11, 2020

I'm trying to send keycodes from the Gemma M0 to a Linux host. I wanted to configure three buttons to send F13, F14, and F15. While this works just fine:

import usb_hid
from adafruit_hid.keyboard import Keyboard
from adafruit_hid.keycode import Keycode

kbd = Keyboard(usb_hid.devices)
kbd.press(Keycode.A)
kbd.release(Keycode.A)

This fails to send anything at all:

kbd.press(Keycode.F13)
kbd.release(Keycode.F13)

I notice that when using evtest to try to debug the problem, I see this report when connecting to the keyboard endpoint:

Input driver version is 1.0.1
Input device ID: bus 0x3 vendor 0x239a product 0x801d version 0x111
Input device name: "Adafruit Industries LLC Gemma M0 Keyboard"
Supported events:
  Event type 0 (EV_SYN)
  Event type 1 (EV_KEY)
    Event code 1 (KEY_ESC)
    Event code 2 (KEY_1)
    Event code 3 (KEY_2)
    Event code 4 (KEY_3)
    Event code 5 (KEY_4)
    Event code 6 (KEY_5)
    Event code 7 (KEY_6)
    Event code 8 (KEY_7)
    Event code 9 (KEY_8)
    Event code 10 (KEY_9)
    Event code 11 (KEY_0)
    Event code 12 (KEY_MINUS)
    Event code 13 (KEY_EQUAL)
    Event code 14 (KEY_BACKSPACE)
    Event code 15 (KEY_TAB)
    Event code 16 (KEY_Q)
    Event code 17 (KEY_W)
    Event code 18 (KEY_E)
    Event code 19 (KEY_R)
    Event code 20 (KEY_T)
    Event code 21 (KEY_Y)
    Event code 22 (KEY_U)
    Event code 23 (KEY_I)
    Event code 24 (KEY_O)
    Event code 25 (KEY_P)
    Event code 26 (KEY_LEFTBRACE)
    Event code 27 (KEY_RIGHTBRACE)
    Event code 28 (KEY_ENTER)
    Event code 29 (KEY_LEFTCTRL)
    Event code 30 (KEY_A)
    Event code 31 (KEY_S)
    Event code 32 (KEY_D)
    Event code 33 (KEY_F)
    Event code 34 (KEY_G)
    Event code 35 (KEY_H)
    Event code 36 (KEY_J)
    Event code 37 (KEY_K)
    Event code 38 (KEY_L)
    Event code 39 (KEY_SEMICOLON)
    Event code 40 (KEY_APOSTROPHE)
    Event code 41 (KEY_GRAVE)
    Event code 42 (KEY_LEFTSHIFT)
    Event code 43 (KEY_BACKSLASH)
    Event code 44 (KEY_Z)
    Event code 45 (KEY_X)
    Event code 46 (KEY_C)
    Event code 47 (KEY_V)
    Event code 48 (KEY_B)
    Event code 49 (KEY_N)
    Event code 50 (KEY_M)
    Event code 51 (KEY_COMMA)
    Event code 52 (KEY_DOT)
    Event code 53 (KEY_SLASH)
    Event code 54 (KEY_RIGHTSHIFT)
    Event code 55 (KEY_KPASTERISK)
    Event code 56 (KEY_LEFTALT)
    Event code 57 (KEY_SPACE)
    Event code 58 (KEY_CAPSLOCK)
    Event code 59 (KEY_F1)
    Event code 60 (KEY_F2)
    Event code 61 (KEY_F3)
    Event code 62 (KEY_F4)
    Event code 63 (KEY_F5)
    Event code 64 (KEY_F6)
    Event code 65 (KEY_F7)
    Event code 66 (KEY_F8)
    Event code 67 (KEY_F9)
    Event code 68 (KEY_F10)
    Event code 69 (KEY_NUMLOCK)
    Event code 70 (KEY_SCROLLLOCK)
    Event code 71 (KEY_KP7)
    Event code 72 (KEY_KP8)
    Event code 73 (KEY_KP9)
    Event code 74 (KEY_KPMINUS)
    Event code 75 (KEY_KP4)
    Event code 76 (KEY_KP5)
    Event code 77 (KEY_KP6)
    Event code 78 (KEY_KPPLUS)
    Event code 79 (KEY_KP1)
    Event code 80 (KEY_KP2)
    Event code 81 (KEY_KP3)
    Event code 82 (KEY_KP0)
    Event code 83 (KEY_KPDOT)
    Event code 86 (KEY_102ND)
    Event code 87 (KEY_F11)
    Event code 88 (KEY_F12)
    Event code 96 (KEY_KPENTER)
    Event code 97 (KEY_RIGHTCTRL)
    Event code 98 (KEY_KPSLASH)
    Event code 99 (KEY_SYSRQ)
    Event code 100 (KEY_RIGHTALT)
    Event code 102 (KEY_HOME)
    Event code 103 (KEY_UP)
    Event code 104 (KEY_PAGEUP)
    Event code 105 (KEY_LEFT)
    Event code 106 (KEY_RIGHT)
    Event code 107 (KEY_END)
    Event code 108 (KEY_DOWN)
    Event code 109 (KEY_PAGEDOWN)
    Event code 110 (KEY_INSERT)
    Event code 111 (KEY_DELETE)
    Event code 119 (KEY_PAUSE)
    Event code 125 (KEY_LEFTMETA)
    Event code 126 (KEY_RIGHTMETA)
    Event code 127 (KEY_COMPOSE)
  Event type 4 (EV_MSC)
    Event code 4 (MSC_SCAN)
  Event type 17 (EV_LED)
    Event code 0 (LED_NUML) state 0
    Event code 1 (LED_CAPSL) state 0
    Event code 2 (LED_SCROLLL) state 0
    Event code 3 (LED_COMPOSE) state 0
    Event code 4 (LED_KANA) state 0
Key repeat handling:
  Repeat type 20 (EV_REP)
    Repeat code 0 (REP_DELAY)
      Value    250
    Repeat code 1 (REP_PERIOD)
      Value     33
Properties:

It appears that the HID driver is explicitly declaring that it only supports the keycode listed in the above output. Is there any way to get CP to send arbitrary HID keycodes?
@dhalbert
Copy link
Collaborator
dhalbert commented Apr 11, 2020 •
edited
Loading

This is due to a range limit in the keyboard HID descriptor, limiting the top value of the keycode:

circuitpython/tools/hid_report_descriptors.py

Line 73 in 44cf798

0x25, 101, # Logical Maximum (101)
. This descriptor was taken from a "standard" USB PC keyboard, but we should really make the range limit 0xdd. See https://www.usb.org/sites/default/files/documents/hut1_12v2.pdf#page=59 for the values we should include up to.

I'll transfer this issue to https://github.com/adafruit/circuitpython. It is a CircuitPython issue, not a library issue. Thanks for discovering this!

@dhalbert dhalbert transferred this issue from adafruit/Adafruit_CircuitPython_HID Apr 11, 2020
@dhalbert dhalbert changed the title Can't send all keycodes from Keycode? Keyboard HID descriptor has too low a maximum Apr 11, 2020
@dhalbert dhalbert self-assigned this Apr 11, 2020
@dhalbert dhalbert added this to the 5.x.x - Bug Fixes milestone Apr 11, 2020
@dhalbert dhalbert added the usb label Apr 11, 2020
@larsks larsks mentioned this issue Apr 11, 2020
Merged
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@dhalbert dhalbert

Labels
usb
Projects
None yet
Milestone
5.x.x - Bug Fixes
Development

Successfully merging a pull request may close this issue.

Fix maximum keycode in keyboard HID descriptor larsks/micropython
2 participants
@larsks @dhalbert
0