1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef _LINUX_FIRMWARE_H
3 #define _LINUX_FIRMWARE_H
5 #include <linux/types.h>
6 #include <linux/compiler.h>
9 #define FW_ACTION_NOHOTPLUG 0
10 #define FW_ACTION_HOTPLUG 1
17 /* firmware loader private fields */
30 /* We have to play tricks here much like stringify() to get the
31 __COUNTER__ macro to be expanded as we want it */
32 #define __fw_concat1(x, y) x##y
33 #define __fw_concat(x, y) __fw_concat1(x, y)
35 #define DECLARE_BUILTIN_FIRMWARE(name, blob) \
36 DECLARE_BUILTIN_FIRMWARE_SIZE(name, &(blob), sizeof(blob))
38 #define DECLARE_BUILTIN_FIRMWARE_SIZE(name, blob, size) \
39 static const struct builtin_fw __fw_concat(__builtin_fw,__COUNTER__) \
40 __used __section(.builtin_fw) = { name, blob, size }
42 #if defined(CONFIG_FW_LOADER) || (defined(CONFIG_FW_LOADER_MODULE) && defined(MODULE))
43 int request_firmware(const struct firmware **fw, const char *name,
44 struct device *device);
45 int firmware_request_nowarn(const struct firmware **fw, const char *name,
46 struct device *device);
47 int firmware_request_platform(const struct firmware **fw, const char *name,
48 struct device *device);
49 int request_firmware_nowait(
50 struct module *module, bool uevent,
51 const char *name, struct device *device, gfp_t gfp, void *context,
52 void (*cont)(const struct firmware *fw, void *context));
53 int request_firmware_direct(const struct firmware **fw, const char *name,
54 struct device *device);
55 int request_firmware_into_buf(const struct firmware **firmware_p,
56 const char *name, struct device *device, void *buf, size_t size);
58 void release_firmware(const struct firmware *fw);
60 static inline int request_firmware(const struct firmware **fw,
62 struct device *device)
67 static inline int firmware_request_nowarn(const struct firmware **fw,
69 struct device *device)
74 static inline int firmware_request_platform(const struct firmware **fw,
76 struct device *device)
81 static inline int request_firmware_nowait(
82 struct module *module, bool uevent,
83 const char *name, struct device *device, gfp_t gfp, void *context,
84 void (*cont)(const struct firmware *fw, void *context))
89 static inline void release_firmware(const struct firmware *fw)
93 static inline int request_firmware_direct(const struct firmware **fw,
95 struct device *device)
100 static inline int request_firmware_into_buf(const struct firmware **firmware_p,
101 const char *name, struct device *device, void *buf, size_t size)
108 int firmware_request_cache(struct device *device, const char *name);