← Back to branch summary

~ubuntu-branches/debian/wheezy/linux-2.6/wheezy

« back to all changes in this revision

Viewing changes to Documentation/usb/linux.inf

  • Committer: Bazaar Package Importer
  • Author(s): Ben Hutchings, Ben Hutchings, Aurelien Jarno, Martin Michlmayr
  • Date: 2011-04-06 13:53:30 UTC
  • mfrom: (43.1.5 sid)
  • Revision ID: james.westby@ubuntu.com-20110406135330-wjufxhd0tvn3zx4z
Tags: 2.6.38-3
http://bugs.debian.org/620124
http://bugs.debian.org/620284
http://bugs.debian.org/620204
[ Ben Hutchings ]
* [ppc64] Add to linux-tools package architectures (Closes: #620124)
* [amd64] Save cr4 to mmu_cr4_features at boot time (Closes: #620284)
* appletalk: Fix bugs introduced when removing use of BKL
* ALSA: Fix yet another race in disconnection
* cciss: Fix lost command issue
* ath9k: Fix kernel panic in AR2427
* ses: Avoid kernel panic when lun 0 is not mapped
* PCI/ACPI: Report ASPM support to BIOS if not disabled from command line

[ Aurelien Jarno ]
* rtlwifi: fix build when PCI is not enabled.

[ Martin Michlmayr ]
* rtlwifi: Eliminate udelay calls with too large values (Closes: #620204)

Show diffs side-by-side

added added

removed removed

Lines of Context:
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
 
 
 
1
; Based on template INF file found at
 
2
;    <http://msdn.microsoft.com/en-us/library/ff570620.aspx>
 
3
; which was:
 
4
;    Copyright (c) Microsoft Corporation
 
5
; and released under the MLPL as found at:
 
6
;    <http://msdn.microsoft.com/en-us/cc300389.aspx#MLPL>.
 
7
; For use only on Windows operating systems.
14
8
 
15
9
[Version]
16
 
Signature           = "$CHICAGO$"
 
10
Signature           = "$Windows NT$"
17
11
Class               = Net
18
12
ClassGUID           = {4d36e972-e325-11ce-bfc1-08002be10318}
19
13
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
 
14
DriverVer           = 06/21/2006,6.0.6000.16384
25
15
 
26
16
[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
 
 
 
17
%Linux%             = LinuxDevices,NTx86,NTamd64,NTia64
 
18
 
 
19
; Decoration for x86 architecture
 
20
[LinuxDevices.NTx86]
 
21
%LinuxDevice%       = RNDIS.NT.5.1, USB\VID_0525&PID_a4a2, USB\VID_0525&PID_a4ab&MI_00
 
22
 
 
23
; Decoration for x64 architecture
 
24
[LinuxDevices.NTamd64]
 
25
%LinuxDevice%       = RNDIS.NT.5.1, USB\VID_0525&PID_a4a2, USB\VID_0525&PID_a4ab&MI_00
 
26
 
 
27
; Decoration for ia64 architecture
 
28
[LinuxDevices.NTia64]
 
29
%LinuxDevice%       = RNDIS.NT.5.1, USB\VID_0525&PID_a4a2, USB\VID_0525&PID_a4ab&MI_00
 
30
 
 
31
;@@@ This is the common setting for setup
36
32
[ControlFlags]
37
33
ExcludeFromSelect=*
38
34
 
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
 
 
 
35
; DDInstall section
 
36
; References the in-build Netrndis.inf
132
37
[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
 
38
Characteristics     = 0x84   ; NCF_PHYSICAL + NCF_HAS_UI
 
39
BusType             = 15
 
40
; NEVER REMOVE THE FOLLOWING REFERENCE FOR NETRNDIS.INF
 
41
include             = netrndis.inf
 
42
needs               = Usb_Rndis.ndi
 
43
AddReg              = Rndis_AddReg_Vista
138
44
 
 
45
; DDInstal.Services section
139
46
[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
 
47
include             = netrndis.inf
 
48
needs               = Usb_Rndis.ndi.Services
 
49
 
 
50
; Optional registry settings. You can modify as needed.
 
51
[RNDIS_AddReg_Vista]
 
52
HKR, NDI\params\VistaProperty, ParamDesc,  0, %Vista_Property%
 
53
HKR, NDI\params\VistaProperty, type,       0, "edit"
 
54
HKR, NDI\params\VistaProperty, LimitText,  0, "12"
 
55
HKR, NDI\params\VistaProperty, UpperCase,  0, "1"
 
56
HKR, NDI\params\VistaProperty, default,    0, " "
 
57
HKR, NDI\params\VistaProperty, optional,   0, "1"
 
58
 
 
59
; No sys copyfiles - the sys files are already in-build
 
60
; (part of the operating system).
 
61
; We do not support XP SP1-, 2003 SP1-, ME, 9x.
193
62
 
194
63
[Strings]
195
 
ServiceDisplayName    = "USB Remote NDIS Network Device Driver"
196
 
NetworkAddress        = "Network Address"
197
64
Linux                 = "Linux Developer Community"
198
65
LinuxDevice           = "Linux USB Ethernet/RNDIS Gadget"
199
 
SourceDisk            = "Ethernet/RNDIS Gadget Driver Install Disk"
200
 
 
 
66
Vista_Property        = "Optional Vista Property"