[deliverable/linux.git] / drivers / net / wireless / rt2x00 / rt2x00firmware.c

/*
	Copyright (C) 2004 - 2009 Ivo van Doorn <IvDoorn@gmail.com>
	Copyright (C) 2004 - 2009 Gertjan van Wingerde <gwingerde@gmail.com>
	<http://rt2x00.serialmonkey.com>

	This program is free software; you can redistribute it and/or modify
	it under the terms of the GNU General Public License as published by
	the Free Software Foundation; either version 2 of the License, or
	(at your option) any later version.

	This program is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	GNU General Public License for more details.

	You should have received a copy of the GNU General Public License
	along with this program; if not, write to the
	Free Software Foundation, Inc.,
	59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 */

/*
	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) {
		ERROR(rt2x00dev,
		      "Invalid firmware filename.\n"
		      "Please file bug report to %s.\n", DRV_PROJECT);
		return -EINVAL;
	}

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

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

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

	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:
		ERROR(rt2x00dev, "Firmware checksum error.\n");
		goto exit;
	case FW_BAD_LENGTH:
		ERROR(rt2x00dev,
		      "Invalid firmware file length (len=%zu)\n", fw->size);
		goto exit;
	case FW_BAD_VERSION:
		ERROR(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 (!test_bit(REQUIRE_FIRMWARE, &rt2x00dev->cap_flags))
		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;
}
Commit	Line	Data
95ea3627	1	/*
9c9a0d14 GW	2	Copyright (C) 2004 - 2009 Ivo van Doorn <IvDoorn@gmail.com>
9c9a0d14 GW	3	Copyright (C) 2004 - 2009 Gertjan van Wingerde <gwingerde@gmail.com>
95ea3627 ID	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
95ea3627 ID	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;
95ea3627 ID	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");
ccbd4d41	61	release_firmware(fw);
95ea3627 ID	62	return -ENOENT;
	63	}
	64
95ea3627 ID	65	INFO(rt2x00dev, "Firmware detected - version: %d.%d.\n",
95ea3627 ID	66	fw->data[fw->size - 4], fw->data[fw->size - 3]);
dd358c9a JL	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]);
95ea3627	70
0cbe0064 ID	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;
ee289b64	86	}
0cbe0064	87
95ea3627 ID	88	rt2x00dev->fw = fw;
	89
	90	return 0;
	91
	92	exit:
	93	release_firmware(fw);
	94
0cbe0064	95	return -ENOENT;
95ea3627 ID	96	}
	97
	98	int rt2x00lib_load_firmware(struct rt2x00_dev *rt2x00dev)
	99	{
	100	int retval;
	101
7dab73b3	102	if (!test_bit(REQUIRE_FIRMWARE, &rt2x00dev->cap_flags))
9404ef34 ID	103	return 0;
9404ef34 ID	104
95ea3627 ID	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);
4c9adaff ID	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
95ea3627 ID	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	}