Commit | Line | Data |
---|---|---|
b2441318 | 1 | /* SPDX-License-Identifier: GPL-2.0 */ |
1da177e4 LT |
2 | #ifndef _LINUX_FIRMWARE_H |
3 | #define _LINUX_FIRMWARE_H | |
5658c769 | 4 | |
1da177e4 | 5 | #include <linux/types.h> |
5658c769 | 6 | #include <linux/compiler.h> |
9ebfbd45 | 7 | #include <linux/gfp.h> |
5658c769 | 8 | |
0733d839 SG |
9 | #define FW_ACTION_NOUEVENT 0 |
10 | #define FW_ACTION_UEVENT 1 | |
6e3eaab0 | 11 | |
1da177e4 LT |
12 | struct firmware { |
13 | size_t size; | |
b7a39bd0 | 14 | const u8 *data; |
1f2b7959 ML |
15 | |
16 | /* firmware loader private fields */ | |
17 | void *priv; | |
1da177e4 | 18 | }; |
fbab976d | 19 | |
de477254 | 20 | struct module; |
1da177e4 | 21 | struct device; |
fbab976d | 22 | |
5658c769 DW |
23 | struct builtin_fw { |
24 | char *name; | |
25 | void *data; | |
26 | unsigned long size; | |
27 | }; | |
28 | ||
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) | |
33 | ||
34 | #define DECLARE_BUILTIN_FIRMWARE(name, blob) \ | |
35 | DECLARE_BUILTIN_FIRMWARE_SIZE(name, &(blob), sizeof(blob)) | |
36 | ||
37 | #define DECLARE_BUILTIN_FIRMWARE_SIZE(name, blob, size) \ | |
38 | static const struct builtin_fw __fw_concat(__builtin_fw,__COUNTER__) \ | |
33def849 | 39 | __used __section(".builtin_fw") = { name, blob, size } |
5658c769 | 40 | |
69d44a18 | 41 | #if defined(CONFIG_FW_LOADER) || (defined(CONFIG_FW_LOADER_MODULE) && defined(MODULE)) |
1da177e4 LT |
42 | int request_firmware(const struct firmware **fw, const char *name, |
43 | struct device *device); | |
7dcc0134 AR |
44 | int firmware_request_nowarn(const struct firmware **fw, const char *name, |
45 | struct device *device); | |
e4c2c0ff HG |
46 | int firmware_request_platform(const struct firmware **fw, const char *name, |
47 | struct device *device); | |
1da177e4 | 48 | int request_firmware_nowait( |
072fc8f0 | 49 | struct module *module, bool uevent, |
9ebfbd45 | 50 | const char *name, struct device *device, gfp_t gfp, void *context, |
1da177e4 | 51 | void (*cont)(const struct firmware *fw, void *context)); |
c868edf4 LR |
52 | int request_firmware_direct(const struct firmware **fw, const char *name, |
53 | struct device *device); | |
a098ecd2 SB |
54 | int request_firmware_into_buf(const struct firmware **firmware_p, |
55 | const char *name, struct device *device, void *buf, size_t size); | |
59cdb23c SB |
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); | |
1da177e4 LT |
59 | |
60 | void release_firmware(const struct firmware *fw); | |
fbab976d JB |
61 | #else |
62 | static inline int request_firmware(const struct firmware **fw, | |
63 | const char *name, | |
64 | struct device *device) | |
65 | { | |
66 | return -EINVAL; | |
67 | } | |
7dcc0134 AR |
68 | |
69 | static inline int firmware_request_nowarn(const struct firmware **fw, | |
70 | const char *name, | |
71 | struct device *device) | |
72 | { | |
73 | return -EINVAL; | |
74 | } | |
75 | ||
e4c2c0ff HG |
76 | static inline int firmware_request_platform(const struct firmware **fw, |
77 | const char *name, | |
78 | struct device *device) | |
79 | { | |
80 | return -EINVAL; | |
81 | } | |
82 | ||
fbab976d | 83 | static inline int request_firmware_nowait( |
072fc8f0 | 84 | struct module *module, bool uevent, |
9ebfbd45 | 85 | const char *name, struct device *device, gfp_t gfp, void *context, |
fbab976d JB |
86 | void (*cont)(const struct firmware *fw, void *context)) |
87 | { | |
88 | return -EINVAL; | |
89 | } | |
90 | ||
91 | static inline void release_firmware(const struct firmware *fw) | |
92 | { | |
93 | } | |
2887b395 | 94 | |
c868edf4 LR |
95 | static inline int request_firmware_direct(const struct firmware **fw, |
96 | const char *name, | |
97 | struct device *device) | |
98 | { | |
99 | return -EINVAL; | |
100 | } | |
fbab976d | 101 | |
a098ecd2 SB |
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) | |
104 | { | |
105 | return -EINVAL; | |
106 | } | |
107 | ||
59cdb23c SB |
108 | static inline int request_partial_firmware_into_buf |
109 | (const struct firmware **firmware_p, | |
110 | const char *name, | |
111 | struct device *device, | |
112 | void *buf, size_t size, size_t offset) | |
113 | { | |
114 | return -EINVAL; | |
115 | } | |
116 | ||
bba3a87e | 117 | #endif |
5d42c96e LR |
118 | |
119 | int firmware_request_cache(struct device *device, const char *name); | |
120 | ||
1da177e4 | 121 | #endif |