LXR linux/include/linux/of_reserved

   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
   7struct of_phandle_args;
   8struct reserved_mem_ops;
   9
  10struct 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
  20struct 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
  27typedef 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
  34int of_reserved_mem_device_init_by_idx(struct device *dev,
  35                                       struct device_node *np, int idx);
  36void of_reserved_mem_device_release(struct device *dev);
  37
  38int 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
  45void fdt_init_reserved_mem(void);
  46void fdt_reserved_mem_save_node(unsigned long node, const char *uname,
  47                               phys_addr_t base, phys_addr_t size);
  48#else
  49static inline int of_reserved_mem_device_init_by_idx(struct device *dev,
  50                                        struct device_node *np, int idx)
  51{
  52        return -ENOSYS;
  53}
  54static inline void of_reserved_mem_device_release(struct device *pdev) { }
  55
  56static inline void fdt_init_reserved_mem(void) { }
  57static 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 */
  71static 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 */
  77