mirror of
https://github.com/ARM-software/arm-trusted-firmware.git
synced 2025-04-16 09:34:18 +00:00
2a4b4b71ba
This fix modifies the order of system includes to meet the ARM TF coding standard. There are some exceptions in order to retain header groupings, minimise changes to imported headers, and where there are headers within the #if and #ifndef statements. Change-Id: I65085a142ba6a83792b26efb47df1329153f1624 Signed-off-by: Isla Mitchell <isla.mitchell@arm.com>
145 lines
4.2 KiB
C
145 lines
4.2 KiB
C
/*
|
|
* Copyright (c) 2016, ARM Limited and Contributors. All rights reserved.
|
|
*
|
|
* SPDX-License-Identifier: BSD-3-Clause
|
|
*/
|
|
|
|
#ifndef __PMF_HELPERS_H__
|
|
#define __PMF_HELPERS_H__
|
|
|
|
#include <arch_helpers.h>
|
|
#include <assert.h>
|
|
#include <bl_common.h>
|
|
#include <platform.h>
|
|
#include <pmf.h>
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
|
|
/*
|
|
* Prototype for PMF service functions.
|
|
*/
|
|
typedef int (*pmf_svc_init_t)(void);
|
|
typedef unsigned long long (*pmf_svc_get_ts_t)(unsigned int tid,
|
|
u_register_t mpidr,
|
|
unsigned int flags);
|
|
|
|
/*
|
|
* This is the definition of PMF service desc.
|
|
*/
|
|
typedef struct pmf_svc_desc {
|
|
/* Structure version information */
|
|
param_header_t h;
|
|
|
|
/* Name of the PMF service */
|
|
const char *name;
|
|
|
|
/* PMF service config: Implementer id, Service id and total id*/
|
|
unsigned int svc_config;
|
|
|
|
/* PMF service initialization handler */
|
|
pmf_svc_init_t init;
|
|
|
|
/* PMF service time-stamp retrieval handler */
|
|
pmf_svc_get_ts_t get_ts;
|
|
} pmf_svc_desc_t;
|
|
|
|
/*
|
|
* Convenience macro to allocate memory for a PMF service.
|
|
*/
|
|
#define PMF_ALLOCATE_TIMESTAMP_MEMORY(_name, _total_id) \
|
|
unsigned long long pmf_ts_mem_ ## _name[_total_id] \
|
|
__aligned(CACHE_WRITEBACK_GRANULE) \
|
|
__section("pmf_timestamp_array") \
|
|
__used;
|
|
|
|
/*
|
|
* Convenience macro to validate tid index for the given TS array.
|
|
*/
|
|
#define PMF_VALIDATE_TID(_name, _tid) \
|
|
assert((_tid & PMF_TID_MASK) < (ARRAY_SIZE(pmf_ts_mem_ ## _name)))
|
|
|
|
/*
|
|
* Convenience macros for capturing time-stamp.
|
|
*/
|
|
#define PMF_DEFINE_CAPTURE_TIMESTAMP(_name, _flags) \
|
|
void pmf_capture_timestamp_ ## _name( \
|
|
unsigned int tid, \
|
|
unsigned long long ts) \
|
|
{ \
|
|
CASSERT(_flags, select_proper_config); \
|
|
PMF_VALIDATE_TID(_name, tid); \
|
|
uintptr_t base_addr = (uintptr_t) pmf_ts_mem_ ## _name; \
|
|
if ((_flags) & PMF_STORE_ENABLE) \
|
|
__pmf_store_timestamp(base_addr, tid, ts); \
|
|
if ((_flags) & PMF_DUMP_ENABLE) \
|
|
__pmf_dump_timestamp(tid, ts); \
|
|
} \
|
|
void pmf_capture_timestamp_with_cache_maint_ ## _name( \
|
|
unsigned int tid, \
|
|
unsigned long long ts) \
|
|
{ \
|
|
CASSERT(_flags, select_proper_config); \
|
|
PMF_VALIDATE_TID(_name, tid); \
|
|
uintptr_t base_addr = (uintptr_t) pmf_ts_mem_ ## _name; \
|
|
if ((_flags) & PMF_STORE_ENABLE) \
|
|
__pmf_store_timestamp_with_cache_maint(base_addr, tid, ts);\
|
|
if ((_flags) & PMF_DUMP_ENABLE) \
|
|
__pmf_dump_timestamp(tid, ts); \
|
|
}
|
|
|
|
/*
|
|
* Convenience macros for retrieving time-stamp.
|
|
*/
|
|
#define PMF_DEFINE_GET_TIMESTAMP(_name) \
|
|
unsigned long long pmf_get_timestamp_by_index_ ## _name( \
|
|
unsigned int tid, unsigned int cpuid, unsigned int flags)\
|
|
{ \
|
|
PMF_VALIDATE_TID(_name, tid); \
|
|
uintptr_t base_addr = (uintptr_t) pmf_ts_mem_ ## _name; \
|
|
return __pmf_get_timestamp(base_addr, tid, cpuid, flags);\
|
|
} \
|
|
unsigned long long pmf_get_timestamp_by_mpidr_ ## _name( \
|
|
unsigned int tid, u_register_t mpidr, unsigned int flags)\
|
|
{ \
|
|
PMF_VALIDATE_TID(_name, tid); \
|
|
uintptr_t base_addr = (uintptr_t) pmf_ts_mem_ ## _name; \
|
|
return __pmf_get_timestamp(base_addr, tid, \
|
|
plat_core_pos_by_mpidr(mpidr), flags); \
|
|
}
|
|
|
|
/*
|
|
* Convenience macro to register a PMF service.
|
|
* This is needed for services that require SMC handling.
|
|
*/
|
|
#define PMF_DEFINE_SERVICE_DESC(_name, _implid, _svcid, _totalid, \
|
|
_init, _getts_by_mpidr) \
|
|
static const pmf_svc_desc_t __pmf_desc_ ## _name \
|
|
__section("pmf_svc_descs") __used = { \
|
|
.h.type = PARAM_EP, \
|
|
.h.version = VERSION_1, \
|
|
.h.size = sizeof(pmf_svc_desc_t), \
|
|
.h.attr = 0, \
|
|
.name = #_name, \
|
|
.svc_config = ((((_implid) << PMF_IMPL_ID_SHIFT) & \
|
|
PMF_IMPL_ID_MASK) | \
|
|
(((_svcid) << PMF_SVC_ID_SHIFT) & \
|
|
PMF_SVC_ID_MASK) | \
|
|
(((_totalid) << PMF_TID_SHIFT) & \
|
|
PMF_TID_MASK)), \
|
|
.init = _init, \
|
|
.get_ts = _getts_by_mpidr \
|
|
};
|
|
|
|
/* PMF internal functions */
|
|
void __pmf_dump_timestamp(unsigned int tid, unsigned long long ts);
|
|
void __pmf_store_timestamp(uintptr_t base_addr,
|
|
unsigned int tid,
|
|
unsigned long long ts);
|
|
void __pmf_store_timestamp_with_cache_maint(uintptr_t base_addr,
|
|
unsigned int tid,
|
|
unsigned long long ts);
|
|
unsigned long long __pmf_get_timestamp(uintptr_t base_addr,
|
|
unsigned int tid,
|
|
unsigned int cpuid,
|
|
unsigned int flags);
|
|
#endif /* __PMF_HELPERS_H__ */
|