6d0507a777
Extend the parameters in the firmware callback so it can be called upon success and failure. This allows the caller to properly clear all resources in the failure path. Right now the error code is always zero, ie. success. Cc: stable@vger.kernel.org # 4.9.x- Reviewed-by: Hante Meuleman <hante.meuleman@broadcom.com> Reviewed-by: Pieter-Paul Giesberts <pieter-paul.giesberts@broadcom.com> Reviewed-by: Franky Lin <franky.lin@broadcom.com> Signed-off-by: Arend van Spriel <arend.vanspriel@broadcom.com> Signed-off-by: Kalle Valo <kvalo@codeaurora.org>
87 lines
3.2 KiB
C
87 lines
3.2 KiB
C
/*
|
|
* 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 */
|