blob: 53d1e6c4f848e710436c77d8fb8b146b7a8ba0e7 [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>
Johannes Berg9ebfbd42009-10-29 12:36:02 +01007#include <linux/gfp.h>
David Woodhouse5658c762008-05-23 13:52:42 +01008
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;
David Woodhousedd336c52010-05-02 11:21:21 +030015 struct page **pages;
Linus Torvalds1da177e2005-04-16 15:20:36 -070016};
James Bottomleyfbab9762008-03-07 08:57:54 -060017
Linus Torvalds1da177e2005-04-16 15:20:36 -070018struct device;
James Bottomleyfbab9762008-03-07 08:57:54 -060019
David Woodhouse5658c762008-05-23 13:52:42 +010020struct 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
James Bottomley69d44a12008-07-04 09:59:27 -070038#if defined(CONFIG_FW_LOADER) || (defined(CONFIG_FW_LOADER_MODULE) && defined(MODULE))
Linus Torvalds1da177e2005-04-16 15:20:36 -070039int request_firmware(const struct firmware **fw, const char *name,
40 struct device *device);
41int request_firmware_nowait(
Kay Sievers312c0042005-11-16 09:00:00 +010042 struct module *module, int uevent,
Johannes Berg9ebfbd42009-10-29 12:36:02 +010043 const char *name, struct device *device, gfp_t gfp, void *context,
Linus Torvalds1da177e2005-04-16 15:20:36 -070044 void (*cont)(const struct firmware *fw, void *context));
45
46void release_firmware(const struct firmware *fw);
James Bottomleyfbab9762008-03-07 08:57:54 -060047#else
48static inline int request_firmware(const struct firmware **fw,
49 const char *name,
50 struct device *device)
51{
52 return -EINVAL;
53}
54static inline int request_firmware_nowait(
55 struct module *module, int uevent,
Johannes Berg9ebfbd42009-10-29 12:36:02 +010056 const char *name, struct device *device, gfp_t gfp, void *context,
James Bottomleyfbab9762008-03-07 08:57:54 -060057 void (*cont)(const struct firmware *fw, void *context))
58{
59 return -EINVAL;
60}
61
62static inline void release_firmware(const struct firmware *fw)
63{
64}
65#endif
66
Linus Torvalds1da177e2005-04-16 15:20:36 -070067#endif