1/* SPDX-License-Identifier: GPL-2.0+ */ 2/* 3 * Copyright (c) 2017 Google, Inc 4 * Written by Simon Glass <sjg@chromium.org> 5 * 6 * Support for a 'live' (as opposed to flat) device tree 7 */ 8 9#ifndef _OF_LIVE_H 10#define _OF_LIVE_H 11 12struct abuf; 13struct device_node; 14 15/** 16 * of_live_build() - build a live (hierarchical) tree from a flat DT 17 * 18 * @fdt_blob: Input tree to convert 19 * @rootp: Returns live tree that was created 20 * Return: 0 if OK, -ve on error 21 */ 22int of_live_build(const void *fdt_blob, struct device_node **rootp); 23 24/** 25 * unflatten_device_tree() - create tree of device_nodes from flat blob 26 * 27 * Note that this allocates a single block of memory, pointed to by *mynodes. 28 * To free the tree, use free(*mynodes) 29 * 30 * unflattens a device-tree, creating the 31 * tree of struct device_node. It also fills the "name" and "type" 32 * pointers of the nodes so the normal device-tree walking functions 33 * can be used. 34 * @blob: The blob to expand 35 * @mynodes: The device_node tree created by the call 36 * Return: 0 if OK, -ve on error 37 */ 38int unflatten_device_tree(const void *blob, struct device_node **mynodes); 39 40/** 41 * of_live_free() - Dispose of a livetree 42 * 43 * This frees memory used by the tree, after which @root becomes invalid and 44 * cannot be used 45 * 46 * @root: Tree to dispose 47 */ 48void of_live_free(struct device_node *root); 49 50/** 51 * of_live_create_empty() - Create a new, empty tree 52 * 53 * @rootp: Returns the root node of the created tree 54 * Return: 0 if OK, -ENOMEM if out of memory 55 */ 56int of_live_create_empty(struct device_node **rootp); 57 58/** 59 * of_live_flatten() - Create an FDT from a hierarchical tree 60 * 61 * @root: Root node of tree to convert 62 * @buf: Buffer to return the tree (inited by this function) 63 * Return: 0 if OK, -ENOMEM if out of memory 64 */ 65int of_live_flatten(const struct device_node *root, struct abuf *buf); 66 67#endif 68