diff options
author | Christian Gmeiner <christian.gmeiner@gmail.com> | 2007-10-28 14:02:51 +0000 |
---|---|---|
committer | Christian Gmeiner <christian.gmeiner@gmail.com> | 2007-10-28 14:02:51 +0000 |
commit | fec406c7a29f015c7fe1ded881e565a73b1e0d09 (patch) | |
tree | 7fc78bbabd16e0220152b9be07107bbaf2512ce7 /firmware/export/usb_ch9.h | |
parent | b77893e4d5636008ceee56929c7477f7dd064ca9 (diff) | |
download | rockbox-fec406c7a29f015c7fe1ded881e565a73b1e0d09.tar.gz rockbox-fec406c7a29f015c7fe1ded881e565a73b1e0d09.zip |
add some informations about this file
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@15344 a1c6a512-1295-4272-9138-f99709370657
Diffstat (limited to 'firmware/export/usb_ch9.h')
-rw-r--r-- | firmware/export/usb_ch9.h | 27 |
1 files changed, 27 insertions, 0 deletions
diff --git a/firmware/export/usb_ch9.h b/firmware/export/usb_ch9.h index a40bc4e4ae..b8fe181158 100644 --- a/firmware/export/usb_ch9.h +++ b/firmware/export/usb_ch9.h | |||
@@ -21,6 +21,33 @@ | |||
21 | * | 21 | * |
22 | ****************************************************************************/ | 22 | ****************************************************************************/ |
23 | 23 | ||
24 | /* | ||
25 | * This file holds USB constants and structures that are needed for | ||
26 | * USB device APIs. These are used by the USB device model, which is | ||
27 | * defined in chapter 9 of the USB 2.0 specification and in the | ||
28 | * Wireless USB 1.0 (spread around). | ||
29 | * | ||
30 | * USB 2.0 adds an additional "On The Go" (OTG) mode, which lets systems | ||
31 | * act either as a USB master/host or as a USB slave/device. That means | ||
32 | * the master and slave side APIs benefit from working well together. | ||
33 | * | ||
34 | * There's also "Wireless USB", using low power short range radios for | ||
35 | * peripheral interconnection but otherwise building on the USB framework. | ||
36 | * | ||
37 | * Note all descriptors are declared '__attribute__((packed))' so that: | ||
38 | * | ||
39 | * [a] they never get padded, either internally (USB spec writers | ||
40 | * probably handled that) or externally; | ||
41 | * | ||
42 | * [b] so that accessing bigger-than-a-bytes fields will never | ||
43 | * generate bus errors on any platform, even when the location of | ||
44 | * its descriptor inside a bundle isn't "naturally aligned", and | ||
45 | * | ||
46 | * [c] for consistency, removing all doubt even when it appears to | ||
47 | * someone that the two other points are non-issues for that | ||
48 | * particular descriptor type. | ||
49 | */ | ||
50 | |||
24 | #ifndef _CH9_H_ | 51 | #ifndef _CH9_H_ |
25 | #define _CH9_H_ | 52 | #define _CH9_H_ |
26 | 53 | ||