root/drivers/net/wireless/ralink/rt2x00/rt2x00firmware.c
// SPDX-License-Identifier: GPL-2.0-or-later
/*
        Copyright (C) 2004 - 2009 Ivo van Doorn <IvDoorn@gmail.com>
        Copyright (C) 2004 - 2009 Gertjan van Wingerde <gwingerde@gmail.com>
        <http://rt2x00.serialmonkey.com>

 */

/*
        Module: rt2x00lib
        Abstract: rt2x00 firmware loading routines.
 */

#include <linux/kernel.h>
#include <linux/module.h>

#include "rt2x00.h"
#include "rt2x00lib.h"

static int rt2x00lib_request_firmware(struct rt2x00_dev *rt2x00dev)
{
        struct device *device = wiphy_dev(rt2x00dev->hw->wiphy);
        const struct firmware *fw;
        char *fw_name;
        int retval;

        /*
         * Read correct firmware from harddisk.
         */
        fw_name = rt2x00dev->ops->lib->get_firmware_name(rt2x00dev);
        if (!fw_name) {
                rt2x00_err(rt2x00dev,
                           "Invalid firmware filename\n"
                           "Please file bug report to %s\n", DRV_PROJECT);
                return -EINVAL;
        }

        rt2x00_info(rt2x00dev, "Loading firmware file '%s'\n", fw_name);

        retval = request_firmware(&fw, fw_name, device);
        if (retval) {
                rt2x00_err(rt2x00dev, "Failed to request Firmware\n");
                return retval;
        }

        if (!fw || !fw->size || !fw->data) {
                rt2x00_err(rt2x00dev, "Failed to read Firmware\n");
                release_firmware(fw);
                return -ENOENT;
        }

        rt2x00_info(rt2x00dev, "Firmware detected - version: %d.%d\n",
                    fw->data[fw->size - 4], fw->data[fw->size - 3]);
        snprintf(rt2x00dev->hw->wiphy->fw_version,
                        sizeof(rt2x00dev->hw->wiphy->fw_version), "%d.%d",
                        fw->data[fw->size - 4], fw->data[fw->size - 3]);

        retval = rt2x00dev->ops->lib->check_firmware(rt2x00dev, fw->data, fw->size);
        switch (retval) {
        case FW_OK:
                break;
        case FW_BAD_CRC:
                rt2x00_err(rt2x00dev, "Firmware checksum error\n");
                goto exit;
        case FW_BAD_LENGTH:
                rt2x00_err(rt2x00dev, "Invalid firmware file length (len=%zu)\n",
                           fw->size);
                goto exit;
        case FW_BAD_VERSION:
                rt2x00_err(rt2x00dev, "Current firmware does not support detected chipset\n");
                goto exit;
        }

        rt2x00dev->fw = fw;

        return 0;

exit:
        release_firmware(fw);

        return -ENOENT;
}

int rt2x00lib_load_firmware(struct rt2x00_dev *rt2x00dev)
{
        int retval;

        if (!rt2x00_has_cap_flag(rt2x00dev, REQUIRE_FIRMWARE))
                return 0;

        if (!rt2x00dev->fw) {
                retval = rt2x00lib_request_firmware(rt2x00dev);
                if (retval)
                        return retval;
        }

        /*
         * Send firmware to the device.
         */
        retval = rt2x00dev->ops->lib->load_firmware(rt2x00dev,
                                                    rt2x00dev->fw->data,
                                                    rt2x00dev->fw->size);

        /*
         * When the firmware is uploaded to the hardware the LED
         * association status might have been triggered, for correct
         * LED handling it should now be reset.
         */
        rt2x00leds_led_assoc(rt2x00dev, false);

        return retval;
}

void rt2x00lib_free_firmware(struct rt2x00_dev *rt2x00dev)
{
        release_firmware(rt2x00dev->fw);
        rt2x00dev->fw = NULL;
}