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