3 * Copyright (c) 2011, ARM Limited. All rights reserved.
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
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.
15 #include "BdsInternal.h"
16 #include "BdsLinuxLoader.h"
18 #include <Library/PcdLib.h>
19 #include <Library/ArmLib.h>
20 #include <Library/HobLib.h>
22 #define ALIGN32_BELOW(addr) ALIGN_POINTER(addr - 32,32)
24 #define LINUX_ATAG_MAX_OFFSET (PcdGet32(PcdSystemMemoryBase) + PcdGet32(PcdArmLinuxAtagMaxOffset))
25 #define LINUX_KERNEL_MAX_OFFSET (PcdGet32(PcdSystemMemoryBase) + PcdGet32(PcdArmLinuxKernelMaxOffset))
27 // Point to the current ATAG
28 STATIC LINUX_ATAG
*mLinuxKernelCurrentAtag
;
36 mLinuxKernelCurrentAtag
->header
.size
= tag_size(LINUX_ATAG_CORE
);
37 mLinuxKernelCurrentAtag
->header
.type
= ATAG_CORE
;
39 mLinuxKernelCurrentAtag
->body
.core_tag
.flags
= 1; /* ensure read-only */
40 mLinuxKernelCurrentAtag
->body
.core_tag
.pagesize
= PageSize
; /* systems PageSize (4k) */
41 mLinuxKernelCurrentAtag
->body
.core_tag
.rootdev
= 0; /* zero root device (typically overridden from kernel command line )*/
43 // move pointer to next tag
44 mLinuxKernelCurrentAtag
= next_tag_address(mLinuxKernelCurrentAtag
);
50 IN UINTN StartAddress
,
54 mLinuxKernelCurrentAtag
->header
.size
= tag_size(LINUX_ATAG_MEM
);
55 mLinuxKernelCurrentAtag
->header
.type
= ATAG_MEM
;
57 mLinuxKernelCurrentAtag
->body
.mem_tag
.start
= StartAddress
; /* Start of memory chunk for AtagMem */
58 mLinuxKernelCurrentAtag
->body
.mem_tag
.size
= Size
; /* Size of memory chunk for AtagMem */
60 // move pointer to next tag
61 mLinuxKernelCurrentAtag
= next_tag_address(mLinuxKernelCurrentAtag
);
67 IN CONST CHAR8
*CmdLine
72 // Increment the line length by 1 to account for the null string terminator character
73 LineLength
= AsciiStrLen(CmdLine
) + 1;
75 /* Check for NULL strings.
76 * Do not insert a tag for an empty CommandLine, don't even modify the tag address pointer.
77 * Remember, you have at least one null string terminator character.
80 mLinuxKernelCurrentAtag
->header
.size
= ((UINT32
)sizeof(LINUX_ATAG_HEADER
) + LineLength
+ (UINT32
)3) >> 2;
81 mLinuxKernelCurrentAtag
->header
.type
= ATAG_CMDLINE
;
83 /* place CommandLine into tag */
84 AsciiStrCpy(mLinuxKernelCurrentAtag
->body
.cmdline_tag
.cmdline
, CmdLine
);
86 // move pointer to next tag
87 mLinuxKernelCurrentAtag
= next_tag_address(mLinuxKernelCurrentAtag
);
97 // Empty tag ends list; this has zero length and no body
98 mLinuxKernelCurrentAtag
->header
.type
= ATAG_NONE
;
99 mLinuxKernelCurrentAtag
->header
.size
= 0;
101 /* We can not calculate the next address by using the standard macro:
102 * Params = next_tag_address(Params);
103 * because it relies on the header.size, which here it is 0 (zero).
104 * The easiest way is to add the sizeof(mLinuxKernelCurrentAtag->header).
106 mLinuxKernelCurrentAtag
= (LINUX_ATAG
*)((UINT32
)mLinuxKernelCurrentAtag
+ sizeof(mLinuxKernelCurrentAtag
->header
));
112 IN CONST CHAR8
* CommandLineString
,
113 OUT LINUX_ATAG
**AtagBase
,
118 LIST_ENTRY
*ResourceLink
;
119 LIST_ENTRY ResourceList
;
120 EFI_PHYSICAL_ADDRESS AtagStartAddress
;
121 BDS_SYSTEM_MEMORY_RESOURCE
*Resource
;
123 AtagStartAddress
= LINUX_ATAG_MAX_OFFSET
;
124 Status
= gBS
->AllocatePages (AllocateMaxAddress
, EfiBootServicesData
, EFI_SIZE_TO_PAGES(ATAG_MAX_SIZE
), &AtagStartAddress
);
125 if (EFI_ERROR(Status
)) {
126 DEBUG ((EFI_D_ERROR
,"Failed to allocate Atag at 0x%lX (%r)\n",AtagStartAddress
,Status
));
127 Status
= gBS
->AllocatePages (AllocateAnyPages
, EfiBootServicesData
, EFI_SIZE_TO_PAGES(ATAG_MAX_SIZE
), &AtagStartAddress
);
128 ASSERT_EFI_ERROR(Status
);
131 // Ready to setup the atag list
132 mLinuxKernelCurrentAtag
= (LINUX_ATAG
*)(UINTN
)AtagStartAddress
;
134 // Standard core tag 4k PageSize
135 SetupCoreTag( (UINT32
)SIZE_4KB
);
137 // Physical memory setup
138 GetSystemMemoryResources (&ResourceList
);
139 ResourceLink
= ResourceList
.ForwardLink
;
140 while (ResourceLink
!= NULL
&& ResourceLink
!= &ResourceList
) {
141 Resource
= (BDS_SYSTEM_MEMORY_RESOURCE
*)ResourceLink
;
142 DEBUG((EFI_D_INFO
,"- [0x%08X,0x%08X]\n",(UINT32
)Resource
->PhysicalStart
,(UINT32
)Resource
->PhysicalStart
+(UINT32
)Resource
->ResourceLength
));
143 SetupMemTag( (UINT32
)Resource
->PhysicalStart
, (UINT32
)Resource
->ResourceLength
);
144 ResourceLink
= ResourceLink
->ForwardLink
;
147 // CommandLine setting root device
148 SetupCmdlineTag (CommandLineString
);
153 // Calculate atag list size
154 *AtagBase
= (LINUX_ATAG
*)(UINTN
)AtagStartAddress
;
155 *AtagSize
= (UINT32
)mLinuxKernelCurrentAtag
- (UINT32
)AtagStartAddress
+ 1;
162 PreparePlatformHardware (
166 //Note: Interrupts will be disabled by the GIC driver when ExitBootServices() will be called.
168 // clean, invalidate, disable data cache
169 ArmCleanInvalidateDataCache();
170 ArmDisableDataCache();
172 // Invalidate and disable the Instruction cache
173 ArmInvalidateInstructionCache ();
174 ArmDisableInstructionCache ();
183 Start a Linux kernel from a Device Path
185 @param LinuxKernel Device Path to the Linux Kernel
186 @param Parameters Linux kernel agruments
187 @param Fdt Device Path to the Flat Device Tree
189 @retval EFI_SUCCESS All drivers have been connected
190 @retval EFI_NOT_FOUND The Linux kernel Device Path has not been found
191 @retval EFI_OUT_OF_RESOURCES There is not enough resource memory to store the matching results.
196 IN EFI_DEVICE_PATH_PROTOCOL
* LinuxKernelDevicePath
,
197 IN CONST CHAR8
* Arguments
,
198 IN EFI_DEVICE_PATH_PROTOCOL
* FdtDevicePath
202 UINT32 LinuxImageSize
;
203 UINT32 KernelParamsSize
;
204 EFI_PHYSICAL_ADDRESS KernelParamsAddress
;
206 BOOLEAN FdtSupported
= FALSE
;
207 LINUX_KERNEL LinuxKernel
;
208 EFI_PHYSICAL_ADDRESS LinuxImage
;;
211 PERF_START (NULL
, "BDS", NULL
, 0);
213 // Load the Linux kernel from a device path
214 LinuxImage
= LINUX_KERNEL_MAX_OFFSET
;
215 Status
= BdsLoadImage (LinuxKernelDevicePath
, AllocateMaxAddress
, &LinuxImage
, &LinuxImageSize
);
216 if (EFI_ERROR(Status
)) {
217 Print (L
"ERROR: Did not find Linux kernel.\n");
220 LinuxKernel
= (LINUX_KERNEL
)(UINTN
)LinuxImage
;
223 // Load the FDT binary from a device path
224 KernelParamsAddress
= LINUX_ATAG_MAX_OFFSET
;
225 Status
= BdsLoadImage (FdtDevicePath
, AllocateMaxAddress
, &KernelParamsAddress
, &KernelParamsSize
);
226 if (EFI_ERROR(Status
)) {
227 Print (L
"ERROR: Did not find Device Tree blob.\n");
234 // Setup the Linux Kernel Parameters
237 // Non-FDT requires a specific machine type.
238 // This OS Boot loader supports just one machine type,
239 // but that could change in the future.
240 MachineType
= PcdGet32(PcdArmMachineType
);
242 // By setting address=0 we leave the memory allocation to the function
243 Status
= PrepareAtagList (Arguments
, (LINUX_ATAG
**)&KernelParamsAddress
, &KernelParamsSize
);
244 if(EFI_ERROR(Status
)) {
245 Print(L
"ERROR: Can not prepare ATAG list. Status=0x%X\n", Status
);
249 MachineType
= 0xFFFFFFFF;
252 // Shut down UEFI boot services. ExitBootServices() will notify every driver that created an event on
253 // ExitBootServices event. Example the Interrupt DXE driver will disable the interrupts on this event.
254 Status
= ShutdownUefiBootServices ();
255 if(EFI_ERROR(Status
)) {
256 DEBUG((EFI_D_ERROR
,"ERROR: Can not shutdown UEFI boot services. Status=0x%X\n", Status
));
260 // Move the kernel parameters to any address inside the first 1MB.
261 // This is necessary because the ARM Linux kernel requires
262 // the FTD / ATAG List to reside entirely inside the first 1MB of
264 if ((UINTN
)KernelParamsAddress
> LINUX_ATAG_MAX_OFFSET
) {
265 //Note: There is no requirement on the alignment
266 KernelParamsAddress
= (EFI_PHYSICAL_ADDRESS
)(UINTN
)CopyMem (ALIGN32_BELOW(LINUX_ATAG_MAX_OFFSET
- KernelParamsSize
), (VOID
*)(UINTN
)KernelParamsAddress
, KernelParamsSize
);
269 if ((UINTN
)LinuxImage
> LINUX_KERNEL_MAX_OFFSET
) {
270 //Note: There is no requirement on the alignment
271 LinuxKernel
= (LINUX_KERNEL
)CopyMem (ALIGN32_BELOW(LINUX_KERNEL_MAX_OFFSET
- LinuxImageSize
), (VOID
*)(UINTN
)LinuxImage
, LinuxImageSize
);
274 //TODO: Check there is no overlapping between kernel and Atag
277 // Switch off interrupts, caches, mmu, etc
279 Status
= PreparePlatformHardware ();
280 ASSERT_EFI_ERROR(Status
);
282 // Register and print out performance information
283 PERF_END (NULL
, "BDS", NULL
, 0);
284 if (PerformanceMeasurementEnabled ()) {
289 // Start the Linux Kernel
292 // Outside BootServices, so can't use Print();
293 DEBUG((EFI_D_ERROR
, "\nStarting the kernel:\n\n"));
295 // jump to kernel with register set
296 LinuxKernel ((UINTN
)0, (UINTN
)MachineType
, (UINTN
)KernelParamsAddress
);
298 // Kernel should never exit
299 // After Life services are not provided
303 // Only be here if we fail to start Linux
304 Print (L
"ERROR : Can not start the kernel. Status=0x%X\n", Status
);
306 // Free Runtimee Memory (kernel and FDT)