ralink/rt2x00/rt2x00firmware.c

0001 // SPDX-License-Identifier: GPL-2.0-or-later
0002 /*
0003     Copyright (C) 2004 - 2009 Ivo van Doorn <IvDoorn@gmail.com>
0004     Copyright (C) 2004 - 2009 Gertjan van Wingerde <gwingerde@gmail.com>
0005     <http://rt2x00.serialmonkey.com>
0006
0007  */
0008
0009 /*
0010     Module: rt2x00lib
0011     Abstract: rt2x00 firmware loading routines.
0012  */
0013
0014 #include <linux/kernel.h>
0015 #include <linux/module.h>
0016
0017 #include "rt2x00.h"
0018 #include "rt2x00lib.h"
0019
0020 static int rt2x00lib_request_firmware(struct rt2x00_dev *rt2x00dev)
0021 {
0022     struct device *device = wiphy_dev(rt2x00dev->hw->wiphy);
0023     const struct firmware *fw;
0024     char *fw_name;
0025     int retval;
0026
0027     /*
0028      * Read correct firmware from harddisk.
0029      */
0030     fw_name = rt2x00dev->ops->lib->get_firmware_name(rt2x00dev);
0031     if (!fw_name) {
0032         rt2x00_err(rt2x00dev,
0033                "Invalid firmware filename\n"
0034                "Please file bug report to %s\n", DRV_PROJECT);
0035         return -EINVAL;
0036     }
0037
0038     rt2x00_info(rt2x00dev, "Loading firmware file '%s'\n", fw_name);
0039
0040     retval = request_firmware(&fw, fw_name, device);
0041     if (retval) {
0042         rt2x00_err(rt2x00dev, "Failed to request Firmware\n");
0043         return retval;
0044     }
0045
0046     if (!fw || !fw->size || !fw->data) {
0047         rt2x00_err(rt2x00dev, "Failed to read Firmware\n");
0048         release_firmware(fw);
0049         return -ENOENT;
0050     }
0051
0052     rt2x00_info(rt2x00dev, "Firmware detected - version: %d.%d\n",
0053             fw->data[fw->size - 4], fw->data[fw->size - 3]);
0054     snprintf(rt2x00dev->hw->wiphy->fw_version,
0055             sizeof(rt2x00dev->hw->wiphy->fw_version), "%d.%d",
0056             fw->data[fw->size - 4], fw->data[fw->size - 3]);
0057
0058     retval = rt2x00dev->ops->lib->check_firmware(rt2x00dev, fw->data, fw->size);
0059     switch (retval) {
0060     case FW_OK:
0061         break;
0062     case FW_BAD_CRC:
0063         rt2x00_err(rt2x00dev, "Firmware checksum error\n");
0064         goto exit;
0065     case FW_BAD_LENGTH:
0066         rt2x00_err(rt2x00dev, "Invalid firmware file length (len=%zu)\n",
0067                fw->size);
0068         goto exit;
0069     case FW_BAD_VERSION:
0070         rt2x00_err(rt2x00dev, "Current firmware does not support detected chipset\n");
0071         goto exit;
0072     }
0073
0074     rt2x00dev->fw = fw;
0075
0076     return 0;
0077
0078 exit:
0079     release_firmware(fw);
0080
0081     return -ENOENT;
0082 }
0083
0084 int rt2x00lib_load_firmware(struct rt2x00_dev *rt2x00dev)
0085 {
0086     int retval;
0087
0088     if (!rt2x00_has_cap_flag(rt2x00dev, REQUIRE_FIRMWARE))
0089         return 0;
0090
0091     if (!rt2x00dev->fw) {
0092         retval = rt2x00lib_request_firmware(rt2x00dev);
0093         if (retval)
0094             return retval;
0095     }
0096
0097     /*
0098      * Send firmware to the device.
0099      */
0100     retval = rt2x00dev->ops->lib->load_firmware(rt2x00dev,
0101                             rt2x00dev->fw->data,
0102                             rt2x00dev->fw->size);
0103
0104     /*
0105      * When the firmware is uploaded to the hardware the LED
0106      * association status might have been triggered, for correct
0107      * LED handling it should now be reset.
0108      */
0109     rt2x00leds_led_assoc(rt2x00dev, false);
0110
0111     return retval;
0112 }
0113
0114 void rt2x00lib_free_firmware(struct rt2x00_dev *rt2x00dev)
0115 {
0116     release_firmware(rt2x00dev->fw);
0117     rt2x00dev->fw = NULL;
0118 }