| /* SPDX-License-Identifier: BSD-2-Clause */ |
| /* |
| * Copyright (c) 2016-2021, Linaro Limited |
| */ |
| |
| #ifndef __OPTEE_RPC_CMD_H |
| #define __OPTEE_RPC_CMD_H |
| |
| /* |
| * All RPC is done with a struct optee_msg_arg as bearer of information, |
| * struct optee_msg_arg::arg holds values defined by OPTEE_RPC_CMD_* below. |
| * Only the commands handled by the kernel driver are defined here. |
| * |
| * RPC communication with tee-supplicant is reversed compared to normal |
| * client communication described above. The supplicant receives requests |
| * and sends responses. |
| */ |
| |
| /* |
| * Get time |
| * |
| * Returns number of seconds and nano seconds since the Epoch, |
| * 1970-01-01 00:00:00 +0000 (UTC). |
| * |
| * [out] value[0].a Number of seconds |
| * [out] value[0].b Number of nano seconds. |
| */ |
| #define OPTEE_RPC_CMD_GET_TIME 3 |
| |
| /* |
| * Notification from/to secure world. |
| * |
| * If secure world needs to wait for something, for instance a mutex, it |
| * does a notification wait request instead of spinning in secure world. |
| * Conversely can a synchronous notification can be sent when a secure |
| * world mutex with a thread waiting thread is unlocked. |
| * |
| * This interface can also be used to wait for a asynchronous notification |
| * which instead is sent via a non-secure interrupt. |
| * |
| * Waiting on notification |
| * [in] value[0].a OPTEE_RPC_NOTIFICATION_WAIT |
| * [in] value[0].b notification value |
| * [in] value[0].c timeout in milliseconds or 0 if no timeout |
| * |
| * Sending a synchronous notification |
| * [in] value[0].a OPTEE_RPC_NOTIFICATION_SEND |
| * [in] value[0].b notification value |
| */ |
| #define OPTEE_RPC_CMD_NOTIFICATION 4 |
| #define OPTEE_RPC_NOTIFICATION_WAIT 0 |
| #define OPTEE_RPC_NOTIFICATION_SEND 1 |
| |
| /* |
| * Suspend execution |
| * |
| * [in] value[0].a Number of milliseconds to suspend |
| */ |
| #define OPTEE_RPC_CMD_SUSPEND 5 |
| |
| /* |
| * Allocate a piece of shared memory |
| * |
| * [in] value[0].a Type of memory one of |
| * OPTEE_RPC_SHM_TYPE_* below |
| * [in] value[0].b Requested size |
| * [in] value[0].c Required alignment |
| * [out] memref[0] Buffer |
| */ |
| #define OPTEE_RPC_CMD_SHM_ALLOC 6 |
| /* Memory that can be shared with a non-secure user space application */ |
| #define OPTEE_RPC_SHM_TYPE_APPL 0 |
| /* Memory only shared with non-secure kernel */ |
| #define OPTEE_RPC_SHM_TYPE_KERNEL 1 |
| |
| /* |
| * Free shared memory previously allocated with OPTEE_RPC_CMD_SHM_ALLOC |
| * |
| * [in] value[0].a Type of memory one of |
| * OPTEE_RPC_SHM_TYPE_* above |
| * [in] value[0].b Value of shared memory reference or cookie |
| */ |
| #define OPTEE_RPC_CMD_SHM_FREE 7 |
| |
| /* |
| * Issue master requests (read and write operations) to an I2C chip. |
| * |
| * [in] value[0].a Transfer mode (OPTEE_RPC_I2C_TRANSFER_*) |
| * [in] value[0].b The I2C bus (a.k.a adapter). |
| * 16 bit field. |
| * [in] value[0].c The I2C chip (a.k.a address). |
| * 16 bit field (either 7 or 10 bit effective). |
| * [in] value[1].a The I2C master control flags (ie, 10 bit address). |
| * 16 bit field. |
| * [in/out] memref[2] Buffer used for data transfers. |
| * [out] value[3].a Number of bytes transferred by the REE. |
| */ |
| #define OPTEE_RPC_CMD_I2C_TRANSFER 21 |
| |
| /* I2C master transfer modes */ |
| #define OPTEE_RPC_I2C_TRANSFER_RD 0 |
| #define OPTEE_RPC_I2C_TRANSFER_WR 1 |
| |
| /* I2C master control flags */ |
| #define OPTEE_RPC_I2C_FLAGS_TEN_BIT BIT(0) |
| |
| /* |
| * Reset RPMB probing |
| * |
| * Releases an eventually already used RPMB devices and starts over searching |
| * for RPMB devices. Returns the kind of shared memory to use in subsequent |
| * OPTEE_RPC_CMD_RPMB_PROBE_NEXT and OPTEE_RPC_CMD_RPMB calls. |
| * |
| * [out] value[0].a OPTEE_RPC_SHM_TYPE_*, the parameter for |
| * OPTEE_RPC_CMD_SHM_ALLOC |
| */ |
| #define OPTEE_RPC_CMD_RPMB_PROBE_RESET 22 |
| |
| /* |
| * Probe next RPMB device |
| * |
| * [out] value[0].a Type of RPMB device, OPTEE_RPC_RPMB_* |
| * [out] value[0].b EXT CSD-slice 168 "RPMB Size" |
| * [out] value[0].c EXT CSD-slice 222 "Reliable Write Sector Count" |
| * [out] memref[1] Buffer with the raw CID |
| */ |
| #define OPTEE_RPC_CMD_RPMB_PROBE_NEXT 23 |
| |
| /* Type of RPMB device */ |
| #define OPTEE_RPC_RPMB_EMMC 0 |
| #define OPTEE_RPC_RPMB_UFS 1 |
| #define OPTEE_RPC_RPMB_NVME 2 |
| |
| /* |
| * Replay Protected Memory Block access |
| * |
| * [in] memref[0] Frames to device |
| * [out] memref[1] Frames from device |
| */ |
| #define OPTEE_RPC_CMD_RPMB_FRAMES 24 |
| |
| #endif /*__OPTEE_RPC_CMD_H*/ |
