]>
git.proxmox.com Git - mirror_ubuntu-jammy-kernel.git/blob - scripts/dtc/dtc.h
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
6 * (C) Copyright David Gibson <dwg@au1.ibm.com>, IBM Corporation. 2005.
21 #include <libfdt_env.h>
27 #define debug(...) printf(__VA_ARGS__)
32 #define DEFAULT_FDT_VERSION 17
35 * Command line options
37 extern int quiet
; /* Level of quietness */
38 extern int reservenum
; /* Number of memory reservation slots */
39 extern int minsize
; /* Minimum blob size */
40 extern int padsize
; /* Additional padding to blob */
41 extern int alignsize
; /* Additional padding to blob accroding to the alignsize */
42 extern int phandle_format
; /* Use linux,phandle or phandle properties */
43 extern int generate_symbols
; /* generate symbols for nodes with labels */
44 extern int generate_fixups
; /* generate fixups */
45 extern int auto_label_aliases
; /* auto generate labels -> aliases */
46 extern int annotate
; /* annotate .dts with input source location */
48 #define PHANDLE_LEGACY 0x1
49 #define PHANDLE_EPAPR 0x2
50 #define PHANDLE_BOTH 0x3
52 typedef uint32_t cell_t
;
54 static inline uint16_t dtb_ld16(const void *p
)
56 const uint8_t *bp
= (const uint8_t *)p
;
58 return ((uint16_t)bp
[0] << 8)
62 static inline uint32_t dtb_ld32(const void *p
)
64 const uint8_t *bp
= (const uint8_t *)p
;
66 return ((uint32_t)bp
[0] << 24)
67 | ((uint32_t)bp
[1] << 16)
68 | ((uint32_t)bp
[2] << 8)
72 static inline uint64_t dtb_ld64(const void *p
)
74 const uint8_t *bp
= (const uint8_t *)p
;
76 return ((uint64_t)bp
[0] << 56)
77 | ((uint64_t)bp
[1] << 48)
78 | ((uint64_t)bp
[2] << 40)
79 | ((uint64_t)bp
[3] << 32)
80 | ((uint64_t)bp
[4] << 24)
81 | ((uint64_t)bp
[5] << 16)
82 | ((uint64_t)bp
[6] << 8)
86 #define streq(a, b) (strcmp((a), (b)) == 0)
87 #define strstarts(s, prefix) (strncmp((s), (prefix), strlen(prefix)) == 0)
88 #define strprefixeq(a, n, b) (strlen(b) == (n) && (memcmp(a, b, n) == 0))
90 #define ALIGN(x, a) (((x) + (a) - 1) & ~((a) - 1))
104 extern const char *markername(enum markertype markertype
);
107 enum markertype type
;
116 struct marker
*markers
;
120 #define empty_data ((struct data){ 0 /* all .members = 0 or NULL */ })
122 #define for_each_marker(m) \
123 for (; (m); (m) = (m)->next)
124 #define for_each_marker_of_type(m, t) \
126 if ((m)->type == (t))
128 size_t type_marker_length(struct marker
*m
);
130 void data_free(struct data d
);
132 struct data
data_grow_for(struct data d
, unsigned int xlen
);
134 struct data
data_copy_mem(const char *mem
, int len
);
135 struct data
data_copy_escape_string(const char *s
, int len
);
136 struct data
data_copy_file(FILE *f
, size_t len
);
138 struct data
data_append_data(struct data d
, const void *p
, int len
);
139 struct data
data_insert_at_marker(struct data d
, struct marker
*m
,
140 const void *p
, int len
);
141 struct data
data_merge(struct data d1
, struct data d2
);
142 struct data
data_append_cell(struct data d
, cell_t word
);
143 struct data
data_append_integer(struct data d
, uint64_t word
, int bits
);
144 struct data
data_append_re(struct data d
, uint64_t address
, uint64_t size
);
145 struct data
data_append_addr(struct data d
, uint64_t addr
);
146 struct data
data_append_byte(struct data d
, uint8_t byte
);
147 struct data
data_append_zeroes(struct data d
, int len
);
148 struct data
data_append_align(struct data d
, int align
);
150 struct data
data_add_marker(struct data d
, enum markertype type
, char *ref
);
152 bool data_is_one_string(struct data d
);
156 #define MAX_PROPNAME_LEN 31
157 #define MAX_NODENAME_LEN 31
175 struct property
*next
;
177 struct label
*labels
;
178 struct srcpos
*srcpos
;
184 struct property
*proplist
;
185 struct node
*children
;
188 struct node
*next_sibling
;
194 int addr_cells
, size_cells
;
196 struct label
*labels
;
197 const struct bus_type
*bus
;
198 struct srcpos
*srcpos
;
200 bool omit_if_unused
, is_referenced
;
203 #define for_each_label_withdel(l0, l) \
204 for ((l) = (l0); (l); (l) = (l)->next)
206 #define for_each_label(l0, l) \
207 for_each_label_withdel(l0, l) \
210 #define for_each_property_withdel(n, p) \
211 for ((p) = (n)->proplist; (p); (p) = (p)->next)
213 #define for_each_property(n, p) \
214 for_each_property_withdel(n, p) \
217 #define for_each_child_withdel(n, c) \
218 for ((c) = (n)->children; (c); (c) = (c)->next_sibling)
220 #define for_each_child(n, c) \
221 for_each_child_withdel(n, c) \
224 void add_label(struct label
**labels
, char *label
);
225 void delete_labels(struct label
**labels
);
227 struct property
*build_property(char *name
, struct data val
,
228 struct srcpos
*srcpos
);
229 struct property
*build_property_delete(char *name
);
230 struct property
*chain_property(struct property
*first
, struct property
*list
);
231 struct property
*reverse_properties(struct property
*first
);
233 struct node
*build_node(struct property
*proplist
, struct node
*children
,
234 struct srcpos
*srcpos
);
235 struct node
*build_node_delete(struct srcpos
*srcpos
);
236 struct node
*name_node(struct node
*node
, char *name
);
237 struct node
*omit_node_if_unused(struct node
*node
);
238 struct node
*reference_node(struct node
*node
);
239 struct node
*chain_node(struct node
*first
, struct node
*list
);
240 struct node
*merge_nodes(struct node
*old_node
, struct node
*new_node
);
241 struct node
*add_orphan_node(struct node
*old_node
, struct node
*new_node
, char *ref
);
243 void add_property(struct node
*node
, struct property
*prop
);
244 void delete_property_by_name(struct node
*node
, char *name
);
245 void delete_property(struct property
*prop
);
246 void add_child(struct node
*parent
, struct node
*child
);
247 void delete_node_by_name(struct node
*parent
, char *name
);
248 void delete_node(struct node
*node
);
249 void append_to_property(struct node
*node
,
250 char *name
, const void *data
, int len
,
251 enum markertype type
);
253 const char *get_unitname(struct node
*node
);
254 struct property
*get_property(struct node
*node
, const char *propname
);
255 cell_t
propval_cell(struct property
*prop
);
256 cell_t
propval_cell_n(struct property
*prop
, unsigned int n
);
257 struct property
*get_property_by_label(struct node
*tree
, const char *label
,
259 struct marker
*get_marker_label(struct node
*tree
, const char *label
,
260 struct node
**node
, struct property
**prop
);
261 struct node
*get_subnode(struct node
*node
, const char *nodename
);
262 struct node
*get_node_by_path(struct node
*tree
, const char *path
);
263 struct node
*get_node_by_label(struct node
*tree
, const char *label
);
264 struct node
*get_node_by_phandle(struct node
*tree
, cell_t phandle
);
265 struct node
*get_node_by_ref(struct node
*tree
, const char *ref
);
266 cell_t
get_node_phandle(struct node
*root
, struct node
*node
);
268 uint32_t guess_boot_cpuid(struct node
*tree
);
270 /* Boot info (tree plus memreserve information */
272 struct reserve_info
{
273 uint64_t address
, size
;
275 struct reserve_info
*next
;
277 struct label
*labels
;
280 struct reserve_info
*build_reserve_entry(uint64_t start
, uint64_t len
);
281 struct reserve_info
*chain_reserve_entry(struct reserve_info
*first
,
282 struct reserve_info
*list
);
283 struct reserve_info
*add_reserve_entry(struct reserve_info
*list
,
284 struct reserve_info
*new);
288 unsigned int dtsflags
;
289 struct reserve_info
*reservelist
;
290 uint32_t boot_cpuid_phys
;
291 struct node
*dt
; /* the device tree */
292 const char *outname
; /* filename being written to, "-" for stdout */
295 /* DTS version flags definitions */
296 #define DTSF_V1 0x0001 /* /dts-v1/ */
297 #define DTSF_PLUGIN 0x0002 /* /plugin/ */
299 struct dt_info
*build_dt_info(unsigned int dtsflags
,
300 struct reserve_info
*reservelist
,
301 struct node
*tree
, uint32_t boot_cpuid_phys
);
302 void sort_tree(struct dt_info
*dti
);
303 void generate_label_tree(struct dt_info
*dti
, char *name
, bool allocph
);
304 void generate_fixups_tree(struct dt_info
*dti
, char *name
);
305 void generate_local_fixups_tree(struct dt_info
*dti
, char *name
);
309 void parse_checks_option(bool warn
, bool error
, const char *arg
);
310 void process_checks(bool force
, struct dt_info
*dti
);
312 /* Flattened trees */
314 void dt_to_blob(FILE *f
, struct dt_info
*dti
, int version
);
315 void dt_to_asm(FILE *f
, struct dt_info
*dti
, int version
);
317 struct dt_info
*dt_from_blob(const char *fname
);
321 void dt_to_source(FILE *f
, struct dt_info
*dti
);
322 struct dt_info
*dt_from_source(const char *f
);
326 void dt_to_yaml(FILE *f
, struct dt_info
*dti
);
330 struct dt_info
*dt_from_fs(const char *dirname
);