Skip to contentSkip to conversation

hidraw: Use Interrupt Endpoint for OUT Transfers if Available

PATCH In review Alan Ott 2 participants 2 messages May 16, 2010 – May 18, 2010

Subsystems (2)
lore
Share & tools
lore

Alan Ott

author
#0 lore raw

PATCH 1/1 hidraw: Use Interrupt Endpoint for OUT Transfers if Available

From: Alan Ott <[email protected]>

This patch makes the hidraw driver use the first Interrupt OUT endpoint for HID transfers to the device if such an endpoint exists. This is consistent with the behavior of the hiddev driver, and the logic is similar.

---
I believe this to be consistent with the section 4.4 of the HID 1.11 specification located at:

    http://www.usb.org/developers/devclass_docs/HID1_11.pdf
Quoted 1 line

From the specification (page numbered 10, the 20th page of the document

(xpdf page 20)):

The Interrupt Out pipe is optional. If a device declares an Interrupt Out endpoint then Output reports are transmitted by the host to the device through the Interrupt Out endpoint. If no Interrupt Out endpoint is declared then Output reports are transmitted to a device through the Control endpoint, using Set_Report(Output) requests.

This is also consistent with the way the Windows HID library (hid.dll) works.

Please let me know if I'm off-base here, or have misread the standard.

Alan.

drivers/hid/usbhid/hid-core.c +30 -10
index 56d06cd..6fd833d 100644
@@ -807,16 +807,36 @@ static int usbhid_output_raw_report(struct hid_device *hid, __u8 *buf, size_t co
 	struct usb_host_interface *interface = intf->cur_altsetting;
 	int ret;
 
-	ret = usb_control_msg(dev, usb_sndctrlpipe(dev, 0),
-		HID_REQ_SET_REPORT,
-		USB_DIR_OUT | USB_TYPE_CLASS | USB_RECIP_INTERFACE,
-		((report_type + 1) << 8) | *buf,
-		interface->desc.bInterfaceNumber, buf + 1, count - 1,
-		USB_CTRL_SET_TIMEOUT);
-
-	/* count also the report id */
-	if (ret > 0)
-		ret++;
+	if (usbhid->urbout) {
+		int actual_length;
+		int skipped_report_id = 0;
+		if (buf[0] == 0x0) {
+			/* Don't send the Report ID */
+			buf++;
+			count--;
+			skipped_report_id = 1;
+		}
+		ret = usb_interrupt_msg(dev, usbhid->urbout->pipe,
+			buf, count, &actual_length,
+			USB_CTRL_SET_TIMEOUT);
+		/* return the number of bytes transferred */
+		if (ret == 0) {
+			ret = actual_length;
+			/* count also the report id */
+			if (skipped_report_id)
+				ret++;
+		}
+	} else {
+		ret = usb_control_msg(dev, usb_sndctrlpipe(dev, 0),
+			HID_REQ_SET_REPORT,
+			USB_DIR_OUT | USB_TYPE_CLASS | USB_RECIP_INTERFACE,
+			((report_type + 1) << 8) | *buf,
+			interface->desc.bInterfaceNumber, buf + 1, count - 1,
+			USB_CTRL_SET_TIMEOUT);
+		/* count also the report id */
+		if (ret > 0)
+			ret++;
+	}
 
 	return ret;
 }
#1 lore raw
Quoted 15 lines · Alan Ott

From: Alan Ott <[email protected]>

This patch makes the hidraw driver use the first Interrupt OUT endpoint for HID transfers to the device if such an endpoint exists. This is consistent with the behavior of the hiddev driver, and the logic is similar.

---
I believe this to be consistent with the section 4.4 of the HID 1.11 specification located at:

    http://www.usb.org/developers/devclass_docs/HID1_11.pdf
Quoted 1 line

From the specification (page numbered 10, the 20th page of the document

(xpdf page 20)):

Quoted 8 lines

The Interrupt Out pipe is optional. If a device declares an Interrupt Out endpoint then Output reports are transmitted by the host to the device through the Interrupt Out endpoint. If no Interrupt Out endpoint is declared then Output reports are transmitted to a device through the Control endpoint, using Set_Report(Output) requests.

This is also consistent with the way the Windows HID library (hid.dll) works.

Yes, this definitely is a proper improvement. Thanks Alan, I have queued the patch.

Signature · 2 lines
Jiri Kosina
SUSE Labs, Novell Inc.