mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-09-23 02:51:47 +00:00
7cb46e7214
Apple platforms have firmware and config files identified with multiple dimensions. We want to be able to find the most specific firmware available for any given platform, progressively trying more general firmwares. To do this, first add support for passing in multiple board_types, which will be tried in sequence. Since this will cause more log spam due to missing firmwares, also switch the secondary firmware fecthes to use the _nowarn variant, which will not log if the firmware is not found. Signed-off-by: Hector Martin <marcan@marcan.st> Reviewed-by: Alvin Šipraga <alsi@bang-olufsen.dk> Signed-off-by: Russell King (Oracle) <rmk+kernel@armlinux.org.uk> Signed-off-by: Kalle Valo <kvalo@kernel.org> Link: https://lore.kernel.org/r/E1oZDnd-0077aG-Dk@rmk-PC.armlinux.org.uk
95 lines
2.4 KiB
C
95 lines
2.4 KiB
C
// SPDX-License-Identifier: ISC
|
|
/*
|
|
* Copyright (c) 2013 Broadcom Corporation
|
|
*/
|
|
#ifndef BRCMFMAC_FIRMWARE_H
|
|
#define BRCMFMAC_FIRMWARE_H
|
|
|
|
#define BRCMF_FW_REQF_OPTIONAL 0x0001
|
|
|
|
#define BRCMF_FW_NAME_LEN 320
|
|
|
|
#define BRCMF_FW_DEFAULT_PATH "brcm/"
|
|
|
|
#define BRCMF_FW_MAX_BOARD_TYPES 8
|
|
|
|
/**
|
|
* 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_base;
|
|
};
|
|
|
|
#define BRCMF_FW_DEF(fw_name, fw_base) \
|
|
static const char BRCM_ ## fw_name ## _FIRMWARE_BASENAME[] = \
|
|
BRCMF_FW_DEFAULT_PATH fw_base; \
|
|
MODULE_FIRMWARE(BRCMF_FW_DEFAULT_PATH fw_base ".bin")
|
|
|
|
/* Firmware and Country Local Matrix files */
|
|
#define BRCMF_FW_CLM_DEF(fw_name, fw_base) \
|
|
static const char BRCM_ ## fw_name ## _FIRMWARE_BASENAME[] = \
|
|
BRCMF_FW_DEFAULT_PATH fw_base; \
|
|
MODULE_FIRMWARE(BRCMF_FW_DEFAULT_PATH fw_base ".bin"); \
|
|
MODULE_FIRMWARE(BRCMF_FW_DEFAULT_PATH fw_base ".clm_blob")
|
|
|
|
#define BRCMF_FW_ENTRY(chipid, mask, name) \
|
|
{ chipid, mask, BRCM_ ## name ## _FIRMWARE_BASENAME }
|
|
|
|
void brcmf_fw_nvram_free(void *nvram);
|
|
|
|
enum brcmf_fw_type {
|
|
BRCMF_FW_TYPE_BINARY,
|
|
BRCMF_FW_TYPE_NVRAM
|
|
};
|
|
|
|
struct brcmf_fw_item {
|
|
const char *path;
|
|
enum brcmf_fw_type type;
|
|
u16 flags;
|
|
union {
|
|
const struct firmware *binary;
|
|
struct {
|
|
void *data;
|
|
u32 len;
|
|
} nv_data;
|
|
};
|
|
};
|
|
|
|
struct brcmf_fw_request {
|
|
u16 domain_nr;
|
|
u16 bus_nr;
|
|
u32 n_items;
|
|
const char *board_types[BRCMF_FW_MAX_BOARD_TYPES];
|
|
struct brcmf_fw_item items[];
|
|
};
|
|
|
|
struct brcmf_fw_name {
|
|
const char *extension;
|
|
char *path;
|
|
};
|
|
|
|
struct brcmf_fw_request *
|
|
brcmf_fw_alloc_request(u32 chip, u32 chiprev,
|
|
const struct brcmf_firmware_mapping mapping_table[],
|
|
u32 table_size, struct brcmf_fw_name *fwnames,
|
|
u32 n_fwnames);
|
|
|
|
/*
|
|
* 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(struct device *dev, struct brcmf_fw_request *req,
|
|
void (*fw_cb)(struct device *dev, int err,
|
|
struct brcmf_fw_request *req));
|
|
|
|
#endif /* BRCMFMAC_FIRMWARE_H */
|