linux-stable.git/Documentation/hid, branch v5.12.2

Documentation: HID: uhid editing & corrections

2021-01-04T10:50:39+00:00

Do basic editing & correction to hid-alps.rst:
- correct a file name (.txt -> .rst)
- use less hyphenation when not needed
- fix grammar & punctuation
- fix article adjectives
- fix typos/spellos
- use HID instead of hid consistently

Signed-off-by: Randy Dunlap 
Cc: Jiri Kosina 
Cc: Benjamin Tissoires 
Cc: linux-input@vger.kernel.org
Cc: David Herrmann 
Cc: Jonathan Corbet 
Cc: linux-doc@vger.kernel.org
Cc: Jonathan Cameron 
Reviewed-by: Jonathan Cameron 
Signed-off-by: Jiri Kosina

Documentation: HID: hid-transport editing & corrections

2021-01-04T10:50:39+00:00

Do basic editing & correction to hid-transport.rst:
- s/responsible of/responsible for/
- fix grammar & punctuation

Signed-off-by: Randy Dunlap 
Cc: Jiri Kosina 
Cc: Benjamin Tissoires 
Cc: linux-input@vger.kernel.org
Cc: David Herrmann 
Cc: Jonathan Corbet 
Cc: linux-doc@vger.kernel.org
Cc: Jonathan Cameron 
Reviewed-by: Jonathan Cameron 
Signed-off-by: Jiri Kosina

Documentation: HID: hid-sensor editing & corrections

2021-01-04T10:50:38+00:00

Do basic editing & correction to hid-sensor.rst:
- use HID consistently instead of hid
- drop a duplicate word
- change article adjective an -> a
- fix grammar & punctuation
- spell out RW -> read-write
- hyphenate multi-word adjectives

Signed-off-by: Randy Dunlap 
Cc: Jiri Kosina 
Cc: Jonathan Cameron 
Cc: Srinivas Pandruvada 
Cc: linux-input@vger.kernel.org
Cc: linux-iio@vger.kernel.org
Cc: Jonathan Corbet 
Cc: linux-doc@vger.kernel.org
Reviewed-by: Jonathan Cameron 
Signed-off-by: Jiri Kosina

Documentation: HID: hidraw editing & corrections

2021-01-04T10:50:38+00:00

Do basic editing & correction to hidraw.rst:
- use "hidraw" consistently except at the beginning of a sentence
- add archive.org URL for signal11.us since the latter seems to be MIA
- use a list for 2 URLs so that they don't run together

Signed-off-by: Randy Dunlap 
Cc: Jiri Kosina 
Cc: Benjamin Tissoires 
Cc: linux-input@vger.kernel.org
Cc: Alan Ott 
Cc: Jonathan Corbet 
Cc: linux-doc@vger.kernel.org
Cc: Jonathan Cameron 
Reviewed-by: Jonathan Cameron 
Signed-off-by: Jiri Kosina

Documentation: HID: intel-ish-hid editing & corrections

2021-01-04T10:50:38+00:00

Do basic editing & correction to intel-ish-hid.rst:
- fix grammar, verb tense, punctutation, and word phrasing
- fix spellos
- hyphenate multi-word adjectives
- collapse 2 spaces to one space in the middle of sentences
- use "I2C" instead of lower-case letters (as Linux I2C does)
- change space indentation to tab
- use HID instead of hid consistently
- use a list so that some line items do not run together
- use "a UUID" instead of "an UUID"

Signed-off-by: Randy Dunlap 
Cc: Jiri Kosina 
Cc: Jonathan Cameron 
Cc: Srinivas Pandruvada 
Cc: linux-input@vger.kernel.org
Cc: linux-iio@vger.kernel.org
Cc: Jonathan Corbet 
Cc: linux-doc@vger.kernel.org
Reviewed-by: Jonathan Cameron 
Signed-off-by: Jiri Kosina

Documentation: HID: hiddev editing & corrections

2021-01-04T10:50:38+00:00

Do basic editing & correction to hiddev.rst:
- use HID instead of hid consistently
- add hyphenation of multi-word adjectives
- drop a duplicate word
- unhyphenate "a priori"

Signed-off-by: Randy Dunlap 
Cc: Jiri Kosina 
Cc: Benjamin Tissoires 
Cc: linux-input@vger.kernel.org
Cc: Jonathan Corbet 
Cc: linux-doc@vger.kernel.org
Cc: Jonathan Cameron 
Reviewed-by: Jonathan Cameron 
Signed-off-by: Jiri Kosina

Documentation: HID: amd-sfh-hid editing & corrections

2021-01-04T10:50:38+00:00

Do basic editing & correction to amd-sfh-hid.rst:
- fix punctuation
- use HID instead of hid consistently
- fix grammar, verb tense
- fix Block Diagram heading

Signed-off-by: Randy Dunlap 
Cc: Jiri Kosina 
Cc: Jonathan Cameron 
Cc: Srinivas Pandruvada 
Cc: linux-input@vger.kernel.org
Cc: linux-iio@vger.kernel.org
Cc: Jonathan Corbet 
Cc: linux-doc@vger.kernel.org
Reviewed-by: Jonathan Cameron 
Signed-off-by: Jiri Kosina

Documentation: HID: hid-alps editing & corrections

2021-01-04T10:50:38+00:00

Do basic editing & correction to hid-alps.rst:
- fix grammar
- fix punctuation spacing

Signed-off-by: Randy Dunlap 
Cc: Jiri Kosina 
Cc: Benjamin Tissoires 
Cc: linux-input@vger.kernel.org
Cc: Jonathan Corbet 
Cc: Jonathan Cameron 
Cc: linux-doc@vger.kernel.org
Reviewed-by: Jonathan Cameron 
Signed-off-by: Jiri Kosina

Merge branch 'for-5.11/core' into for-linus

2020-12-16T10:38:38+00:00

- increase of maximum HID report size to 16KB in order to support
  some of the modern devices, from Dean Camera

- control interface support for hidraw, from Dean Camera

- stylus battery reporting improvement, from Dmitry Torokhov

HID: hidraw: Add additional hidraw input/output report ioctls.

2020-11-27T14:48:31+00:00

Currently the hidraw module can only read and write feature HID reports on
demand, via dedicated ioctls. Input reports are read from the device through
the read() interface, while output reports are written through the write
interface().

This is insufficient; it is desirable in many situations to be able to read and
write input and output reports through the control interface to cover
additional scenarios:

  - Reading an input report by its report ID, to get initial state
  - Writing an input report, to set initial input state in the device
  - Reading an output report by its report ID, to obtain current state
  - Writing an output report by its report ID, out of band

This patch adds these missing ioctl requests to read and write the remaining
HID report types. Note that not all HID backends will neccesarily support this
(e.g. while the USB link layer supports setting Input reports, others may not).

Also included are documentation and example updates. The current hidraw
documentation states that feature reports read from the device does *not*
include the report ID, however this is not the case and the returned report
will have its report ID prepended by conforming HID devices, as the report data
sent from the device over the control endpoint must be indentical in format to
those sent over the regular transport.

Signed-off-by: Dean Camera 
Signed-off-by: Jiri Kosina