| blob | fdad360e96de2d18a5164481e8f02b281eb42875 |
1 Intel Wireless WiFi Link 5000AGN Adapter Series\r
2 Copyright (C) 2006 - 2008 Intel Corporation. All rights reserved.\r
3 \r
4 Microcode Package README.iwlwifi-5000-ucode\r
5 \r
6 INDEX\r
7 \r
8 1. OVERVIEW\r
9 2. INSTALLATION\r
10 3. LICENSE\r
11 \r
12 \r
13 1. OVERVIEW\r
14 \r
15 The file iwlwifi-5000-1.ucode provided in this package must be \r
16 present on your system in order for the Intel Wireless WiFi Link\r
17 5000AGN driver for Linux (iwlwifi-5000) to operate on your system.\r
18 \r
19 The "-1" in the filename reflects an interface/architecture version number.\r
20 It will change only when changes in new uCode releases make the new uCode\r
21 incompatible with earlier drivers.\r
22 \r
23 On adapter initialization, and at varying times during the uptime of \r
24 the adapter, the microcode is loaded into the memory on the network \r
25 adapter. The microcode provides the low level MAC features including \r
26 radio control and high precision timing events (backoff, transmit, \r
27 etc.) while also providing varying levels of packet filtering which can \r
28 be used to keep the host from having to handle packets that are not of \r
29 interest given the current operating mode of the device.\r
30 \r
31 2. INSTALLATION\r
32 \r
33 The iwl5000 driver will look for the file iwlwifi-5000-1.ucode using the \r
34 kernel's firmware_loader infrastructure. In order to function \r
35 correctly, you need to have this support enabled in your kernel. When \r
36 you configure the kernel, you can find this option in the following \r
37 location:\r
38 \r
39 Device Drivers ->\r
40 Generic Driver Options ->\r
41 Hotplug firmware loading support\r
42 \r
43 \r
44 You can determine if your kernel currently has firmware loader support \r
45 by looking for the CONFIG_FW_LOADER definition on your kernel's \r
46 .config.\r
47 \r
48 In addition to having the firmware_loader support in your kernel, you \r
49 must also have a working hotplug and udev infrastructure configured. \r
50 The steps for installing and configuring hotplug and udev are very \r
51 distribution specific. \r
52 \r
53 Once you have the firmware loader in place (or if you aren't sure and \r
54 you just want to try things to see if it works), you need to install \r
55 the microcode file into the appropriate location.\r
56 \r
57 Where that appropriate location is depends (again) on your system \r
58 distribution. You can typically find this location by looking in the \r
59 hotplug configuration file for your distro:\r
60 \r
61 % grep \"^FIRMWARE_DIR\" /etc/hotplug/firmware.agent\r
62 \r
63 This should give you output like:\r
64 \r
65 FIRMWARE_DIR=/lib/firmware\r
66 \r
67 If it lists more than one directory, you only need to put the \r
68 microcode in one of them. In the above example, installation is \r
69 simply:\r
70 \r
71 % cp iwlwifi-5000-3x3-1.ucode /lib/firmware\r
72 \r
73 You can now load the driver (see the INSTALL and README.iwlwifi provided with\r
74 the iwlwifi package for information on building and using that driver.)\r
75 \r
76 3. LICENSE\r
77 \r
78 The microcode in this package (iwlwifi-5000-1.ucode) is provided under the \r
79 terms of the following license (available in the file \r
80 LICENSE.iwlwifi-5000-ucode):\r
81 \r
82 Copyright (c) 2006-2008, Intel Corporation.\r
83 All rights reserved.\r
84 \r
85 Redistribution. Redistribution and use in binary form, without \r
86 modification, are permitted provided that the following conditions are \r
87 met:\r
88 \r
89 * Redistributions must reproduce the above copyright notice and the \r
90 following disclaimer in the documentation and/or other materials \r
91 provided with the distribution. \r
92 * Neither the name of Intel Corporation nor the names of its suppliers \r
93 may be used to endorse or promote products derived from this software \r
94 without specific prior written permission. \r
95 * No reverse engineering, decompilation, or disassembly of this software \r
96 is permitted.\r
97 \r
98 Limited patent license. Intel Corporation grants a world-wide, \r
99 royalty-free, non-exclusive license under patents it now or hereafter \r
100 owns or controls to make, have made, use, import, offer to sell and \r
101 sell ("Utilize") this software, but solely to the extent that any \r
102 such patent is necessary to Utilize the software alone, or in \r
103 combination with an operating system licensed under an approved Open \r
104 Source license as listed by the Open Source Initiative at \r
105 http://opensource.org/licenses. The patent license shall not apply to \r
106 any other combinations which include this software. No hardware per \r
107 se is licensed hereunder.\r
108 \r
109 DISCLAIMER. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND \r
110 CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, \r
111 BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND \r
112 FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE \r
113 COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, \r
114 INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, \r
115 BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS \r
116 OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND \r
117 ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR \r
118 TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE \r
119 USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH \r
120 DAMAGE.\r