Skip to content

consumer control code: update link to HID usage tables #55

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.

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

Merged
merged 3 commits into from
Jan 18, 2021

Conversation

schneider42
Copy link
Contributor

The old file was not available anymore. I believe this is where it was pointing at in the document.

@@ -33,7 +33,7 @@ class Keycode:
"""USB HID Keycode constants.

This list is modeled after the names for USB keycodes defined in
https://www.usb.org/sites/default/files/documents/hut1_12v2.pdf#page=53.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I pasted https://www.usb.org/sites/default/files/documents/hut1_12v2.pdf#page=53 and it went to the document and page I expected (screenshot below). Could you check this again?

image

@@ -33,7 +33,7 @@ class Keycode:
"""USB HID Keycode constants.

This list is modeled after the names for USB keycodes defined in
https://www.usb.org/sites/default/files/documents/hut1_12v2.pdf#page=53.
https://www.usb.org/sites/default/files/hut1_21_0.pdf#page=118.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is the newer version of the other document, and the page. It's the Keyboard/Keypad Page (0x07). 118 is the Consumer Control codes page.

@schneider42
Copy link
Contributor Author

Oh, I'm sorry I modified the wrong file. The consumer control codes point to http://www.usb.org/developers/hidpage/Hut1_12v2.pdf#page=75 which is not available (anymore?). I'll update the PR.

@schneider42 schneider42 changed the title update link to HID usage tables consumer control code: update link to HID usage tables Dec 20, 2020
@schneider42
Copy link
Contributor Author

Ah looks like they changed name and location of that PDF.

The version referenced in the file now lives under https://www.usb.org/sites/default/files/documents/hut1_12v2.pdf#page=75

The latest version seems to be https://www.usb.org/sites/default/files/hut1_21_0.pdf#page=118

Let me know which one you prefer.

@dhalbert
Copy link
Collaborator

Certainly let's use the latest version of the document. But could you fix both links, both the keyboard codes and the consumer control codes? The page in the new document for keyboard codes is https://www.usb.org/sites/default/files/hut1_21_0.pdf#page=82.

Oh, I'm sorry I modified the wrong file. The consumer control codes point to http://www.usb.org/developers/hidpage/Hut1_12v2.pdf#page=75 which is not available (anymore?). I'll update the PR.

@schneider42
Copy link
Contributor Author

Will do

@steamfoundry
Copy link

Darn. I found this in the middle of submitting a pull request for the same issue.

The Keyboard codes are also on PDF page 83, print page 82. https://www.usb.org/sites/default/files/hut1_21_0.pdf#page=83

@silverman
Copy link

silverman commented Jan 18, 2021

This seems to have lost steam. I suggest that this is what needs to be done:

  1. The URL in the ConsumerControlCode docstring should be changed to https://usb.org/sites/default/files/hut1_21_0.pdf#page=118, which is where section 15 'Consumer Page' begins.
  2. The URL in the Keycode docstring should be changed to https://usb.org/sites/default/files/hut1_21_0.pdf#page=83, which is where section 10 'Keyboard/Keypad Page' begins.

The commit of @schneider42 already addresses the first one. The second one is me concurring with the recent comment of @steamfoundry.

Copy link
Collaborator

@dhalbert dhalbert left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @schneider42, @steamfoundry, and @silverman for your work and comments. I consolidated everything, fixed both links, and merged from upstream.

@dhalbert dhalbert merged commit 67bc37f into adafruit:master Jan 18, 2021
adafruit-adabot added a commit to adafruit/Adafruit_CircuitPython_Bundle that referenced this pull request Jan 19, 2021
Updating https://github.com/adafruit/Adafruit_CircuitPython_PyPortal to 5.1.0 from 5.0.0:
  > Merge pull request adafruit/Adafruit_CircuitPython_PyPortal#102 from makermelissa/master
  > Merge pull request adafruit/Adafruit_CircuitPython_PyPortal#101 from jfurcean/fix-secrets-import

Updating https://github.com/adafruit/Adafruit_CircuitPython_HID to 4.1.5 from 4.1.4:
  > Merge pull request adafruit/Adafruit_CircuitPython_HID#55 from schneider42/update-hut-link
  > Merge pull request adafruit/Adafruit_CircuitPython_HID#56 from adafruit/REUSE
  > Added pre-commit-config file
  > Added pre-commit and SPDX copyright

Updating https://github.com/adafruit/Adafruit_CircuitPython_MotorKit to 1.6.0 from 1.5.4:
  > Merge pull request adafruit/Adafruit_CircuitPython_MotorKit#38 from adafruit/REUSE
  > Merge pull request adafruit/Adafruit_CircuitPython_MotorKit#37 from CedarGroveStudios/pwm-freq-get-set
  > Added pre-commit-config file
  > Added pre-commit and SPDX copyright

Updating https://github.com/adafruit/Adafruit_CircuitPython_Bundle/circuitpython_library_list.md to NA from NA:
  > Added the following libraries: Adafruit_CircuitPython_SHT4x
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants