mirror of
https://github.com/ARM-software/arm-trusted-firmware.git
synced 2025-04-25 14:25:44 +00:00
49b268ce30
There are several users in the tree which want to check whether a given FDT node is enabled or not: the "status" property holds that information. So far all those users provide private implementations, some of them having issues. Export a generic implementation of that function in fdt_wrappers.h, as a "static inline" function to not increase code size. Also replace the existing implementation in Arm's fconf code, which had a tiny bug in needlessly using the property length: "status = [6f 6b 61 79 20];" would pass the check, where it should not. The proper solution is also simpler: status must be a string, and strings must be NUL-terminated in a DT. strcmp() would terminate on the first NUL in *either* of the two strings it compares, so it would never walk beyond the property boundary in the DTB. Change-Id: I9d89093432f127c09add6cf5c93a725bc534e5de Signed-off-by: Andre Przywara <andre.przywara@arm.com>
71 lines
2.6 KiB
C
71 lines
2.6 KiB
C
/*
|
|
* Copyright (c) 2018-2022, ARM Limited and Contributors. All rights reserved.
|
|
*
|
|
* SPDX-License-Identifier: BSD-3-Clause
|
|
*/
|
|
|
|
/* Helper functions to offer easier navigation of Device Tree Blob */
|
|
|
|
#ifndef FDT_WRAPPERS_H
|
|
#define FDT_WRAPPERS_H
|
|
|
|
#include <libfdt_env.h>
|
|
#include <libfdt.h>
|
|
|
|
/* Number of cells, given total length in bytes. Each cell is 4 bytes long */
|
|
#define NCELLS(len) ((len) / 4U)
|
|
|
|
int fdt_read_uint32(const void *dtb, int node, const char *prop_name,
|
|
uint32_t *value);
|
|
uint32_t fdt_read_uint32_default(const void *dtb, int node,
|
|
const char *prop_name, uint32_t dflt_value);
|
|
int fdt_read_uint64(const void *dtb, int node, const char *prop_name,
|
|
uint64_t *value);
|
|
int fdt_read_uint32_array(const void *dtb, int node, const char *prop_name,
|
|
unsigned int cells, uint32_t *value);
|
|
int fdtw_read_string(const void *dtb, int node, const char *prop,
|
|
char *str, size_t size);
|
|
int fdtw_read_uuid(const void *dtb, int node, const char *prop,
|
|
unsigned int length, uint8_t *uuid);
|
|
int fdtw_write_inplace_cells(void *dtb, int node, const char *prop,
|
|
unsigned int cells, void *value);
|
|
int fdtw_read_bytes(const void *dtb, int node, const char *prop,
|
|
unsigned int length, void *value);
|
|
int fdtw_write_inplace_bytes(void *dtb, int node, const char *prop,
|
|
unsigned int length, const void *data);
|
|
int fdt_get_reg_props_by_index(const void *dtb, int node, int index,
|
|
uintptr_t *base, size_t *size);
|
|
int fdt_get_reg_props_by_name(const void *dtb, int node, const char *name,
|
|
uintptr_t *base, size_t *size);
|
|
int fdt_get_stdout_node_offset(const void *dtb);
|
|
|
|
uint64_t fdtw_translate_address(const void *dtb, int bus_node,
|
|
uint64_t base_address);
|
|
|
|
int fdtw_for_each_cpu(const void *fdt,
|
|
int (*callback)(const void *dtb, int node, uintptr_t mpidr));
|
|
|
|
int fdtw_find_or_add_subnode(void *fdt, int parentoffset, const char *name);
|
|
|
|
static inline uint32_t fdt_blob_size(const void *dtb)
|
|
{
|
|
const uint32_t *dtb_header = dtb;
|
|
|
|
return fdt32_to_cpu(dtb_header[1]);
|
|
}
|
|
|
|
static inline bool fdt_node_is_enabled(const void *fdt, int node)
|
|
{
|
|
int len;
|
|
const void *prop = fdt_getprop(fdt, node, "status", &len);
|
|
|
|
/* A non-existing status property means the device is enabled. */
|
|
return (prop == NULL) || (len == 5 && strcmp(prop, "okay") == 0);
|
|
}
|
|
|
|
#define fdt_for_each_compatible_node(dtb, node, compatible_str) \
|
|
for (node = fdt_node_offset_by_compatible(dtb, -1, compatible_str); \
|
|
node >= 0; \
|
|
node = fdt_node_offset_by_compatible(dtb, node, compatible_str))
|
|
|
|
#endif /* FDT_WRAPPERS_H */
|