xref: /rk3399_ARM-atf/include/drivers/arm/tzc400.h (revision 51faada71a219a8b94cd8d8e423f0f22e9da4d8f)
1 /*
2  * Copyright (c) 2014-2016, ARM Limited and Contributors. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions are met:
6  *
7  * Redistributions of source code must retain the above copyright notice, this
8  * list of conditions and the following disclaimer.
9  *
10  * Redistributions in binary form must reproduce the above copyright notice,
11  * this list of conditions and the following disclaimer in the documentation
12  * and/or other materials provided with the distribution.
13  *
14  * Neither the name of ARM nor the names of its contributors may be used
15  * to endorse or promote products derived from this software without specific
16  * prior written permission.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
22  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28  * POSSIBILITY OF SUCH DAMAGE.
29  */
30 
31 #ifndef __TZC400_H__
32 #define __TZC400_H__
33 
34 #include <tzc_common.h>
35 
36 #define BUILD_CONFIG_OFF			0x000
37 #define GATE_KEEPER_OFF				0x008
38 #define SPECULATION_CTRL_OFF			0x00c
39 #define INT_STATUS				0x010
40 #define INT_CLEAR				0x014
41 
42 #define FAIL_ADDRESS_LOW_OFF			0x020
43 #define FAIL_ADDRESS_HIGH_OFF			0x024
44 #define FAIL_CONTROL_OFF			0x028
45 #define FAIL_ID					0x02c
46 
47 /* ID registers not common across different varieties of TZC */
48 #define PID5					0xFD4
49 #define PID6					0xFD8
50 #define PID7					0xFDC
51 
52 #define BUILD_CONFIG_NF_SHIFT			24
53 #define BUILD_CONFIG_NF_MASK			0x3
54 #define BUILD_CONFIG_AW_SHIFT			8
55 #define BUILD_CONFIG_AW_MASK			0x3f
56 #define BUILD_CONFIG_NR_SHIFT			0
57 #define BUILD_CONFIG_NR_MASK			0x1f
58 
59 /*
60  * Number of gate keepers is implementation defined. But we know the max for
61  * this device is 4. Get implementation details from BUILD_CONFIG.
62  */
63 #define GATE_KEEPER_OS_SHIFT			16
64 #define GATE_KEEPER_OS_MASK			0xf
65 #define GATE_KEEPER_OR_SHIFT			0
66 #define GATE_KEEPER_OR_MASK			0xf
67 #define GATE_KEEPER_FILTER_MASK			0x1
68 
69 /* Speculation is enabled by default. */
70 #define SPECULATION_CTRL_WRITE_DISABLE		(1 << 1)
71 #define SPECULATION_CTRL_READ_DISABLE		(1 << 0)
72 
73 /* Max number of filters allowed is 4. */
74 #define INT_STATUS_OVERLAP_SHIFT		16
75 #define INT_STATUS_OVERLAP_MASK			0xf
76 #define INT_STATUS_OVERRUN_SHIFT		8
77 #define INT_STATUS_OVERRUN_MASK			0xf
78 #define INT_STATUS_STATUS_SHIFT			0
79 #define INT_STATUS_STATUS_MASK			0xf
80 
81 #define INT_CLEAR_CLEAR_SHIFT			0
82 #define INT_CLEAR_CLEAR_MASK			0xf
83 
84 #define FAIL_CONTROL_DIR_SHIFT			(1 << 24)
85 #define FAIL_CONTROL_DIR_READ			0x0
86 #define FAIL_CONTROL_DIR_WRITE			0x1
87 #define FAIL_CONTROL_NS_SHIFT			(1 << 21)
88 #define FAIL_CONTROL_NS_SECURE			0x0
89 #define FAIL_CONTROL_NS_NONSECURE		0x1
90 #define FAIL_CONTROL_PRIV_SHIFT			(1 << 20)
91 #define FAIL_CONTROL_PRIV_PRIV			0x0
92 #define FAIL_CONTROL_PRIV_UNPRIV		0x1
93 
94 /*
95  * FAIL_ID_ID_MASK depends on AID_WIDTH which is platform specific.
96  * Platform should provide the value on initialisation.
97  */
98 #define FAIL_ID_VNET_SHIFT			24
99 #define FAIL_ID_VNET_MASK			0xf
100 #define FAIL_ID_ID_SHIFT			0
101 
102 #define TZC_400_PERIPHERAL_ID			0x460
103 
104 /* Filter enable bits in a TZC */
105 #define TZC_400_REGION_ATTR_F_EN_MASK		0xf
106 #define TZC_400_REGION_ATTR_FILTER_BIT(x)	((1 << x)		\
107 					<< TZC_REGION_ATTR_F_EN_SHIFT)
108 #define TZC_400_REGION_ATTR_FILTER_BIT_ALL				\
109 				(TZC_400_REGION_ATTR_F_EN_MASK <<	\
110 				TZC_REGION_ATTR_F_EN_SHIFT)
111 
112 /*
113  * Define some macros for backward compatibility with existing tzc400 clients.
114  */
115 #if !ERROR_DEPRECATED
116 #define REG_ATTR_FILTER_BIT(x)			((1 << x)		\
117 					<< TZC_REGION_ATTR_F_EN_SHIFT)
118 #define REG_ATTR_FILTER_BIT_ALL	(TZC_400_REGION_ATTR_F_EN_MASK <<	\
119 					TZC_REGION_ATTR_F_EN_SHIFT)
120 #endif /* __ERROR_DEPRECATED__ */
121 
122 /*
123  * All TZC region configuration registers are placed one after another. It
124  * depicts size of block of registers for programming each region.
125  */
126 #define TZC_400_REGION_SIZE			0x20
127 #define TZC_400_ACTION_OFF			0x4
128 
129 #ifndef __ASSEMBLY__
130 
131 #include <cdefs.h>
132 #include <stdint.h>
133 
134 /*******************************************************************************
135  * Function & variable prototypes
136  ******************************************************************************/
137 void tzc400_init(uintptr_t base);
138 void tzc400_configure_region0(tzc_region_attributes_t sec_attr,
139 			   unsigned int ns_device_access);
140 void tzc400_configure_region(unsigned int filters,
141 			  int region,
142 			  unsigned long long region_base,
143 			  unsigned long long region_top,
144 			  tzc_region_attributes_t sec_attr,
145 			  unsigned int ns_device_access);
146 void tzc400_set_action(tzc_action_t action);
147 void tzc400_enable_filters(void);
148 void tzc400_disable_filters(void);
149 
150 /*
151  * Deprecated APIs
152  */
153 static inline void tzc_init(uintptr_t base) __deprecated;
154 static inline void tzc_configure_region0(
155 			tzc_region_attributes_t sec_attr,
156 			unsigned int ns_device_access) __deprecated;
157 static inline void tzc_configure_region(
158 			  unsigned int filters,
159 			  int region,
160 			  unsigned long long region_base,
161 			  unsigned long long region_top,
162 			  tzc_region_attributes_t sec_attr,
163 			  unsigned int ns_device_access) __deprecated;
164 static inline void tzc_set_action(tzc_action_t action) __deprecated;
165 static inline void tzc_enable_filters(void) __deprecated;
166 static inline void tzc_disable_filters(void) __deprecated;
167 
168 static inline void tzc_init(uintptr_t base)
169 {
170 	tzc400_init(base);
171 }
172 
173 static inline void tzc_configure_region0(
174 			tzc_region_attributes_t sec_attr,
175 			unsigned int ns_device_access)
176 {
177 	tzc400_configure_region0(sec_attr, ns_device_access);
178 }
179 
180 static inline void tzc_configure_region(
181 			  unsigned int filters,
182 			  int region,
183 			  unsigned long long region_base,
184 			  unsigned long long region_top,
185 			  tzc_region_attributes_t sec_attr,
186 			  unsigned int ns_device_access)
187 {
188 	tzc400_configure_region(filters, region, region_base,
189 			region_top, sec_attr, ns_device_access);
190 }
191 
192 static inline void tzc_set_action(tzc_action_t action)
193 {
194 	tzc400_set_action(action);
195 }
196 
197 
198 static inline void tzc_enable_filters(void)
199 {
200 	tzc400_enable_filters();
201 }
202 
203 static inline void tzc_disable_filters(void)
204 {
205 	tzc400_disable_filters();
206 }
207 
208 #endif /* __ASSEMBLY__ */
209 
210 #endif /* __TZC400__ */
211