xref: /rk3399_ARM-atf/include/plat/common/common_def.h (revision 08438e24e10504642634da9ee3dde794ac6fa8f0)
1 /*
2  * Copyright (c) 2015, 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 #ifndef __COMMON_DEF_H__
31 #define __COMMON_DEF_H__
32 
33 /******************************************************************************
34  * Required platform porting definitions that are expected to be common to
35  * all platforms
36  *****************************************************************************/
37 
38 /*
39  * Platform binary types for linking
40  */
41 #define PLATFORM_LINKER_FORMAT          "elf64-littleaarch64"
42 #define PLATFORM_LINKER_ARCH            aarch64
43 
44 
45 /*
46  * Generic platform constants
47  */
48 #define FIRMWARE_WELCOME_STR		"Booting Trusted Firmware\n"
49 
50 /* Trusted Boot Firmware BL2 */
51 #define BL2_IMAGE_NAME			"bl2.bin"
52 
53 /* SCP Firmware BL3-0 */
54 #define BL30_IMAGE_NAME			"bl30.bin"
55 
56 /* EL3 Runtime Firmware BL31 */
57 #define BL31_IMAGE_NAME			"bl31.bin"
58 
59 /* Secure Payload BL32 (Trusted OS) */
60 #define BL32_IMAGE_NAME			"bl32.bin"
61 
62 /* Non-Trusted Firmware BL33 */
63 #define BL33_IMAGE_NAME			"bl33.bin"
64 
65 /* Firmware Image Package */
66 #define FIP_IMAGE_NAME			"fip.bin"
67 
68 #if TRUSTED_BOARD_BOOT
69 /* Certificates */
70 # define BL2_CERT_NAME			"bl2.crt"
71 # define TRUSTED_KEY_CERT_NAME		"trusted_key.crt"
72 
73 # define BL30_KEY_CERT_NAME		"bl30_key.crt"
74 # define BL31_KEY_CERT_NAME		"bl31_key.crt"
75 # define BL32_KEY_CERT_NAME		"bl32_key.crt"
76 # define BL33_KEY_CERT_NAME		"bl33_key.crt"
77 
78 # define BL30_CERT_NAME			"bl30.crt"
79 # define BL31_CERT_NAME			"bl31.crt"
80 # define BL32_CERT_NAME			"bl32.crt"
81 # define BL33_CERT_NAME			"bl33.crt"
82 #endif /* TRUSTED_BOARD_BOOT */
83 
84 /*
85  * Some of the platform porting definitions use the 'ull' suffix in order to
86  * avoid subtle integer overflow errors due to implicit integer type promotion
87  * when working with 32-bit values.
88  *
89  * The TSP linker script includes some of these definitions to define the BL3-2
90  * memory map, but the GNU LD does not support the 'ull' suffix, causing the
91  * build process to fail. To solve this problem, the auxiliary macro MAKE_ULL(x)
92  * will add the 'ull' suffix only when the macro __LINKER__  is not defined
93  * (__LINKER__ is defined in the command line to preprocess the linker script).
94  * Constants in the linker script will not have the 'ull' suffix, but this is
95  * not a problem since the linker evaluates all constant expressions to 64 bit
96  * (assuming the target architecture is 64 bit).
97  */
98 #ifndef __LINKER__
99   #define MAKE_ULL(x)			x##ull
100 #else
101   #define MAKE_ULL(x)			x
102 #endif
103 
104 
105 #endif /* __COMMON_DEF_H__ */
106 
107