From 74298f8ca11dc8d3b0359d1d4e124d6494c3eeac Mon Sep 17 00:00:00 2001 From: Nicolas Schodet Date: Fri, 10 Apr 2009 01:15:42 +0200 Subject: * digital/avr/modules/usb: - imported LUFA. --- .../lufa/Demos/KeyboardHostWithParser/HIDReport.c | 119 +++++++++++++++++++++ 1 file changed, 119 insertions(+) create mode 100644 digital/avr/modules/usb/lufa/Demos/KeyboardHostWithParser/HIDReport.c (limited to 'digital/avr/modules/usb/lufa/Demos/KeyboardHostWithParser/HIDReport.c') diff --git a/digital/avr/modules/usb/lufa/Demos/KeyboardHostWithParser/HIDReport.c b/digital/avr/modules/usb/lufa/Demos/KeyboardHostWithParser/HIDReport.c new file mode 100644 index 00000000..70749eb1 --- /dev/null +++ b/digital/avr/modules/usb/lufa/Demos/KeyboardHostWithParser/HIDReport.c @@ -0,0 +1,119 @@ +/* + LUFA Library + Copyright (C) Dean Camera, 2009. + + dean [at] fourwalledcubicle [dot] com + www.fourwalledcubicle.com +*/ + +/* + Copyright 2009 Dean Camera (dean [at] fourwalledcubicle [dot] com) + + Permission to use, copy, modify, and distribute this software + and its documentation for any purpose and without fee is hereby + granted, provided that the above copyright notice appear in all + copies and that both that the copyright notice and this + permission notice and warranty disclaimer appear in supporting + documentation, and that the name of the author not be used in + advertising or publicity pertaining to distribution of the + software without specific, written prior permission. + + The author disclaim all warranties with regard to this + software, including all implied warranties of merchantability + and fitness. In no event shall the author be liable for any + special, indirect or consequential damages or any damages + whatsoever resulting from loss of use, data or profits, whether + in an action of contract, negligence or other tortious action, + arising out of or in connection with the use or performance of + this software. +*/ + +#include "HIDReport.h" + +/** Size in bytes of the attached device's HID report descriptor */ +uint16_t HIDReportSize; + +/** Processed HID report descriptor items structure, containing information on each HID report element */ +HID_ReportInfo_t HIDReportInfo; + + +/** Function to read in the HID report descriptor from the attached device, and process it into easy-to-read + * structures via the HID parser routines in the LUFA library. + * + * \return A value from the KeyboardHostWithParser_GetHIDReportDataCodes_t enum + */ +uint8_t GetHIDReportData(void) +{ + /* Create a buffer big enough to hold the entire returned HID report */ + uint8_t HIDReportData[HIDReportSize]; + + USB_HostRequest = (USB_Host_Request_Header_t) + { + bmRequestType: (REQDIR_DEVICETOHOST | REQTYPE_STANDARD | REQREC_INTERFACE), + bRequest: REQ_GetDescriptor, + wValue: (DTYPE_Report << 8), + wIndex: 0, + wLength: HIDReportSize, + }; + + /* Send control request to retrieve the HID report from the attached device */ + if (USB_Host_SendControlRequest(HIDReportData) != HOST_SENDCONTROL_Successful) + return ParseControlError; + + /* Send the HID report to the parser for processing */ + if (ProcessHIDReport(HIDReportData, HIDReportSize, &HIDReportInfo) != HID_PARSE_Successful) + return ParseError; + + return ParseSuccessful; +} + +/** Function to print out the attached device's HID descriptor elements in human readable form + * through the serial port. This is good for examining a device's HID descriptors, however it + * can cause noticible delays as there is generally a lot of data to be sent. + */ +void DumpHIDReportItems(void) +{ + /* Loop through each of the loaded HID report items in the processed item structure */ + for (uint8_t ItemIndex = 0; ItemIndex < HIDReportInfo.TotalReportItems; ItemIndex++) + { + /* Create pointer to the current report info structure */ + HID_ReportItem_t* RItem = &HIDReportInfo.ReportItems[ItemIndex]; + + /* Print out each report item's details */ + printf_P(PSTR(" Item %d:\r\n" + " Type: %s\r\n" + " Flags: %d\r\n" + " BitOffset: %d\r\n" + " BitSize: %d\r\n" + " Coll Ptr: %d\r\n" + " Coll Usage: %d\r\n" + " Coll Prnt: %d\r\n" + " Usage Page: %d\r\n" + " Usage: %d\r\n" + " Usage Min: %d\r\n" + " Usage Max: %d\r\n" + " Unit Type: %d\r\n" + " Unit Exp: %d\r\n" + " Log Min: %d\r\n" + " Log Max: %d\r\n" + " Phy Min: %d\r\n" + " Phy Max: %d\r\n"), ItemIndex, + ((RItem->ItemType == REPORT_ITEM_TYPE_In) ? "IN" : "OUT"), + RItem->ItemFlags, + RItem->BitOffset, + RItem->Attributes.BitSize, + RItem->CollectionPath, + RItem->CollectionPath->Usage, + RItem->CollectionPath->Parent, + RItem->Attributes.Usage.Page, + RItem->Attributes.Usage.Usage, + RItem->Attributes.Usage.MinMax.Minimum, + RItem->Attributes.Usage.MinMax.Maximum, + RItem->Attributes.Unit.Type, + RItem->Attributes.Unit.Exponent, + RItem->Attributes.Logical.Minimum, + RItem->Attributes.Logical.Maximum, + RItem->Attributes.Physical.Minimum, + RItem->Attributes.Physical.Maximum); + } +} -- cgit v1.2.3