include/linux/of_reserved_mem.h

   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
  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
  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
  60 static inline void of_reserved_mem_device_release(struct device *pdev) { }
  61
  62 static inline void fdt_init_reserved_mem(void) { }
  63 static inline void fdt_reserved_mem_save_node(unsigned long node,
  64                 const char *uname, phys_addr_t base, phys_addr_t size) { }
  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  */
  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 */