xref: /netbsd-src/external/intel-fw-public/iwl7265/dist/README.iwlwifi-7265-ucode (revision f8baa4e97e8349e0c4cb9809d24d57ba562be0af)
1*f8baa4e9SnonakaIntel Wireless WiFi Link 7265 AC Adapter
2*f8baa4e9SnonakaCopyright (C) 2014 Intel Corporation.  All rights reserved.
3*f8baa4e9Snonaka
4*f8baa4e9SnonakaMicrocode Package README.iwlwifi-7265-ucode
5*f8baa4e9Snonaka
6*f8baa4e9SnonakaINDEX
7*f8baa4e9Snonaka
8*f8baa4e9Snonaka1. OVERVIEW
9*f8baa4e9Snonaka2. INSTALLATION
10*f8baa4e9Snonaka3. LICENSE
11*f8baa4e9Snonaka
12*f8baa4e9Snonaka
13*f8baa4e9Snonaka1. OVERVIEW
14*f8baa4e9Snonaka
15*f8baa4e9SnonakaThe file iwlwifi-7265-9.ucode provided in this package must be
16*f8baa4e9Snonakapresent on your system in order for the Intel Wireless WiFi Link
17*f8baa4e9SnonakaAGN driver for Linux (iwlwifi) to operate on your system.
18*f8baa4e9Snonaka
19*f8baa4e9SnonakaThe "-9" in the filename reflects an interface/architecture version number.
20*f8baa4e9SnonakaIt will change only when changes in new uCode releases make the new uCode
21*f8baa4e9Snonakaincompatible with earlier drivers.
22*f8baa4e9Snonaka
23*f8baa4e9SnonakaOn adapter initialization, and at varying times during the uptime of
24*f8baa4e9Snonakathe adapter, the microcode is loaded into the memory on the network
25*f8baa4e9Snonakaadapter.  The microcode provides the low level MAC features including
26*f8baa4e9Snonakaradio control and high precision timing events (backoff, transmit,
27*f8baa4e9Snonakaetc.) while also providing varying levels of packet filtering which can
28*f8baa4e9Snonakabe used to keep the host from having to handle packets that are not of
29*f8baa4e9Snonakainterest given the current operating mode of the device.
30*f8baa4e9Snonaka
31*f8baa4e9Snonaka2. INSTALLATION
32*f8baa4e9Snonaka
33*f8baa4e9SnonakaThe iwlwifi driver will look for the file iwlwifi-7265-9.ucode using the
34*f8baa4e9Snonakakernel's firmware_class infrastructure. More information can be found under
35*f8baa4e9SnonakaDocumentation/firmware_class in kernel source. In order to function
36*f8baa4e9Snonakacorrectly, you need to have this support enabled in your kernel.  When
37*f8baa4e9Snonakayou configure the kernel, you can find this option in the following
38*f8baa4e9Snonakalocation:
39*f8baa4e9Snonaka
40*f8baa4e9Snonaka        Device Drivers ->
41*f8baa4e9Snonaka                Generic Driver Options ->
42*f8baa4e9Snonaka                        Userspace firmware loading support
43*f8baa4e9Snonaka
44*f8baa4e9Snonaka
45*f8baa4e9SnonakaYou can determine if your kernel currently has firmware loader support
46*f8baa4e9Snonakaby looking for the CONFIG_FW_LOADER definition on your kernel's
47*f8baa4e9Snonaka.config.
48*f8baa4e9Snonaka
49*f8baa4e9SnonakaIn addition to having the firmware_class support in your kernel, you
50*f8baa4e9Snonakamust also have a working udev and uevent infrastructure configured.
51*f8baa4e9SnonakaThe steps for installing and configuring udev are very
52*f8baa4e9Snonakadistribution specific.
53*f8baa4e9Snonaka
54*f8baa4e9SnonakaOnce you have the firmware loader in place (or if you aren't sure and
55*f8baa4e9Snonakayou just want to try things to see if it works), you need to install
56*f8baa4e9Snonakathe microcode file into the appropriate location.
57*f8baa4e9Snonaka
58*f8baa4e9SnonakaWhere that appropriate location is depends (again) on your system
59*f8baa4e9Snonakadistribution.  You can typically find this location by looking in the
60*f8baa4e9Snonakaudev scripts of your distro, the default is /lib/firmware.
61*f8baa4e9Snonaka
62*f8baa4e9SnonakaInstallation of the firmware is simply:
63*f8baa4e9Snonaka
64*f8baa4e9Snonaka        % cp iwlwifi-7265-9.ucode /lib/firmware
65*f8baa4e9Snonaka
66*f8baa4e9SnonakaYou can now load the driver (see the INSTALL and README.iwlwifi provided with
67*f8baa4e9Snonakathe iwlwifi package for information on building and using that driver.)
68*f8baa4e9Snonaka
69*f8baa4e9Snonaka3. LICENSE
70*f8baa4e9Snonaka
71*f8baa4e9SnonakaThe microcode in this package (iwlwifi-7265-9.ucode) is provided under the
72*f8baa4e9Snonakaterms of the following license (available in the file
73*f8baa4e9SnonakaLICENSE.iwlwifi-7265-ucode):
74*f8baa4e9Snonaka
75*f8baa4e9SnonakaCopyright (c) 2014, Intel Corporation.
76*f8baa4e9SnonakaAll rights reserved.
77*f8baa4e9Snonaka
78*f8baa4e9SnonakaRedistribution.  Redistribution and use in binary form, without
79*f8baa4e9Snonakamodification, are permitted provided that the following conditions are
80*f8baa4e9Snonakamet:
81*f8baa4e9Snonaka
82*f8baa4e9Snonaka* Redistributions must reproduce the above copyright notice and the
83*f8baa4e9Snonaka  following disclaimer in the documentation and/or other materials
84*f8baa4e9Snonaka  provided with the distribution.
85*f8baa4e9Snonaka* Neither the name of Intel Corporation nor the names of its suppliers
86*f8baa4e9Snonaka  may be used to endorse or promote products derived from this software
87*f8baa4e9Snonaka  without specific prior written permission.
88*f8baa4e9Snonaka* No reverse engineering, decompilation, or disassembly of this software
89*f8baa4e9Snonaka  is permitted.
90*f8baa4e9Snonaka
91*f8baa4e9SnonakaLimited patent license.  Intel Corporation grants a world-wide,
92*f8baa4e9Snonakaroyalty-free, non-exclusive license under patents it now or hereafter
93*f8baa4e9Snonakaowns or controls to make, have made, use, import, offer to sell and
94*f8baa4e9Snonakasell ("Utilize") this software, but solely to the extent that any
95*f8baa4e9Snonakasuch patent is necessary to Utilize the software alone, or in
96*f8baa4e9Snonakacombination with an operating system licensed under an approved Open
97*f8baa4e9SnonakaSource license as listed by the Open Source Initiative at
98*f8baa4e9Snonakahttp://opensource.org/licenses.  The patent license shall not apply to
99*f8baa4e9Snonakaany other combinations which include this software.  No hardware per
100*f8baa4e9Snonakase is licensed hereunder.
101*f8baa4e9Snonaka
102*f8baa4e9SnonakaDISCLAIMER.  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
103*f8baa4e9SnonakaCONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING,
104*f8baa4e9SnonakaBUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
105*f8baa4e9SnonakaFITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
106*f8baa4e9SnonakaCOPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
107*f8baa4e9SnonakaINCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
108*f8baa4e9SnonakaBUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
109*f8baa4e9SnonakaOF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
110*f8baa4e9SnonakaON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
111*f8baa4e9SnonakaTORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
112*f8baa4e9SnonakaUSE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
113*f8baa4e9SnonakaDAMAGE.
114