1 /*
2  * Copyright (c) 2006-2023, RT-Thread Development Team
3  *
4  * SPDX-License-Identifier: Apache-2.0
5  *
6  * Change Logs:
7  * Date           Author       Notes
8  * 2022-12-20     RT-Thread   the first version
9  */
10 
11 #ifndef _FDT_H
12 #define _FDT_H
13 /*
14  * libfdt - Flat Device Tree manipulation
15  * Copyright (C) 2006 David Gibson, IBM Corporation.
16  * Copyright 2012 Kim Phillips, Freescale Semiconductor.
17  *
18  * libfdt is dual licensed: you can use it either under the terms of
19  * the GPL, or the BSD license, at your option.
20  *
21  *  a) This library is free software; you can redistribute it and/or
22  *     modify it under the terms of the GNU General Public License as
23  *     published by the Free Software Foundation; either version 2 of the
24  *     License, or (at your option) any later version.
25  *
26  *     This library is distributed in the hope that it will be useful,
27  *     but WITHOUT ANY WARRANTY; without even the implied warranty of
28  *     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
29  *     GNU General Public License for more details.
30  *
31  *     You should have received a copy of the GNU General Public
32  *     License along with this library; if not, write to the Free
33  *     Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,
34  *     MA 02110-1301 USA
35  *
36  * Alternatively,
37  *
38  *  b) Redistribution and use in source and binary forms, with or
39  *     without modification, are permitted provided that the following
40  *     conditions are met:
41  *
42  *     1. Redistributions of source code must retain the above
43  *        copyright notice, this list of conditions and the following
44  *        disclaimer.
45  *     2. Redistributions in binary form must reproduce the above
46  *        copyright notice, this list of conditions and the following
47  *        disclaimer in the documentation and/or other materials
48  *        provided with the distribution.
49  *
50  *     THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
51  *     CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
52  *     INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
53  *     MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
54  *     DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
55  *     CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
56  *     SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
57  *     NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
58  *     LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
59  *     HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
60  *     CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
61  *     OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
62  *     EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
63  */
64 
65 #ifndef __ASSEMBLY__
66 
67 #include <errno.h>
68 #include <unistd.h>
69 #include <fcntl.h>
70 
71 struct fdt_header {
72     fdt32_t magic;                  /* magic word FDT_MAGIC */
73     fdt32_t totalsize;              /* total size of DT block */
74     fdt32_t off_dt_struct;          /* offset to structure */
75     fdt32_t off_dt_strings;         /* offset to strings */
76     fdt32_t off_mem_rsvmap;         /* offset to memory reserve map */
77     fdt32_t version;                /* format version */
78     fdt32_t last_comp_version;      /* last compatible version */
79 
80     /* version 2 fields below */
81     fdt32_t boot_cpuid_phys;        /* Which physical CPU id we're
82                                     booting on */
83     /* version 3 fields below */
84     fdt32_t size_dt_strings;        /* size of the strings block */
85 
86     /* version 17 fields below */
87     fdt32_t size_dt_struct;         /* size of the structure block */
88 };
89 
90 struct fdt_reserve_entry {
91     fdt64_t address;
92     fdt64_t size;
93 };
94 
95 struct fdt_node_header {
96     fdt32_t tag;
97     char name[0];
98 };
99 
100 struct fdt_property {
101     fdt32_t tag;
102     fdt32_t len;
103     fdt32_t nameoff;
104     char data[0];
105 };
106 
107 #endif /* !__ASSEMBLY */
108 
109 #define FDT_MAGIC    0xd00dfeed    /* 4: version, 4: total size */
110 #define FDT_TAGSIZE    sizeof(fdt32_t)
111 
112 #define FDT_BEGIN_NODE    0x1        /* Start node: full name */
113 #define FDT_END_NODE    0x2        /* End node */
114 #define FDT_PROP    0x3        /* Property: name off,
115                        size, content */
116 #define FDT_NOP        0x4        /* nop */
117 #define FDT_END        0x9
118 
119 #define FDT_V1_SIZE    (7*sizeof(fdt32_t))
120 #define FDT_V2_SIZE    (FDT_V1_SIZE + sizeof(fdt32_t))
121 #define FDT_V3_SIZE    (FDT_V2_SIZE + sizeof(fdt32_t))
122 #define FDT_V16_SIZE    FDT_V3_SIZE
123 #define FDT_V17_SIZE    (FDT_V16_SIZE + sizeof(fdt32_t))
124 
125 #endif /* _FDT_H */
126