mirror of
https://github.com/ARM-software/arm-trusted-firmware.git
synced 2025-04-16 01:24:27 +00:00
15ca1ee342
Introduce initial test cases to the TSP which are
designed to be exercised by the FF-A Test Driver
in the Normal World. These have been designed to
test basic functionality of the EL3 SPMC.
These tests currently ensure the following functionality:
- Partition discovery.
- Direct messaging.
- Communication with a Logical SP.
- Memory Sharing and Lending ABIs
- Sharing of contiguous and non-contiguous memory regions.
- Memory region descriptors spread of over multiple
invocations.
Signed-off-by: Marc Bonnici <marc.bonnici@arm.com>
Signed-off-by: Shruti Gupta <shruti.gupta@arm.com>
Change-Id: Iaee4180aa18d6b7ac7b53685c6589f0ab306e876
116 lines
3.3 KiB
C
116 lines
3.3 KiB
C
/*
|
|
* Copyright (c) 2022, Arm Limited. All rights reserved.
|
|
*
|
|
* SPDX-License-Identifier: BSD-3-Clause
|
|
*/
|
|
|
|
#ifndef FFA_HELPERS_H
|
|
#define FFA_HELPERS_H
|
|
|
|
#include <stdint.h>
|
|
|
|
#include "../../services/std_svc/spm/el3_spmc/spmc.h"
|
|
#include "../../services/std_svc/spm/el3_spmc/spmc_shared_mem.h"
|
|
#include <services/el3_spmc_ffa_memory.h>
|
|
#include <services/ffa_svc.h>
|
|
#include "tsp_private.h"
|
|
|
|
static inline uint32_t ffa_func_id(smc_args_t val)
|
|
{
|
|
return (uint32_t) val._regs[0];
|
|
}
|
|
|
|
static inline int32_t ffa_error_code(smc_args_t val)
|
|
{
|
|
return (uint32_t) val._regs[2];
|
|
}
|
|
|
|
extern uint8_t mem_region_buffer[4096 * 2] __aligned(PAGE_SIZE);
|
|
#define REGION_BUF_SIZE sizeof(mem_region_buffer)
|
|
|
|
/** The maximum number of recipients a memory region may be sent to. */
|
|
#define MAX_MEM_SHARE_RECIPIENTS 2U
|
|
|
|
/* FFA Memory Management mode flags. */
|
|
#define FFA_FLAG_SHARE_MEMORY (1U << 3)
|
|
#define FFA_FLAG_LEND_MEMORY (1U << 4)
|
|
|
|
#define FFA_FLAG_MEMORY_MASK (3U << 3)
|
|
|
|
#define FFA_MEM_HANDLE_LOW(x) (x & 0xFFFFFFFF)
|
|
#define FFA_MEM_HANDLE_HIGH(x) (x >> 32)
|
|
|
|
#define FFA_MEM_PERM_DATA_OFFSET 0
|
|
#define FFA_MEM_PERM_DATA_MASK 0x3
|
|
|
|
static inline uint32_t ffa_mem_relinquish_init(
|
|
struct ffa_mem_relinquish_descriptor *relinquish_request,
|
|
uint64_t handle, ffa_mtd_flag32_t flags,
|
|
ffa_endpoint_id16_t sender)
|
|
{
|
|
relinquish_request->handle = handle;
|
|
relinquish_request->flags = flags;
|
|
relinquish_request->endpoint_count = 1;
|
|
relinquish_request->endpoint_array[0] = sender;
|
|
|
|
return sizeof(struct ffa_mem_relinquish_descriptor) + sizeof(ffa_endpoint_id16_t);
|
|
}
|
|
|
|
/**
|
|
* Gets the `ffa_comp_mrd` for the given receiver from an
|
|
* `ffa_mtd`, or NULL if it is not valid.
|
|
*/
|
|
static inline struct ffa_comp_mrd *
|
|
ffa_memory_region_get_composite(struct ffa_mtd *memory_region,
|
|
uint32_t receiver_index)
|
|
{
|
|
struct ffa_emad_v1_0 *receivers;
|
|
uint32_t offset;
|
|
|
|
receivers = (struct ffa_emad_v1_0 *)
|
|
((uint8_t *) memory_region +
|
|
memory_region->emad_offset +
|
|
(memory_region->emad_size * receiver_index));
|
|
offset = receivers->comp_mrd_offset;
|
|
|
|
if (offset == 0U) {
|
|
return NULL;
|
|
}
|
|
|
|
return (struct ffa_comp_mrd *)
|
|
((uint8_t *) memory_region + offset);
|
|
}
|
|
|
|
static inline uint32_t ffa_get_data_access_attr(ffa_mem_perm8_t perm)
|
|
{
|
|
return ((perm >> FFA_MEM_PERM_DATA_OFFSET) & FFA_MEM_PERM_DATA_MASK);
|
|
}
|
|
|
|
smc_args_t ffa_mem_frag_rx(uint64_t handle, uint32_t recv_length);
|
|
bool ffa_mem_relinquish(void);
|
|
bool ffa_rx_release(void);
|
|
bool memory_relinquish(struct ffa_mem_relinquish_descriptor *m, uint64_t handle,
|
|
ffa_endpoint_id16_t id);
|
|
bool ffa_rxtx_map(uintptr_t send, uintptr_t recv, uint32_t pages);
|
|
bool memory_retrieve(struct mailbox *mb,
|
|
struct ffa_mtd **retrieved,
|
|
uint64_t handle, ffa_endpoint_id16_t sender,
|
|
ffa_endpoint_id16_t *receivers, uint32_t receiver_count,
|
|
ffa_mtd_flag32_t flags, uint32_t *frag_length,
|
|
uint32_t *total_length);
|
|
|
|
smc_args_t ffa_msg_send_direct_req(ffa_endpoint_id16_t sender,
|
|
ffa_endpoint_id16_t receiver,
|
|
uint32_t arg3,
|
|
uint32_t arg4,
|
|
uint32_t arg5,
|
|
uint32_t arg6,
|
|
uint32_t arg7);
|
|
smc_args_t *ffa_msg_send_direct_resp(ffa_endpoint_id16_t sender,
|
|
ffa_endpoint_id16_t receiver,
|
|
uint32_t arg3,
|
|
uint32_t arg4,
|
|
uint32_t arg5,
|
|
uint32_t arg6,
|
|
uint32_t arg7);
|
|
#endif /* FFA_HELPERS_H */
|