linux/drivers/staging/wfx/fwio.c
<<
>>
Prefs
   1// SPDX-License-Identifier: GPL-2.0-only
   2/*
   3 * Firmware loading.
   4 *
   5 * Copyright (c) 2017-2020, Silicon Laboratories, Inc.
   6 * Copyright (c) 2010, ST-Ericsson
   7 */
   8#include <linux/firmware.h>
   9#include <linux/slab.h>
  10#include <linux/mm.h>
  11#include <linux/bitfield.h>
  12
  13#include "fwio.h"
  14#include "wfx.h"
  15#include "hwio.h"
  16
  17// Addresses below are in SRAM area
  18#define WFX_DNLD_FIFO             0x09004000
  19#define     DNLD_BLOCK_SIZE           0x0400
  20#define     DNLD_FIFO_SIZE            0x8000 // (32 * DNLD_BLOCK_SIZE)
  21// Download Control Area (DCA)
  22#define WFX_DCA_IMAGE_SIZE        0x0900C000
  23#define WFX_DCA_PUT               0x0900C004
  24#define WFX_DCA_GET               0x0900C008
  25#define WFX_DCA_HOST_STATUS       0x0900C00C
  26#define     HOST_READY                0x87654321
  27#define     HOST_INFO_READ            0xA753BD99
  28#define     HOST_UPLOAD_PENDING       0xABCDDCBA
  29#define     HOST_UPLOAD_COMPLETE      0xD4C64A99
  30#define     HOST_OK_TO_JUMP           0x174FC882
  31#define WFX_DCA_NCP_STATUS        0x0900C010
  32#define     NCP_NOT_READY             0x12345678
  33#define     NCP_READY                 0x87654321
  34#define     NCP_INFO_READY            0xBD53EF99
  35#define     NCP_DOWNLOAD_PENDING      0xABCDDCBA
  36#define     NCP_DOWNLOAD_COMPLETE     0xCAFEFECA
  37#define     NCP_AUTH_OK               0xD4C64A99
  38#define     NCP_AUTH_FAIL             0x174FC882
  39#define     NCP_PUB_KEY_RDY           0x7AB41D19
  40#define WFX_DCA_FW_SIGNATURE      0x0900C014
  41#define     FW_SIGNATURE_SIZE         0x40
  42#define WFX_DCA_FW_HASH           0x0900C054
  43#define     FW_HASH_SIZE              0x08
  44#define WFX_DCA_FW_VERSION        0x0900C05C
  45#define     FW_VERSION_SIZE           0x04
  46#define WFX_DCA_RESERVED          0x0900C060
  47#define     DCA_RESERVED_SIZE         0x20
  48#define WFX_STATUS_INFO           0x0900C080
  49#define WFX_BOOTLOADER_LABEL      0x0900C084
  50#define     BOOTLOADER_LABEL_SIZE     0x3C
  51#define WFX_PTE_INFO              0x0900C0C0
  52#define     PTE_INFO_KEYSET_IDX       0x0D
  53#define     PTE_INFO_SIZE             0x10
  54#define WFX_ERR_INFO              0x0900C0D0
  55#define     ERR_INVALID_SEC_TYPE      0x05
  56#define     ERR_SIG_VERIF_FAILED      0x0F
  57#define     ERR_AES_CTRL_KEY          0x10
  58#define     ERR_ECC_PUB_KEY           0x11
  59#define     ERR_MAC_KEY               0x18
  60
  61#define DCA_TIMEOUT  50 // milliseconds
  62#define WAKEUP_TIMEOUT 200 // milliseconds
  63
  64static const char * const fwio_errors[] = {
  65        [ERR_INVALID_SEC_TYPE] = "Invalid section type or wrong encryption",
  66        [ERR_SIG_VERIF_FAILED] = "Signature verification failed",
  67        [ERR_AES_CTRL_KEY] = "AES control key not initialized",
  68        [ERR_ECC_PUB_KEY] = "ECC public key not initialized",
  69        [ERR_MAC_KEY] = "MAC key not initialized",
  70};
  71
  72/*
  73 * request_firmware() allocate data using vmalloc(). It is not compatible with
  74 * underlying hardware that use DMA. Function below detect this case and
  75 * allocate a bounce buffer if necessary.
  76 *
  77 * Notice that, in doubt, you can enable CONFIG_DEBUG_SG to ask kernel to
  78 * detect this problem at runtime  (else, kernel silently fail).
  79 *
  80 * NOTE: it may also be possible to use 'pages' from struct firmware and avoid
  81 * bounce buffer
  82 */
  83static int sram_write_dma_safe(struct wfx_dev *wdev, u32 addr, const u8 *buf,
  84                               size_t len)
  85{
  86        int ret;
  87        const u8 *tmp;
  88
  89        if (!virt_addr_valid(buf)) {
  90                tmp = kmemdup(buf, len, GFP_KERNEL);
  91                if (!tmp)
  92                        return -ENOMEM;
  93        } else {
  94                tmp = buf;
  95        }
  96        ret = sram_buf_write(wdev, addr, tmp, len);
  97        if (tmp != buf)
  98                kfree(tmp);
  99        return ret;
 100}
 101
 102static int get_firmware(struct wfx_dev *wdev, u32 keyset_chip,
 103                        const struct firmware **fw, int *file_offset)
 104{
 105        int keyset_file;
 106        char filename[256];
 107        const char *data;
 108        int ret;
 109
 110        snprintf(filename, sizeof(filename), "%s_%02X.sec",
 111                 wdev->pdata.file_fw, keyset_chip);
 112        ret = firmware_request_nowarn(fw, filename, wdev->dev);
 113        if (ret) {
 114                dev_info(wdev->dev, "can't load %s, falling back to %s.sec\n",
 115                         filename, wdev->pdata.file_fw);
 116                snprintf(filename, sizeof(filename), "%s.sec",
 117                         wdev->pdata.file_fw);
 118                ret = request_firmware(fw, filename, wdev->dev);
 119                if (ret) {
 120                        dev_err(wdev->dev, "can't load %s\n", filename);
 121                        *fw = NULL;
 122                        return ret;
 123                }
 124        }
 125
 126        data = (*fw)->data;
 127        if (memcmp(data, "KEYSET", 6) != 0) {
 128                // Legacy firmware format
 129                *file_offset = 0;
 130                keyset_file = 0x90;
 131        } else {
 132                *file_offset = 8;
 133                keyset_file = (hex_to_bin(data[6]) * 16) | hex_to_bin(data[7]);
 134                if (keyset_file < 0) {
 135                        dev_err(wdev->dev, "%s corrupted\n", filename);
 136                        release_firmware(*fw);
 137                        *fw = NULL;
 138                        return -EINVAL;
 139                }
 140        }
 141        if (keyset_file != keyset_chip) {
 142                dev_err(wdev->dev, "firmware keyset is incompatible with chip (file: 0x%02X, chip: 0x%02X)\n",
 143                        keyset_file, keyset_chip);
 144                release_firmware(*fw);
 145                *fw = NULL;
 146                return -ENODEV;
 147        }
 148        wdev->keyset = keyset_file;
 149        return 0;
 150}
 151
 152static int wait_ncp_status(struct wfx_dev *wdev, u32 status)
 153{
 154        ktime_t now, start;
 155        u32 reg;
 156        int ret;
 157
 158        start = ktime_get();
 159        for (;;) {
 160                ret = sram_reg_read(wdev, WFX_DCA_NCP_STATUS, &reg);
 161                if (ret < 0)
 162                        return -EIO;
 163                now = ktime_get();
 164                if (reg == status)
 165                        break;
 166                if (ktime_after(now, ktime_add_ms(start, DCA_TIMEOUT)))
 167                        return -ETIMEDOUT;
 168        }
 169        if (ktime_compare(now, start))
 170                dev_dbg(wdev->dev, "chip answer after %lldus\n",
 171                        ktime_us_delta(now, start));
 172        else
 173                dev_dbg(wdev->dev, "chip answer immediately\n");
 174        return 0;
 175}
 176
 177static int upload_firmware(struct wfx_dev *wdev, const u8 *data, size_t len)
 178{
 179        int ret;
 180        u32 offs, bytes_done = 0;
 181        ktime_t now, start;
 182
 183        if (len % DNLD_BLOCK_SIZE) {
 184                dev_err(wdev->dev, "firmware size is not aligned. Buffer overrun will occur\n");
 185                return -EIO;
 186        }
 187        offs = 0;
 188        while (offs < len) {
 189                start = ktime_get();
 190                for (;;) {
 191                        now = ktime_get();
 192                        if (offs + DNLD_BLOCK_SIZE - bytes_done < DNLD_FIFO_SIZE)
 193                                break;
 194                        if (ktime_after(now, ktime_add_ms(start, DCA_TIMEOUT)))
 195                                return -ETIMEDOUT;
 196                        ret = sram_reg_read(wdev, WFX_DCA_GET, &bytes_done);
 197                        if (ret < 0)
 198                                return ret;
 199                }
 200                if (ktime_compare(now, start))
 201                        dev_dbg(wdev->dev, "answer after %lldus\n",
 202                                ktime_us_delta(now, start));
 203
 204                ret = sram_write_dma_safe(wdev, WFX_DNLD_FIFO +
 205                                          (offs % DNLD_FIFO_SIZE),
 206                                          data + offs, DNLD_BLOCK_SIZE);
 207                if (ret < 0)
 208                        return ret;
 209
 210                // WFx seems to not support writing 0 in this register during
 211                // first loop
 212                offs += DNLD_BLOCK_SIZE;
 213                ret = sram_reg_write(wdev, WFX_DCA_PUT, offs);
 214                if (ret < 0)
 215                        return ret;
 216        }
 217        return 0;
 218}
 219
 220static void print_boot_status(struct wfx_dev *wdev)
 221{
 222        u32 reg;
 223
 224        sram_reg_read(wdev, WFX_STATUS_INFO, &reg);
 225        if (reg == 0x12345678)
 226                return;
 227        sram_reg_read(wdev, WFX_ERR_INFO, &reg);
 228        if (reg < ARRAY_SIZE(fwio_errors) && fwio_errors[reg])
 229                dev_info(wdev->dev, "secure boot: %s\n", fwio_errors[reg]);
 230        else
 231                dev_info(wdev->dev, "secure boot: Error %#02x\n", reg);
 232}
 233
 234static int load_firmware_secure(struct wfx_dev *wdev)
 235{
 236        const struct firmware *fw = NULL;
 237        int header_size;
 238        int fw_offset;
 239        ktime_t start;
 240        u8 *buf;
 241        int ret;
 242
 243        BUILD_BUG_ON(PTE_INFO_SIZE > BOOTLOADER_LABEL_SIZE);
 244        buf = kmalloc(BOOTLOADER_LABEL_SIZE + 1, GFP_KERNEL);
 245        if (!buf)
 246                return -ENOMEM;
 247
 248        sram_reg_write(wdev, WFX_DCA_HOST_STATUS, HOST_READY);
 249        ret = wait_ncp_status(wdev, NCP_INFO_READY);
 250        if (ret)
 251                goto error;
 252
 253        sram_buf_read(wdev, WFX_BOOTLOADER_LABEL, buf, BOOTLOADER_LABEL_SIZE);
 254        buf[BOOTLOADER_LABEL_SIZE] = 0;
 255        dev_dbg(wdev->dev, "bootloader: \"%s\"\n", buf);
 256
 257        sram_buf_read(wdev, WFX_PTE_INFO, buf, PTE_INFO_SIZE);
 258        ret = get_firmware(wdev, buf[PTE_INFO_KEYSET_IDX], &fw, &fw_offset);
 259        if (ret)
 260                goto error;
 261        header_size = fw_offset + FW_SIGNATURE_SIZE + FW_HASH_SIZE;
 262
 263        sram_reg_write(wdev, WFX_DCA_HOST_STATUS, HOST_INFO_READ);
 264        ret = wait_ncp_status(wdev, NCP_READY);
 265        if (ret)
 266                goto error;
 267
 268        sram_reg_write(wdev, WFX_DNLD_FIFO, 0xFFFFFFFF); // Fifo init
 269        sram_write_dma_safe(wdev, WFX_DCA_FW_VERSION, "\x01\x00\x00\x00",
 270                            FW_VERSION_SIZE);
 271        sram_write_dma_safe(wdev, WFX_DCA_FW_SIGNATURE, fw->data + fw_offset,
 272                            FW_SIGNATURE_SIZE);
 273        sram_write_dma_safe(wdev, WFX_DCA_FW_HASH,
 274                            fw->data + fw_offset + FW_SIGNATURE_SIZE,
 275                            FW_HASH_SIZE);
 276        sram_reg_write(wdev, WFX_DCA_IMAGE_SIZE, fw->size - header_size);
 277        sram_reg_write(wdev, WFX_DCA_HOST_STATUS, HOST_UPLOAD_PENDING);
 278        ret = wait_ncp_status(wdev, NCP_DOWNLOAD_PENDING);
 279        if (ret)
 280                goto error;
 281
 282        start = ktime_get();
 283        ret = upload_firmware(wdev, fw->data + header_size,
 284                              fw->size - header_size);
 285        if (ret)
 286                goto error;
 287        dev_dbg(wdev->dev, "firmware load after %lldus\n",
 288                ktime_us_delta(ktime_get(), start));
 289
 290        sram_reg_write(wdev, WFX_DCA_HOST_STATUS, HOST_UPLOAD_COMPLETE);
 291        ret = wait_ncp_status(wdev, NCP_AUTH_OK);
 292        // Legacy ROM support
 293        if (ret < 0)
 294                ret = wait_ncp_status(wdev, NCP_PUB_KEY_RDY);
 295        if (ret < 0)
 296                goto error;
 297        sram_reg_write(wdev, WFX_DCA_HOST_STATUS, HOST_OK_TO_JUMP);
 298
 299error:
 300        kfree(buf);
 301        if (fw)
 302                release_firmware(fw);
 303        if (ret)
 304                print_boot_status(wdev);
 305        return ret;
 306}
 307
 308static int init_gpr(struct wfx_dev *wdev)
 309{
 310        int ret, i;
 311        static const struct {
 312                int index;
 313                u32 value;
 314        } gpr_init[] = {
 315                { 0x07, 0x208775 },
 316                { 0x08, 0x2EC020 },
 317                { 0x09, 0x3C3C3C },
 318                { 0x0B, 0x322C44 },
 319                { 0x0C, 0xA06497 },
 320        };
 321
 322        for (i = 0; i < ARRAY_SIZE(gpr_init); i++) {
 323                ret = igpr_reg_write(wdev, gpr_init[i].index,
 324                                     gpr_init[i].value);
 325                if (ret < 0)
 326                        return ret;
 327                dev_dbg(wdev->dev, "  index %02x: %08x\n",
 328                        gpr_init[i].index, gpr_init[i].value);
 329        }
 330        return 0;
 331}
 332
 333int wfx_init_device(struct wfx_dev *wdev)
 334{
 335        int ret;
 336        int hw_revision, hw_type;
 337        int wakeup_timeout = 50; // ms
 338        ktime_t now, start;
 339        u32 reg;
 340
 341        reg = CFG_DIRECT_ACCESS_MODE | CFG_CPU_RESET | CFG_BYTE_ORDER_ABCD;
 342        if (wdev->pdata.use_rising_clk)
 343                reg |= CFG_CLK_RISE_EDGE;
 344        ret = config_reg_write(wdev, reg);
 345        if (ret < 0) {
 346                dev_err(wdev->dev, "bus returned an error during first write access. Host configuration error?\n");
 347                return -EIO;
 348        }
 349
 350        ret = config_reg_read(wdev, &reg);
 351        if (ret < 0) {
 352                dev_err(wdev->dev, "bus returned an error during first read access. Bus configuration error?\n");
 353                return -EIO;
 354        }
 355        if (reg == 0 || reg == ~0) {
 356                dev_err(wdev->dev, "chip mute. Bus configuration error or chip wasn't reset?\n");
 357                return -EIO;
 358        }
 359        dev_dbg(wdev->dev, "initial config register value: %08x\n", reg);
 360
 361        hw_revision = FIELD_GET(CFG_DEVICE_ID_MAJOR, reg);
 362        if (hw_revision == 0) {
 363                dev_err(wdev->dev, "bad hardware revision number: %d\n",
 364                        hw_revision);
 365                return -ENODEV;
 366        }
 367        hw_type = FIELD_GET(CFG_DEVICE_ID_TYPE, reg);
 368        if (hw_type == 1) {
 369                dev_notice(wdev->dev, "development hardware detected\n");
 370                wakeup_timeout = 2000;
 371        }
 372
 373        ret = init_gpr(wdev);
 374        if (ret < 0)
 375                return ret;
 376
 377        ret = control_reg_write(wdev, CTRL_WLAN_WAKEUP);
 378        if (ret < 0)
 379                return -EIO;
 380        start = ktime_get();
 381        for (;;) {
 382                ret = control_reg_read(wdev, &reg);
 383                now = ktime_get();
 384                if (reg & CTRL_WLAN_READY)
 385                        break;
 386                if (ktime_after(now, ktime_add_ms(start, wakeup_timeout))) {
 387                        dev_err(wdev->dev, "chip didn't wake up. Chip wasn't reset?\n");
 388                        return -ETIMEDOUT;
 389                }
 390        }
 391        dev_dbg(wdev->dev, "chip wake up after %lldus\n",
 392                ktime_us_delta(now, start));
 393
 394        ret = config_reg_write_bits(wdev, CFG_CPU_RESET, 0);
 395        if (ret < 0)
 396                return ret;
 397        ret = load_firmware_secure(wdev);
 398        if (ret < 0)
 399                return ret;
 400        return config_reg_write_bits(wdev,
 401                                     CFG_DIRECT_ACCESS_MODE |
 402                                     CFG_IRQ_ENABLE_DATA |
 403                                     CFG_IRQ_ENABLE_WRDY,
 404                                     CFG_IRQ_ENABLE_DATA);
 405}
 406