Root/
1 | |
2 | Intel(R) PRO/Wireless 2100 Driver for Linux in support of: |
3 | |
4 | Intel(R) PRO/Wireless 2100 Network Connection |
5 | |
6 | Copyright (C) 2003-2006, Intel Corporation |
7 | |
8 | README.ipw2100 |
9 | |
10 | Version: git-1.1.5 |
11 | Date : January 25, 2006 |
12 | |
13 | Index |
14 | ----------------------------------------------- |
15 | 0. IMPORTANT INFORMATION BEFORE USING THIS DRIVER |
16 | 1. Introduction |
17 | 2. Release git-1.1.5 Current Features |
18 | 3. Command Line Parameters |
19 | 4. Sysfs Helper Files |
20 | 5. Radio Kill Switch |
21 | 6. Dynamic Firmware |
22 | 7. Power Management |
23 | 8. Support |
24 | 9. License |
25 | |
26 | |
27 | 0. IMPORTANT INFORMATION BEFORE USING THIS DRIVER |
28 | ----------------------------------------------- |
29 | |
30 | Important Notice FOR ALL USERS OR DISTRIBUTORS!!!! |
31 | |
32 | Intel wireless LAN adapters are engineered, manufactured, tested, and |
33 | quality checked to ensure that they meet all necessary local and |
34 | governmental regulatory agency requirements for the regions that they |
35 | are designated and/or marked to ship into. Since wireless LANs are |
36 | generally unlicensed devices that share spectrum with radars, |
37 | satellites, and other licensed and unlicensed devices, it is sometimes |
38 | necessary to dynamically detect, avoid, and limit usage to avoid |
39 | interference with these devices. In many instances Intel is required to |
40 | provide test data to prove regional and local compliance to regional and |
41 | governmental regulations before certification or approval to use the |
42 | product is granted. Intel's wireless LAN's EEPROM, firmware, and |
43 | software driver are designed to carefully control parameters that affect |
44 | radio operation and to ensure electromagnetic compliance (EMC). These |
45 | parameters include, without limitation, RF power, spectrum usage, |
46 | channel scanning, and human exposure. |
47 | |
48 | For these reasons Intel cannot permit any manipulation by third parties |
49 | of the software provided in binary format with the wireless WLAN |
50 | adapters (e.g., the EEPROM and firmware). Furthermore, if you use any |
51 | patches, utilities, or code with the Intel wireless LAN adapters that |
52 | have been manipulated by an unauthorized party (i.e., patches, |
53 | utilities, or code (including open source code modifications) which have |
54 | not been validated by Intel), (i) you will be solely responsible for |
55 | ensuring the regulatory compliance of the products, (ii) Intel will bear |
56 | no liability, under any theory of liability for any issues associated |
57 | with the modified products, including without limitation, claims under |
58 | the warranty and/or issues arising from regulatory non-compliance, and |
59 | (iii) Intel will not provide or be required to assist in providing |
60 | support to any third parties for such modified products. |
61 | |
62 | Note: Many regulatory agencies consider Wireless LAN adapters to be |
63 | modules, and accordingly, condition system-level regulatory approval |
64 | upon receipt and review of test data documenting that the antennas and |
65 | system configuration do not cause the EMC and radio operation to be |
66 | non-compliant. |
67 | |
68 | The drivers available for download from SourceForge are provided as a |
69 | part of a development project. Conformance to local regulatory |
70 | requirements is the responsibility of the individual developer. As |
71 | such, if you are interested in deploying or shipping a driver as part of |
72 | solution intended to be used for purposes other than development, please |
73 | obtain a tested driver from Intel Customer Support at: |
74 | |
75 | http://www.intel.com/support/wireless/sb/CS-006408.htm |
76 | |
77 | 1. Introduction |
78 | ----------------------------------------------- |
79 | |
80 | This document provides a brief overview of the features supported by the |
81 | IPW2100 driver project. The main project website, where the latest |
82 | development version of the driver can be found, is: |
83 | |
84 | http://ipw2100.sourceforge.net |
85 | |
86 | There you can find the not only the latest releases, but also information about |
87 | potential fixes and patches, as well as links to the development mailing list |
88 | for the driver project. |
89 | |
90 | |
91 | 2. Release git-1.1.5 Current Supported Features |
92 | ----------------------------------------------- |
93 | - Managed (BSS) and Ad-Hoc (IBSS) |
94 | - WEP (shared key and open) |
95 | - Wireless Tools support |
96 | - 802.1x (tested with XSupplicant 1.0.1) |
97 | |
98 | Enabled (but not supported) features: |
99 | - Monitor/RFMon mode |
100 | - WPA/WPA2 |
101 | |
102 | The distinction between officially supported and enabled is a reflection |
103 | on the amount of validation and interoperability testing that has been |
104 | performed on a given feature. |
105 | |
106 | |
107 | 3. Command Line Parameters |
108 | ----------------------------------------------- |
109 | |
110 | If the driver is built as a module, the following optional parameters are used |
111 | by entering them on the command line with the modprobe command using this |
112 | syntax: |
113 | |
114 | modprobe ipw2100 [<option>=<VAL1><,VAL2>...] |
115 | |
116 | For example, to disable the radio on driver loading, enter: |
117 | |
118 | modprobe ipw2100 disable=1 |
119 | |
120 | The ipw2100 driver supports the following module parameters: |
121 | |
122 | Name Value Example: |
123 | debug 0x0-0xffffffff debug=1024 |
124 | mode 0,1,2 mode=1 /* AdHoc */ |
125 | channel int channel=3 /* Only valid in AdHoc or Monitor */ |
126 | associate boolean associate=0 /* Do NOT auto associate */ |
127 | disable boolean disable=1 /* Do not power the HW */ |
128 | |
129 | |
130 | 4. Sysfs Helper Files |
131 | --------------------------- |
132 | ----------------------------------------------- |
133 | |
134 | There are several ways to control the behavior of the driver. Many of the |
135 | general capabilities are exposed through the Wireless Tools (iwconfig). There |
136 | are a few capabilities that are exposed through entries in the Linux Sysfs. |
137 | |
138 | |
139 | ----- Driver Level ------ |
140 | For the driver level files, look in /sys/bus/pci/drivers/ipw2100/ |
141 | |
142 | debug_level |
143 | |
144 | This controls the same global as the 'debug' module parameter. For |
145 | information on the various debugging levels available, run the 'dvals' |
146 | script found in the driver source directory. |
147 | |
148 | NOTE: 'debug_level' is only enabled if CONFIG_IPW2100_DEBUG is turn |
149 | on. |
150 | |
151 | ----- Device Level ------ |
152 | For the device level files look in |
153 | |
154 | /sys/bus/pci/drivers/ipw2100/{PCI-ID}/ |
155 | |
156 | For example: |
157 | /sys/bus/pci/drivers/ipw2100/0000:02:01.0 |
158 | |
159 | For the device level files, see /sys/bus/pci/drivers/ipw2100: |
160 | |
161 | rf_kill |
162 | read - |
163 | 0 = RF kill not enabled (radio on) |
164 | 1 = SW based RF kill active (radio off) |
165 | 2 = HW based RF kill active (radio off) |
166 | 3 = Both HW and SW RF kill active (radio off) |
167 | write - |
168 | 0 = If SW based RF kill active, turn the radio back on |
169 | 1 = If radio is on, activate SW based RF kill |
170 | |
171 | NOTE: If you enable the SW based RF kill and then toggle the HW |
172 | based RF kill from ON -> OFF -> ON, the radio will NOT come back on |
173 | |
174 | |
175 | 5. Radio Kill Switch |
176 | ----------------------------------------------- |
177 | Most laptops provide the ability for the user to physically disable the radio. |
178 | Some vendors have implemented this as a physical switch that requires no |
179 | software to turn the radio off and on. On other laptops, however, the switch |
180 | is controlled through a button being pressed and a software driver then making |
181 | calls to turn the radio off and on. This is referred to as a "software based |
182 | RF kill switch" |
183 | |
184 | See the Sysfs helper file 'rf_kill' for determining the state of the RF switch |
185 | on your system. |
186 | |
187 | |
188 | 6. Dynamic Firmware |
189 | ----------------------------------------------- |
190 | As the firmware is licensed under a restricted use license, it can not be |
191 | included within the kernel sources. To enable the IPW2100 you will need a |
192 | firmware image to load into the wireless NIC's processors. |
193 | |
194 | You can obtain these images from <http://ipw2100.sf.net/firmware.php>. |
195 | |
196 | See INSTALL for instructions on installing the firmware. |
197 | |
198 | |
199 | 7. Power Management |
200 | ----------------------------------------------- |
201 | The IPW2100 supports the configuration of the Power Save Protocol |
202 | through a private wireless extension interface. The IPW2100 supports |
203 | the following different modes: |
204 | |
205 | off No power management. Radio is always on. |
206 | on Automatic power management |
207 | 1-5 Different levels of power management. The higher the |
208 | number the greater the power savings, but with an impact to |
209 | packet latencies. |
210 | |
211 | Power management works by powering down the radio after a certain |
212 | interval of time has passed where no packets are passed through the |
213 | radio. Once powered down, the radio remains in that state for a given |
214 | period of time. For higher power savings, the interval between last |
215 | packet processed to sleep is shorter and the sleep period is longer. |
216 | |
217 | When the radio is asleep, the access point sending data to the station |
218 | must buffer packets at the AP until the station wakes up and requests |
219 | any buffered packets. If you have an AP that does not correctly support |
220 | the PSP protocol you may experience packet loss or very poor performance |
221 | while power management is enabled. If this is the case, you will need |
222 | to try and find a firmware update for your AP, or disable power |
223 | management (via `iwconfig eth1 power off`) |
224 | |
225 | To configure the power level on the IPW2100 you use a combination of |
226 | iwconfig and iwpriv. iwconfig is used to turn power management on, off, |
227 | and set it to auto. |
228 | |
229 | iwconfig eth1 power off Disables radio power down |
230 | iwconfig eth1 power on Enables radio power management to |
231 | last set level (defaults to AUTO) |
232 | iwpriv eth1 set_power 0 Sets power level to AUTO and enables |
233 | power management if not previously |
234 | enabled. |
235 | iwpriv eth1 set_power 1-5 Set the power level as specified, |
236 | enabling power management if not |
237 | previously enabled. |
238 | |
239 | You can view the current power level setting via: |
240 | |
241 | iwpriv eth1 get_power |
242 | |
243 | It will return the current period or timeout that is configured as a string |
244 | in the form of xxxx/yyyy (z) where xxxx is the timeout interval (amount of |
245 | time after packet processing), yyyy is the period to sleep (amount of time to |
246 | wait before powering the radio and querying the access point for buffered |
247 | packets), and z is the 'power level'. If power management is turned off the |
248 | xxxx/yyyy will be replaced with 'off' -- the level reported will be the active |
249 | level if `iwconfig eth1 power on` is invoked. |
250 | |
251 | |
252 | 8. Support |
253 | ----------------------------------------------- |
254 | |
255 | For general development information and support, |
256 | go to: |
257 | |
258 | http://ipw2100.sf.net/ |
259 | |
260 | The ipw2100 1.1.0 driver and firmware can be downloaded from: |
261 | |
262 | http://support.intel.com |
263 | |
264 | For installation support on the ipw2100 1.1.0 driver on Linux kernels |
265 | 2.6.8 or greater, email support is available from: |
266 | |
267 | http://supportmail.intel.com |
268 | |
269 | 9. License |
270 | ----------------------------------------------- |
271 | |
272 | Copyright(c) 2003 - 2006 Intel Corporation. All rights reserved. |
273 | |
274 | This program is free software; you can redistribute it and/or modify it |
275 | under the terms of the GNU General Public License (version 2) as |
276 | published by the Free Software Foundation. |
277 | |
278 | This program is distributed in the hope that it will be useful, but WITHOUT |
279 | ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
280 | FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for |
281 | more details. |
282 | |
283 | You should have received a copy of the GNU General Public License along with |
284 | this program; if not, write to the Free Software Foundation, Inc., 59 |
285 | Temple Place - Suite 330, Boston, MA 02111-1307, USA. |
286 | |
287 | The full GNU General Public License is included in this distribution in the |
288 | file called LICENSE. |
289 | |
290 | License Contact Information: |
291 | James P. Ketrenos <ipw2100-admin@linux.intel.com> |
292 | Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497 |
293 | |
294 |
Branches:
ben-wpan
ben-wpan-stefan
javiroman/ks7010
jz-2.6.34
jz-2.6.34-rc5
jz-2.6.34-rc6
jz-2.6.34-rc7
jz-2.6.35
jz-2.6.36
jz-2.6.37
jz-2.6.38
jz-2.6.39
jz-3.0
jz-3.1
jz-3.11
jz-3.12
jz-3.13
jz-3.15
jz-3.16
jz-3.18-dt
jz-3.2
jz-3.3
jz-3.4
jz-3.5
jz-3.6
jz-3.6-rc2-pwm
jz-3.9
jz-3.9-clk
jz-3.9-rc8
jz47xx
jz47xx-2.6.38
master
Tags:
od-2011-09-04
od-2011-09-18
v2.6.34-rc5
v2.6.34-rc6
v2.6.34-rc7
v3.9