New sentence, new line; add article.

This commit is contained in:
wiz 2004-05-11 23:23:20 +00:00
parent 106e243f37
commit f7bb6060f2
1 changed files with 26 additions and 20 deletions

View File

@ -1,4 +1,4 @@
.\" $NetBSD: uhid.4,v 1.17 2004/05/08 11:46:51 jdolecek Exp $
.\" $NetBSD: uhid.4,v 1.18 2004/05/11 23:23:20 wiz Exp $
.\"
.\" Copyright (c) 1999, 2001 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -56,10 +56,10 @@ calls:
.It Dv USB_GET_REPORT_ID (int)
Get the report identifier used by this HID report.
.It Dv USB_GET_REPORT_DESC (struct usb_ctl_report_desc)
Get the HID report descriptor. Using
this descriptor the exact layout and meaning of data to/from
the device can be found. The report descriptor is delivered
without any processing.
Get the HID report descriptor.
Using this descriptor the exact layout and meaning of data to/from
the device can be found.
The report descriptor is delivered without any processing.
.Bd -literal
struct usb_ctl_report_desc {
int ucrd_size;
@ -69,17 +69,19 @@ struct usb_ctl_report_desc {
.It Dv USB_SET_IMMED (int)
Sets the device in a mode where each
.Xr read 2
will return the current value of the input report. Normally
a
will return the current value of the input report.
Normally a
.Xr read 2
will only return the data that the device reports on its
interrupt pipe. This call may fail if the device does not support
this feature.
interrupt pipe.
This call may fail if the device does not support this feature.
.It Dv USB_GET_REPORT (struct usb_ctl_report)
Get a report from the device without waiting for data on
the interrupt pipe. The
the interrupt pipe.
The
.Dv report
field indicates which report is requested. It should be
field indicates which report is requested.
It should be
.Dv UHID_INPUT_REPORT ,
.Dv UHID_OUTPUT_REPORT ,
or
@ -92,17 +94,19 @@ struct usb_ctl_report {
};
.Ed
.It Dv USB_SET_REPORT (struct usb_ctl_report)
Set a report in the device. The
Set a report in the device.
The
.Dv report
field indicates which report is to be set. It should be
field indicates which report is to be set.
It should be
.Dv UHID_INPUT_REPORT ,
.Dv UHID_OUTPUT_REPORT ,
or
.Dv UHID_FEATURE_REPORT .
This call may fail if the device does not support this feature.
.It Dv USB_GET_DEVICEINFO (struct usb_device_info)
Get an information summary for the device. This call will not
issue any USB transactions.
Get an information summary for the device.
This call will not issue any USB transactions.
.It Dv USB_GET_STRING_DESC (struct usb_string_desc)
Get a string descriptor for the given language id and
string index.
@ -117,13 +121,15 @@ struct usb_string_desc {
.Pp
Use
.Xr read 2
to get data from the device. Data should be read in chunks of the
size prescribed by the report descriptor.
to get data from the device.
Data should be read in chunks of the size prescribed by the report
descriptor.
.Pp
Use
.Xr write 2
send data to the device. Data should be written in chunks of the
size prescribed by the report descriptor.
send data to the device.
Data should be written in chunks of the size prescribed by the
report descriptor.
.Sh FILES
.Bl -tag -width Pa
.It Pa /dev/uhid?
@ -139,7 +145,7 @@ The
driver
appeared in
.Nx 1.4 .
Support for
Support for the
.Dv USB_GET_DEVICEINFO
and
.Dv USB_GET_STRING_DESC