Changeset f1fae414 in mainline for uspace/drv/bus/usb/usbhid/subdrivers.h

Timestamp:

2011-06-22T01:34:53Z (13 years ago)

Author:

Petr Koupy <petr.koupy@…>

Branches:

lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export

Children:

8d7e82c1, cac458f

Parents:

72ec8cc (diff), bf172825 (diff)
Note: this is a merge changeset, the changes displayed below correspond to the merge itself.
Use the (diff) links above to see all the changes relative to each parent.

Message:

Merge mainline changes.

File:

• uspace/drv/bus/usb/usbhid/subdrivers.h (moved) (moved from uspace/drv/usbhid/subdrivers.h ) (1 diff)

uspace/drv/bus/usb/usbhid/subdrivers.h

@@ -49 +49 @@
 /*----------------------------------------------------------------------------*/
 
-/* TODO: This mapping must contain some other information to get the proper
- *       interface.
+/** Structure representing the mapping between device requirements and the 
+ *  subdriver supposed to handle this device.
+ *
+ * By filling in this structure and adding it to the usb_hid_subdrivers array,
+ * a new subdriver mapping will be created and used by the HID driver when it
+ * searches for appropriate subdrivers for a device.
  */
 typedef struct usb_hid_subdriver_mapping {
+        /** Usage path that the device's Input reports must contain. 
+         *
+         * It is an array of pairs <usage_page, usage>, terminated by a <0, 0>
+         * pair. If you do not wish to specify the device in this way, set this
+         * to NULL.
+         */
         const usb_hid_subdriver_usage_t *usage_path;
+        
+        /** Report ID for which the path should apply. */
         int report_id;
+        
+        /** Compare type for the Usage path. */
         int compare;
+        
+        /** Vendor ID (set to -1 if not specified). */
         int vendor_id;
+        
+        /** Product ID (set to -1 if not specified). */
         int product_id;
+        
+        /** Subdriver for controlling this device. */
         usb_hid_subdriver_t subdriver;
 } usb_hid_subdriver_mapping_t;