2 * Copyright (c) 2015 Google, Inc
4 * SPDX-License-Identifier: GPL-2.0+
6 * EFI information obtained here:
7 * http://wiki.phoenix.com/wiki/index.php/EFI_BOOT_SERVICES
9 * Loads a payload (U-Boot) within the EFI environment. This is built as an
10 * EFI application. It can be built either in 32-bit or 64-bit mode.
14 #include <debug_uart.h>
21 #include <linux/err.h>
22 #include <linux/types.h>
24 DECLARE_GLOBAL_DATA_PTR;
29 * - putc() uses the ns16550 address directly and assumed I/O access. Many
30 * platforms will use memory access
31 * get_codeseg32() is only meaningful on x86
33 #error "This file needs to be ported for use on architectures"
36 static struct efi_priv *global_priv;
39 struct __packed desctab_info {
46 * EFI uses Unicode and we don't. The easiest way to get a sensible output
47 * function is to use the U-Boot debug UART. We use EFI's console output
48 * function where available, and assume the built-in UART after that. We rely
49 * on EFI to set up the UART for us and just bring in the functions here.
50 * This last bit is a bit icky, but it's only for debugging anyway. We could
51 * build in ns16550.c with some effort, but this is a payload loader after
54 * Note: We avoid using printf() so we don't need to bring in lib/vsprintf.c.
55 * That would require some refactoring since we already build this for U-Boot.
56 * Building an EFI shared library version would have to be a separate stem.
57 * That might push us to using the SPL framework to build this stub. However
58 * that would involve a round of EFI-specific changes in SPL. Worth
59 * considering if we start needing more U-Boot functionality. Note that we
60 * could then move get_codeseg32() to arch/x86/cpu/cpu.c.
62 void _debug_uart_init(void)
66 void putc(const char ch)
69 NS16550_t com_port = (NS16550_t)0x3f8;
71 while ((inb((ulong)&com_port->lsr) & UART_LSR_THRE) == 0)
73 outb(ch, (ulong)&com_port->thr);
75 efi_putc(global_priv, ch);
81 void puts(const char *str)
87 static void _debug_uart_putc(int ch)
94 void *memcpy(void *dest, const void *src, size_t size)
96 unsigned char *dptr = dest;
97 const unsigned char *ptr = src;
98 const unsigned char *end = src + size;
106 void *memset(void *inptr, int ch, size_t size)
109 char *end = ptr + size;
117 static void jump_to_uboot(ulong cs32, ulong addr, ulong info)
119 #ifdef CONFIG_EFI_STUB_32BIT
121 * U-Boot requires these parameters in registers, not on the stack.
122 * See _x86boot_start() for this code.
124 typedef void (*func_t)(int bist, int unused, ulong info)
125 __attribute__((regparm(3)));
127 ((func_t)addr)(0, 0, info);
129 cpu_call32(cs32, CONFIG_SYS_TEXT_BASE, info);
133 #ifdef CONFIG_EFI_STUB_64BIT
134 static void get_gdt(struct desctab_info *info)
136 asm volatile ("sgdt %0" : : "m"(*info) : "memory");
140 static inline unsigned long read_cr3(void)
144 asm volatile("mov %%cr3,%0" : "=r" (val) : : "memory");
149 * get_codeseg32() - Find the code segment to use for 32-bit code
151 * U-Boot only works in 32-bit mode at present, so when booting from 64-bit
152 * EFI we must first change to 32-bit mode. To do this we need to find the
153 * correct code segment to use (an entry in the Global Descriptor Table).
155 * @return code segment GDT offset, or 0 for 32-bit EFI, -ENOENT if not found
157 static int get_codeseg32(void)
161 #ifdef CONFIG_EFI_STUB_64BIT
162 struct desctab_info gdt;
167 for (ptr = (uint64_t *)(unsigned long)gdt.addr, i = 0; i < gdt.limit;
169 uint64_t desc = *ptr;
170 uint64_t base, limit;
173 * Check that the target U-Boot jump address is within the
174 * selector and that the selector is of the right type.
176 base = ((desc >> GDT_BASE_LOW_SHIFT) & GDT_BASE_LOW_MASK) |
177 ((desc >> GDT_BASE_HIGH_SHIFT) & GDT_BASE_HIGH_MASK)
179 limit = ((desc >> GDT_LIMIT_LOW_SHIFT) & GDT_LIMIT_LOW_MASK) |
180 ((desc >> GDT_LIMIT_HIGH_SHIFT) & GDT_LIMIT_HIGH_MASK)
182 base <<= 12; /* 4KB granularity */
184 if ((desc & GDT_PRESENT) && (desc && GDT_NOTSYS) &&
185 !(desc & GDT_LONG) && (desc & GDT_4KB) &&
186 (desc & GDT_32BIT) && (desc & GDT_CODE) &&
187 CONFIG_SYS_TEXT_BASE > base &&
188 CONFIG_SYS_TEXT_BASE + CONFIG_SYS_MONITOR_LEN < limit
197 printhex8(gdt.limit);
199 printhex8(gdt.addr >> 32);
201 for (i = 0; i < gdt.limit; i += 8) {
202 uint32_t *ptr = (uint32_t *)((unsigned long)gdt.addr + i);
212 puts("32-bit code segment: ");
216 puts("page_table: ");
217 printhex8(read_cr3());
221 puts("Can't find 32-bit code segment\n");
229 static int setup_info_table(struct efi_priv *priv, int size)
231 struct efi_info_hdr *info;
234 /* Get some memory for our info table */
235 priv->info_size = size;
236 info = efi_malloc(priv, priv->info_size, &ret);
239 puts(" No memory for info table: ");
243 memset(info, '\0', sizeof(*info));
244 info->version = EFI_TABLE_VERSION;
245 info->hdr_size = sizeof(*info);
247 priv->next_hdr = (char *)info + info->hdr_size;
252 static void add_entry_addr(struct efi_priv *priv, enum efi_entry_t type,
253 void *ptr1, int size1, void *ptr2, int size2)
255 struct efi_entry_hdr *hdr = priv->next_hdr;
258 hdr->size = size1 + size2;
260 hdr->link = ALIGN(sizeof(*hdr) + hdr->size, 16);
261 priv->next_hdr += hdr->link;
262 memcpy(hdr + 1, ptr1, size1);
263 memcpy((void *)(hdr + 1) + size1, ptr2, size2);
264 priv->info->total_size = (ulong)priv->next_hdr - (ulong)priv->info;
268 * efi_main() - Start an EFI image
270 * This function is called by our EFI start-up code. It handles running
271 * U-Boot. If it returns, EFI will continue.
273 efi_status_t efi_main(efi_handle_t image, struct efi_system_table *sys_table)
275 struct efi_priv local_priv, *priv = &local_priv;
276 struct efi_boot_services *boot = sys_table->boottime;
277 struct efi_mem_desc *desc;
278 struct efi_entry_memmap map;
279 ulong key, desc_size, size;
284 ret = efi_init(priv, "Payload", image, sys_table);
286 printhex2(ret); puts(" efi_init() failed\n");
291 cs32 = get_codeseg32();
293 return EFI_UNSUPPORTED;
295 /* Get the memory map so we can switch off EFI */
297 ret = boot->get_memory_map(&size, NULL, &key, &desc_size, &version);
298 if (ret != EFI_BUFFER_TOO_SMALL) {
299 printhex2(BITS_PER_LONG);
301 puts(" No memory map\n");
304 size += 1024; /* Since doing a malloc() may change the memory map! */
305 desc = efi_malloc(priv, size, &ret);
308 puts(" No memory for memory descriptor: ");
311 ret = setup_info_table(priv, size + 128);
315 ret = boot->get_memory_map(&size, desc, &key, &desc_size, &version);
318 puts(" Can't get memory map\n");
322 ret = boot->exit_boot_services(image, key);
325 * Unfortunately it happens that we cannot exit boot services
326 * the first time. But the second time it work. I don't know
327 * why but this seems to be a repeatable problem. To get
328 * around it, just try again.
331 puts(" Can't exit boot services\n");
333 ret = boot->get_memory_map(&size, desc, &key, &desc_size,
337 puts(" Can't get memory map\n");
340 ret = boot->exit_boot_services(image, key);
343 puts(" Can't exit boot services 2\n");
348 map.version = version;
349 map.desc_size = desc_size;
350 add_entry_addr(priv, EFIET_MEMORY_MAP, &map, sizeof(map), desc, size);
351 add_entry_addr(priv, EFIET_END, NULL, 0, 0, 0);
353 /* The EFI UART won't work now, switch to a debug one */
356 memcpy((void *)CONFIG_SYS_TEXT_BASE, _binary_u_boot_dtb_bin_start,
357 (ulong)_binary_u_boot_dtb_bin_end -
358 (ulong)_binary_u_boot_dtb_bin_start);
361 puts("EFI table at ");
362 printhex8((ulong)priv->info);
364 printhex8(priv->info->total_size);
367 jump_to_uboot(cs32, CONFIG_SYS_TEXT_BASE, (ulong)priv->info);
369 return EFI_LOAD_ERROR;