114 lines
		
	
	
		
			5.1 KiB
		
	
	
	
		
			C
		
	
	
	
			
		
		
	
	
			114 lines
		
	
	
		
			5.1 KiB
		
	
	
	
		
			C
		
	
	
	
/*
 | 
						|
 * Header with function prototypes to help device tree manipulation using
 | 
						|
 * libfdt. It also provides functions to read entries from device tree proc
 | 
						|
 * interface.
 | 
						|
 *
 | 
						|
 * Copyright 2008 IBM Corporation.
 | 
						|
 * Authors: Jerone Young <jyoung5@us.ibm.com>
 | 
						|
 *          Hollis Blanchard <hollisb@us.ibm.com>
 | 
						|
 *
 | 
						|
 * This work is licensed under the GNU GPL license version 2 or later.
 | 
						|
 *
 | 
						|
 */
 | 
						|
 | 
						|
#ifndef __DEVICE_TREE_H__
 | 
						|
#define __DEVICE_TREE_H__
 | 
						|
 | 
						|
void *create_device_tree(int *sizep);
 | 
						|
void *load_device_tree(const char *filename_path, int *sizep);
 | 
						|
 | 
						|
int qemu_fdt_setprop(void *fdt, const char *node_path,
 | 
						|
                     const char *property, const void *val, int size);
 | 
						|
int qemu_fdt_setprop_cell(void *fdt, const char *node_path,
 | 
						|
                          const char *property, uint32_t val);
 | 
						|
int qemu_fdt_setprop_u64(void *fdt, const char *node_path,
 | 
						|
                         const char *property, uint64_t val);
 | 
						|
int qemu_fdt_setprop_string(void *fdt, const char *node_path,
 | 
						|
                            const char *property, const char *string);
 | 
						|
int qemu_fdt_setprop_phandle(void *fdt, const char *node_path,
 | 
						|
                             const char *property,
 | 
						|
                             const char *target_node_path);
 | 
						|
const void *qemu_fdt_getprop(void *fdt, const char *node_path,
 | 
						|
                             const char *property, int *lenp);
 | 
						|
uint32_t qemu_fdt_getprop_cell(void *fdt, const char *node_path,
 | 
						|
                               const char *property);
 | 
						|
uint32_t qemu_fdt_get_phandle(void *fdt, const char *path);
 | 
						|
uint32_t qemu_fdt_alloc_phandle(void *fdt);
 | 
						|
int qemu_fdt_nop_node(void *fdt, const char *node_path);
 | 
						|
int qemu_fdt_add_subnode(void *fdt, const char *name);
 | 
						|
 | 
						|
#define qemu_fdt_setprop_cells(fdt, node_path, property, ...)                 \
 | 
						|
    do {                                                                      \
 | 
						|
        uint32_t qdt_tmp[] = { __VA_ARGS__ };                                 \
 | 
						|
        int i;                                                                \
 | 
						|
                                                                              \
 | 
						|
        for (i = 0; i < ARRAY_SIZE(qdt_tmp); i++) {                           \
 | 
						|
            qdt_tmp[i] = cpu_to_be32(qdt_tmp[i]);                             \
 | 
						|
        }                                                                     \
 | 
						|
        qemu_fdt_setprop(fdt, node_path, property, qdt_tmp,                   \
 | 
						|
                         sizeof(qdt_tmp));                                    \
 | 
						|
    } while (0)
 | 
						|
 | 
						|
void qemu_fdt_dumpdtb(void *fdt, int size);
 | 
						|
 | 
						|
/**
 | 
						|
 * qemu_fdt_setprop_sized_cells_from_array:
 | 
						|
 * @fdt: device tree blob
 | 
						|
 * @node_path: node to set property on
 | 
						|
 * @property: property to set
 | 
						|
 * @numvalues: number of values
 | 
						|
 * @values: array of number-of-cells, value pairs
 | 
						|
 *
 | 
						|
 * Set the specified property on the specified node in the device tree
 | 
						|
 * to be an array of cells. The values of the cells are specified via
 | 
						|
 * the values list, which alternates between "number of cells used by
 | 
						|
 * this value" and "value".
 | 
						|
 * number-of-cells must be either 1 or 2 (other values will result in
 | 
						|
 * an error being returned). If a value is too large to fit in the
 | 
						|
 * number of cells specified for it, an error is returned.
 | 
						|
 *
 | 
						|
 * This function is useful because device tree nodes often have cell arrays
 | 
						|
 * which are either lists of addresses or lists of address,size tuples, but
 | 
						|
 * the number of cells used for each element vary depending on the
 | 
						|
 * #address-cells and #size-cells properties of their parent node.
 | 
						|
 * If you know all your cell elements are one cell wide you can use the
 | 
						|
 * simpler qemu_fdt_setprop_cells(). If you're not setting up the
 | 
						|
 * array programmatically, qemu_fdt_setprop_sized_cells may be more
 | 
						|
 * convenient.
 | 
						|
 *
 | 
						|
 * Return value: 0 on success, <0 on error.
 | 
						|
 */
 | 
						|
int qemu_fdt_setprop_sized_cells_from_array(void *fdt,
 | 
						|
                                            const char *node_path,
 | 
						|
                                            const char *property,
 | 
						|
                                            int numvalues,
 | 
						|
                                            uint64_t *values);
 | 
						|
 | 
						|
/**
 | 
						|
 * qemu_fdt_setprop_sized_cells:
 | 
						|
 * @fdt: device tree blob
 | 
						|
 * @node_path: node to set property on
 | 
						|
 * @property: property to set
 | 
						|
 * @...: list of number-of-cells, value pairs
 | 
						|
 *
 | 
						|
 * Set the specified property on the specified node in the device tree
 | 
						|
 * to be an array of cells. The values of the cells are specified via
 | 
						|
 * the variable arguments, which alternates between "number of cells
 | 
						|
 * used by this value" and "value".
 | 
						|
 *
 | 
						|
 * This is a convenience wrapper for the function
 | 
						|
 * qemu_fdt_setprop_sized_cells_from_array().
 | 
						|
 *
 | 
						|
 * Return value: 0 on success, <0 on error.
 | 
						|
 */
 | 
						|
#define qemu_fdt_setprop_sized_cells(fdt, node_path, property, ...)       \
 | 
						|
    ({                                                                    \
 | 
						|
        uint64_t qdt_tmp[] = { __VA_ARGS__ };                             \
 | 
						|
        qemu_fdt_setprop_sized_cells_from_array(fdt, node_path,           \
 | 
						|
                                                property,                 \
 | 
						|
                                                ARRAY_SIZE(qdt_tmp) / 2,  \
 | 
						|
                                                qdt_tmp);                 \
 | 
						|
    })
 | 
						|
 | 
						|
#endif /* __DEVICE_TREE_H__ */
 |