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