forked from Mirrors/opensbi
2179777364
We extend fdt_iterate_each_domain() and fdt_iterate_each_memregion() functions to allow underlying iteration function to fail. This will help us catch more domain misconfiguration issues at boot time. Signed-off-by: Anup Patel <anup.patel@wdc.com> Reviewed-by: Alistair Francis <alistair.francis@wdc.com> Reviewed-by: Atish Patra <atish.patra@wdc.com>
85 lines
2.2 KiB
C
85 lines
2.2 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>
|
|
|
|
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);
|
|
|
|
/**
|
|
* Get domain instance for given HART
|
|
*
|
|
* Note: Domains should be populated before using this function.
|
|
*
|
|
* @param hartid the HART for which domain instance is needed
|
|
*
|
|
* @return pointer to domain instance on success and NULL on failure
|
|
*/
|
|
struct sbi_domain *fdt_domain_get(u32 hartid);
|
|
|
|
/**
|
|
* 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(void *fdt);
|
|
|
|
#endif /* __FDT_DOMAIN_H__ */
|