From 0338587d013daa232c37003c46b5c36f91db9b8b Mon Sep 17 00:00:00 2001 From: "Peter F. Patel-Schneider" Date: Thu, 18 Jun 2020 05:52:43 -0400 Subject: [PATCH 1/3] feature: add 0x4521 DisableKeys --- hidpp20/features/0x4521-DisableKeys_2.rst | 99 +++++++++++++++++++++++ 1 file changed, 99 insertions(+) create mode 100644 hidpp20/features/0x4521-DisableKeys_2.rst diff --git a/hidpp20/features/0x4521-DisableKeys_2.rst b/hidpp20/features/0x4521-DisableKeys_2.rst new file mode 100644 index 0000000..e93c09b --- /dev/null +++ b/hidpp20/features/0x4521-DisableKeys_2.rst @@ -0,0 +1,99 @@ +********************* +0x4521 - Disable Keys +********************* + +Interface + +[0x4521] DisableKeys +==================== + + disableableKeys = [0]GetCapabilities() + + disabledKeys = [1]GetDisabledKeys() + + disabledKeys = [2]SetDisabledKeys(keysToDisable) + + +DisableKeys +~~~~~~~~~~~ + +Define the presence of the keys which the SW allows the user to disable, and allow SW to disable them. +A unifying device containing this feature should adopt HID++ reset policy #3 and implement the 0x0020 +configuration change feature. + +GetCapabilities +~~~~~~~~~~~~~~~ + +Summary + + Returns keys which the SW allows the user to disable + +Parameters + + None + +Returns + + - disableableKeys [8bits] keys which the SW allows the user to disable + + +---+---+---+---------+--------+------------+---------+----------+ + | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 | + +===+===+===+=========+========+============+=========+==========+ + | | | | Windows | Insert | ScrollLock | NumLock | CAPSLock | + | | | | (Start) | | | | | + +---+---+---+---------+--------+------------+---------+----------+ + +GetDisabledKeys +~~~~~~~~~~~~~~~ + +Summary + + Returns list of keys the SW has disabled + +Parameters + + None + +Returns + + - disabledKeys [8bits] keys which the SW has disabled + + +---+---+---+---------+--------+------------+---------+----------+ + | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 | + +===+===+===+=========+========+============+=========+==========+ + | | | | Windows | Insert | ScrollLock | NumLock | CAPSLock | + | | | | (Start) | | | | | + +---+---+---+---------+--------+------------+---------+----------+ + + +SetDisabledKeys +~~~~~~~~~~~~~~~ + +Summary + + Selects which keys to disable + +Parameters + + - keysToDisable [8bits] keys to disable + + + +---+---+---+---------+--------+------------+---------+----------+ + | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 | + +===+===+===+=========+========+============+=========+==========+ + | | | | Windows | Insert | ScrollLock | NumLock | CAPSLock | + | | | | (Start) | | | | | + +---+---+---+---------+--------+------------+---------+----------+ + + +Returns + + - disabledKeys [8bits] echo of the keysToDisable parameter + + + +---+---+---+---------+--------+------------+---------+----------+ + | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 | + +===+===+===+=========+========+============+=========+==========+ + | | | | Windows | Insert | ScrollLock | NumLock | CAPSLock | + | | | | (Start) | | | | | + +---+---+---+---------+--------+------------+---------+----------+ From 55977abbd79e7baddf5f0cabe1e966879f519310 Mon Sep 17 00:00:00 2001 From: "Peter F. Patel-Schneider" Date: Thu, 18 Jun 2020 07:35:30 -0400 Subject: [PATCH 2/3] feature: update 0x4521 DisableKeys to match form of 0x0000 --- hidpp20/features/0x4521-DisableKeys_2.rst | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/hidpp20/features/0x4521-DisableKeys_2.rst b/hidpp20/features/0x4521-DisableKeys_2.rst index e93c09b..1110e91 100644 --- a/hidpp20/features/0x4521-DisableKeys_2.rst +++ b/hidpp20/features/0x4521-DisableKeys_2.rst @@ -1,18 +1,19 @@ ********************* -0x4521 - Disable Keys +Disable Keys (``0x4521``) ********************* -Interface +.. table:: Table 1 - Functions -[0x4521] DisableKeys -==================== - - disableableKeys = [0]GetCapabilities() - - disabledKeys = [1]GetDisabledKeys() - - disabledKeys = [2]SetDisabledKeys(keysToDisable) + == ====================== ======================================================= + ID Name Arguments + == ====================== ======================================================= + 0 GetCapabilities None + 1 GetDisabledKeys None + 2 SetDisabledKeys keysToDisable + == ====================== ======================================================= +Functions +========= DisableKeys ~~~~~~~~~~~ From 9bd729eb541f8f9b3aba70985272d6b5d0378908 Mon Sep 17 00:00:00 2001 From: "Peter F. Patel-Schneider" Date: Sat, 20 Jun 2020 06:10:10 -0400 Subject: [PATCH 3/3] feature: fix formatting in 0x4521 DisableKeys --- hidpp20/features/0x4521-DisableKeys_2.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/hidpp20/features/0x4521-DisableKeys_2.rst b/hidpp20/features/0x4521-DisableKeys_2.rst index 1110e91..35b8a23 100644 --- a/hidpp20/features/0x4521-DisableKeys_2.rst +++ b/hidpp20/features/0x4521-DisableKeys_2.rst @@ -1,6 +1,6 @@ -********************* +************************* Disable Keys (``0x4521``) -********************* +************************* .. table:: Table 1 - Functions