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
16 /* firmware loader private fields */
29 /* We have to play tricks here much like stringify() to get the
30 __COUNTER__ macro to be expanded as we want it */
31 #define __fw_concat1(x, y) x##y
32 #define __fw_concat(x, y) __fw_concat1(x, y)
34 #define DECLARE_BUILTIN_FIRMWARE(name, blob) \
35 DECLARE_BUILTIN_FIRMWARE_SIZE(name, &(blob), sizeof(blob))
37 #define DECLARE_BUILTIN_FIRMWARE_SIZE(name, blob, size) \
38 static const struct builtin_fw __fw_concat(__builtin_fw,__COUNTER__) \
39 __used __section(".builtin_fw") = { name, blob, size }
41 #if defined(CONFIG_FW_LOADER) || (defined(CONFIG_FW_LOADER_MODULE) && defined(MODULE))
42 int request_firmware(const struct firmware
**fw
, const char *name
,
43 struct device
*device
);
44 int firmware_request_nowarn(const struct firmware
**fw
, const char *name
,
45 struct device
*device
);
46 int firmware_request_platform(const struct firmware
**fw
, const char *name
,
47 struct device
*device
);
48 int request_firmware_nowait(
49 struct module
*module
, bool uevent
,
50 const char *name
, struct device
*device
, gfp_t gfp
, void *context
,
51 void (*cont
)(const struct firmware
*fw
, void *context
));
52 int request_firmware_direct(const struct firmware
**fw
, const char *name
,
53 struct device
*device
);
54 int request_firmware_into_buf(const struct firmware
**firmware_p
,
55 const char *name
, struct device
*device
, void *buf
, size_t size
);
56 int request_partial_firmware_into_buf(const struct firmware
**firmware_p
,
57 const char *name
, struct device
*device
,
58 void *buf
, size_t size
, size_t offset
);
60 void release_firmware(const struct firmware
*fw
);
62 static inline int request_firmware(const struct firmware
**fw
,
64 struct device
*device
)
69 static inline int firmware_request_nowarn(const struct firmware
**fw
,
71 struct device
*device
)
76 static inline int firmware_request_platform(const struct firmware
**fw
,
78 struct device
*device
)
83 static inline int request_firmware_nowait(
84 struct module
*module
, bool uevent
,
85 const char *name
, struct device
*device
, gfp_t gfp
, void *context
,
86 void (*cont
)(const struct firmware
*fw
, void *context
))
91 static inline void release_firmware(const struct firmware
*fw
)
95 static inline int request_firmware_direct(const struct firmware
**fw
,
97 struct device
*device
)
102 static inline int request_firmware_into_buf(const struct firmware
**firmware_p
,
103 const char *name
, struct device
*device
, void *buf
, size_t size
)
108 static inline int request_partial_firmware_into_buf
109 (const struct firmware
**firmware_p
,
111 struct device
*device
,
112 void *buf
, size_t size
, size_t offset
)
119 int firmware_request_cache(struct device
*device
, const char *name
);