u-boot/arch/sandbox/include/asm/sandbox_arm_ffa_priv.h

/* SPDX-License-Identifier: GPL-2.0+ */
/*
 * Copyright 2022-2023 Arm Limited and/or its affiliates <open-source-office@arm.com>
 *
 * Authors:
 *   Abdellatif El Khlifi <abdellatif.elkhlifi@arm.com>
 */

#ifndef __SANDBOX_ARM_FFA_PRV_H
#define __SANDBOX_ARM_FFA_PRV_H

#include <arm_ffa_priv.h>

/* This header is exclusively used by the Sandbox FF-A driver and emulator */

/* Non-secure physical FF-A instance */
#define NS_PHYS_ENDPOINT_ID (0)

#define GET_NS_PHYS_ENDPOINT_ID_MASK		GENMASK(31, 16)
#define GET_NS_PHYS_ENDPOINT_ID(x)		\
			((u16)(FIELD_GET(GET_NS_PHYS_ENDPOINT_ID_MASK, (x))))

/* Helper macro for reading the destination partition ID */
#define GET_DST_SP_ID_MASK		GENMASK(15, 0)
#define GET_DST_SP_ID(x)		\
			((u16)(FIELD_GET(GET_DST_SP_ID_MASK, (x))))

/* Helper macro for setting the source partition ID */
#define PREP_SRC_SP_ID_MASK		GENMASK(31, 16)
#define PREP_SRC_SP_ID(x)		\
			(FIELD_PREP(PREP_SRC_SP_ID_MASK, (x)))

/* Helper macro for setting the destination endpoint ID */
#define PREP_NS_PHYS_ENDPOINT_ID_MASK		GENMASK(15, 0)
#define PREP_NS_PHYS_ENDPOINT_ID(x)		\
			(FIELD_PREP(PREP_NS_PHYS_ENDPOINT_ID_MASK, (x)))

/*  RX/TX buffers minimum size */
#define RXTX_BUFFERS_MIN_SIZE (RXTX_4K)
#define RXTX_BUFFERS_MIN_PAGES (1)

/* MBZ registers info */

/* x1-x7 MBZ */
#define FFA_X1X7_MBZ_CNT (7)
#define FFA_X1X7_MBZ_REG_START (&res->a1)

/* x4-x7 MBZ */
#define FFA_X4X7_MBZ_CNT (4)
#define FFA_X4X7_MBZ_REG_START (&res->a4)

/* x3-x7 MBZ */
#define FFA_X3X7_MBZ_CNT (5)
#define FFA_X3_MBZ_REG_START (&res->a3)

/* number of emulated FF-A secure partitions (SPs) */
#define SANDBOX_PARTITIONS_CNT (4)

/* Binary data of the emulated services UUIDs */

/* service 1  UUID binary data (little-endian format) */
#define SANDBOX_SERVICE1_UUID_A1	0xed32d533
#define SANDBOX_SERVICE1_UUID_A2	0x99e64209
#define SANDBOX_SERVICE1_UUID_A3	0x9cc02d72
#define SANDBOX_SERVICE1_UUID_A4	0xcdd998a7

/* service 2  UUID binary data (little-endian format) */
#define SANDBOX_SERVICE2_UUID_A1	0xed32d544
#define SANDBOX_SERVICE2_UUID_A2	0x99e64209
#define SANDBOX_SERVICE2_UUID_A3	0x9cc02d72
#define SANDBOX_SERVICE2_UUID_A4	0xcdd998a7

/**
 * struct ffa_rxtxpair_info - structure hosting the RX/TX buffers flags
 * @rxbuf_owned:	RX buffer ownership flag (the owner is non secure world)
 * @rxbuf_mapped:	RX buffer mapping flag
 * @txbuf_owned	TX buffer ownership flag
 * @txbuf_mapped:	TX buffer mapping flag
 * @rxtx_buf_size:	RX/TX buffers size
 *
 * Hosts the ownership/mapping flags of the RX/TX buffers
 * When a buffer is owned/mapped its corresponding flag is set to 1 otherwise 0.
 */
struct ffa_rxtxpair_info {
	u8 rxbuf_owned;
	u8 rxbuf_mapped;
	u8 txbuf_owned;
	u8 txbuf_mapped;
	u32 rxtx_buf_size;
};

/**
 * struct sandbox_ffa_emul - emulator data
 *
 * @fwk_version:	FF-A framework version
 * @id:	u-boot endpoint ID
 * @partitions:	The partitions descriptors structure
 * @pair:	The RX/TX buffers pair
 * @pair_info:	The RX/TX buffers pair flags and size
 * @test_ffa_data:	The data of the FF-A bus under test
 *
 * Hosts all the emulated secure world data.
 */
struct sandbox_ffa_emul {
	u32 fwk_version;
	u16 id;
	struct ffa_partitions partitions;
	struct ffa_rxtxpair pair;
	struct ffa_rxtxpair_info pair_info;
};

/**
 * ffa_emul_find() - Finds the FF-A emulator
 * @dev:	the sandbox FF-A device (sandbox-arm-ffa)
 * @emulp:	the FF-A emulator device (sandbox-ffa-emul)
 * Return:
 * 0 on success. Otherwise, failure
 */
int ffa_emul_find(struct udevice *dev, struct udevice **emulp);

#endif