[mirror_ubuntu-artful-kernel.git] / drivers / net / wireless / broadcom / brcm80211 / brcmfmac / firmware.h

/*
 * Copyright (c) 2013 Broadcom Corporation
 *
 * Permission to use, copy, modify, and/or distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
 * SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
 * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
 * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
#ifndef BRCMFMAC_FIRMWARE_H
#define BRCMFMAC_FIRMWARE_H

#define BRCMF_FW_REQUEST		0x000F
#define  BRCMF_FW_REQUEST_NVRAM		0x0001
#define BRCMF_FW_REQ_FLAGS		0x00F0
#define  BRCMF_FW_REQ_NV_OPTIONAL	0x0010

#define	BRCMF_FW_NAME_LEN		320

#define BRCMF_FW_DEFAULT_PATH		"brcm/"

/**
 * struct brcmf_firmware_mapping - Used to map chipid/revmask to firmware
 *	filename and nvram filename. Each bus type implementation should create
 *	a table of firmware mappings (using the macros defined below).
 *
 * @chipid: ID of chip.
 * @revmask: bitmask of revisions, e.g. 0x10 means rev 4 only, 0xf means rev 0-3
 * @fw: name of the firmware file.
 * @nvram: name of nvram file.
 */
struct brcmf_firmware_mapping {
	u32 chipid;
	u32 revmask;
	const char *fw;
	const char *nvram;
};

#define BRCMF_FW_NVRAM_DEF(fw_nvram_name, fw, nvram) \
static const char BRCM_ ## fw_nvram_name ## _FIRMWARE_NAME[] = \
	BRCMF_FW_DEFAULT_PATH fw; \
static const char BRCM_ ## fw_nvram_name ## _NVRAM_NAME[] = \
	BRCMF_FW_DEFAULT_PATH nvram; \
MODULE_FIRMWARE(BRCMF_FW_DEFAULT_PATH fw);

#define BRCMF_FW_DEF(fw_name, fw) \
static const char BRCM_ ## fw_name ## _FIRMWARE_NAME[] = \
	BRCMF_FW_DEFAULT_PATH fw; \
MODULE_FIRMWARE(BRCMF_FW_DEFAULT_PATH fw) \

#define BRCMF_FW_NVRAM_ENTRY(chipid, mask, name) \
	{ chipid, mask, \
	  BRCM_ ## name ## _FIRMWARE_NAME, BRCM_ ## name ## _NVRAM_NAME }

#define BRCMF_FW_ENTRY(chipid, mask, name) \
	{ chipid, mask, BRCM_ ## name ## _FIRMWARE_NAME, NULL }

int brcmf_fw_map_chip_to_name(u32 chip, u32 chiprev,
			      struct brcmf_firmware_mapping mapping_table[],
			      u32 table_size, char fw_name[BRCMF_FW_NAME_LEN],
			      char nvram_name[BRCMF_FW_NAME_LEN]);
void brcmf_fw_nvram_free(void *nvram);
/*
 * Request firmware(s) asynchronously. When the asynchronous request
 * fails it will not use the callback, but call device_release_driver()
 * instead which will call the driver .remove() callback.
 */
int brcmf_fw_get_firmwares_pcie(struct device *dev, u16 flags,
				const char *code, const char *nvram,
				void (*fw_cb)(struct device *dev, int err,
					      const struct firmware *fw,
					      void *nvram_image, u32 nvram_len),
				u16 domain_nr, u16 bus_nr);
int brcmf_fw_get_firmwares(struct device *dev, u16 flags,
			   const char *code, const char *nvram,
			   void (*fw_cb)(struct device *dev, int err,
					 const struct firmware *fw,
					 void *nvram_image, u32 nvram_len));

#endif /* BRCMFMAC_FIRMWARE_H */
Commit	Line	Data
a74d036f HM	1	/*
	2	* Copyright (c) 2013 Broadcom Corporation
	3	*
	4	* Permission to use, copy, modify, and/or distribute this software for any
	5	* purpose with or without fee is hereby granted, provided that the above
	6	* copyright notice and this permission notice appear in all copies.
	7	*
	8	* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
	9	* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
	10	* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
	11	* SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
	12	* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
	13	* OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
	14	* CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
	15	*/
dabedab9 AS	16	#ifndef BRCMFMAC_FIRMWARE_H
dabedab9 AS	17	#define BRCMFMAC_FIRMWARE_H
a74d036f	18
c1416e77 AS	19	#define BRCMF_FW_REQUEST 0x000F
	20	#define BRCMF_FW_REQUEST_NVRAM 0x0001
	21	#define BRCMF_FW_REQ_FLAGS 0x00F0
	22	#define BRCMF_FW_REQ_NV_OPTIONAL 0x0010
a74d036f	23
46d703a7	24	#define BRCMF_FW_NAME_LEN 320
c1b20532	25
46d703a7	26	#define BRCMF_FW_DEFAULT_PATH "brcm/"
c1b20532	27
46d703a7 HM	28	/**
	29	* struct brcmf_firmware_mapping - Used to map chipid/revmask to firmware
	30	* filename and nvram filename. Each bus type implementation should create
	31	* a table of firmware mappings (using the macros defined below).
	32	*
	33	* @chipid: ID of chip.
	34	* @revmask: bitmask of revisions, e.g. 0x10 means rev 4 only, 0xf means rev 0-3
	35	* @fw: name of the firmware file.
	36	* @nvram: name of nvram file.
	37	*/
	38	struct brcmf_firmware_mapping {
	39	u32 chipid;
	40	u32 revmask;
	41	const char *fw;
	42	const char *nvram;
	43	};
	44
	45	#define BRCMF_FW_NVRAM_DEF(fw_nvram_name, fw, nvram) \
	46	static const char BRCM_ ## fw_nvram_name ## _FIRMWARE_NAME[] = \
	47	BRCMF_FW_DEFAULT_PATH fw; \
	48	static const char BRCM_ ## fw_nvram_name ## _NVRAM_NAME[] = \
	49	BRCMF_FW_DEFAULT_PATH nvram; \
23195ec0	50	MODULE_FIRMWARE(BRCMF_FW_DEFAULT_PATH fw);
46d703a7 HM	51
	52	#define BRCMF_FW_DEF(fw_name, fw) \
	53	static const char BRCM_ ## fw_name ## _FIRMWARE_NAME[] = \
	54	BRCMF_FW_DEFAULT_PATH fw; \
	55	MODULE_FIRMWARE(BRCMF_FW_DEFAULT_PATH fw) \
	56
	57	#define BRCMF_FW_NVRAM_ENTRY(chipid, mask, name) \
	58	{ chipid, mask, \
	59	BRCM_ ## name ## _FIRMWARE_NAME, BRCM_ ## name ## _NVRAM_NAME }
	60
	61	#define BRCMF_FW_ENTRY(chipid, mask, name) \
	62	{ chipid, mask, BRCM_ ## name ## _FIRMWARE_NAME, NULL }
	63
	64	int brcmf_fw_map_chip_to_name(u32 chip, u32 chiprev,
	65	struct brcmf_firmware_mapping mapping_table[],
	66	u32 table_size, char fw_name[BRCMF_FW_NAME_LEN],
	67	char nvram_name[BRCMF_FW_NAME_LEN]);
dabedab9	68	void brcmf_fw_nvram_free(void *nvram);
c1416e77 AS	69	/*
	70	* Request firmware(s) asynchronously. When the asynchronous request
	71	* fails it will not use the callback, but call device_release_driver()
	72	* instead which will call the driver .remove() callback.
	73	*/
c4365534 HM	74	int brcmf_fw_get_firmwares_pcie(struct device *dev, u16 flags,
c4365534 HM	75	const char code, const char nvram,
6d0507a7	76	void (fw_cb)(struct device dev, int err,
c4365534 HM	77	const struct firmware *fw,
	78	void *nvram_image, u32 nvram_len),
	79	u16 domain_nr, u16 bus_nr);
c1416e77 AS	80	int brcmf_fw_get_firmwares(struct device *dev, u16 flags,
c1416e77 AS	81	const char code, const char nvram,
6d0507a7	82	void (fw_cb)(struct device dev, int err,
c1416e77 AS	83	const struct firmware *fw,
c1416e77 AS	84	void *nvram_image, u32 nvram_len));
a74d036f	85
dabedab9	86	#endif /* BRCMFMAC_FIRMWARE_H */