forked from Mirrors/opensbi
33ba4e0567
Distinguish between functions which modify the devicetree and those which only extract information from it. Other than the iterators in fdt_domain.c, this is a mechanical conversion. Signed-off-by: Samuel Holland <samuel.holland@sifive.com> Reviewed-by: Andrew Jones <ajones@ventanamicro.com> Reviewed-by: Anup Patel <anup@brainfault.org>
83 lines
2.1 KiB
C
83 lines
2.1 KiB
C
// SPDX-License-Identifier: BSD-2-Clause
|
|
/*
|
|
* fdt_domain.c - Flat Device Tree Domain helper routines
|
|
*
|
|
* Copyright (c) 2020 Western Digital Corporation or its affiliates.
|
|
*
|
|
* Authors:
|
|
* Anup Patel <anup.patel@wdc.com>
|
|
*/
|
|
|
|
#ifndef __FDT_DOMAIN_H__
|
|
#define __FDT_DOMAIN_H__
|
|
|
|
#include <sbi/sbi_types.h>
|
|
|
|
#ifdef CONFIG_FDT_DOMAIN
|
|
|
|
struct sbi_domain;
|
|
|
|
/**
|
|
* Iterate over each domains in device tree
|
|
*
|
|
* @param fdt device tree blob
|
|
* @param opaque private pointer for each iteration
|
|
* @param fn callback function for each iteration
|
|
*
|
|
* @return 0 on success and negative error code on failure
|
|
*/
|
|
int fdt_iterate_each_domain(void *fdt, void *opaque,
|
|
int (*fn)(void *fdt, int domain_offset,
|
|
void *opaque));
|
|
|
|
/**
|
|
* Iterate over each memregion of a domain in device tree
|
|
*
|
|
* @param fdt device tree blob
|
|
* @param domain_offset domain DT node offset
|
|
* @param opaque private pointer for each iteration
|
|
* @param fn callback function for each iteration
|
|
*
|
|
* @return 0 on success and negative error code on failure
|
|
*/
|
|
int fdt_iterate_each_memregion(void *fdt, int domain_offset, void *opaque,
|
|
int (*fn)(void *fdt, int domain_offset,
|
|
int region_offset, u32 region_access,
|
|
void *opaque));
|
|
|
|
/**
|
|
* Fix up the domain configuration in the device tree
|
|
*
|
|
* This routine:
|
|
* 1. Disables MMIO devices not accessible to the coldboot HART domain
|
|
* 2. Removes "opensbi-domain" DT property from CPU DT nodes
|
|
* 3. Removes domain configuration DT node under /chosen DT node
|
|
*
|
|
* It is recommended that platform support call this function in
|
|
* their final_init() platform operation.
|
|
*
|
|
* @param fdt device tree blob
|
|
*/
|
|
void fdt_domain_fixup(void *fdt);
|
|
|
|
/**
|
|
* Populate domains from device tree
|
|
*
|
|
* It is recommended that platform support call this function in
|
|
* their domains_init() platform operation.
|
|
*
|
|
* @param fdt device tree blob
|
|
*
|
|
* @return 0 on success and negative error code on failure
|
|
*/
|
|
int fdt_domains_populate(const void *fdt);
|
|
|
|
#else
|
|
|
|
static inline void fdt_domain_fixup(void *fdt) { }
|
|
static inline int fdt_domains_populate(const void *fdt) { return 0; }
|
|
|
|
#endif
|
|
|
|
#endif /* __FDT_DOMAIN_H__ */
|