page-types: add GPL note
[linux-2.6.git] / Documentation / usb / linux.inf
1 ; MS-Windows driver config matching some basic modes of the
2 ; Linux-USB Ethernet/RNDIS gadget firmware:
3 ;
4 ;  - RNDIS plus CDC Ethernet ... this may be familiar as a DOCSIS
5 ;    cable modem profile, and supports most non-Microsoft USB hosts
6 ;
7 ;  - RNDIS plus CDC Subset ... used by hardware that incapable of
8 ;    full CDC Ethernet support.
9 ;
10 ; Microsoft only directly supports RNDIS drivers, and bundled them into XP.
11 ; The Microsoft "Remote NDIS USB Driver Kit" is currently found at:
12 ;   http://www.microsoft.com/whdc/hwdev/resources/HWservices/rndis.mspx
13
14
15 [Version]
16 Signature           = "$CHICAGO$"
17 Class               = Net
18 ClassGUID           = {4d36e972-e325-11ce-bfc1-08002be10318}
19 Provider            = %Linux%
20 Compatible          = 1
21 MillenniumPreferred = .ME
22 DriverVer           = 03/30/2004,0.0.0.0
23 ; catalog file would be used by WHQL
24 ;CatalogFile         = Linux.cat
25
26 [Manufacturer]
27 %Linux%          = LinuxDevices,NT.5.1
28
29 [LinuxDevices]
30 ; NetChip IDs, used by both firmware modes
31 %LinuxDevice%    = RNDIS, USB\VID_0525&PID_a4a2
32
33 [LinuxDevices.NT.5.1]
34 %LinuxDevice%    = RNDIS.NT.5.1, USB\VID_0525&PID_a4a2
35
36 [ControlFlags]
37 ExcludeFromSelect=*
38
39 ; Windows 98, Windows 98 Second Edition specific sections --------
40
41 [RNDIS]
42 DeviceID        = usb8023
43 MaxInstance     = 512
44 DriverVer           = 03/30/2004,0.0.0.0
45 AddReg          = RNDIS_AddReg_98, RNDIS_AddReg_Common
46
47 [RNDIS_AddReg_98]
48 HKR, ,               DevLoader,        0, *ndis
49 HKR, ,               DeviceVxDs,       0, usb8023.sys
50 HKR, NDIS,           LogDriverName,    0, "usb8023"
51 HKR, NDIS,           MajorNdisVersion, 1, 5
52 HKR, NDIS,           MinorNdisVersion, 1, 0
53 HKR, Ndi\Interfaces, DefUpper,         0, "ndis3,ndis4,ndis5"
54 HKR, Ndi\Interfaces, DefLower,         0, "ethernet"
55 HKR, Ndi\Interfaces, UpperRange,       0, "ndis3,ndis4,ndis5"
56 HKR, Ndi\Interfaces, LowerRange,       0, "ethernet"
57 HKR, Ndi\Install,    ndis3,            0, "RNDIS_Install_98"
58 HKR, Ndi\Install,    ndis4,            0, "RNDIS_Install_98"
59 HKR, Ndi\Install,    ndis5,            0, "RNDIS_Install_98"
60 HKR, Ndi,            DeviceId,         0, "USB\VID_0525&PID_a4a2"
61
62 [RNDIS_Install_98]
63 CopyFiles=RNDIS_CopyFiles_98
64
65 [RNDIS_CopyFiles_98]
66 usb8023.sys, usb8023w.sys, , 0 
67 rndismp.sys, rndismpw.sys, , 0 
68
69 ; Windows Millennium Edition specific sections --------------------
70
71 [RNDIS.ME]
72 DeviceID        = usb8023
73 MaxInstance     = 512
74 DriverVer           = 03/30/2004,0.0.0.0
75 AddReg          = RNDIS_AddReg_ME, RNDIS_AddReg_Common
76 Characteristics = 0x84   ; NCF_PHYSICAL + NCF_HAS_UI
77 BusType         = 15
78
79 [RNDIS_AddReg_ME]
80 HKR, ,               DevLoader,        0, *ndis
81 HKR, ,               DeviceVxDs,       0, usb8023.sys
82 HKR, NDIS,           LogDriverName,    0, "usb8023"
83 HKR, NDIS,           MajorNdisVersion, 1, 5
84 HKR, NDIS,           MinorNdisVersion, 1, 0
85 HKR, Ndi\Interfaces, DefUpper,         0, "ndis3,ndis4,ndis5"
86 HKR, Ndi\Interfaces, DefLower,         0, "ethernet"
87 HKR, Ndi\Interfaces, UpperRange,       0, "ndis3,ndis4,ndis5"
88 HKR, Ndi\Interfaces, LowerRange,       0, "ethernet"
89 HKR, Ndi\Install,    ndis3,            0, "RNDIS_Install_ME"
90 HKR, Ndi\Install,    ndis4,            0, "RNDIS_Install_ME"
91 HKR, Ndi\Install,    ndis5,            0, "RNDIS_Install_ME"
92 HKR, Ndi,            DeviceId,         0, "USB\VID_0525&PID_a4a2"
93
94 [RNDIS_Install_ME]
95 CopyFiles=RNDIS_CopyFiles_ME
96
97 [RNDIS_CopyFiles_ME]
98 usb8023.sys, usb8023m.sys, , 0 
99 rndismp.sys, rndismpm.sys, , 0 
100
101 ; Windows 2000 specific sections ---------------------------------
102
103 [RNDIS.NT]
104 Characteristics = 0x84   ; NCF_PHYSICAL + NCF_HAS_UI
105 BusType         = 15
106 DriverVer           = 03/30/2004,0.0.0.0
107 AddReg          = RNDIS_AddReg_NT, RNDIS_AddReg_Common
108 CopyFiles       = RNDIS_CopyFiles_NT
109
110 [RNDIS.NT.Services]
111 AddService = USB_RNDIS, 2, RNDIS_ServiceInst_NT, RNDIS_EventLog
112
113 [RNDIS_CopyFiles_NT]
114 ; no rename of files on Windows 2000, use the 'k' names as is
115 usb8023k.sys, , , 0 
116 rndismpk.sys, , , 0 
117
118 [RNDIS_ServiceInst_NT]
119 DisplayName     = %ServiceDisplayName%
120 ServiceType     = 1 
121 StartType       = 3 
122 ErrorControl    = 1 
123 ServiceBinary   = %12%\usb8023k.sys    
124 LoadOrderGroup  = NDIS
125 AddReg          = RNDIS_WMI_AddReg_NT
126
127 [RNDIS_WMI_AddReg_NT]
128 HKR, , MofImagePath, 0x00020000, "System32\drivers\rndismpk.sys"
129
130 ; Windows XP specific sections -----------------------------------
131
132 [RNDIS.NT.5.1]
133 Characteristics = 0x84   ; NCF_PHYSICAL + NCF_HAS_UI
134 BusType         = 15
135 DriverVer           = 03/30/2004,0.0.0.0
136 AddReg          = RNDIS_AddReg_NT, RNDIS_AddReg_Common
137 ; no copyfiles - the files are already in place
138
139 [RNDIS.NT.5.1.Services]
140 AddService      = USB_RNDIS, 2, RNDIS_ServiceInst_51, RNDIS_EventLog
141
142 [RNDIS_ServiceInst_51]
143 DisplayName     = %ServiceDisplayName%
144 ServiceType     = 1 
145 StartType       = 3 
146 ErrorControl    = 1 
147 ServiceBinary   = %12%\usb8023.sys    
148 LoadOrderGroup  = NDIS
149 AddReg          = RNDIS_WMI_AddReg_51
150
151 [RNDIS_WMI_AddReg_51]
152 HKR, , MofImagePath, 0x00020000, "System32\drivers\rndismp.sys"
153
154 ; Windows 2000 and Windows XP common sections --------------------
155
156 [RNDIS_AddReg_NT]
157 HKR, Ndi,               Service,        0, "USB_RNDIS"
158 HKR, Ndi\Interfaces,    UpperRange,     0, "ndis5" 
159 HKR, Ndi\Interfaces,    LowerRange,     0, "ethernet"
160
161 [RNDIS_EventLog]
162 AddReg = RNDIS_EventLog_AddReg
163
164 [RNDIS_EventLog_AddReg]
165 HKR, , EventMessageFile, 0x00020000, "%%SystemRoot%%\System32\netevent.dll"
166 HKR, , TypesSupported,   0x00010001, 7
167
168 ; Common Sections -------------------------------------------------
169
170 [RNDIS_AddReg_Common]
171 HKR, NDI\params\NetworkAddress, ParamDesc,  0, %NetworkAddress%
172 HKR, NDI\params\NetworkAddress, type,       0, "edit"
173 HKR, NDI\params\NetworkAddress, LimitText,  0, "12"
174 HKR, NDI\params\NetworkAddress, UpperCase,  0, "1"
175 HKR, NDI\params\NetworkAddress, default,    0, " "
176 HKR, NDI\params\NetworkAddress, optional,   0, "1"
177
178 [SourceDisksNames]
179 1=%SourceDisk%,,1
180
181 [SourceDisksFiles]
182 usb8023m.sys=1
183 rndismpm.sys=1
184 usb8023w.sys=1
185 rndismpw.sys=1
186 usb8023k.sys=1
187 rndismpk.sys=1
188
189 [DestinationDirs]
190 RNDIS_CopyFiles_98    = 10, system32/drivers
191 RNDIS_CopyFiles_ME    = 10, system32/drivers
192 RNDIS_CopyFiles_NT    = 12
193
194 [Strings]
195 ServiceDisplayName    = "USB Remote NDIS Network Device Driver"
196 NetworkAddress        = "Network Address"
197 Linux                 = "Linux Developer Community"
198 LinuxDevice           = "Linux USB Ethernet/RNDIS Gadget"
199 SourceDisk            = "Ethernet/RNDIS Gadget Driver Install Disk"
200