mirror of
https://github.com/ARM-software/arm-trusted-firmware.git
synced 2025-08-16 09:27:01 +02:00
25d740c45e
A populate() function essentially captures the value of a property, defined by a platform, into a fconf related c structure. Such a callback is usually platform specific and is associated to a specific configuration source. For example, a populate() function which captures the hardware topology of the platform can only parse HW_CONFIG DTB. Hence each populator function must be registered with a specific 'config_type' identifier. It broadly represents a logical grouping of configuration properties which is usually a device tree source file. Example: > TB_FW: properties related to trusted firmware such as IO policies, base address of other DTBs, mbedtls heap info etc. > HW_CONFIG: properties related to hardware configuration of the SoC such as topology, GIC controller, PSCI hooks, CPU ID etc. This patch modifies FCONF_REGISTER_POPULATOR macro and fconf_populate() to register and invoke the appropriate callbacks selectively based on configuration type. Change-Id: I6f63b1fd7a8729c6c9137d5b63270af1857bb44a Signed-off-by: Madhukar Pappireddy <madhukar.pappireddy@arm.com>
70 lines
1.7 KiB
C
70 lines
1.7 KiB
C
/*
|
|
* Copyright (c) 2019-2020, ARM Limited. All rights reserved.
|
|
*
|
|
* SPDX-License-Identifier: BSD-3-Clause
|
|
*/
|
|
|
|
#ifndef FCONF_H
|
|
#define FCONF_H
|
|
|
|
#include <stdint.h>
|
|
|
|
/* Public API */
|
|
#define FCONF_GET_PROPERTY(a, b, c) a##__##b##_getter(c)
|
|
|
|
/*
|
|
* This macro takes three arguments:
|
|
* config: Configuration identifier
|
|
* name: property namespace
|
|
* callback: populate() function
|
|
*/
|
|
#define FCONF_REGISTER_POPULATOR(config, name, callback) \
|
|
__attribute__((used, section(".fconf_populator"))) \
|
|
const struct fconf_populator (name##__populator) = { \
|
|
.config_type = (#config), \
|
|
.info = (#name), \
|
|
.populate = (callback) \
|
|
};
|
|
|
|
/*
|
|
* Populator callback
|
|
*
|
|
* This structure are used by the fconf_populate function and should only be
|
|
* defined by the FCONF_REGISTER_POPULATOR macro.
|
|
*/
|
|
struct fconf_populator {
|
|
/* Description of the data loaded by the callback */
|
|
const char *config_type;
|
|
const char *info;
|
|
|
|
/* Callback used by fconf_populate function with a provided config dtb.
|
|
* Return 0 on success, err_code < 0 otherwise.
|
|
*/
|
|
int (*populate)(uintptr_t config);
|
|
};
|
|
|
|
/* Load firmware configuration dtb */
|
|
void fconf_load_config(void);
|
|
|
|
/* Top level populate function
|
|
*
|
|
* This function takes a configuration dtb and calls all the registered
|
|
* populator callback with it.
|
|
*
|
|
* Panic on error.
|
|
*/
|
|
void fconf_populate(const char *config_type, uintptr_t config);
|
|
|
|
/* FCONF specific getter */
|
|
#define fconf__dtb_getter(prop) fconf_dtb_info.prop
|
|
|
|
/* Structure used to locally keep a reference to the config dtb. */
|
|
struct fconf_dtb_info_t {
|
|
uintptr_t base_addr;
|
|
size_t size;
|
|
};
|
|
|
|
extern struct fconf_dtb_info_t fconf_dtb_info;
|
|
|
|
#endif /* FCONF_H */
|