blob: 164377f6f216a5d9cef7fcdff9ffeb45be3556c4 [file] [log] [blame]
Achin Gupta4f6ad662013-10-25 09:08:21 +01001/*
Dan Handleye83b0ca2014-01-14 18:17:09 +00002 * Copyright (c) 2013-2014, ARM Limited and Contributors. All rights reserved.
Achin Gupta4f6ad662013-10-25 09:08:21 +01003 *
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 __BL_COMMON_H__
32#define __BL_COMMON_H__
33
Vikram Kanigirida567432014-04-15 18:08:08 +010034#define SECURE 0x0
35#define NON_SECURE 0x1
Juan Castillof558cac2014-06-05 09:45:36 +010036#define sec_state_is_valid(s) (((s) == SECURE) || ((s) == NON_SECURE))
Achin Gupta4f6ad662013-10-25 09:08:21 +010037
38#define UP 1
39#define DOWN 0
40
41/*******************************************************************************
Sandrine Bailleux467d0572014-06-24 14:02:34 +010042 * Constants to identify the location of a memory region in a given memory
43 * layout.
44******************************************************************************/
45#define TOP 0x1
46#define BOTTOM !TOP
Achin Gupta4f6ad662013-10-25 09:08:21 +010047
Sandrine Bailleuxba6980a2013-12-02 15:41:25 +000048/******************************************************************************
49 * Opcode passed in x0 to tell next EL that we want to run an image.
50 * Corresponds to the function ID of the only SMC that the BL1 exception
51 * handlers service. That's why the chosen value is the first function ID of
52 * the ARM SMC64 range.
53 *****************************************************************************/
54#define RUN_IMAGE 0xC0000000
55
Vikram Kanigiria3a5e4a2014-05-15 18:27:15 +010056/*******************************************************************************
57 * Constants that allow assembler code to access members of and the
Vikram Kanigirida567432014-04-15 18:08:08 +010058 * 'entry_point_info' structure at their correct offsets.
Vikram Kanigiria3a5e4a2014-05-15 18:27:15 +010059 ******************************************************************************/
Vikram Kanigirida567432014-04-15 18:08:08 +010060#define ENTRY_POINT_INFO_PC_OFFSET 0x08
61#define ENTRY_POINT_INFO_ARGS_OFFSET 0x18
Sandrine Bailleuxba6980a2013-12-02 15:41:25 +000062
Andrew Thoelke4e126072014-06-04 21:10:52 +010063#define PARAM_EP_SECURITY_MASK 0x1
Vikram Kanigirida567432014-04-15 18:08:08 +010064#define GET_SECURITY_STATE(x) (x & PARAM_EP_SECURITY_MASK)
65#define SET_SECURITY_STATE(x, security) \
66 ((x) = ((x) & ~PARAM_EP_SECURITY_MASK) | (security))
67
Andrew Thoelke4e126072014-06-04 21:10:52 +010068#define EP_EE_MASK 0x2
69#define EP_EE_LITTLE 0x0
70#define EP_EE_BIG 0x2
71#define EP_GET_EE(x) (x & EP_EE_MASK)
72#define EP_SET_EE(x, ee) ((x) = ((x) & ~EP_EE_MASK) | (ee))
73
74#define EP_ST_MASK 0x4
75#define EP_ST_DISABLE 0x0
76#define EP_ST_ENABLE 0x4
77#define EP_GET_ST(x) (x & EP_ST_MASK)
78#define EP_SET_ST(x, ee) ((x) = ((x) & ~EP_ST_MASK) | (ee))
79
Vikram Kanigirida567432014-04-15 18:08:08 +010080#define PARAM_EP 0x01
81#define PARAM_IMAGE_BINARY 0x02
82#define PARAM_BL31 0x03
Dan Handley2bd4ef22014-04-09 13:14:54 +010083
Vikram Kanigirida567432014-04-15 18:08:08 +010084#define VERSION_1 0x01
85
86#define SET_PARAM_HEAD(_p, _type, _ver, _attr) do { \
87 (_p)->h.type = (uint8_t)(_type); \
88 (_p)->h.version = (uint8_t)(_ver); \
89 (_p)->h.size = (uint16_t)sizeof(*_p); \
90 (_p)->h.attr = (uint32_t)(_attr) ; \
91 } while (0)
92
93#ifndef __ASSEMBLY__
Dan Handley2bd4ef22014-04-09 13:14:54 +010094#include <cdefs.h> /* For __dead2 */
Vikram Kanigiria3a5e4a2014-05-15 18:27:15 +010095#include <cassert.h>
Vikram Kanigirida567432014-04-15 18:08:08 +010096#include <stdint.h>
Sandrine Bailleux467d0572014-06-24 14:02:34 +010097#include <stddef.h>
Achin Guptae4d084e2014-02-19 17:18:23 +000098
Vikram Kanigiri725b1332015-03-04 10:34:27 +000099#define ARRAY_SIZE(a) (sizeof(a) / sizeof((a)[0]))
100
Dan Handleyf05c1b52015-04-27 11:49:22 +0100101/*
102 * Declarations of linker defined symbols to help determine memory layout of
103 * BL images
104 */
105extern unsigned long __RO_START__;
106extern unsigned long __RO_END__;
107#if IMAGE_BL2
108extern unsigned long __BL2_END__;
109#elif IMAGE_BL31
110extern unsigned long __BL31_END__;
111#elif IMAGE_BL32
112extern unsigned long __BL32_END__;
113#endif /* IMAGE_BLX */
114
115#if USE_COHERENT_MEM
116extern unsigned long __COHERENT_RAM_START__;
117extern unsigned long __COHERENT_RAM_END__;
118#endif
119
120
Achin Gupta4f6ad662013-10-25 09:08:21 +0100121/*******************************************************************************
122 * Structure used for telling the next BL how much of a particular type of
123 * memory is available for its use and how much is already used.
124 ******************************************************************************/
Dan Handleye2712bc2014-04-10 15:37:22 +0100125typedef struct meminfo {
Sandrine Bailleux467d0572014-06-24 14:02:34 +0100126 uint64_t total_base;
127 size_t total_size;
128 uint64_t free_base;
129 size_t free_size;
Dan Handleye2712bc2014-04-10 15:37:22 +0100130} meminfo_t;
Achin Gupta4f6ad662013-10-25 09:08:21 +0100131
Dan Handleye2712bc2014-04-10 15:37:22 +0100132typedef struct aapcs64_params {
Achin Gupta4f6ad662013-10-25 09:08:21 +0100133 unsigned long arg0;
134 unsigned long arg1;
135 unsigned long arg2;
136 unsigned long arg3;
137 unsigned long arg4;
138 unsigned long arg5;
139 unsigned long arg6;
140 unsigned long arg7;
Dan Handleye2712bc2014-04-10 15:37:22 +0100141} aapcs64_params_t;
Achin Gupta4f6ad662013-10-25 09:08:21 +0100142
Vikram Kanigirida567432014-04-15 18:08:08 +0100143/***************************************************************************
144 * This structure provides version information and the size of the
145 * structure, attributes for the structure it represents
146 ***************************************************************************/
147typedef struct param_header {
148 uint8_t type; /* type of the structure */
149 uint8_t version; /* version of this structure */
150 uint16_t size; /* size of this structure in bytes */
151 uint32_t attr; /* attributes: unused bits SBZ */
152} param_header_t;
153
154/*****************************************************************************
155 * This structure represents the superset of information needed while
156 * switching exception levels. The only two mechanisms to do so are
157 * ERET & SMC. Security state is indicated using bit zero of header
158 * attribute
159 * NOTE: BL1 expects entrypoint followed by spsr while processing
160 * SMC to jump to BL31 from the start of entry_point_info
161 *****************************************************************************/
162typedef struct entry_point_info {
163 param_header_t h;
164 uintptr_t pc;
165 uint32_t spsr;
Dan Handleye2712bc2014-04-10 15:37:22 +0100166 aapcs64_params_t args;
Vikram Kanigirida567432014-04-15 18:08:08 +0100167} entry_point_info_t;
168
169/*****************************************************************************
170 * Image info binary provides information from the image loader that
171 * can be used by the firmware to manage available trusted RAM.
172 * More advanced firmware image formats can provide additional
173 * information that enables optimization or greater flexibility in the
174 * common firmware code
175 *****************************************************************************/
176typedef struct image_info {
177 param_header_t h;
178 uintptr_t image_base; /* physical address of base of image */
179 uint32_t image_size; /* bytes read from image file */
180} image_info_t;
Achin Gupta4f6ad662013-10-25 09:08:21 +0100181
182/*******************************************************************************
Achin Guptae4d084e2014-02-19 17:18:23 +0000183 * This structure represents the superset of information that can be passed to
184 * BL31 e.g. while passing control to it from BL2. The BL32 parameters will be
Vikram Kanigirida567432014-04-15 18:08:08 +0100185 * populated only if BL2 detects its presence. A pointer to a structure of this
Sandrine Bailleuxacde8b02015-05-19 11:54:45 +0100186 * type should be passed in X0 to BL3-1's cold boot entrypoint.
Vikram Kanigirida567432014-04-15 18:08:08 +0100187 *
Sandrine Bailleuxacde8b02015-05-19 11:54:45 +0100188 * Use of this structure and the X0 parameter is not mandatory: the BL3-1
Vikram Kanigirida567432014-04-15 18:08:08 +0100189 * platform code can use other mechanisms to provide the necessary information
190 * about BL3-2 and BL3-3 to the common and SPD code.
191 *
192 * BL3-1 image information is mandatory if this structure is used. If either of
193 * the optional BL3-2 and BL3-3 image information is not provided, this is
194 * indicated by the respective image_info pointers being zero.
Achin Guptae4d084e2014-02-19 17:18:23 +0000195 ******************************************************************************/
Vikram Kanigirida567432014-04-15 18:08:08 +0100196typedef struct bl31_params {
197 param_header_t h;
198 image_info_t *bl31_image_info;
199 entry_point_info_t *bl32_ep_info;
200 image_info_t *bl32_image_info;
201 entry_point_info_t *bl33_ep_info;
202 image_info_t *bl33_image_info;
203} bl31_params_t;
204
Juan Castillo97dbcf12015-08-17 10:43:27 +0100205/*
206 * load_auth_image() return values
207 */
208enum {
209 LOAD_SUCCESS, /* Load + authentication success */
210 LOAD_ERR, /* Load error */
211 LOAD_AUTH_ERR /* Authentication error */
212};
213
Vikram Kanigirida567432014-04-15 18:08:08 +0100214
Vikram Kanigiria3a5e4a2014-05-15 18:27:15 +0100215/*
Vikram Kanigirida567432014-04-15 18:08:08 +0100216 * Compile time assertions related to the 'entry_point_info' structure to
Vikram Kanigiria3a5e4a2014-05-15 18:27:15 +0100217 * ensure that the assembler and the compiler view of the offsets of
218 * the structure members is the same.
219 */
Vikram Kanigirida567432014-04-15 18:08:08 +0100220CASSERT(ENTRY_POINT_INFO_PC_OFFSET ==
221 __builtin_offsetof(entry_point_info_t, pc), \
222 assert_BL31_pc_offset_mismatch);
Vikram Kanigiria3a5e4a2014-05-15 18:27:15 +0100223
Vikram Kanigirida567432014-04-15 18:08:08 +0100224CASSERT(ENTRY_POINT_INFO_ARGS_OFFSET == \
225 __builtin_offsetof(entry_point_info_t, args), \
Vikram Kanigiria3a5e4a2014-05-15 18:27:15 +0100226 assert_BL31_args_offset_mismatch);
227
Vikram Kanigirida567432014-04-15 18:08:08 +0100228CASSERT(sizeof(unsigned long) ==
229 __builtin_offsetof(entry_point_info_t, spsr) - \
230 __builtin_offsetof(entry_point_info_t, pc), \
Vikram Kanigiria3a5e4a2014-05-15 18:27:15 +0100231 assert_entrypoint_and_spsr_should_be_adjacent);
232
Achin Guptae4d084e2014-02-19 17:18:23 +0000233/*******************************************************************************
Achin Gupta4f6ad662013-10-25 09:08:21 +0100234 * Function & variable prototypes
235 ******************************************************************************/
Dan Handleya17fefa2014-05-14 12:38:32 +0100236unsigned long page_align(unsigned long, unsigned);
Juan Castillo3a66aca2015-04-13 17:36:19 +0100237unsigned long image_size(unsigned int image_id);
Sandrine Bailleux467d0572014-06-24 14:02:34 +0100238int load_image(meminfo_t *mem_layout,
Juan Castillo3a66aca2015-04-13 17:36:19 +0100239 unsigned int image_id,
Juan Castilloa08a5e72015-05-19 11:54:12 +0100240 uintptr_t image_base,
Sandrine Bailleux467d0572014-06-24 14:02:34 +0100241 image_info_t *image_data,
242 entry_point_info_t *entry_point_info);
Juan Castilloa08a5e72015-05-19 11:54:12 +0100243int load_auth_image(meminfo_t *mem_layout,
244 unsigned int image_name,
245 uintptr_t image_base,
246 image_info_t *image_data,
247 entry_point_info_t *entry_point_info);
Jon Medhurstecf0a712014-02-17 12:18:24 +0000248extern const char build_message[];
Juan Castillo04be3a52014-06-30 11:41:46 +0100249extern const char version_string[];
Achin Gupta4f6ad662013-10-25 09:08:21 +0100250
Sandrine Bailleux467d0572014-06-24 14:02:34 +0100251void reserve_mem(uint64_t *free_base, size_t *free_size,
252 uint64_t addr, size_t size);
253
Achin Gupta4f6ad662013-10-25 09:08:21 +0100254#endif /*__ASSEMBLY__*/
255
256#endif /* __BL_COMMON_H__ */