xref: /rk3399_ARM-atf/services/std_svc/spmd/spmd_private.h (revision c0267cc9947ac04478f6f0e54dbbfc7f8c02f6a0)
1bdd2596dSAchin Gupta /*
2bdd2596dSAchin Gupta  * Copyright (c) 2019-2020, ARM Limited and Contributors. All rights reserved.
3bdd2596dSAchin Gupta  *
4bdd2596dSAchin Gupta  * SPDX-License-Identifier: BSD-3-Clause
5bdd2596dSAchin Gupta  */
6bdd2596dSAchin Gupta 
7bdd2596dSAchin Gupta #ifndef SPMD_PRIVATE_H
8bdd2596dSAchin Gupta #define SPMD_PRIVATE_H
9bdd2596dSAchin Gupta 
10bdd2596dSAchin Gupta #include <context.h>
11bdd2596dSAchin Gupta 
12bdd2596dSAchin Gupta /*******************************************************************************
13bdd2596dSAchin Gupta  * Constants that allow assembler code to preserve callee-saved registers of the
14bdd2596dSAchin Gupta  * C runtime context while performing a security state switch.
15bdd2596dSAchin Gupta  ******************************************************************************/
16bdd2596dSAchin Gupta #define SPMD_C_RT_CTX_X19		0x0
17bdd2596dSAchin Gupta #define SPMD_C_RT_CTX_X20		0x8
18bdd2596dSAchin Gupta #define SPMD_C_RT_CTX_X21		0x10
19bdd2596dSAchin Gupta #define SPMD_C_RT_CTX_X22		0x18
20bdd2596dSAchin Gupta #define SPMD_C_RT_CTX_X23		0x20
21bdd2596dSAchin Gupta #define SPMD_C_RT_CTX_X24		0x28
22bdd2596dSAchin Gupta #define SPMD_C_RT_CTX_X25		0x30
23bdd2596dSAchin Gupta #define SPMD_C_RT_CTX_X26		0x38
24bdd2596dSAchin Gupta #define SPMD_C_RT_CTX_X27		0x40
25bdd2596dSAchin Gupta #define SPMD_C_RT_CTX_X28		0x48
26bdd2596dSAchin Gupta #define SPMD_C_RT_CTX_X29		0x50
27bdd2596dSAchin Gupta #define SPMD_C_RT_CTX_X30		0x58
28bdd2596dSAchin Gupta 
29bdd2596dSAchin Gupta #define SPMD_C_RT_CTX_SIZE		0x60
30bdd2596dSAchin Gupta #define SPMD_C_RT_CTX_ENTRIES		(SPMD_C_RT_CTX_SIZE >> DWORD_SHIFT)
31bdd2596dSAchin Gupta 
32bdd2596dSAchin Gupta #ifndef __ASSEMBLER__
33662af36dSJ-Alves #include <services/ffa_svc.h>
34bdd2596dSAchin Gupta #include <stdint.h>
35bdd2596dSAchin Gupta 
36bdd2596dSAchin Gupta typedef enum spmc_state {
37bdd2596dSAchin Gupta 	SPMC_STATE_RESET = 0,
38bdd2596dSAchin Gupta 	SPMC_STATE_IDLE
39bdd2596dSAchin Gupta } spmc_state_t;
40bdd2596dSAchin Gupta 
41bdd2596dSAchin Gupta /*
42bdd2596dSAchin Gupta  * Data structure used by the SPM dispatcher (SPMD) in EL3 to track context of
43bdd2596dSAchin Gupta  * the SPM core (SPMC) at the next lower EL.
44bdd2596dSAchin Gupta  */
45bdd2596dSAchin Gupta typedef struct spmd_spm_core_context {
46bdd2596dSAchin Gupta 	uint64_t c_rt_ctx;
47bdd2596dSAchin Gupta 	cpu_context_t cpu_ctx;
48bdd2596dSAchin Gupta 	spmc_state_t state;
49bdd2596dSAchin Gupta } spmd_spm_core_context_t;
50bdd2596dSAchin Gupta 
51bdd2596dSAchin Gupta /*
52662af36dSJ-Alves  * Reserve ID for NS physical FFA Endpoint.
53ac03ac5eSMax Shvetsov  */
54662af36dSJ-Alves #define FFA_NS_ENDPOINT_ID		U(0)
55ac03ac5eSMax Shvetsov 
56662af36dSJ-Alves /* Mask and shift to check valid secure FFA Endpoint ID. */
5752696946SOlivier Deprez #define SPMC_SECURE_ID_MASK		U(1)
5852696946SOlivier Deprez #define SPMC_SECURE_ID_SHIFT		U(15)
59ac03ac5eSMax Shvetsov 
6052696946SOlivier Deprez /* Functions used to enter/exit SPMC synchronously */
61bdd2596dSAchin Gupta uint64_t spmd_spm_core_sync_entry(spmd_spm_core_context_t *ctx);
62bdd2596dSAchin Gupta __dead2 void spmd_spm_core_sync_exit(uint64_t rc);
63bdd2596dSAchin Gupta 
64bdd2596dSAchin Gupta /* Assembly helpers */
65bdd2596dSAchin Gupta uint64_t spmd_spm_core_enter(uint64_t *c_rt_ctx);
66bdd2596dSAchin Gupta void __dead2 spmd_spm_core_exit(uint64_t c_rt_ctx, uint64_t ret);
67bdd2596dSAchin Gupta 
68*c0267cc9SOlivier Deprez /* SPMC entry point information helper */
69*c0267cc9SOlivier Deprez entry_point_info_t *spmd_spmc_ep_info_get(void);
70*c0267cc9SOlivier Deprez 
7152696946SOlivier Deprez /* SPMC context on current CPU get helper */
7252696946SOlivier Deprez spmd_spm_core_context_t *spmd_get_context(void);
7352696946SOlivier Deprez 
74bdd2596dSAchin Gupta #endif /* __ASSEMBLER__ */
75bdd2596dSAchin Gupta 
76bdd2596dSAchin Gupta #endif /* SPMD_PRIVATE_H */
77