]>
Commit | Line | Data |
---|---|---|
1d5d0ae9 | 1 | /** @file |
2 | * | |
3 | * Copyright (c) 2011, ARM Limited. All rights reserved. | |
4 | * | |
5 | * This program and the accompanying materials | |
6 | * are licensed and made available under the terms and conditions of the BSD License | |
7 | * which accompanies this distribution. The full text of the license may be found at | |
8 | * http://opensource.org/licenses/bsd-license.php | |
9 | * | |
10 | * THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, | |
11 | * WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. | |
12 | * | |
13 | **/ | |
14 | ||
15 | #ifndef _ARMPLATFORMLIB_H_ | |
16 | #define _ARMPLATFORMLIB_H_ | |
17 | ||
18 | // | |
19 | // The package level header files this module uses | |
20 | // | |
21 | #include <PiPei.h> | |
22 | // | |
23 | // The protocols, PPI and GUID defintions for this module | |
24 | // | |
25 | #include <Ppi/MasterBootMode.h> | |
26 | #include <Ppi/BootInRecoveryMode.h> | |
27 | #include <Guid/MemoryTypeInformation.h> | |
28 | ||
29 | #include <Library/ArmLib.h> | |
30 | #include <ArmPlatform.h> | |
31 | ||
32 | /** | |
33 | This structure is used by ArmVExpressGetEfiMemoryMap to describes a region of the EFI memory map | |
34 | ||
35 | Every EFI regions of the system memory described by their physical start address and their size | |
36 | can have different attributes. Some regions can be tested and other untested. | |
37 | ||
38 | **/ | |
39 | typedef struct { | |
40 | EFI_RESOURCE_ATTRIBUTE_TYPE ResourceAttribute; | |
41 | EFI_PHYSICAL_ADDRESS PhysicalStart; | |
42 | UINT64 NumberOfBytes; | |
43 | } ARM_SYSTEM_MEMORY_REGION_DESCRIPTOR; | |
44 | ||
45 | /** | |
46 | Called at the early stage of the Boot phase to know if the memory has already been initialized | |
47 | ||
48 | Running the code from the reset vector does not mean we start from cold boot. In some case, we | |
49 | can go through this code with the memory already initialized. | |
50 | Because this function is called at the early stage, the implementation must not use the stack. | |
51 | Its implementation must probably done in assembly to ensure this requirement. | |
52 | ||
53 | @return Return the condition value into the 'Z' flag | |
54 | ||
55 | **/ | |
56 | VOID ArmPlatformIsMemoryInitialized(VOID); | |
57 | ||
58 | /** | |
59 | Initialize the memory where the initial stacks will reside | |
60 | ||
61 | This memory can contain the initial stacks (Secure and Secure Monitor stacks). | |
62 | In some platform, this region is already initialized and the implementation of this function can | |
63 | do nothing. This memory can also represent the Secure RAM. | |
64 | This function is called before the satck has been set up. Its implementation must ensure the stack | |
65 | pointer is not used (probably required to use assembly language) | |
66 | ||
67 | **/ | |
68 | VOID ArmPlatformInitializeBootMemory(VOID); | |
69 | ||
a534d714 | 70 | /** |
71 | Return the current Boot Mode | |
72 | ||
73 | This function returns the boot reason on the platform | |
74 | ||
75 | @return Return the current Boot Mode of the platform | |
76 | ||
77 | **/ | |
78 | EFI_BOOT_MODE | |
79 | ArmPlatformGetBootMode ( | |
80 | VOID | |
81 | ); | |
82 | ||
8e06b586 | 83 | /** |
84 | Initialize controllers that must setup at the early stage | |
85 | ||
86 | Some peripherals must be initialized in Secure World. | |
87 | For example, some L2x0 requires to be initialized in Secure World | |
88 | ||
89 | **/ | |
90 | VOID | |
91 | ArmPlatformInitialize ( | |
92 | VOID | |
93 | ); | |
94 | ||
1d5d0ae9 | 95 | /** |
96 | Initialize the system (or sometimes called permanent) memory | |
97 | ||
98 | This memory is generally represented by the DRAM. | |
99 | ||
100 | **/ | |
101 | VOID ArmPlatformInitializeSystemMemory(VOID); | |
102 | ||
103 | /** | |
104 | Remap the memory at 0x0 | |
105 | ||
106 | Some platform requires or gives the ability to remap the memory at the address 0x0. | |
107 | This function can do nothing if this feature is not relevant to your platform. | |
108 | ||
109 | **/ | |
110 | VOID ArmPlatformBootRemapping(VOID); | |
111 | ||
112 | /** | |
113 | Return if Trustzone is supported by your platform | |
114 | ||
115 | A non-zero value must be returned if you want to support a Secure World on your platform. | |
116 | ArmPlatformTrustzoneInit() will later set up the secure regions. | |
117 | This function can return 0 even if Trustzone is supported by your processor. In this case, | |
118 | the platform will continue to run in Secure World. | |
119 | ||
120 | @return A non-zero value if Trustzone supported. | |
121 | ||
122 | **/ | |
123 | UINTN ArmPlatformTrustzoneSupported(VOID); | |
124 | ||
125 | /** | |
126 | Initialize the Secure peripherals and memory regions | |
127 | ||
128 | If Trustzone is supported by your platform then this function makes the required initialization | |
129 | of the secure peripherals and memory regions. | |
130 | ||
131 | **/ | |
132 | VOID ArmPlatformTrustzoneInit(VOID); | |
133 | ||
134 | /** | |
135 | Return the information about the memory region in permanent memory used by PEI | |
136 | ||
137 | One of the PEI Module must install the permament memory used by PEI. This function returns the | |
138 | information about this region for your platform to this PEIM module. | |
139 | ||
140 | @param[out] PeiMemoryBase Base of the memory region used by PEI core and modules | |
141 | @param[out] PeiMemorySize Size of the memory region used by PEI core and modules | |
142 | ||
143 | **/ | |
144 | VOID ArmPlatformGetPeiMemory ( | |
145 | OUT UINTN* PeiMemoryBase, | |
146 | OUT UINTN* PeiMemorySize | |
147 | ); | |
148 | ||
149 | /** | |
150 | Return the Virtual Memory Map of your platform | |
151 | ||
152 | This Virtual Memory Map is used by MemoryInitPei Module to initialize the MMU on your platform. | |
153 | ||
154 | @param[out] VirtualMemoryMap Array of ARM_MEMORY_REGION_DESCRIPTOR describing a Physical-to- | |
155 | Virtual Memory mapping. This array must be ended by a zero-filled | |
156 | entry | |
157 | ||
158 | **/ | |
159 | VOID ArmPlatformGetVirtualMemoryMap ( | |
160 | OUT ARM_MEMORY_REGION_DESCRIPTOR** VirtualMemoryMap | |
161 | ); | |
162 | ||
163 | /** | |
164 | Return the EFI Memory Map of your platform | |
165 | ||
166 | This EFI Memory Map of the System Memory is used by MemoryInitPei module to create the Resource | |
167 | Descriptor HOBs used by DXE core. | |
168 | ||
169 | @param[out] EfiMemoryMap Array of ARM_SYSTEM_MEMORY_REGION_DESCRIPTOR describing an | |
170 | EFI Memory region. This array must be ended by a zero-filled entry | |
171 | ||
172 | **/ | |
964680c1 | 173 | EFI_STATUS |
174 | ArmPlatformGetAdditionalSystemMemory ( | |
175 | OUT ARM_SYSTEM_MEMORY_REGION_DESCRIPTOR** EfiMemoryMap | |
176 | ); | |
1d5d0ae9 | 177 | |
178 | #endif |