xref: /rk3399_ARM-atf/services/std_svc/spmd/spmd_private.h (revision 9dcf63dd8bb02fca8f781c06e610f2012e5dc690)
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,
38*9dcf63ddSOlivier Deprez 	SPMC_STATE_OFF,
39*9dcf63ddSOlivier Deprez 	SPMC_STATE_ON_PENDING,
40*9dcf63ddSOlivier Deprez 	SPMC_STATE_ON
41bdd2596dSAchin Gupta } spmc_state_t;
42bdd2596dSAchin Gupta 
43bdd2596dSAchin Gupta /*
44bdd2596dSAchin Gupta  * Data structure used by the SPM dispatcher (SPMD) in EL3 to track context of
45bdd2596dSAchin Gupta  * the SPM core (SPMC) at the next lower EL.
46bdd2596dSAchin Gupta  */
47bdd2596dSAchin Gupta typedef struct spmd_spm_core_context {
48bdd2596dSAchin Gupta 	uint64_t c_rt_ctx;
49bdd2596dSAchin Gupta 	cpu_context_t cpu_ctx;
50bdd2596dSAchin Gupta 	spmc_state_t state;
51bdd2596dSAchin Gupta } spmd_spm_core_context_t;
52bdd2596dSAchin Gupta 
53bdd2596dSAchin Gupta /*
54662af36dSJ-Alves  * Reserve ID for NS physical FFA Endpoint.
55ac03ac5eSMax Shvetsov  */
56662af36dSJ-Alves #define FFA_NS_ENDPOINT_ID		U(0)
57ac03ac5eSMax Shvetsov 
58662af36dSJ-Alves /* Mask and shift to check valid secure FFA Endpoint ID. */
5952696946SOlivier Deprez #define SPMC_SECURE_ID_MASK		U(1)
6052696946SOlivier Deprez #define SPMC_SECURE_ID_SHIFT		U(15)
61ac03ac5eSMax Shvetsov 
6252696946SOlivier Deprez /* Functions used to enter/exit SPMC synchronously */
63bdd2596dSAchin Gupta uint64_t spmd_spm_core_sync_entry(spmd_spm_core_context_t *ctx);
64bdd2596dSAchin Gupta __dead2 void spmd_spm_core_sync_exit(uint64_t rc);
65bdd2596dSAchin Gupta 
66bdd2596dSAchin Gupta /* Assembly helpers */
67bdd2596dSAchin Gupta uint64_t spmd_spm_core_enter(uint64_t *c_rt_ctx);
68bdd2596dSAchin Gupta void __dead2 spmd_spm_core_exit(uint64_t c_rt_ctx, uint64_t ret);
69bdd2596dSAchin Gupta 
70c0267cc9SOlivier Deprez /* SPMC entry point information helper */
71c0267cc9SOlivier Deprez entry_point_info_t *spmd_spmc_ep_info_get(void);
72c0267cc9SOlivier Deprez 
7352696946SOlivier Deprez /* SPMC context on current CPU get helper */
7452696946SOlivier Deprez spmd_spm_core_context_t *spmd_get_context(void);
7552696946SOlivier Deprez 
76bdd2596dSAchin Gupta #endif /* __ASSEMBLER__ */
77bdd2596dSAchin Gupta 
78bdd2596dSAchin Gupta #endif /* SPMD_PRIVATE_H */
79