drivers/net/wireless/rt2x00/rt2x00firmware.c

   1 /*
   2         Copyright (C) 2004 - 2009 Ivo van Doorn <IvDoorn@gmail.com>
   3         Copyright (C) 2004 - 2009 Gertjan van Wingerde <gwingerde@gmail.com>
   4         <http://rt2x00.serialmonkey.com>
   5
   6         This program is free software; you can redistribute it and/or modify
   7         it under the terms of the GNU General Public License as published by
   8         the Free Software Foundation; either version 2 of the License, or
   9         (at your option) any later version.
  10
  11         This program is distributed in the hope that it will be useful,
  12         but WITHOUT ANY WARRANTY; without even the implied warranty of
  13         MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  14         GNU General Public License for more details.
  15
  16         You should have received a copy of the GNU General Public License
  17         along with this program; if not, write to the
  18         Free Software Foundation, Inc.,
  19         59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  20  */
  21
  22 /*
  23         Module: rt2x00lib
  24         Abstract: rt2x00 firmware loading routines.
  25  */
  26
  27 #include <linux/kernel.h>
  28 #include <linux/module.h>
  29
  30 #include "rt2x00.h"
  31 #include "rt2x00lib.h"
  32
  33 static int rt2x00lib_request_firmware(struct rt2x00_dev *rt2x00dev)
  34 {
  35         struct device *device = wiphy_dev(rt2x00dev->hw->wiphy);
  36         const struct firmware *fw;
  37         char *fw_name;
  38         int retval;
  39
  40         /*
  41          * Read correct firmware from harddisk.
  42          */
  43         fw_name = rt2x00dev->ops->lib->get_firmware_name(rt2x00dev);
  44         if (!fw_name) {
  45                 ERROR(rt2x00dev,
  46                       "Invalid firmware filename.\n"
  47                       "Please file bug report to %s.\n", DRV_PROJECT);
  48                 return -EINVAL;
  49         }
  50
  51         INFO(rt2x00dev, "Loading firmware file '%s'.\n", fw_name);
  52
  53         retval = request_firmware(&fw, fw_name, device);
  54         if (retval) {
  55                 ERROR(rt2x00dev, "Failed to request Firmware.\n");
  56                 return retval;
  57         }
  58
  59         if (!fw || !fw->size || !fw->data) {
  60                 ERROR(rt2x00dev, "Failed to read Firmware.\n");
  61                 release_firmware(fw);
  62                 return -ENOENT;
  63         }
  64
  65         INFO(rt2x00dev, "Firmware detected - version: %d.%d.\n",
  66              fw->data[fw->size - 4], fw->data[fw->size - 3]);
  67         snprintf(rt2x00dev->hw->wiphy->fw_version,
  68                         sizeof(rt2x00dev->hw->wiphy->fw_version), "%d.%d",
  69                         fw->data[fw->size - 4], fw->data[fw->size - 3]);
  70
  71         retval = rt2x00dev->ops->lib->check_firmware(rt2x00dev, fw->data, fw->size);
  72         switch (retval) {
  73         case FW_OK:
  74                 break;
  75         case FW_BAD_CRC:
  76                 ERROR(rt2x00dev, "Firmware checksum error.\n");
  77                 goto exit;
  78         case FW_BAD_LENGTH:
  79                 ERROR(rt2x00dev,
  80                       "Invalid firmware file length (len=%zu)\n", fw->size);
  81                 goto exit;
  82         case FW_BAD_VERSION:
  83                 ERROR(rt2x00dev,
  84                       "Current firmware does not support detected chipset.\n");
  85                 goto exit;
  86         }
  87
  88         rt2x00dev->fw = fw;
  89
  90         return 0;
  91
  92 exit:
  93         release_firmware(fw);
  94
  95         return -ENOENT;
  96 }
  97
  98 int rt2x00lib_load_firmware(struct rt2x00_dev *rt2x00dev)
  99 {
 100         int retval;
 101
 102         if (!test_bit(REQUIRE_FIRMWARE, &rt2x00dev->cap_flags))
 103                 return 0;
 104
 105         if (!rt2x00dev->fw) {
 106                 retval = rt2x00lib_request_firmware(rt2x00dev);
 107                 if (retval)
 108                         return retval;
 109         }
 110
 111         /*
 112          * Send firmware to the device.
 113          */
 114         retval = rt2x00dev->ops->lib->load_firmware(rt2x00dev,
 115                                                     rt2x00dev->fw->data,
 116                                                     rt2x00dev->fw->size);
 117
 118         /*
 119          * When the firmware is uploaded to the hardware the LED
 120          * association status might have been triggered, for correct
 121          * LED handling it should now be reset.
 122          */
 123         rt2x00leds_led_assoc(rt2x00dev, false);
 124
 125         return retval;
 126 }
 127
 128 void rt2x00lib_free_firmware(struct rt2x00_dev *rt2x00dev)
 129 {
 130         release_firmware(rt2x00dev->fw);
 131         rt2x00dev->fw = NULL;
 132 }