blob: ed4792e5806f3322796c41fab3ec6594c7c5ec9a [file] [log] [blame]
Achin Gupta7c88f3f2014-02-18 18:09:12 +00001/*
David Cunado28f69ab2017-04-05 11:34:03 +01002 * Copyright (c) 2013-2017, ARM Limited and Contributors. All rights reserved.
Achin Gupta7c88f3f2014-02-18 18:09:12 +00003 *
dp-armfa3cf0b2017-05-03 09:38:09 +01004 * SPDX-License-Identifier: BSD-3-Clause
Achin Gupta7c88f3f2014-02-18 18:09:12 +00005 */
6
Antonio Nino Diaz5eb88372018-11-08 10:20:19 +00007#ifndef TSP_H
8#define TSP_H
Achin Gupta7c88f3f2014-02-18 18:09:12 +00009
Achin Gupta7c88f3f2014-02-18 18:09:12 +000010/*
11 * SMC function IDs that TSP uses to signal various forms of completions
12 * to the secure payload dispatcher.
13 */
14#define TSP_ENTRY_DONE 0xf2000000
15#define TSP_ON_DONE 0xf2000001
16#define TSP_OFF_DONE 0xf2000002
17#define TSP_SUSPEND_DONE 0xf2000003
18#define TSP_RESUME_DONE 0xf2000004
Soby Mathew9f71f702014-05-09 20:49:17 +010019#define TSP_PREEMPTED 0xf2000005
Douglas Raillardf2129652016-11-24 15:43:19 +000020#define TSP_ABORT_DONE 0xf2000007
Juan Castillo4dc4a472014-08-12 11:17:06 +010021#define TSP_SYSTEM_OFF_DONE 0xf2000008
22#define TSP_SYSTEM_RESET_DONE 0xf2000009
Achin Gupta7c88f3f2014-02-18 18:09:12 +000023
Achin Gupta76717892014-05-09 11:42:56 +010024/*
David Cunado28f69ab2017-04-05 11:34:03 +010025 * Function identifiers to handle S-EL1 interrupt through the synchronous
Soby Mathewbec98512015-09-03 18:29:38 +010026 * handling model. If the TSP was previously interrupted then control has to
27 * be returned to the TSPD after handling the interrupt else execution can
28 * remain in the TSP.
Achin Gupta76717892014-05-09 11:42:56 +010029 */
Soby Mathewbec98512015-09-03 18:29:38 +010030#define TSP_HANDLED_S_EL1_INTR 0xf2000006
Achin Gupta76717892014-05-09 11:42:56 +010031
32/* SMC function ID that TSP uses to request service from secure monitor */
Achin Gupta7c88f3f2014-02-18 18:09:12 +000033#define TSP_GET_ARGS 0xf2001000
34
Soby Mathew9f71f702014-05-09 20:49:17 +010035/*
36 * Identifiers for various TSP services. Corresponding function IDs (whether
David Cunado28f69ab2017-04-05 11:34:03 +010037 * fast or yielding) are generated by macros defined below
Soby Mathew9f71f702014-05-09 20:49:17 +010038 */
39#define TSP_ADD 0x2000
40#define TSP_SUB 0x2001
41#define TSP_MUL 0x2002
42#define TSP_DIV 0x2003
Soby Mathewbec98512015-09-03 18:29:38 +010043#define TSP_HANDLE_SEL1_INTR_AND_RETURN 0x2004
Soby Mathew9f71f702014-05-09 20:49:17 +010044
45/*
Douglas Raillard04939f12016-12-12 14:37:34 +000046 * Identify a TSP service from function ID filtering the last 16 bits from the
47 * SMC function ID
48 */
49#define TSP_BARE_FID(fid) ((fid) & 0xffff)
50
51/*
Soby Mathew9f71f702014-05-09 20:49:17 +010052 * Generate function IDs for TSP services to be used in SMC calls, by
David Cunado28f69ab2017-04-05 11:34:03 +010053 * appropriately setting bit 31 to differentiate yielding and fast SMC calls
Soby Mathew9f71f702014-05-09 20:49:17 +010054 */
David Cunado28f69ab2017-04-05 11:34:03 +010055#define TSP_YIELD_FID(fid) ((TSP_BARE_FID(fid) | 0x72000000))
Douglas Raillard04939f12016-12-12 14:37:34 +000056#define TSP_FAST_FID(fid) ((TSP_BARE_FID(fid) | 0x72000000) | (1u << 31))
Soby Mathew9f71f702014-05-09 20:49:17 +010057
David Cunado28f69ab2017-04-05 11:34:03 +010058/* SMC function ID to request a previously preempted yielding smc */
59#define TSP_FID_RESUME TSP_YIELD_FID(0x3000)
Jeenu Viswambharandf1ddb52014-02-28 11:23:35 +000060/*
David Cunado28f69ab2017-04-05 11:34:03 +010061 * SMC function ID to request abortion of a previously preempted yielding SMC. A
Douglas Raillardf2129652016-11-24 15:43:19 +000062 * fast SMC is used so that the TSP abort handler does not have to be
63 * reentrant.
64 */
65#define TSP_FID_ABORT TSP_FAST_FID(0x3001)
66
67/*
Jeenu Viswambharandf1ddb52014-02-28 11:23:35 +000068 * Total number of function IDs implemented for services offered to NS clients.
69 * The function IDs are defined above
70 */
Douglas Raillardf2129652016-11-24 15:43:19 +000071#define TSP_NUM_FID 0x5
Jeenu Viswambharandf1ddb52014-02-28 11:23:35 +000072
73/* TSP implementation version numbers */
74#define TSP_VERSION_MAJOR 0x0 /* Major version */
75#define TSP_VERSION_MINOR 0x1 /* Minor version */
76
77/*
78 * Standard Trusted OS Function IDs that fall under Trusted OS call range
79 * according to SMC calling convention
80 */
81#define TOS_CALL_COUNT 0xbf00ff00 /* Number of calls implemented */
82#define TOS_UID 0xbf00ff01 /* Implementation UID */
83/* 0xbf00ff02 is reserved */
84#define TOS_CALL_VERSION 0xbf00ff03 /* Trusted OS Call Version */
85
Achin Gupta7c88f3f2014-02-18 18:09:12 +000086
87#ifndef __ASSEMBLY__
Dan Handley2bd4ef22014-04-09 13:14:54 +010088
Achin Gupta7c88f3f2014-02-18 18:09:12 +000089#include <stdint.h>
90
Dan Handleye2c27f52014-08-01 17:58:27 +010091
Andrew Thoelke891c4ca2014-05-20 21:43:27 +010092typedef uint32_t tsp_vector_isn_t;
Achin Gupta7c88f3f2014-02-18 18:09:12 +000093
Andrew Thoelke891c4ca2014-05-20 21:43:27 +010094typedef struct tsp_vectors {
David Cunado28f69ab2017-04-05 11:34:03 +010095 tsp_vector_isn_t yield_smc_entry;
Andrew Thoelke891c4ca2014-05-20 21:43:27 +010096 tsp_vector_isn_t fast_smc_entry;
97 tsp_vector_isn_t cpu_on_entry;
98 tsp_vector_isn_t cpu_off_entry;
99 tsp_vector_isn_t cpu_resume_entry;
100 tsp_vector_isn_t cpu_suspend_entry;
Soby Mathewbec98512015-09-03 18:29:38 +0100101 tsp_vector_isn_t sel1_intr_entry;
Juan Castillo4dc4a472014-08-12 11:17:06 +0100102 tsp_vector_isn_t system_off_entry;
103 tsp_vector_isn_t system_reset_entry;
David Cunado28f69ab2017-04-05 11:34:03 +0100104 tsp_vector_isn_t abort_yield_smc_entry;
Andrew Thoelke891c4ca2014-05-20 21:43:27 +0100105} tsp_vectors_t;
Achin Gupta7c88f3f2014-02-18 18:09:12 +0000106
Andrew Thoelke891c4ca2014-05-20 21:43:27 +0100107
Achin Gupta7c88f3f2014-02-18 18:09:12 +0000108#endif /* __ASSEMBLY__ */
109
Antonio Nino Diaz5eb88372018-11-08 10:20:19 +0000110#endif /* TSP_H */