1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef __OF_RESERVED_MEM_H
3 #define __OF_RESERVED_MEM_H
4 
5 #include <linux/device.h>
6 #include <linux/of.h>
7 
8 struct of_phandle_args;
9 struct reserved_mem_ops;
10 
11 struct reserved_mem {
12 	const char			*name;
13 	unsigned long			fdt_node;
14 	unsigned long			phandle;
15 	const struct reserved_mem_ops	*ops;
16 	phys_addr_t			base;
17 	phys_addr_t			size;
18 	void				*priv;
19 };
20 
21 struct reserved_mem_ops {
22 	int	(*device_init)(struct reserved_mem *rmem,
23 			       struct device *dev);
24 	void	(*device_release)(struct reserved_mem *rmem,
25 				  struct device *dev);
26 };
27 
28 typedef int (*reservedmem_of_init_fn)(struct reserved_mem *rmem);
29 
30 #define RESERVEDMEM_OF_DECLARE(name, compat, init)			\
31 	_OF_DECLARE(reservedmem, name, compat, init, reservedmem_of_init_fn)
32 
33 #ifdef CONFIG_OF_RESERVED_MEM
34 
35 int of_reserved_mem_device_init_by_idx(struct device *dev,
36 				       struct device_node *np, int idx);
37 int of_reserved_mem_device_init_by_name(struct device *dev,
38 					struct device_node *np,
39 					const char *name);
40 void of_reserved_mem_device_release(struct device *dev);
41 
42 void fdt_init_reserved_mem(void);
43 void fdt_reserved_mem_save_node(unsigned long node, const char *uname,
44 			       phys_addr_t base, phys_addr_t size);
45 struct reserved_mem *of_reserved_mem_lookup(struct device_node *np);
46 #else
of_reserved_mem_device_init_by_idx(struct device * dev,struct device_node * np,int idx)47 static inline int of_reserved_mem_device_init_by_idx(struct device *dev,
48 					struct device_node *np, int idx)
49 {
50 	return -ENOSYS;
51 }
52 
of_reserved_mem_device_init_by_name(struct device * dev,struct device_node * np,const char * name)53 static inline int of_reserved_mem_device_init_by_name(struct device *dev,
54 						      struct device_node *np,
55 						      const char *name)
56 {
57 	return -ENOSYS;
58 }
59 
of_reserved_mem_device_release(struct device * pdev)60 static inline void of_reserved_mem_device_release(struct device *pdev) { }
61 
fdt_init_reserved_mem(void)62 static inline void fdt_init_reserved_mem(void) { }
fdt_reserved_mem_save_node(unsigned long node,const char * uname,phys_addr_t base,phys_addr_t size)63 static inline void fdt_reserved_mem_save_node(unsigned long node,
64 		const char *uname, phys_addr_t base, phys_addr_t size) { }
of_reserved_mem_lookup(struct device_node * np)65 static inline struct reserved_mem *of_reserved_mem_lookup(struct device_node *np)
66 {
67 	return NULL;
68 }
69 #endif
70 
71 /**
72  * of_reserved_mem_device_init() - assign reserved memory region to given device
73  * @dev:	Pointer to the device to configure
74  *
75  * This function assigns respective DMA-mapping operations based on the first
76  * reserved memory region specified by 'memory-region' property in device tree
77  * node of the given device.
78  *
79  * Returns error code or zero on success.
80  */
of_reserved_mem_device_init(struct device * dev)81 static inline int of_reserved_mem_device_init(struct device *dev)
82 {
83 	return of_reserved_mem_device_init_by_idx(dev, dev->of_node, 0);
84 }
85 
86 #endif /* __OF_RESERVED_MEM_H */
87