blob: ef6022134b53ef002aec7ab665134df9eba7a202 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
/*
* Copyright (c) 2018-2022, Arm Limited. All rights reserved.
*
* SPDX-License-Identifier: BSD-3-Clause
*/
#ifndef SP_HELPERS_H
#define SP_HELPERS_H
#include <stdint.h>
#include <tftf_lib.h>
#include <spm_common.h>
#include <spinlock.h>
/* Currently, Hafnium/SPM supports only 64 virtual interrupt IDs. */
#define NUM_VINT_ID 64
typedef struct {
u_register_t fid;
u_register_t arg1;
u_register_t arg2;
u_register_t arg3;
u_register_t arg4;
u_register_t arg5;
u_register_t arg6;
u_register_t arg7;
} svc_args;
/*
* Trigger an SVC call.
*
* The arguments to pass through the SVC call must be stored in the svc_args
* structure. The return values of the SVC call will be stored in the same
* structure (overriding the input arguments).
*
* Return the first return value. It is equivalent to args.fid but is also
* provided as the return value for convenience.
*/
u_register_t sp_svc(svc_args *args);
/*
* Choose a pseudo-random number within the [min,max] range (both limits are
* inclusive).
*/
uintptr_t bound_rand(uintptr_t min, uintptr_t max);
/*
* Check that expr == expected.
* If not, loop forever.
*/
void expect(int expr, int expected);
/*
* Test framework functions
*/
void announce_test_section_start(const char *test_sect_desc);
void announce_test_section_end(const char *test_sect_desc);
void announce_test_start(const char *test_desc);
void announce_test_end(const char *test_desc);
/* Sleep for at least 'ms' milliseconds and return the elapsed time(ms). */
uint64_t sp_sleep_elapsed_time(uint32_t ms);
/* Sleep for at least 'ms' milliseconds. */
void sp_sleep(uint32_t ms);
void sp_handler_spin_lock_init(void);
/* Handler invoked at the tail end of interrupt processing by SP. */
extern void (*sp_interrupt_tail_end_handler[NUM_VINT_ID])(void);
/* Register the handler. */
void sp_register_interrupt_tail_end_handler(void (*handler)(void),
uint32_t interrupt_id);
/* Un-register the handler. */
void sp_unregister_interrupt_tail_end_handler(uint32_t interrupt_id);
#endif /* SP_HELPERS_H */
|