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