blob: 2929fc23d5bbffe38004eadef477382cc39d8a59 [file] [log] [blame]
Soby Mathewb9fccca2017-11-06 13:56:40 +00001/*
Ruchika Guptad4802022022-04-08 13:16:16 +05302 * Copyright (c) 2018-2022, ARM Limited and Contributors. All rights reserved.
Soby Mathewb9fccca2017-11-06 13:56:40 +00003 *
4 * SPDX-License-Identifier: BSD-3-Clause
5 */
6
7/* Helper functions to offer easier navigation of Device Tree Blob */
8
Antonio Nino Diaz5eb88372018-11-08 10:20:19 +00009#ifndef FDT_WRAPPERS_H
10#define FDT_WRAPPERS_H
Soby Mathewb9fccca2017-11-06 13:56:40 +000011
Andre Przywara97c6e902020-07-09 12:33:17 +010012#include <libfdt_env.h>
13
Soby Mathewb9fccca2017-11-06 13:56:40 +000014/* Number of cells, given total length in bytes. Each cell is 4 bytes long */
Antonio Nino Diazf0b14cf2018-10-04 09:55:23 +010015#define NCELLS(len) ((len) / 4U)
Soby Mathewb9fccca2017-11-06 13:56:40 +000016
Andre Przywarafe5bdf52020-03-26 11:22:37 +000017int fdt_read_uint32(const void *dtb, int node, const char *prop_name,
18 uint32_t *value);
Andre Przywara2d5690c2020-03-26 11:50:33 +000019uint32_t fdt_read_uint32_default(const void *dtb, int node,
20 const char *prop_name, uint32_t dflt_value);
Andre Przywarafe5bdf52020-03-26 11:22:37 +000021int fdt_read_uint64(const void *dtb, int node, const char *prop_name,
22 uint64_t *value);
Andre Przywara6cf6a1b2020-03-30 23:21:13 +010023int fdt_read_uint32_array(const void *dtb, int node, const char *prop_name,
24 unsigned int cells, uint32_t *value);
Antonio Nino Diazd85c8782018-06-26 10:34:07 +010025int fdtw_read_string(const void *dtb, int node, const char *prop,
26 char *str, size_t size);
David Horstmanna65a8ff2021-03-01 19:34:37 +000027int fdtw_read_uuid(const void *dtb, int node, const char *prop,
28 unsigned int length, uint8_t *uuid);
Soby Mathewb9fccca2017-11-06 13:56:40 +000029int fdtw_write_inplace_cells(void *dtb, int node, const char *prop,
30 unsigned int cells, void *value);
Alexei Fedorov2de82fc2020-01-29 16:21:28 +000031int fdtw_read_bytes(const void *dtb, int node, const char *prop,
32 unsigned int length, void *value);
33int fdtw_write_inplace_bytes(void *dtb, int node, const char *prop,
34 unsigned int length, const void *data);
Andre Przywarae183e152020-03-26 11:57:43 +000035int fdt_get_reg_props_by_index(const void *dtb, int node, int index,
36 uintptr_t *base, size_t *size);
Andre Przywara4a1c8742020-03-26 12:11:34 +000037int fdt_get_reg_props_by_name(const void *dtb, int node, const char *name,
38 uintptr_t *base, size_t *size);
Andre Przywaraa0eaca52020-03-26 12:52:06 +000039int fdt_get_stdout_node_offset(const void *dtb);
Antonio Nino Diazd85c8782018-06-26 10:34:07 +010040
Madhukar Pappireddy361c1b32020-03-24 10:03:34 -050041uint64_t fdtw_translate_address(const void *dtb, int bus_node,
42 uint64_t base_address);
43
Chris Kay93c9db02021-09-28 16:06:25 +010044int fdtw_for_each_cpu(const void *fdt,
45 int (*callback)(const void *dtb, int node, uintptr_t mpidr));
46
Ruchika Guptad4802022022-04-08 13:16:16 +053047int fdtw_find_or_add_subnode(void *fdt, int parentoffset, const char *name);
48
Andre Przywara97c6e902020-07-09 12:33:17 +010049static inline uint32_t fdt_blob_size(const void *dtb)
50{
51 const uint32_t *dtb_header = dtb;
52
53 return fdt32_to_cpu(dtb_header[1]);
54}
55
Laurent Carlier246b1ad2021-09-30 15:57:09 +010056#define fdt_for_each_compatible_node(dtb, node, compatible_str) \
57for (node = fdt_node_offset_by_compatible(dtb, -1, compatible_str); \
58 node >= 0; \
59 node = fdt_node_offset_by_compatible(dtb, node, compatible_str))
60
Antonio Nino Diaz5eb88372018-11-08 10:20:19 +000061#endif /* FDT_WRAPPERS_H */