sys/dev/iwm/if_iwm_fw.c

   1 /*-
   2  * Based on BSD-licensed source modules in the Linux iwlwifi driver,
   3  * which were used as the reference documentation for this implementation.
   4  *
   5  * Driver version we are currently based off of is
   6  * Linux 4.7.3 (tag id d7f6728f57e3ecbb7ef34eb7d9f564d514775d75)
   7  *
   8  ***********************************************************************
   9  *
  10  * This file is provided under a dual BSD/GPLv2 license.  When using or
  11  * redistributing this file, you may do so under either license.
  12  *
  13  * GPL LICENSE SUMMARY
  14  *
  15  * Copyright(c) 2012 - 2014 Intel Corporation. All rights reserved.
  16  * Copyright(c) 2013 - 2015 Intel Mobile Communications GmbH
  17  * Copyright(c) 2016 Intel Deutschland GmbH
  18  *
  19  * This program is free software; you can redistribute it and/or modify
  20  * it under the terms of version 2 of the GNU General Public License as
  21  * published by the Free Software Foundation.
  22  *
  23  * This program is distributed in the hope that it will be useful, but
  24  * WITHOUT ANY WARRANTY; without even the implied warranty of
  25  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  26  * General Public License for more details.
  27  *
  28  * You should have received a copy of the GNU General Public License
  29  * along with this program; if not, write to the Free Software
  30  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110,
  31  * USA
  32  *
  33  * The full GNU General Public License is included in this distribution
  34  * in the file called COPYING.
  35  *
  36  * Contact Information:
  37  *  Intel Linux Wireless <linuxwifi@intel.com>
  38  * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
  39  *
  40  * BSD LICENSE
  41  *
  42  * Copyright(c) 2012 - 2014 Intel Corporation. All rights reserved.
  43  * Copyright(c) 2013 - 2015 Intel Mobile Communications GmbH
  44  * All rights reserved.
  45  *
  46  * Redistribution and use in source and binary forms, with or without
  47  * modification, are permitted provided that the following conditions
  48  * are met:
  49  *
  50  *  * Redistributions of source code must retain the above copyright
  51  *    notice, this list of conditions and the following disclaimer.
  52  *  * Redistributions in binary form must reproduce the above copyright
  53  *    notice, this list of conditions and the following disclaimer in
  54  *    the documentation and/or other materials provided with the
  55  *    distribution.
  56  *  * Neither the name Intel Corporation nor the names of its
  57  *    contributors may be used to endorse or promote products derived
  58  *    from this software without specific prior written permission.
  59  *
  60  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  61  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  62  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  63  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  64  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  65  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  66  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  67  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  68  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  69  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  70  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  71  */
  72
  73 #include <sys/cdefs.h>
  74 __FBSDID("$FreeBSD$");
  75
  76 #include "opt_wlan.h"
  77 #include "opt_iwm.h"
  78
  79 #include <sys/param.h>
  80 #include <sys/bus.h>
  81 #include <sys/conf.h>
  82 #include <sys/endian.h>
  83 #include <sys/firmware.h>
  84 #include <sys/kernel.h>
  85 #include <sys/malloc.h>
  86 #include <sys/mbuf.h>
  87 #include <sys/mutex.h>
  88 #include <sys/module.h>
  89 #include <sys/proc.h>
  90 #include <sys/rman.h>
  91 #include <sys/socket.h>
  92 #include <sys/sockio.h>
  93 #include <sys/sysctl.h>
  94 #include <sys/linker.h>
  95
  96 #include <machine/bus.h>
  97 #include <machine/endian.h>
  98 #include <machine/resource.h>
  99
 100 #include <dev/pci/pcivar.h>
 101 #include <dev/pci/pcireg.h>
 102
 103 #include <net/bpf.h>
 104
 105 #include <net/if.h>
 106 #include <net/if_var.h>
 107 #include <net/if_arp.h>
 108 #include <net/if_dl.h>
 109 #include <net/if_media.h>
 110 #include <net/if_types.h>
 111
 112 #include <netinet/in.h>
 113 #include <netinet/in_systm.h>
 114 #include <netinet/if_ether.h>
 115 #include <netinet/ip.h>
 116
 117 #include <net80211/ieee80211_var.h>
 118 #include <net80211/ieee80211_regdomain.h>
 119 #include <net80211/ieee80211_ratectl.h>
 120 #include <net80211/ieee80211_radiotap.h>
 121
 122 #include <dev/iwm/if_iwmreg.h>
 123 #include <dev/iwm/if_iwmvar.h>
 124 #include <dev/iwm/if_iwm_debug.h>
 125 #include <dev/iwm/if_iwm_util.h>
 126 #include <dev/iwm/if_iwm_fw.h>
 127
 128 void
 129 iwm_free_fw_paging(struct iwm_softc *sc)
 130 {
 131         int i;
 132
 133         if (sc->fw_paging_db[0].fw_paging_block.vaddr == NULL)
 134                 return;
 135
 136         for (i = 0; i < IWM_NUM_OF_FW_PAGING_BLOCKS; i++) {
 137                 iwm_dma_contig_free(&sc->fw_paging_db[i].fw_paging_block);
 138         }
 139
 140         memset(sc->fw_paging_db, 0, sizeof(sc->fw_paging_db));
 141 }
 142
 143 static int
 144 iwm_fill_paging_mem(struct iwm_softc *sc, const struct iwm_fw_sects *image)
 145 {
 146         int sec_idx, idx;
 147         uint32_t offset = 0;
 148
 149         /*
 150          * find where is the paging image start point:
 151          * if CPU2 exist and it's in paging format, then the image looks like:
 152          * CPU1 sections (2 or more)
 153          * CPU1_CPU2_SEPARATOR_SECTION delimiter - separate between CPU1 to CPU2
 154          * CPU2 sections (not paged)
 155          * PAGING_SEPARATOR_SECTION delimiter - separate between CPU2
 156          * non paged to CPU2 paging sec
 157          * CPU2 paging CSS
 158          * CPU2 paging image (including instruction and data)
 159          */
 160         for (sec_idx = 0; sec_idx < IWM_UCODE_SECTION_MAX; sec_idx++) {
 161                 if (image->fw_sect[sec_idx].offset == IWM_PAGING_SEPARATOR_SECTION) {
 162                         sec_idx++;
 163                         break;
 164                 }
 165         }
 166
 167         /*
 168          * If paging is enabled there should be at least 2 more sections left
 169          * (one for CSS and one for Paging data)
 170          */
 171         if (sec_idx >= nitems(image->fw_sect) - 1) {
 172                 device_printf(sc->sc_dev,
 173                     "Paging: Missing CSS and/or paging sections\n");
 174                 iwm_free_fw_paging(sc);
 175                 return EINVAL;
 176         }
 177
 178         /* copy the CSS block to the dram */
 179         IWM_DPRINTF(sc, IWM_DEBUG_FW,
 180                     "Paging: load paging CSS to FW, sec = %d\n",
 181                     sec_idx);
 182
 183         memcpy(sc->fw_paging_db[0].fw_paging_block.vaddr,
 184                image->fw_sect[sec_idx].data,
 185                sc->fw_paging_db[0].fw_paging_size);
 186
 187         IWM_DPRINTF(sc, IWM_DEBUG_FW,
 188                     "Paging: copied %d CSS bytes to first block\n",
 189                     sc->fw_paging_db[0].fw_paging_size);
 190
 191         sec_idx++;
 192
 193         /*
 194          * copy the paging blocks to the dram
 195          * loop index start from 1 since that CSS block already copied to dram
 196          * and CSS index is 0.
 197          * loop stop at num_of_paging_blk since that last block is not full.
 198          */
 199         for (idx = 1; idx < sc->num_of_paging_blk; idx++) {
 200                 memcpy(sc->fw_paging_db[idx].fw_paging_block.vaddr,
 201                        (const char *)image->fw_sect[sec_idx].data + offset,
 202                        sc->fw_paging_db[idx].fw_paging_size);
 203
 204                 IWM_DPRINTF(sc, IWM_DEBUG_FW,
 205                             "Paging: copied %d paging bytes to block %d\n",
 206                             sc->fw_paging_db[idx].fw_paging_size,
 207                             idx);
 208
 209                 offset += sc->fw_paging_db[idx].fw_paging_size;
 210         }
 211
 212         /* copy the last paging block */
 213         if (sc->num_of_pages_in_last_blk > 0) {
 214                 memcpy(sc->fw_paging_db[idx].fw_paging_block.vaddr,
 215                        (const char *)image->fw_sect[sec_idx].data + offset,
 216                        IWM_FW_PAGING_SIZE * sc->num_of_pages_in_last_blk);
 217
 218                 IWM_DPRINTF(sc, IWM_DEBUG_FW,
 219                             "Paging: copied %d pages in the last block %d\n",
 220                             sc->num_of_pages_in_last_blk, idx);
 221         }
 222
 223         return 0;
 224 }
 225
 226 static int
 227 iwm_alloc_fw_paging_mem(struct iwm_softc *sc, const struct iwm_fw_sects *image)
 228 {
 229         int blk_idx = 0;
 230         int error, num_of_pages;
 231
 232         if (sc->fw_paging_db[0].fw_paging_block.vaddr != NULL) {
 233                 int i;
 234                 /* Device got reset, and we setup firmware paging again */
 235                 for (i = 0; i < sc->num_of_paging_blk + 1; i++) {
 236                         bus_dmamap_sync(sc->sc_dmat,
 237                             sc->fw_paging_db[i].fw_paging_block.map,
 238                             BUS_DMASYNC_POSTWRITE | BUS_DMASYNC_POSTREAD);
 239                 }
 240                 return 0;
 241         }
 242
 243         /* ensure IWM_BLOCK_2_EXP_SIZE is power of 2 of IWM_PAGING_BLOCK_SIZE */
 244         _Static_assert((1 << IWM_BLOCK_2_EXP_SIZE) == IWM_PAGING_BLOCK_SIZE,
 245             "IWM_BLOCK_2_EXP_SIZE must be power of 2 of IWM_PAGING_BLOCK_SIZE");
 246
 247         num_of_pages = image->paging_mem_size / IWM_FW_PAGING_SIZE;
 248         sc->num_of_paging_blk = ((num_of_pages - 1) /
 249                                     IWM_NUM_OF_PAGE_PER_GROUP) + 1;
 250
 251         sc->num_of_pages_in_last_blk =
 252                 num_of_pages -
 253                 IWM_NUM_OF_PAGE_PER_GROUP * (sc->num_of_paging_blk - 1);
 254
 255         IWM_DPRINTF(sc, IWM_DEBUG_FW,
 256                     "Paging: allocating mem for %d paging blocks, each block holds 8 pages, last block holds %d pages\n",
 257                     sc->num_of_paging_blk,
 258                     sc->num_of_pages_in_last_blk);
 259
 260         /* allocate block of 4Kbytes for paging CSS */
 261         error = iwm_dma_contig_alloc(sc->sc_dmat,
 262             &sc->fw_paging_db[blk_idx].fw_paging_block, IWM_FW_PAGING_SIZE,
 263             4096);
 264         if (error) {
 265                 /* free all the previous pages since we failed */
 266                 iwm_free_fw_paging(sc);
 267                 return ENOMEM;
 268         }
 269
 270         sc->fw_paging_db[blk_idx].fw_paging_size = IWM_FW_PAGING_SIZE;
 271
 272         IWM_DPRINTF(sc, IWM_DEBUG_FW,
 273                     "Paging: allocated 4K(CSS) bytes for firmware paging.\n");
 274
 275         /*
 276          * allocate blocks in dram.
 277          * since that CSS allocated in fw_paging_db[0] loop start from index 1
 278          */
 279         for (blk_idx = 1; blk_idx < sc->num_of_paging_blk + 1; blk_idx++) {
 280                 /* allocate block of IWM_PAGING_BLOCK_SIZE (32K) */
 281                 /* XXX Use iwm_dma_contig_alloc for allocating */
 282                 error = iwm_dma_contig_alloc(sc->sc_dmat,
 283                      &sc->fw_paging_db[blk_idx].fw_paging_block,
 284                     IWM_PAGING_BLOCK_SIZE, 4096);
 285                 if (error) {
 286                         /* free all the previous pages since we failed */
 287                         iwm_free_fw_paging(sc);
 288                         return ENOMEM;
 289                 }
 290
 291                 sc->fw_paging_db[blk_idx].fw_paging_size = IWM_PAGING_BLOCK_SIZE;
 292
 293                 IWM_DPRINTF(sc, IWM_DEBUG_FW,
 294                             "Paging: allocated 32K bytes for firmware paging.\n");
 295         }
 296
 297         return 0;
 298 }
 299
 300 int
 301 iwm_save_fw_paging(struct iwm_softc *sc, const struct iwm_fw_sects *fw)
 302 {
 303         int ret;
 304
 305         ret = iwm_alloc_fw_paging_mem(sc, fw);
 306         if (ret)
 307                 return ret;
 308
 309         return iwm_fill_paging_mem(sc, fw);
 310 }
 311
 312 /* send paging cmd to FW in case CPU2 has paging image */
 313 int
 314 iwm_send_paging_cmd(struct iwm_softc *sc, const struct iwm_fw_sects *fw)
 315 {
 316         int blk_idx;
 317         uint32_t dev_phy_addr;
 318         struct iwm_fw_paging_cmd fw_paging_cmd = {
 319                 .flags =
 320                         htole32(IWM_PAGING_CMD_IS_SECURED |
 321                                 IWM_PAGING_CMD_IS_ENABLED |
 322                                 (sc->num_of_pages_in_last_blk <<
 323                                 IWM_PAGING_CMD_NUM_OF_PAGES_IN_LAST_GRP_POS)),
 324                 .block_size = htole32(IWM_BLOCK_2_EXP_SIZE),
 325                 .block_num = htole32(sc->num_of_paging_blk),
 326         };
 327
 328         /* loop for for all paging blocks + CSS block */
 329         for (blk_idx = 0; blk_idx < sc->num_of_paging_blk + 1; blk_idx++) {
 330                 dev_phy_addr = htole32(
 331                     sc->fw_paging_db[blk_idx].fw_paging_block.paddr >>
 332                     IWM_PAGE_2_EXP_SIZE);
 333                 fw_paging_cmd.device_phy_addr[blk_idx] = dev_phy_addr;
 334                 bus_dmamap_sync(sc->sc_dmat,
 335                     sc->fw_paging_db[blk_idx].fw_paging_block.map,
 336                     BUS_DMASYNC_PREWRITE | BUS_DMASYNC_PREREAD);
 337         }
 338
 339         return iwm_mvm_send_cmd_pdu(sc, iwm_cmd_id(IWM_FW_PAGING_BLOCK_CMD,
 340                                                    IWM_ALWAYS_LONG_GROUP, 0),
 341                                     0, sizeof(fw_paging_cmd), &fw_paging_cmd);
 342 }