1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0-or-later
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun Copyright (C) 2004 - 2009 Ivo van Doorn <IvDoorn@gmail.com>
4*4882a593Smuzhiyun Copyright (C) 2004 - 2009 Gertjan van Wingerde <gwingerde@gmail.com>
5*4882a593Smuzhiyun <http://rt2x00.serialmonkey.com>
6*4882a593Smuzhiyun
7*4882a593Smuzhiyun */
8*4882a593Smuzhiyun
9*4882a593Smuzhiyun /*
10*4882a593Smuzhiyun Module: rt2x00lib
11*4882a593Smuzhiyun Abstract: rt2x00 firmware loading routines.
12*4882a593Smuzhiyun */
13*4882a593Smuzhiyun
14*4882a593Smuzhiyun #include <linux/kernel.h>
15*4882a593Smuzhiyun #include <linux/module.h>
16*4882a593Smuzhiyun
17*4882a593Smuzhiyun #include "rt2x00.h"
18*4882a593Smuzhiyun #include "rt2x00lib.h"
19*4882a593Smuzhiyun
rt2x00lib_request_firmware(struct rt2x00_dev * rt2x00dev)20*4882a593Smuzhiyun static int rt2x00lib_request_firmware(struct rt2x00_dev *rt2x00dev)
21*4882a593Smuzhiyun {
22*4882a593Smuzhiyun struct device *device = wiphy_dev(rt2x00dev->hw->wiphy);
23*4882a593Smuzhiyun const struct firmware *fw;
24*4882a593Smuzhiyun char *fw_name;
25*4882a593Smuzhiyun int retval;
26*4882a593Smuzhiyun
27*4882a593Smuzhiyun /*
28*4882a593Smuzhiyun * Read correct firmware from harddisk.
29*4882a593Smuzhiyun */
30*4882a593Smuzhiyun fw_name = rt2x00dev->ops->lib->get_firmware_name(rt2x00dev);
31*4882a593Smuzhiyun if (!fw_name) {
32*4882a593Smuzhiyun rt2x00_err(rt2x00dev,
33*4882a593Smuzhiyun "Invalid firmware filename\n"
34*4882a593Smuzhiyun "Please file bug report to %s\n", DRV_PROJECT);
35*4882a593Smuzhiyun return -EINVAL;
36*4882a593Smuzhiyun }
37*4882a593Smuzhiyun
38*4882a593Smuzhiyun rt2x00_info(rt2x00dev, "Loading firmware file '%s'\n", fw_name);
39*4882a593Smuzhiyun
40*4882a593Smuzhiyun retval = request_firmware(&fw, fw_name, device);
41*4882a593Smuzhiyun if (retval) {
42*4882a593Smuzhiyun rt2x00_err(rt2x00dev, "Failed to request Firmware\n");
43*4882a593Smuzhiyun return retval;
44*4882a593Smuzhiyun }
45*4882a593Smuzhiyun
46*4882a593Smuzhiyun if (!fw || !fw->size || !fw->data) {
47*4882a593Smuzhiyun rt2x00_err(rt2x00dev, "Failed to read Firmware\n");
48*4882a593Smuzhiyun release_firmware(fw);
49*4882a593Smuzhiyun return -ENOENT;
50*4882a593Smuzhiyun }
51*4882a593Smuzhiyun
52*4882a593Smuzhiyun rt2x00_info(rt2x00dev, "Firmware detected - version: %d.%d\n",
53*4882a593Smuzhiyun fw->data[fw->size - 4], fw->data[fw->size - 3]);
54*4882a593Smuzhiyun snprintf(rt2x00dev->hw->wiphy->fw_version,
55*4882a593Smuzhiyun sizeof(rt2x00dev->hw->wiphy->fw_version), "%d.%d",
56*4882a593Smuzhiyun fw->data[fw->size - 4], fw->data[fw->size - 3]);
57*4882a593Smuzhiyun
58*4882a593Smuzhiyun retval = rt2x00dev->ops->lib->check_firmware(rt2x00dev, fw->data, fw->size);
59*4882a593Smuzhiyun switch (retval) {
60*4882a593Smuzhiyun case FW_OK:
61*4882a593Smuzhiyun break;
62*4882a593Smuzhiyun case FW_BAD_CRC:
63*4882a593Smuzhiyun rt2x00_err(rt2x00dev, "Firmware checksum error\n");
64*4882a593Smuzhiyun goto exit;
65*4882a593Smuzhiyun case FW_BAD_LENGTH:
66*4882a593Smuzhiyun rt2x00_err(rt2x00dev, "Invalid firmware file length (len=%zu)\n",
67*4882a593Smuzhiyun fw->size);
68*4882a593Smuzhiyun goto exit;
69*4882a593Smuzhiyun case FW_BAD_VERSION:
70*4882a593Smuzhiyun rt2x00_err(rt2x00dev, "Current firmware does not support detected chipset\n");
71*4882a593Smuzhiyun goto exit;
72*4882a593Smuzhiyun }
73*4882a593Smuzhiyun
74*4882a593Smuzhiyun rt2x00dev->fw = fw;
75*4882a593Smuzhiyun
76*4882a593Smuzhiyun return 0;
77*4882a593Smuzhiyun
78*4882a593Smuzhiyun exit:
79*4882a593Smuzhiyun release_firmware(fw);
80*4882a593Smuzhiyun
81*4882a593Smuzhiyun return -ENOENT;
82*4882a593Smuzhiyun }
83*4882a593Smuzhiyun
rt2x00lib_load_firmware(struct rt2x00_dev * rt2x00dev)84*4882a593Smuzhiyun int rt2x00lib_load_firmware(struct rt2x00_dev *rt2x00dev)
85*4882a593Smuzhiyun {
86*4882a593Smuzhiyun int retval;
87*4882a593Smuzhiyun
88*4882a593Smuzhiyun if (!rt2x00_has_cap_flag(rt2x00dev, REQUIRE_FIRMWARE))
89*4882a593Smuzhiyun return 0;
90*4882a593Smuzhiyun
91*4882a593Smuzhiyun if (!rt2x00dev->fw) {
92*4882a593Smuzhiyun retval = rt2x00lib_request_firmware(rt2x00dev);
93*4882a593Smuzhiyun if (retval)
94*4882a593Smuzhiyun return retval;
95*4882a593Smuzhiyun }
96*4882a593Smuzhiyun
97*4882a593Smuzhiyun /*
98*4882a593Smuzhiyun * Send firmware to the device.
99*4882a593Smuzhiyun */
100*4882a593Smuzhiyun retval = rt2x00dev->ops->lib->load_firmware(rt2x00dev,
101*4882a593Smuzhiyun rt2x00dev->fw->data,
102*4882a593Smuzhiyun rt2x00dev->fw->size);
103*4882a593Smuzhiyun
104*4882a593Smuzhiyun /*
105*4882a593Smuzhiyun * When the firmware is uploaded to the hardware the LED
106*4882a593Smuzhiyun * association status might have been triggered, for correct
107*4882a593Smuzhiyun * LED handling it should now be reset.
108*4882a593Smuzhiyun */
109*4882a593Smuzhiyun rt2x00leds_led_assoc(rt2x00dev, false);
110*4882a593Smuzhiyun
111*4882a593Smuzhiyun return retval;
112*4882a593Smuzhiyun }
113*4882a593Smuzhiyun
rt2x00lib_free_firmware(struct rt2x00_dev * rt2x00dev)114*4882a593Smuzhiyun void rt2x00lib_free_firmware(struct rt2x00_dev *rt2x00dev)
115*4882a593Smuzhiyun {
116*4882a593Smuzhiyun release_firmware(rt2x00dev->fw);
117*4882a593Smuzhiyun rt2x00dev->fw = NULL;
118*4882a593Smuzhiyun }
119