xref: /rk3399_ARM-atf/services/std_svc/rmmd/rmmd_private.h (revision 2132c707d73753338ce05f262843a91738177f5e)
177c27753SZelalem Aweke /*
2*2132c707SSona Mathew  * Copyright (c) 2021-2025, Arm Limited and Contributors. All rights reserved.
377c27753SZelalem Aweke  *
477c27753SZelalem Aweke  * SPDX-License-Identifier: BSD-3-Clause
577c27753SZelalem Aweke  */
677c27753SZelalem Aweke 
777c27753SZelalem Aweke #ifndef RMMD_PRIVATE_H
877c27753SZelalem Aweke #define RMMD_PRIVATE_H
977c27753SZelalem Aweke 
1077c27753SZelalem Aweke #include <context.h>
11*2132c707SSona Mathew #include <services/rmmd_svc.h>
1277c27753SZelalem Aweke 
1377c27753SZelalem Aweke /*******************************************************************************
1477c27753SZelalem Aweke  * Constants that allow assembler code to preserve callee-saved registers of the
1577c27753SZelalem Aweke  * C runtime context while performing a security state switch.
1677c27753SZelalem Aweke  ******************************************************************************/
1777c27753SZelalem Aweke #define RMMD_C_RT_CTX_X19		0x0
1877c27753SZelalem Aweke #define RMMD_C_RT_CTX_X20		0x8
1977c27753SZelalem Aweke #define RMMD_C_RT_CTX_X21		0x10
2077c27753SZelalem Aweke #define RMMD_C_RT_CTX_X22		0x18
2177c27753SZelalem Aweke #define RMMD_C_RT_CTX_X23		0x20
2277c27753SZelalem Aweke #define RMMD_C_RT_CTX_X24		0x28
2377c27753SZelalem Aweke #define RMMD_C_RT_CTX_X25		0x30
2477c27753SZelalem Aweke #define RMMD_C_RT_CTX_X26		0x38
2577c27753SZelalem Aweke #define RMMD_C_RT_CTX_X27		0x40
2677c27753SZelalem Aweke #define RMMD_C_RT_CTX_X28		0x48
2777c27753SZelalem Aweke #define RMMD_C_RT_CTX_X29		0x50
2877c27753SZelalem Aweke #define RMMD_C_RT_CTX_X30		0x58
2977c27753SZelalem Aweke 
3077c27753SZelalem Aweke #define RMMD_C_RT_CTX_SIZE		0x60
3177c27753SZelalem Aweke #define RMMD_C_RT_CTX_ENTRIES		(RMMD_C_RT_CTX_SIZE >> DWORD_SHIFT)
3277c27753SZelalem Aweke 
3377c27753SZelalem Aweke #ifndef __ASSEMBLER__
3477c27753SZelalem Aweke #include <stdint.h>
3577c27753SZelalem Aweke 
3677c27753SZelalem Aweke /*
3777c27753SZelalem Aweke  * Data structure used by the RMM dispatcher (RMMD) in EL3 to track context of
3877c27753SZelalem Aweke  * the RMM at R-EL2.
3977c27753SZelalem Aweke  */
4077c27753SZelalem Aweke typedef struct rmmd_rmm_context {
4177c27753SZelalem Aweke 	uint64_t c_rt_ctx;
4277c27753SZelalem Aweke 	cpu_context_t cpu_ctx;
4377c27753SZelalem Aweke } rmmd_rmm_context_t;
4477c27753SZelalem Aweke 
4577c27753SZelalem Aweke /* Functions used to enter/exit the RMM synchronously */
4677c27753SZelalem Aweke uint64_t rmmd_rmm_sync_entry(rmmd_rmm_context_t *ctx);
4777c27753SZelalem Aweke __dead2 void rmmd_rmm_sync_exit(uint64_t rc);
4877c27753SZelalem Aweke 
490f9159b7SSoby Mathew /* Functions implementing attestation utilities for RMM */
50dc65ae46SJavier Almansa Sobrino int rmmd_attest_get_platform_token(uint64_t buf_pa, uint64_t *buf_size,
5142cf6026SJuan Pablo Conde 				   uint64_t c_size,
5242cf6026SJuan Pablo Conde 				   uint64_t *remaining_len);
53dc65ae46SJavier Almansa Sobrino int rmmd_attest_get_signing_key(uint64_t buf_pa, uint64_t *buf_size,
54a0435105SSoby Mathew 				uint64_t ecc_curve);
556a88ec8bSRaghu Krishnamurthy uint64_t rmmd_el3_token_sign(void *handle, uint64_t x1, uint64_t x2,
566a88ec8bSRaghu Krishnamurthy 				    uint64_t x3, uint64_t x4);
570f9159b7SSoby Mathew 
58*2132c707SSona Mathew /* Functions implementing IDE KM programming */
59*2132c707SSona Mathew int rmmd_el3_ide_key_program(uint64_t ecam_address, uint64_t rp_id,
60*2132c707SSona Mathew 			     uint64_t ide_stream_info, rp_ide_key_info_t *ide_key_info_ptr,
61*2132c707SSona Mathew 			     uint64_t request_id, uint64_t cookie);
62*2132c707SSona Mathew int rmmd_el3_ide_key_set_go(uint64_t ecam_address, uint64_t rp_id, uint64_t ide_stream_info,
63*2132c707SSona Mathew 			    uint64_t request_id, uint64_t cookie);
64*2132c707SSona Mathew int rmmd_el3_ide_key_set_stop(uint64_t ecam_address, uint64_t rp_id, uint64_t ide_stream_info,
65*2132c707SSona Mathew 			      uint64_t request_id, uint64_t cookie);
66*2132c707SSona Mathew int rmmd_el3_ide_km_pull_response(uint64_t ecam_address, uint64_t rp_id, uint64_t *req_resp,
67*2132c707SSona Mathew 				  uint64_t *request_id, uint64_t *cookie_ptr);
68*2132c707SSona Mathew 
6977c27753SZelalem Aweke /* Assembly helpers */
7077c27753SZelalem Aweke uint64_t rmmd_rmm_enter(uint64_t *c_rt_ctx);
7177c27753SZelalem Aweke void __dead2 rmmd_rmm_exit(uint64_t c_rt_ctx, uint64_t ret);
7277c27753SZelalem Aweke 
7377c27753SZelalem Aweke /* Reference to PM ops for the RMMD */
7477c27753SZelalem Aweke extern const spd_pm_ops_t rmmd_pm;
7577c27753SZelalem Aweke 
7677c27753SZelalem Aweke #endif /* __ASSEMBLER__ */
7777c27753SZelalem Aweke 
7877c27753SZelalem Aweke #endif /* RMMD_PRIVATE_H */
79