firmware.h 2.01 KB
Newer Older
Linus Torvalds's avatar
Linus Torvalds committed
1 2
#ifndef _LINUX_FIRMWARE_H
#define _LINUX_FIRMWARE_H
3

Linus Torvalds's avatar
Linus Torvalds committed
4
#include <linux/types.h>
5
#include <linux/compiler.h>
6
#include <linux/gfp.h>
7

8 9 10
#define FW_ACTION_NOHOTPLUG 0
#define FW_ACTION_HOTPLUG 1

Linus Torvalds's avatar
Linus Torvalds committed
11 12
struct firmware {
	size_t size;
13
	const u8 *data;
14
	struct page **pages;
15 16 17

	/* firmware loader private fields */
	void *priv;
Linus Torvalds's avatar
Linus Torvalds committed
18
};
19

20
struct module;
Linus Torvalds's avatar
Linus Torvalds committed
21
struct device;
22

23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40
struct builtin_fw {
	char *name;
	void *data;
	unsigned long size;
};

/* We have to play tricks here much like stringify() to get the
   __COUNTER__ macro to be expanded as we want it */
#define __fw_concat1(x, y) x##y
#define __fw_concat(x, y) __fw_concat1(x, y)

#define DECLARE_BUILTIN_FIRMWARE(name, blob)				     \
	DECLARE_BUILTIN_FIRMWARE_SIZE(name, &(blob), sizeof(blob))

#define DECLARE_BUILTIN_FIRMWARE_SIZE(name, blob, size)			     \
	static const struct builtin_fw __fw_concat(__builtin_fw,__COUNTER__) \
	__used __section(.builtin_fw) = { name, blob, size }

41
#if defined(CONFIG_FW_LOADER) || (defined(CONFIG_FW_LOADER_MODULE) && defined(MODULE))
Linus Torvalds's avatar
Linus Torvalds committed
42 43 44
int request_firmware(const struct firmware **fw, const char *name,
		     struct device *device);
int request_firmware_nowait(
45
	struct module *module, bool uevent,
46
	const char *name, struct device *device, gfp_t gfp, void *context,
Linus Torvalds's avatar
Linus Torvalds committed
47
	void (*cont)(const struct firmware *fw, void *context));
48 49
int request_firmware_direct(const struct firmware **fw, const char *name,
			    struct device *device);
Linus Torvalds's avatar
Linus Torvalds committed
50 51

void release_firmware(const struct firmware *fw);
52 53 54 55 56 57 58 59
#else
static inline int request_firmware(const struct firmware **fw,
				   const char *name,
				   struct device *device)
{
	return -EINVAL;
}
static inline int request_firmware_nowait(
60
	struct module *module, bool uevent,
61
	const char *name, struct device *device, gfp_t gfp, void *context,
62 63 64 65 66 67 68 69
	void (*cont)(const struct firmware *fw, void *context))
{
	return -EINVAL;
}

static inline void release_firmware(const struct firmware *fw)
{
}
70

71 72 73 74 75 76
static inline int request_firmware_direct(const struct firmware **fw,
					  const char *name,
					  struct device *device)
{
	return -EINVAL;
}
77

78
#endif
Linus Torvalds's avatar
Linus Torvalds committed
79
#endif