]>
Commit | Line | Data |
---|---|---|
1ddb209e | 1 | /** @file |
2 | * | |
0db25ccc | 3 | * Copyright (c) 2011-2012, ARM Limited. All rights reserved. |
1ddb209e | 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 | ||
e314d564 | 15 | #ifndef _ARMPLATFORMSECLIB_H_ |
16 | #define _ARMPLATFORMSECLIB_H_ | |
0db25ccc | 17 | |
a75568e9 | 18 | #define ARM_SEC_BOOT_MASK ~0 |
19 | #define ARM_SEC_COLD_BOOT (1 << 0) | |
20 | #define ARM_SEC_SECONDARY_COLD_BOOT (1 << 1) | |
21 | ||
e314d564 | 22 | /** |
23 | Initialize the memory where the initial stacks will reside | |
0db25ccc | 24 | |
e314d564 | 25 | This memory can contain the initial stacks (Secure and Secure Monitor stacks). |
26 | In some platform, this region is already initialized and the implementation of this function can | |
27 | do nothing. This memory can also represent the Secure RAM. | |
28 | This function is called before the satck has been set up. Its implementation must ensure the stack | |
29 | pointer is not used (probably required to use assembly language) | |
30 | ||
31 | **/ | |
32 | VOID | |
33 | ArmPlatformSecBootMemoryInit ( | |
34 | VOID | |
35 | ); | |
1ddb209e | 36 | |
37 | /** | |
e314d564 | 38 | Call at the beginning of the platform boot up |
1ddb209e | 39 | |
e314d564 | 40 | This function allows the firmware platform to do extra actions at the early |
41 | stage of the platform power up. | |
42 | ||
43 | Note: This function must be implemented in assembler as there is no stack set up yet | |
1ddb209e | 44 | |
45 | **/ | |
46 | VOID | |
e314d564 | 47 | ArmPlatformSecBootAction ( |
48 | VOID | |
49 | ); | |
1ddb209e | 50 | |
51 | /** | |
52 | Initialize controllers that must setup at the early stage | |
53 | ||
54 | Some peripherals must be initialized in Secure World. | |
e314d564 | 55 | For example: Some L2 controller, interconnect, clock, DMC, etc |
1ddb209e | 56 | |
57 | **/ | |
e314d564 | 58 | RETURN_STATUS |
1ddb209e | 59 | ArmPlatformSecInitialize ( |
e314d564 | 60 | IN UINTN MpId |
61 | ); | |
1ddb209e | 62 | |
63 | /** | |
64 | Call before jumping to Normal World | |
65 | ||
66 | This function allows the firmware platform to do extra actions before | |
67 | jumping to the Normal World | |
68 | ||
69 | **/ | |
70 | VOID | |
71 | ArmPlatformSecExtraAction ( | |
72 | IN UINTN MpId, | |
73 | OUT UINTN* JumpAddress | |
e314d564 | 74 | ); |
75 | ||
76 | /** | |
77 | Initialize the Secure peripherals and memory regions | |
78 | ||
79 | If Trustzone is supported by your platform then this function makes the required initialization | |
80 | of the secure peripherals and memory regions. | |
81 | ||
82 | **/ | |
83 | VOID | |
84 | ArmPlatformSecTrustzoneInit ( | |
85 | IN UINTN MpId | |
86 | ); | |
87 | ||
88 | #endif |