1 #ifndef _LINUX_FIRMWARE_H
2 #define _LINUX_FIRMWARE_H
3 
4 #include <linux/types.h>
5 #include <linux/compiler.h>
6 #include <linux/gfp.h>
7 
8 #define FW_ACTION_NOHOTPLUG 0
9 #define FW_ACTION_HOTPLUG 1
10 
11 struct firmware {
12 	size_t size;
13 	const u8 *data;
14 	struct page **pages;
15 };
16 
17 struct module;
18 struct device;
19 
20 struct builtin_fw {
21 	char *name;
22 	void *data;
23 	unsigned long size;
24 };
25 
26 /* We have to play tricks here much like stringify() to get the
27    __COUNTER__ macro to be expanded as we want it */
28 #define __fw_concat1(x, y) x##y
29 #define __fw_concat(x, y) __fw_concat1(x, y)
30 
31 #define DECLARE_BUILTIN_FIRMWARE(name, blob)				     \
32 	DECLARE_BUILTIN_FIRMWARE_SIZE(name, &(blob), sizeof(blob))
33 
34 #define DECLARE_BUILTIN_FIRMWARE_SIZE(name, blob, size)			     \
35 	static const struct builtin_fw __fw_concat(__builtin_fw,__COUNTER__) \
36 	__used __section(.builtin_fw) = { name, blob, size }
37 
38 #if defined(CONFIG_FW_LOADER) || (defined(CONFIG_FW_LOADER_MODULE) && defined(MODULE))
39 int request_firmware(const struct firmware **fw, const char *name,
40 		     struct device *device);
41 int request_firmware_nowait(
42 	struct module *module, bool uevent,
43 	const char *name, struct device *device, gfp_t gfp, void *context,
44 	void (*cont)(const struct firmware *fw, void *context));
45 
46 void release_firmware(const struct firmware *fw);
47 #else
request_firmware(const struct firmware ** fw,const char * name,struct device * device)48 static inline int request_firmware(const struct firmware **fw,
49 				   const char *name,
50 				   struct device *device)
51 {
52 	return -EINVAL;
53 }
request_firmware_nowait(struct module * module,bool uevent,const char * name,struct device * device,gfp_t gfp,void * context,void (* cont)(const struct firmware * fw,void * context))54 static inline int request_firmware_nowait(
55 	struct module *module, bool uevent,
56 	const char *name, struct device *device, gfp_t gfp, void *context,
57 	void (*cont)(const struct firmware *fw, void *context))
58 {
59 	return -EINVAL;
60 }
61 
release_firmware(const struct firmware * fw)62 static inline void release_firmware(const struct firmware *fw)
63 {
64 }
65 #endif
66 
67 #endif
68