xref: /openbmc/linux/arch/arm/include/asm/firmware.h (revision f35e839a)
1 /*
2  * Copyright (C) 2012 Samsung Electronics.
3  * Kyungmin Park <kyungmin.park@samsung.com>
4  * Tomasz Figa <t.figa@samsung.com>
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License version 2 as
8  * published by the Free Software Foundation.
9  */
10 
11 #ifndef __ASM_ARM_FIRMWARE_H
12 #define __ASM_ARM_FIRMWARE_H
13 
14 #include <linux/bug.h>
15 
16 /*
17  * struct firmware_ops
18  *
19  * A structure to specify available firmware operations.
20  *
21  * A filled up structure can be registered with register_firmware_ops().
22  */
23 struct firmware_ops {
24 	/*
25 	 * Enters CPU idle mode
26 	 */
27 	int (*do_idle)(void);
28 	/*
29 	 * Sets boot address of specified physical CPU
30 	 */
31 	int (*set_cpu_boot_addr)(int cpu, unsigned long boot_addr);
32 	/*
33 	 * Boots specified physical CPU
34 	 */
35 	int (*cpu_boot)(int cpu);
36 	/*
37 	 * Initializes L2 cache
38 	 */
39 	int (*l2x0_init)(void);
40 };
41 
42 /* Global pointer for current firmware_ops structure, can't be NULL. */
43 extern const struct firmware_ops *firmware_ops;
44 
45 /*
46  * call_firmware_op(op, ...)
47  *
48  * Checks if firmware operation is present and calls it,
49  * otherwise returns -ENOSYS
50  */
51 #define call_firmware_op(op, ...)					\
52 	((firmware_ops->op) ? firmware_ops->op(__VA_ARGS__) : (-ENOSYS))
53 
54 /*
55  * register_firmware_ops(ops)
56  *
57  * A function to register platform firmware_ops struct.
58  */
59 static inline void register_firmware_ops(const struct firmware_ops *ops)
60 {
61 	BUG_ON(!ops);
62 
63 	firmware_ops = ops;
64 }
65 
66 #endif
67