Samuel Mokrani
USBDevice stack
Dependents: erg USBSerial_HelloWorld Slingshot SuperScanner ... more
USBDevice/USBDescriptor.h@0:140cdf8e2d60, 2012-05-30 (annotated)
- Committer:
- samux
- Date:
- Wed May 30 18:28:11 2012 +0000
- Revision:
- 0:140cdf8e2d60
Who changed what in which revision?
| User | Revision | Line number | New contents of line |
|---|---|---|---|
| samux | 0:140cdf8e2d60 | 1 | /* Copyright (c) 2010-2011 mbed.org, MIT License |
| samux | 0:140cdf8e2d60 | 2 | * |
| samux | 0:140cdf8e2d60 | 3 | * Permission is hereby granted, free of charge, to any person obtaining a copy of this software |
| samux | 0:140cdf8e2d60 | 4 | * and associated documentation files (the "Software"), to deal in the Software without |
| samux | 0:140cdf8e2d60 | 5 | * restriction, including without limitation the rights to use, copy, modify, merge, publish, |
| samux | 0:140cdf8e2d60 | 6 | * distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the |
| samux | 0:140cdf8e2d60 | 7 | * Software is furnished to do so, subject to the following conditions: |
| samux | 0:140cdf8e2d60 | 8 | * |
| samux | 0:140cdf8e2d60 | 9 | * The above copyright notice and this permission notice shall be included in all copies or |
| samux | 0:140cdf8e2d60 | 10 | * substantial portions of the Software. |
| samux | 0:140cdf8e2d60 | 11 | * |
| samux | 0:140cdf8e2d60 | 12 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING |
| samux | 0:140cdf8e2d60 | 13 | * BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND |
| samux | 0:140cdf8e2d60 | 14 | * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, |
| samux | 0:140cdf8e2d60 | 15 | * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
| samux | 0:140cdf8e2d60 | 16 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| samux | 0:140cdf8e2d60 | 17 | */ |
| samux | 0:140cdf8e2d60 | 18 | |
| samux | 0:140cdf8e2d60 | 19 | /* Standard descriptor types */ |
| samux | 0:140cdf8e2d60 | 20 | #define DEVICE_DESCRIPTOR (1) |
| samux | 0:140cdf8e2d60 | 21 | #define CONFIGURATION_DESCRIPTOR (2) |
| samux | 0:140cdf8e2d60 | 22 | #define STRING_DESCRIPTOR (3) |
| samux | 0:140cdf8e2d60 | 23 | #define INTERFACE_DESCRIPTOR (4) |
| samux | 0:140cdf8e2d60 | 24 | #define ENDPOINT_DESCRIPTOR (5) |
| samux | 0:140cdf8e2d60 | 25 | #define QUALIFIER_DESCRIPTOR (6) |
| samux | 0:140cdf8e2d60 | 26 | |
| samux | 0:140cdf8e2d60 | 27 | /* Standard descriptor lengths */ |
| samux | 0:140cdf8e2d60 | 28 | #define DEVICE_DESCRIPTOR_LENGTH (0x12) |
| samux | 0:140cdf8e2d60 | 29 | #define CONFIGURATION_DESCRIPTOR_LENGTH (0x09) |
| samux | 0:140cdf8e2d60 | 30 | #define INTERFACE_DESCRIPTOR_LENGTH (0x09) |
| samux | 0:140cdf8e2d60 | 31 | #define ENDPOINT_DESCRIPTOR_LENGTH (0x07) |
| samux | 0:140cdf8e2d60 | 32 | |
| samux | 0:140cdf8e2d60 | 33 | |
| samux | 0:140cdf8e2d60 | 34 | /*string offset*/ |
| samux | 0:140cdf8e2d60 | 35 | #define STRING_OFFSET_LANGID (0) |
| samux | 0:140cdf8e2d60 | 36 | #define STRING_OFFSET_IMANUFACTURER (1) |
| samux | 0:140cdf8e2d60 | 37 | #define STRING_OFFSET_IPRODUCT (2) |
| samux | 0:140cdf8e2d60 | 38 | #define STRING_OFFSET_ISERIAL (3) |
| samux | 0:140cdf8e2d60 | 39 | #define STRING_OFFSET_ICONFIGURATION (4) |
| samux | 0:140cdf8e2d60 | 40 | #define STRING_OFFSET_IINTERFACE (5) |
| samux | 0:140cdf8e2d60 | 41 | |
| samux | 0:140cdf8e2d60 | 42 | /* USB Specification Release Number */ |
| samux | 0:140cdf8e2d60 | 43 | #define USB_VERSION_2_0 (0x0200) |
| samux | 0:140cdf8e2d60 | 44 | |
| samux | 0:140cdf8e2d60 | 45 | /* Least/Most significant byte of short integer */ |
| samux | 0:140cdf8e2d60 | 46 | #define LSB(n) ((n)&0xff) |
| samux | 0:140cdf8e2d60 | 47 | #define MSB(n) (((n)&0xff00)>>8) |
| samux | 0:140cdf8e2d60 | 48 | |
| samux | 0:140cdf8e2d60 | 49 | /* Convert physical endpoint number to descriptor endpoint number */ |
| samux | 0:140cdf8e2d60 | 50 | #define PHY_TO_DESC(endpoint) (((endpoint)>>1) | (((endpoint) & 1) ? 0x80:0)) |
| samux | 0:140cdf8e2d60 | 51 | |
| samux | 0:140cdf8e2d60 | 52 | /* bmAttributes in configuration descriptor */ |
| samux | 0:140cdf8e2d60 | 53 | /* C_RESERVED must always be set */ |
| samux | 0:140cdf8e2d60 | 54 | #define C_RESERVED (1U<<7) |
| samux | 0:140cdf8e2d60 | 55 | #define C_SELF_POWERED (1U<<6) |
| samux | 0:140cdf8e2d60 | 56 | #define C_REMOTE_WAKEUP (1U<<5) |
| samux | 0:140cdf8e2d60 | 57 | |
| samux | 0:140cdf8e2d60 | 58 | /* bMaxPower in configuration descriptor */ |
| samux | 0:140cdf8e2d60 | 59 | #define C_POWER(mA) ((mA)/2) |
| samux | 0:140cdf8e2d60 | 60 | |
| samux | 0:140cdf8e2d60 | 61 | /* bmAttributes in endpoint descriptor */ |
| samux | 0:140cdf8e2d60 | 62 | #define E_CONTROL (0x00) |
| samux | 0:140cdf8e2d60 | 63 | #define E_ISOCHRONOUS (0x01) |
| samux | 0:140cdf8e2d60 | 64 | #define E_BULK (0x02) |
| samux | 0:140cdf8e2d60 | 65 | #define E_INTERRUPT (0x03) |
| samux | 0:140cdf8e2d60 | 66 | |
| samux | 0:140cdf8e2d60 | 67 | /* For isochronous endpoints only: */ |
| samux | 0:140cdf8e2d60 | 68 | #define E_NO_SYNCHRONIZATION (0x00) |
| samux | 0:140cdf8e2d60 | 69 | #define E_ASYNCHRONOUS (0x04) |
| samux | 0:140cdf8e2d60 | 70 | #define E_ADAPTIVE (0x08) |
| samux | 0:140cdf8e2d60 | 71 | #define E_SYNCHRONOUS (0x0C) |
| samux | 0:140cdf8e2d60 | 72 | #define E_DATA (0x00) |
| samux | 0:140cdf8e2d60 | 73 | #define E_FEEDBACK (0x10) |
| samux | 0:140cdf8e2d60 | 74 | #define E_IMPLICIT_FEEDBACK (0x20) |