blob: c8ecf5b2a207371d5662234ec4eb9be9d3420c14 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001#ifndef _LINUX_FIRMWARE_H
2#define _LINUX_FIRMWARE_H
David Woodhouse5658c762008-05-23 13:52:42 +01003
Linus Torvalds1da177e2005-04-16 15:20:36 -07004#include <linux/module.h>
5#include <linux/types.h>
David Woodhouse5658c762008-05-23 13:52:42 +01006#include <linux/compiler.h>
7
Linus Torvalds1da177e2005-04-16 15:20:36 -07008#define FIRMWARE_NAME_MAX 30
Abhay Salunke6e3eaab2005-09-06 15:17:13 -07009#define FW_ACTION_NOHOTPLUG 0
10#define FW_ACTION_HOTPLUG 1
11
Linus Torvalds1da177e2005-04-16 15:20:36 -070012struct firmware {
13 size_t size;
David Woodhouseb7a39bd2008-05-23 18:38:49 +010014 const u8 *data;
Linus Torvalds1da177e2005-04-16 15:20:36 -070015};
James Bottomleyfbab9762008-03-07 08:57:54 -060016
Linus Torvalds1da177e2005-04-16 15:20:36 -070017struct device;
James Bottomleyfbab9762008-03-07 08:57:54 -060018
David Woodhouse5658c762008-05-23 13:52:42 +010019struct builtin_fw {
20 char *name;
21 void *data;
22 unsigned long size;
23};
24
25/* We have to play tricks here much like stringify() to get the
26 __COUNTER__ macro to be expanded as we want it */
27#define __fw_concat1(x, y) x##y
28#define __fw_concat(x, y) __fw_concat1(x, y)
29
30#define DECLARE_BUILTIN_FIRMWARE(name, blob) \
31 DECLARE_BUILTIN_FIRMWARE_SIZE(name, &(blob), sizeof(blob))
32
33#define DECLARE_BUILTIN_FIRMWARE_SIZE(name, blob, size) \
34 static const struct builtin_fw __fw_concat(__builtin_fw,__COUNTER__) \
35 __used __section(.builtin_fw) = { name, blob, size }
36
James Bottomley69d44a12008-07-04 09:59:27 -070037#if defined(CONFIG_FW_LOADER) || (defined(CONFIG_FW_LOADER_MODULE) && defined(MODULE))
Linus Torvalds1da177e2005-04-16 15:20:36 -070038int request_firmware(const struct firmware **fw, const char *name,
39 struct device *device);
40int request_firmware_nowait(
Kay Sievers312c0042005-11-16 09:00:00 +010041 struct module *module, int uevent,
Linus Torvalds1da177e2005-04-16 15:20:36 -070042 const char *name, struct device *device, void *context,
43 void (*cont)(const struct firmware *fw, void *context));
44
45void release_firmware(const struct firmware *fw);
James Bottomleyfbab9762008-03-07 08:57:54 -060046#else
47static inline int request_firmware(const struct firmware **fw,
48 const char *name,
49 struct device *device)
50{
51 return -EINVAL;
52}
53static inline int request_firmware_nowait(
54 struct module *module, int uevent,
55 const char *name, struct device *device, void *context,
56 void (*cont)(const struct firmware *fw, void *context))
57{
58 return -EINVAL;
59}
60
61static inline void release_firmware(const struct firmware *fw)
62{
63}
64#endif
65
Linus Torvalds1da177e2005-04-16 15:20:36 -070066#endif