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
   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 #else
  49 static inline int of_reserved_mem_device_init_by_idx(struct device *dev,
  50                                         struct device_node *np, int idx)
  51 {
  52         return -ENOSYS;
  53 }
  54 static inline void of_reserved_mem_device_release(struct device *pdev) { }
  55
  56 static inline void fdt_init_reserved_mem(void) { }
  57 static inline void fdt_reserved_mem_save_node(unsigned long node,
  58                 const char *uname, phys_addr_t base, phys_addr_t size) { }
  59 #endif
  60
  61 /**
  62  * of_reserved_mem_device_init() - assign reserved memory region to given device
  63  * @dev:        Pointer to the device to configure
  64  *
  65  * This function assigns respective DMA-mapping operations based on the first
  66  * reserved memory region specified by 'memory-region' property in device tree
  67  * node of the given device.
  68  *
  69  * Returns error code or zero on success.
  70  */
  71 static inline int of_reserved_mem_device_init(struct device *dev)
  72 {
  73         return of_reserved_mem_device_init_by_idx(dev, dev->of_node, 0);
  74 }
  75
  76 #endif /* __OF_RESERVED_MEM_H */