€•i‹      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ/translations/zh_CN/hid/uhid”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/zh_TW/hid/uhid”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/it_IT/hid/uhid”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/ja_JP/hid/uhid”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/ko_KR/hid/uhid”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/pt_BR/hid/uhid”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/sp_SP/hid/uhid”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ6UHID - User-space I/O driver support for HID subsystem”h]”hŒ6UHID - User-space I/O driver support for HID subsystem”…””}”(hh¼h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhh·h²hh³Œ6/var/lib/git/docbuild/linux/Documentation/hid/uhid.rst”h´KubhŒ	paragraph”“”)”}”(hŒÇUHID allows user-space to implement HID transport drivers. Please see
hid-transport.rst for an introduction into HID transport drivers. This document
relies heavily on the definitions declared there.”h]”hŒÇUHID allows user-space to implement HID transport drivers. Please see
hid-transport.rst for an introduction into HID transport drivers. This document
relies heavily on the definitions declared there.”…””}”(hhÍh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubhÌ)”}”(hŒÝWith UHID, a user-space transport driver can create kernel hid-devices for each
device connected to the user-space controlled bus. The UHID API defines the I/O
events provided from the kernel to user-space and vice versa.”h]”hŒÝWith UHID, a user-space transport driver can create kernel hid-devices for each
device connected to the user-space controlled bus. The UHID API defines the I/O
events provided from the kernel to user-space and vice versa.”…””}”(hhÛh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K	hh·h²hubhÌ)”}”(hŒKThere is an example user-space application in ./samples/uhid/uhid-example.c”h]”hŒKThere is an example user-space application in ./samples/uhid/uhid-example.c”…””}”(hhéh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubh¶)”}”(hhh]”(h»)”}”(hŒThe UHID API”h]”hŒThe UHID API”…””}”(hhúh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhh÷h²hh³hÊh´KubhÌ)”}”(hŒ½UHID is accessed through a character misc-device. The minor number is allocated
dynamically so you need to rely on udev (or similar) to create the device node.
This is /dev/uhid by default.”h]”hŒ½UHID is accessed through a character misc-device. The minor number is allocated
dynamically so you need to rely on udev (or similar) to create the device node.
This is /dev/uhid by default.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh÷h²hubhÌ)”}”(hXT  If a new device is detected by your HID I/O Driver and you want to register this
device with the HID subsystem, then you need to open /dev/uhid once for each
device you want to register. All further communication is done by read()'ing or
write()'ing "struct uhid_event" objects. Non-blocking operations are supported
by setting O_NONBLOCK::”h]”hX[  If a new device is detected by your HID I/O Driver and you want to register this
device with the HID subsystem, then you need to open /dev/uhid once for each
device you want to register. All further communication is done by read()â€™ing or
write()â€™ing â€œstruct uhid_eventâ€ objects. Non-blocking operations are supported
by setting O_NONBLOCK:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh÷h²hubhŒliteral_block”“”)”}”(hŒÜstruct uhid_event {
      __u32 type;
      union {
              struct uhid_create2_req create2;
              struct uhid_output_req output;
              struct uhid_input2_req input2;
              ...
      } u;
};”h]”hŒÜstruct uhid_event {
      __u32 type;
      union {
              struct uhid_create2_req create2;
              struct uhid_output_req output;
              struct uhid_input2_req input2;
              ...
      } u;
};”…””}”hj&  sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1j$  h³hÊh´Khh÷h²hubhÌ)”}”(hXd  The "type" field contains the ID of the event. Depending on the ID different
payloads are sent. You must not split a single event across multiple read()'s or
multiple write()'s. A single event must always be sent as a whole. Furthermore,
only a single event can be sent per read() or write(). Pending data is ignored.
If you want to handle multiple events in a single syscall, then use vectored
I/O with readv()/writev().
The "type" field defines the payload. For each type, there is a
payload-structure available in the union "u" (except for empty payloads). This
payload contains management and/or device data.”h]”hXt  The â€œtypeâ€ field contains the ID of the event. Depending on the ID different
payloads are sent. You must not split a single event across multiple read()â€™s or
multiple write()â€™s. A single event must always be sent as a whole. Furthermore,
only a single event can be sent per read() or write(). Pending data is ignored.
If you want to handle multiple events in a single syscall, then use vectored
I/O with readv()/writev().
The â€œtypeâ€ field defines the payload. For each type, there is a
payload-structure available in the union â€œuâ€ (except for empty payloads). This
payload contains management and/or device data.”…””}”(hj6  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K&hh÷h²hubhÌ)”}”(hX|  The first thing you should do is send a UHID_CREATE2 event. This will
register the device. UHID will respond with a UHID_START event. You can now
start sending data to and reading data from UHID. However, unless UHID sends the
UHID_OPEN event, the internally attached HID Device Driver has no user attached.
That is, you might put your device asleep unless you receive the UHID_OPEN
event. If you receive the UHID_OPEN event, you should start I/O. If the last
user closes the HID device, you will receive a UHID_CLOSE event. This may be
followed by a UHID_OPEN event again and so on. There is no need to perform
reference-counting in user-space. That is, you will never receive multiple
UHID_OPEN events without a UHID_CLOSE event. The HID subsystem performs
ref-counting for you.
You may decide to ignore UHID_OPEN/UHID_CLOSE, though. I/O is allowed even
though the device may have no users.”h]”hX|  The first thing you should do is send a UHID_CREATE2 event. This will
register the device. UHID will respond with a UHID_START event. You can now
start sending data to and reading data from UHID. However, unless UHID sends the
UHID_OPEN event, the internally attached HID Device Driver has no user attached.
That is, you might put your device asleep unless you receive the UHID_OPEN
event. If you receive the UHID_OPEN event, you should start I/O. If the last
user closes the HID device, you will receive a UHID_CLOSE event. This may be
followed by a UHID_OPEN event again and so on. There is no need to perform
reference-counting in user-space. That is, you will never receive multiple
UHID_OPEN events without a UHID_CLOSE event. The HID subsystem performs
ref-counting for you.
You may decide to ignore UHID_OPEN/UHID_CLOSE, though. I/O is allowed even
though the device may have no users.”…””}”(hjD  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K0hh÷h²hubhÌ)”}”(hX"  If you want to send data on the interrupt channel to the HID subsystem, you send
a HID_INPUT2 event with your raw data payload. If the kernel wants to send data
on the interrupt channel to the device, you will read a UHID_OUTPUT event.
Data requests on the control channel are currently limited to GET_REPORT and
SET_REPORT (no other data reports on the control channel are defined so far).
Those requests are always synchronous. That means, the kernel sends
UHID_GET_REPORT and UHID_SET_REPORT events and requires you to forward them to
the device on the control channel. Once the device responds, you must forward
the response via UHID_GET_REPORT_REPLY and UHID_SET_REPORT_REPLY to the kernel.
The kernel blocks internal driver-execution during such round-trips (times out
after a hard-coded period).”h]”hX"  If you want to send data on the interrupt channel to the HID subsystem, you send
a HID_INPUT2 event with your raw data payload. If the kernel wants to send data
on the interrupt channel to the device, you will read a UHID_OUTPUT event.
Data requests on the control channel are currently limited to GET_REPORT and
SET_REPORT (no other data reports on the control channel are defined so far).
Those requests are always synchronous. That means, the kernel sends
UHID_GET_REPORT and UHID_SET_REPORT events and requires you to forward them to
the device on the control channel. Once the device responds, you must forward
the response via UHID_GET_REPORT_REPLY and UHID_SET_REPORT_REPLY to the kernel.
The kernel blocks internal driver-execution during such round-trips (times out
after a hard-coded period).”…””}”(hjR  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K>hh÷h²hubhÌ)”}”(hŒúIf your device disconnects, you should send a UHID_DESTROY event. This will
unregister the device. You can now send UHID_CREATE2 again to register a new
device.
If you close() the fd, the device is automatically unregistered and destroyed
internally.”h]”hŒúIf your device disconnects, you should send a UHID_DESTROY event. This will
unregister the device. You can now send UHID_CREATE2 again to register a new
device.
If you close() the fd, the device is automatically unregistered and destroyed
internally.”…””}”(hj`  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KJhh÷h²hubeh}”(h]”Œthe-uhid-api”ah ]”h"]”Œthe uhid api”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kubh¶)”}”(hhh]”(h»)”}”(hŒwrite()”h]”hŒwrite()”…””}”(hjy  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjv  h²hh³hÊh´KQubhÌ)”}”(hXû  write() allows you to modify the state of the device and feed input data into
the kernel. The kernel will parse the event immediately and if the event ID is
not supported, it will return -EOPNOTSUPP. If the payload is invalid, then
-EINVAL is returned, otherwise, the amount of data that was read is returned and
the request was handled successfully. O_NONBLOCK does not affect write() as
writes are always handled immediately in a non-blocking fashion. Future requests
might make use of O_NONBLOCK, though.”h]”hXû  write() allows you to modify the state of the device and feed input data into
the kernel. The kernel will parse the event immediately and if the event ID is
not supported, it will return -EOPNOTSUPP. If the payload is invalid, then
-EINVAL is returned, otherwise, the amount of data that was read is returned and
the request was handled successfully. O_NONBLOCK does not affect write() as
writes are always handled immediately in a non-blocking fashion. Future requests
might make use of O_NONBLOCK, though.”…””}”(hj‡  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KRhjv  h²hubhŒdefinition_list”“”)”}”(hhh]”(hŒdefinition_list_item”“”)”}”(hŒâUHID_CREATE2:
This creates the internal HID device. No I/O is possible until you send this
event to the kernel. The payload is of type struct uhid_create2_req and
contains information about your device. You can start I/O now.
”h]”(hŒterm”“”)”}”(hŒUHID_CREATE2:”h]”hŒUHID_CREATE2:”…””}”(hj¢  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   h³hÊh´K]hjœ  ubhŒ
definition”“”)”}”(hhh]”hÌ)”}”(hŒÓThis creates the internal HID device. No I/O is possible until you send this
event to the kernel. The payload is of type struct uhid_create2_req and
contains information about your device. You can start I/O now.”h]”hŒÓThis creates the internal HID device. No I/O is possible until you send this
event to the kernel. The payload is of type struct uhid_create2_req and
contains information about your device. You can start I/O now.”…””}”(hjµ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K[hj²  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j°  hjœ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jš  h³hÊh´K]hj—  ubj›  )”}”(hXC  UHID_DESTROY:
This destroys the internal HID device. No further I/O will be accepted. There
may still be pending messages that you can receive with read() but no further
UHID_INPUT events can be sent to the kernel.
You can create a new device by sending UHID_CREATE2 again. There is no need to
reopen the character device.
”h]”(j¡  )”}”(hŒUHID_DESTROY:”h]”hŒUHID_DESTROY:”…””}”(hjÓ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   h³hÊh´KdhjÏ  ubj±  )”}”(hhh]”hÌ)”}”(hX4  This destroys the internal HID device. No further I/O will be accepted. There
may still be pending messages that you can receive with read() but no further
UHID_INPUT events can be sent to the kernel.
You can create a new device by sending UHID_CREATE2 again. There is no need to
reopen the character device.”h]”hX4  This destroys the internal HID device. No further I/O will be accepted. There
may still be pending messages that you can receive with read() but no further
UHID_INPUT events can be sent to the kernel.
You can create a new device by sending UHID_CREATE2 again. There is no need to
reopen the character device.”…””}”(hjä  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K`hjá  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j°  hjÏ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jš  h³hÊh´Kdhj—  h²hubj›  )”}”(hŒåUHID_INPUT2:
You must send UHID_CREATE2 before sending input to the kernel! This event
contains a data-payload. This is the raw data that you read from your device
on the interrupt channel. The kernel will parse the HID reports.
”h]”(j¡  )”}”(hŒUHID_INPUT2:”h]”hŒUHID_INPUT2:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   h³hÊh´Kihjþ  ubj±  )”}”(hhh]”hÌ)”}”(hŒ×You must send UHID_CREATE2 before sending input to the kernel! This event
contains a data-payload. This is the raw data that you read from your device
on the interrupt channel. The kernel will parse the HID reports.”h]”hŒ×You must send UHID_CREATE2 before sending input to the kernel! This event
contains a data-payload. This is the raw data that you read from your device
on the interrupt channel. The kernel will parse the HID reports.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kghj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j°  hjþ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jš  h³hÊh´Kihj—  h²hubj›  )”}”(hX|  UHID_GET_REPORT_REPLY:
If you receive a UHID_GET_REPORT request you must answer with this request.
You  must copy the "id" field from the request into the answer. Set the "err"
field to 0 if no error occurred or to EIO if an I/O error occurred.
If "err" is 0 then you should fill the buffer of the answer with the results
of the GET_REPORT request and set "size" correspondingly.
”h]”(j¡  )”}”(hŒUHID_GET_REPORT_REPLY:”h]”hŒUHID_GET_REPORT_REPLY:”…””}”(hj1  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   h³hÊh´Kphj-  ubj±  )”}”(hhh]”hÌ)”}”(hXd  If you receive a UHID_GET_REPORT request you must answer with this request.
You  must copy the "id" field from the request into the answer. Set the "err"
field to 0 if no error occurred or to EIO if an I/O error occurred.
If "err" is 0 then you should fill the buffer of the answer with the results
of the GET_REPORT request and set "size" correspondingly.”h]”hXt  If you receive a UHID_GET_REPORT request you must answer with this request.
You  must copy the â€œidâ€ field from the request into the answer. Set the â€œerrâ€
field to 0 if no error occurred or to EIO if an I/O error occurred.
If â€œerrâ€ is 0 then you should fill the buffer of the answer with the results
of the GET_REPORT request and set â€œsizeâ€ correspondingly.”…””}”(hjB  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Klhj?  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j°  hj-  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jš  h³hÊh´Kphj—  h²hubj›  )”}”(hŒÕUHID_SET_REPORT_REPLY:
This is the SET_REPORT equivalent of UHID_GET_REPORT_REPLY. Unlike GET_REPORT,
SET_REPORT never returns a data buffer, therefore, it's sufficient to set the
"id" and "err" fields correctly.
”h]”(j¡  )”}”(hŒUHID_SET_REPORT_REPLY:”h]”hŒUHID_SET_REPORT_REPLY:”…””}”(hj`  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   h³hÊh´Kuhj\  ubj±  )”}”(hhh]”hÌ)”}”(hŒ½This is the SET_REPORT equivalent of UHID_GET_REPORT_REPLY. Unlike GET_REPORT,
SET_REPORT never returns a data buffer, therefore, it's sufficient to set the
"id" and "err" fields correctly.”h]”hŒÇThis is the SET_REPORT equivalent of UHID_GET_REPORT_REPLY. Unlike GET_REPORT,
SET_REPORT never returns a data buffer, therefore, itâ€™s sufficient to set the
â€œidâ€ and â€œerrâ€ fields correctly.”…””}”(hjq  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kshjn  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j°  hj\  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jš  h³hÊh´Kuhj—  h²hubeh}”(h]”h ]”h"]”h$]”h&]”uh1j•  hjv  h²hh³hÊh´Nubeh}”(h]”Œwrite”ah ]”h"]”Œwrite()”ah$]”h&]”uh1hµhh·h²hh³hÊh´KQubh¶)”}”(hhh]”(h»)”}”(hŒread()”h]”hŒread()”…””}”(hjœ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj™  h²hh³hÊh´KxubhÌ)”}”(hŒ…read() will return a queued output report. No reaction is required to any of
them but you should handle them according to your needs.”h]”hŒ…read() will return a queued output report. No reaction is required to any of
them but you should handle them according to your needs.”…””}”(hjª  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kyhj™  h²hubj–  )”}”(hhh]”(j›  )”}”(hX©  UHID_START:
This is sent when the HID device is started. Consider this as an answer to
UHID_CREATE2. This is always the first event that is sent. Note that this
event might not be available immediately after write(UHID_CREATE2) returns.
Device drivers might require delayed setups.
This event contains a payload of type uhid_start_req. The "dev_flags" field
describes special behaviors of a device. The following flags are defined:

    - UHID_DEV_NUMBERED_FEATURE_REPORTS
    - UHID_DEV_NUMBERED_OUTPUT_REPORTS
    - UHID_DEV_NUMBERED_INPUT_REPORTS

        Each of these flags defines whether a given report-type uses numbered
        reports. If numbered reports are used for a type, all messages from
        the kernel already have the report-number as prefix. Otherwise, no
        prefix is added by the kernel.
        For messages sent by user-space to the kernel, you must adjust the
        prefixes according to these flags.
”h]”(j¡  )”}”(hŒUHID_START:”h]”hŒUHID_START:”…””}”(hj¿  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   h³hÊh´Khj»  ubj±  )”}”(hhh]”(hÌ)”}”(hX£  This is sent when the HID device is started. Consider this as an answer to
UHID_CREATE2. This is always the first event that is sent. Note that this
event might not be available immediately after write(UHID_CREATE2) returns.
Device drivers might require delayed setups.
This event contains a payload of type uhid_start_req. The "dev_flags" field
describes special behaviors of a device. The following flags are defined:”h]”hX§  This is sent when the HID device is started. Consider this as an answer to
UHID_CREATE2. This is always the first event that is sent. Note that this
event might not be available immediately after write(UHID_CREATE2) returns.
Device drivers might require delayed setups.
This event contains a payload of type uhid_start_req. The â€œdev_flagsâ€ field
describes special behaviors of a device. The following flags are defined:”…””}”(hjÐ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K}hjÍ  ubhŒblock_quote”“”)”}”(hXÔ  - UHID_DEV_NUMBERED_FEATURE_REPORTS
- UHID_DEV_NUMBERED_OUTPUT_REPORTS
- UHID_DEV_NUMBERED_INPUT_REPORTS

    Each of these flags defines whether a given report-type uses numbered
    reports. If numbered reports are used for a type, all messages from
    the kernel already have the report-number as prefix. Otherwise, no
    prefix is added by the kernel.
    For messages sent by user-space to the kernel, you must adjust the
    prefixes according to these flags.
”h]”hŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒ!UHID_DEV_NUMBERED_FEATURE_REPORTS”h]”hÌ)”}”(hjí  h]”hŒ!UHID_DEV_NUMBERED_FEATURE_REPORTS”…””}”(hjï  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K„hjë  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jé  hjæ  ubjê  )”}”(hŒ UHID_DEV_NUMBERED_OUTPUT_REPORTS”h]”hÌ)”}”(hj  h]”hŒ UHID_DEV_NUMBERED_OUTPUT_REPORTS”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K…hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jé  hjæ  ubjê  )”}”(hX  UHID_DEV_NUMBERED_INPUT_REPORTS

  Each of these flags defines whether a given report-type uses numbered
  reports. If numbered reports are used for a type, all messages from
  the kernel already have the report-number as prefix. Otherwise, no
  prefix is added by the kernel.
  For messages sent by user-space to the kernel, you must adjust the
  prefixes according to these flags.
”h]”(hÌ)”}”(hŒUHID_DEV_NUMBERED_INPUT_REPORTS”h]”hŒUHID_DEV_NUMBERED_INPUT_REPORTS”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K†hj  ubjß  )”}”(hXR  Each of these flags defines whether a given report-type uses numbered
reports. If numbered reports are used for a type, all messages from
the kernel already have the report-number as prefix. Otherwise, no
prefix is added by the kernel.
For messages sent by user-space to the kernel, you must adjust the
prefixes according to these flags.
”h]”hÌ)”}”(hXQ  Each of these flags defines whether a given report-type uses numbered
reports. If numbered reports are used for a type, all messages from
the kernel already have the report-number as prefix. Otherwise, no
prefix is added by the kernel.
For messages sent by user-space to the kernel, you must adjust the
prefixes according to these flags.”h]”hXQ  Each of these flags defines whether a given report-type uses numbered
reports. If numbered reports are used for a type, all messages from
the kernel already have the report-number as prefix. Otherwise, no
prefix is added by the kernel.
For messages sent by user-space to the kernel, you must adjust the
prefixes according to these flags.”…””}”(hj/  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kˆhj+  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÞ  h³hÊh´Kˆhj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jé  hjæ  ubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1jä  h³hÊh´K„hjà  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÞ  h³hÊh´K„hjÍ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j°  hj»  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jš  h³hÊh´Khj¸  ubj›  )”}”(hX›  UHID_STOP:
This is sent when the HID device is stopped. Consider this as an answer to
UHID_DESTROY.

If you didn't destroy your device via UHID_DESTROY, but the kernel sends an
UHID_STOP event, this should usually be ignored. It means that the kernel
reloaded/changed the device driver loaded on your HID device (or some other
maintenance actions happened).

You can usually ignore any UHID_STOP events safely.
”h]”(j¡  )”}”(hŒ
UHID_STOP:”h]”hŒ
UHID_STOP:”…””}”(hjg  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   h³hÊh´K˜hjc  ubj±  )”}”(hhh]”(hÌ)”}”(hŒXThis is sent when the HID device is stopped. Consider this as an answer to
UHID_DESTROY.”h]”hŒXThis is sent when the HID device is stopped. Consider this as an answer to
UHID_DESTROY.”…””}”(hjx  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khju  ubhÌ)”}”(hX   If you didn't destroy your device via UHID_DESTROY, but the kernel sends an
UHID_STOP event, this should usually be ignored. It means that the kernel
reloaded/changed the device driver loaded on your HID device (or some other
maintenance actions happened).”h]”hX  If you didnâ€™t destroy your device via UHID_DESTROY, but the kernel sends an
UHID_STOP event, this should usually be ignored. It means that the kernel
reloaded/changed the device driver loaded on your HID device (or some other
maintenance actions happened).”…””}”(hj†  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K“hju  ubhÌ)”}”(hŒ3You can usually ignore any UHID_STOP events safely.”h]”hŒ3You can usually ignore any UHID_STOP events safely.”…””}”(hj”  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K˜hju  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j°  hjc  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jš  h³hÊh´K˜hj¸  h²hubj›  )”}”(hXg  UHID_OPEN:
This is sent when the HID device is opened. That is, the data that the HID
device provides is read by some other process. You may ignore this event but
it is useful for power-management. As long as you haven't received this event
there is actually no other process that reads your data so there is no need to
send UHID_INPUT2 events to the kernel.
”h]”(j¡  )”}”(hŒ
UHID_OPEN:”h]”hŒ
UHID_OPEN:”…””}”(hj²  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   h³hÊh´KŸhj®  ubj±  )”}”(hhh]”hÌ)”}”(hX[  This is sent when the HID device is opened. That is, the data that the HID
device provides is read by some other process. You may ignore this event but
it is useful for power-management. As long as you haven't received this event
there is actually no other process that reads your data so there is no need to
send UHID_INPUT2 events to the kernel.”h]”hX]  This is sent when the HID device is opened. That is, the data that the HID
device provides is read by some other process. You may ignore this event but
it is useful for power-management. As long as you havenâ€™t received this event
there is actually no other process that reads your data so there is no need to
send UHID_INPUT2 events to the kernel.”…””}”(hjÃ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K›hjÀ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j°  hj®  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jš  h³hÊh´KŸhj¸  h²hubj›  )”}”(hŒUHID_CLOSE:
This is sent when there are no more processes which read the HID data. It is
the counterpart of UHID_OPEN and you may as well ignore this event.
”h]”(j¡  )”}”(hŒUHID_CLOSE:”h]”hŒUHID_CLOSE:”…””}”(hjá  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   h³hÊh´K£hjÝ  ubj±  )”}”(hhh]”hÌ)”}”(hŒThis is sent when there are no more processes which read the HID data. It is
the counterpart of UHID_OPEN and you may as well ignore this event.”h]”hŒThis is sent when there are no more processes which read the HID data. It is
the counterpart of UHID_OPEN and you may as well ignore this event.”…””}”(hjò  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K¢hjï  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j°  hjÝ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jš  h³hÊh´K£hj¸  h²hubj›  )”}”(hX&  UHID_OUTPUT:
This is sent if the HID device driver wants to send raw data to the I/O
device on the interrupt channel. You should read the payload and forward it to
the device. The payload is of type "struct uhid_output_req".
This may be received even though you haven't received UHID_OPEN yet.
”h]”(j¡  )”}”(hŒUHID_OUTPUT:”h]”hŒUHID_OUTPUT:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   h³hÊh´K©hj  ubj±  )”}”(hhh]”hÌ)”}”(hX  This is sent if the HID device driver wants to send raw data to the I/O
device on the interrupt channel. You should read the payload and forward it to
the device. The payload is of type "struct uhid_output_req".
This may be received even though you haven't received UHID_OPEN yet.”h]”hX  This is sent if the HID device driver wants to send raw data to the I/O
device on the interrupt channel. You should read the payload and forward it to
the device. The payload is of type â€œstruct uhid_output_reqâ€.
This may be received even though you havenâ€™t received UHID_OPEN yet.”…””}”(hj!  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K¦hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j°  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jš  h³hÊh´K©hj¸  h²hubj›  )”}”(hX0  UHID_GET_REPORT:
This event is sent if the kernel driver wants to perform a GET_REPORT request
on the control channel as described in the HID specs. The report-type and
report-number are available in the payload.
The kernel serializes GET_REPORT requests so there will never be two in
parallel. However, if you fail to respond with a UHID_GET_REPORT_REPLY, the
request might silently time out.
Once you read a GET_REPORT request, you shall forward it to the HID device and
remember the "id" field in the payload. Once your HID device responds to the
GET_REPORT (or if it fails), you must send a UHID_GET_REPORT_REPLY to the
kernel with the exact same "id" as in the request. If the request already
timed out, the kernel will ignore the response silently. The "id" field is
never re-used, so conflicts cannot happen.
”h]”(j¡  )”}”(hŒUHID_GET_REPORT:”h]”hŒUHID_GET_REPORT:”…””}”(hj?  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   h³hÊh´K·hj;  ubj±  )”}”(hhh]”hÌ)”}”(hX  This event is sent if the kernel driver wants to perform a GET_REPORT request
on the control channel as described in the HID specs. The report-type and
report-number are available in the payload.
The kernel serializes GET_REPORT requests so there will never be two in
parallel. However, if you fail to respond with a UHID_GET_REPORT_REPLY, the
request might silently time out.
Once you read a GET_REPORT request, you shall forward it to the HID device and
remember the "id" field in the payload. Once your HID device responds to the
GET_REPORT (or if it fails), you must send a UHID_GET_REPORT_REPLY to the
kernel with the exact same "id" as in the request. If the request already
timed out, the kernel will ignore the response silently. The "id" field is
never re-used, so conflicts cannot happen.”h]”hX*  This event is sent if the kernel driver wants to perform a GET_REPORT request
on the control channel as described in the HID specs. The report-type and
report-number are available in the payload.
The kernel serializes GET_REPORT requests so there will never be two in
parallel. However, if you fail to respond with a UHID_GET_REPORT_REPLY, the
request might silently time out.
Once you read a GET_REPORT request, you shall forward it to the HID device and
remember the â€œidâ€ field in the payload. Once your HID device responds to the
GET_REPORT (or if it fails), you must send a UHID_GET_REPORT_REPLY to the
kernel with the exact same â€œidâ€ as in the request. If the request already
timed out, the kernel will ignore the response silently. The â€œidâ€ field is
never re-used, so conflicts cannot happen.”…””}”(hjP  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K¬hjM  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j°  hj;  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jš  h³hÊh´K·hj¸  h²hubj›  )”}”(hX  UHID_SET_REPORT:
This is the SET_REPORT equivalent of UHID_GET_REPORT. On receipt, you shall
send a SET_REPORT request to your HID device. Once it replies, you must tell
the kernel about it via UHID_SET_REPORT_REPLY.
The same restrictions as for UHID_GET_REPORT apply.
”h]”(j¡  )”}”(hŒUHID_SET_REPORT:”h]”hŒUHID_SET_REPORT:”…””}”(hjn  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   h³hÊh´K½hjj  ubj±  )”}”(hhh]”hÌ)”}”(hŒûThis is the SET_REPORT equivalent of UHID_GET_REPORT. On receipt, you shall
send a SET_REPORT request to your HID device. Once it replies, you must tell
the kernel about it via UHID_SET_REPORT_REPLY.
The same restrictions as for UHID_GET_REPORT apply.”h]”hŒûThis is the SET_REPORT equivalent of UHID_GET_REPORT. On receipt, you shall
send a SET_REPORT request to your HID device. Once it replies, you must tell
the kernel about it via UHID_SET_REPORT_REPLY.
The same restrictions as for UHID_GET_REPORT apply.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kºhj|  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j°  hjj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jš  h³hÊh´K½hj¸  h²hubeh}”(h]”h ]”h"]”h$]”h&]”uh1j•  hj™  h²hh³hÊh´NubhŒ
transition”“”)”}”(hŒ4----------------------------------------------------”h]”h}”(h]”h ]”h"]”h$]”h&]”uh1jŸ  h³hÊh´K¿hj™  h²hubhÌ)”}”(hŒ4Written 2012, David Herrmann <dh.herrmann@gmail.com>”h]”(hŒWritten 2012, David Herrmann <”…””}”(hj«  h²hh³Nh´NubhŒ	reference”“”)”}”(hŒdh.herrmann@gmail.com”h]”hŒdh.herrmann@gmail.com”…””}”(hjµ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:dh.herrmann@gmail.com”uh1j³  hj«  ubhŒ>”…””}”(hj«  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÁhj™  h²hubeh}”(h]”Œread”ah ]”h"]”Œread()”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kxubeh}”(h]”Œ4uhid-user-space-i-o-driver-support-for-hid-subsystem”ah ]”h"]”Œ6uhid - user-space i/o driver support for hid subsystem”ah$]”h&]”uh1hµhhh²hh³hÊh´Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hÊuh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hºNŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”hÊŒ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jÜ  jÙ  js  jp  j–  j“  jÔ  jÑ  uŒ	nametypes”}”(jÜ  ‰js  ‰j–  ‰jÔ  ‰uh}”(jÙ  h·jp  h÷j“  jv  jÑ  j™  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nh²hub.