|
1 /* |
|
2 * Copyright (c) 2003-2009 Nokia Corporation and/or its subsidiary(-ies). |
|
3 * All rights reserved. |
|
4 * This component and the accompanying materials are made available |
|
5 * under the terms of "Eclipse Public License v1.0" |
|
6 * which accompanies this distribution, and is available |
|
7 * at the URL "http://www.eclipse.org/legal/epl-v10.html". |
|
8 * |
|
9 * Initial Contributors: |
|
10 * Nokia Corporation - initial contribution. |
|
11 * |
|
12 * Contributors: |
|
13 * |
|
14 * Description: |
|
15 * Resource header for usbman configuration. |
|
16 * |
|
17 */ |
|
18 |
|
19 /** |
|
20 @file |
|
21 @publishedPartner |
|
22 @released |
|
23 */ |
|
24 |
|
25 STRUCT usb_configuration |
|
26 { |
|
27 /** |
|
28 vendorId is the 16-bit number that is assigned by USB-ORG. |
|
29 */ |
|
30 WORD vendorId = 0x0e22; |
|
31 |
|
32 /** |
|
33 productId is a 16-bit number that is assigned by the licensee to |
|
34 uniquely identify this particular type of device. |
|
35 */ |
|
36 WORD productId = 0x000b; |
|
37 |
|
38 /** |
|
39 bcdDevice may be optionally used during enumeration, this depends on |
|
40 the licensee's policy regarding device upgrades (new versions of a |
|
41 device may require to use new host driver files) |
|
42 */ |
|
43 WORD bcdDevice = 0x0000; |
|
44 |
|
45 /** |
|
46 manufacturerString is displayed on the Windows screen during first |
|
47 enumeration of the device, and should identify the same company that |
|
48 owns the USB vendorId given above |
|
49 */ |
|
50 LTEXT manufacturer = "Symbian Ltd."; |
|
51 |
|
52 /** |
|
53 productString is displayed on the Windows screen during first |
|
54 enumeration of the device, and should identify the same device that is |
|
55 implied by the productId given above |
|
56 */ |
|
57 LTEXT product = "Symbian OS"; |
|
58 } |
|
59 |
|
60 STRUCT PERSONALITY |
|
61 { |
|
62 /** Class code (assigned by the USB-IF). If this field is set to zero, each interface within |
|
63 a configuration specifies its own class information and the various interfaces operate independently. |
|
64 |
|
65 If this field is set to a value between 1 and FEH, the device supports different class |
|
66 specifications on different interfaces and the interfaces may not operate independently. |
|
67 This value identifies the class definition used for the aggregate interfaces. |
|
68 |
|
69 If this field is set to FFH, the device class is vendor-specific. */ |
|
70 BYTE bDeviceClass; |
|
71 |
|
72 /** Subclass code (assigned by the USB-IF). These codes are qualified by the value of the bDeviceClass field. |
|
73 If the bDeviceClass field is set to zero, this field must also be set to zero. |
|
74 If the bDeviceClass field is not set to FFH, all values are reserved for assignment by the USB-IF. */ |
|
75 BYTE bDeviceSubClass; |
|
76 |
|
77 /** Protocol code (assigned by the USB-IF). These codes are qualified by the value of the bDeviceClass and the |
|
78 bDeviceSubClass fields. If a device supports class-specific protocols on a device basis as opposed to an |
|
79 interface basis, this code identifies the protocols that the device uses as defined by the specification of the device class. |
|
80 If this field is set to zero, the device does not use class-specific protocols on a device basis. However, it may use |
|
81 classspecific protocols on an interface basis. |
|
82 If this field is set to FFH, the device uses a vendor-specific protocol on a device basis. */ |
|
83 BYTE protocol; |
|
84 |
|
85 /** Number of possible configurations */ |
|
86 BYTE numConfigurations; |
|
87 |
|
88 /** vendorId is the 16-bit number that is assigned by USB-ORG. */ |
|
89 WORD vendorId; |
|
90 |
|
91 /** productId is a 16-bit number that is assigned by the licensee to |
|
92 uniquely identify this particular personality as type of device . */ |
|
93 WORD productId; |
|
94 |
|
95 /** bcdDevice may be optionally used during enumeration, this depends on |
|
96 the licensee's policy regarding device upgrades */ |
|
97 WORD bcdDevice; |
|
98 |
|
99 /** manufacturerString is displayed on the Windows screen during first |
|
100 enumeration of the device, and should identify the same company that |
|
101 owns the USB vendorId given above */ |
|
102 LTEXT manufacturer; |
|
103 |
|
104 /** productString is displayed on the Windows screen during first |
|
105 enumeration of the device, and should identify the same device that is |
|
106 implied by the productId given above */ |
|
107 LTEXT product; |
|
108 |
|
109 /** personality id - UID which identified this personality */ |
|
110 WORD id; |
|
111 |
|
112 /** list of Class Controllers UIDs associated with this personality. |
|
113 UIDs shoud be provided as list of hexadecimal numbers separated by space or comma. |
|
114 Note Do not provide leading 0x or any trailing characters! |
|
115 Example "1Abc3422, 12345678 FE43bc33" |
|
116 Incorrect example "1abc3422, 0x12345678," */ |
|
117 LTEXT class_uids; |
|
118 |
|
119 /** free text description of this personality. */ |
|
120 LTEXT description; |
|
121 |
|
122 /** free text detailed description of this personality. */ |
|
123 LTEXT detailedDescription; |
|
124 |
|
125 /** personality property - the property of this personality */ |
|
126 LONG property; |
|
127 |
|
128 } |
|
129 |
|
130 STRUCT PERSONALITY_ARRAY |
|
131 { |
|
132 STRUCT personalities[]; // STRUCT PERSONALITY |
|
133 } |