LXR qemu/include/sysemu/device

   1/*
   2 * Header with function prototypes to help device tree manipulation using
   3 * libfdt. It also provides functions to read entries from device tree proc
   4 * interface.
   5 *
   6 * Copyright 2008 IBM Corporation.
   7 * Authors: Jerone Young <jyoung5@us.ibm.com>
   8 *          Hollis Blanchard <hollisb@us.ibm.com>
   9 *
  10 * This work is licensed under the GNU GPL license version 2 or later.
  11 *
  12 */
  13
  14#ifndef __DEVICE_TREE_H__
  15#define __DEVICE_TREE_H__
  16
  17void *create_device_tree(int *sizep);
  18void *load_device_tree(const char *filename_path, int *sizep);
  19
  20int qemu_devtree_setprop(void *fdt, const char *node_path,
  21                         const char *property, const void *val_array, int size);
  22int qemu_devtree_setprop_cell(void *fdt, const char *node_path,
  23                              const char *property, uint32_t val);
  24int qemu_devtree_setprop_u64(void *fdt, const char *node_path,
  25                             const char *property, uint64_t val);
  26int qemu_devtree_setprop_string(void *fdt, const char *node_path,
  27                                const char *property, const char *string);
  28int qemu_devtree_setprop_phandle(void *fdt, const char *node_path,
  29                                 const char *property,
  30                                 const char *target_node_path);
  31const void *qemu_devtree_getprop(void *fdt, const char *node_path,
  32                                 const char *property, int *lenp);
  33uint32_t qemu_devtree_getprop_cell(void *fdt, const char *node_path,
  34                                   const char *property);
  35uint32_t qemu_devtree_get_phandle(void *fdt, const char *path);
  36uint32_t qemu_devtree_alloc_phandle(void *fdt);
  37int qemu_devtree_nop_node(void *fdt, const char *node_path);
  38int qemu_devtree_add_subnode(void *fdt, const char *name);
  39
  40#define qemu_devtree_setprop_cells(fdt, node_path, property, ...)             \
  41    do {                                                                      \
  42        uint32_t qdt_tmp[] = { __VA_ARGS__ };                                 \
  43        int i;                                                                \
  44                                                                              \
  45        for (i = 0; i < ARRAY_SIZE(qdt_tmp); i++) {                           \
  46            qdt_tmp[i] = cpu_to_be32(qdt_tmp[i]);                             \
  47        }                                                                     \
  48        qemu_devtree_setprop(fdt, node_path, property, qdt_tmp,               \
  49                             sizeof(qdt_tmp));                                \
  50    } while (0)
  51
  52void qemu_devtree_dumpdtb(void *fdt, int size);
  53
  54/**
  55 * qemu_devtree_setprop_sized_cells_from_array:
  56 * @fdt: device tree blob
  57 * @node_path: node to set property on
  58 * @property: property to set
  59 * @numvalues: number of values
  60 * @values: array of number-of-cells, value pairs
  61 *
  62 * Set the specified property on the specified node in the device tree
  63 * to be an array of cells. The values of the cells are specified via
  64 * the values list, which alternates between "number of cells used by
  65 * this value" and "value".
  66 * number-of-cells must be either 1 or 2 (other values will result in
  67 * an error being returned). If a value is too large to fit in the
  68 * number of cells specified for it, an error is returned.
  69 *
  70 * This function is useful because device tree nodes often have cell arrays
  71 * which are either lists of addresses or lists of address,size tuples, but
  72 * the number of cells used for each element vary depending on the
  73 * #address-cells and #size-cells properties of their parent node.
  74 * If you know all your cell elements are one cell wide you can use the
  75 * simpler qemu_devtree_setprop_cells(). If you're not setting up the
  76 * array programmatically, qemu_devtree_setprop_sized_cells may be more
  77 * convenient.
  78 *
  79 * Return value: 0 on success, <0 on error.
  80 */
  81int qemu_devtree_setprop_sized_cells_from_array(void *fdt,
  82                                                const char *node_path,
  83                                                const char *property,
  84                                                int numvalues,
  85                                                uint64_t *values);
  86
  87/**
  88 * qemu_devtree_setprop_sized_cells:
  89 * @fdt: device tree blob
  90 * @node_path: node to set property on
  91 * @property: property to set
  92 * @...: list of number-of-cells, value pairs
  93 *
  94 * Set the specified property on the specified node in the device tree
  95 * to be an array of cells. The values of the cells are specified via
  96 * the variable arguments, which alternates between "number of cells
  97 * used by this value" and "value".
  98 *
  99 * This is a convenience wrapper for the function
 100 * qemu_devtree_setprop_sized_cells_from_array().
 101 *
 102 * Return value: 0 on success, <0 on error.
 103 */
 104#define qemu_devtree_setprop_sized_cells(fdt, node_path, property, ...)       \
 105    ({                                                                        \
 106        uint64_t qdt_tmp[] = { __VA_ARGS__ };                                 \
 107        qemu_devtree_setprop_sized_cells_from_array(fdt, node_path,           \
 108                                                    property,                 \
 109                                                    ARRAY_SIZE(qdt_tmp) / 2,  \
 110                                                    qdt_tmp);                 \
 111    })
 112
 113#endif /* __DEVICE_TREE_H__ */
 114