mirror of
https://github.com/Telecominfraproject/OpenCellular.git
synced 2025-11-24 18:25:10 +00:00
Change-Id: I976c11c82c3d665a4feb88226e919f16c2440f60 BUG=chrome-os-partner:1657 TEST=manual - see below make && make runtests Then test verifying a test image in both dev mode (-b1, no key specified) and recovery mode (key specified) build/utility/load_kernel_test -b1 ~/b/USB_images/0.11.224.0-alex/chromiumos_test_image.bin build/utility/load_kernel_test ~/b/USB_images/0.11.224.0-alex/chromiumos_test_image.bin tests/devkeys/recovery_key.vbpubk And make sure the firmware with this change actually boots to USB and SSD. NOTE: u-boot-next needs to change to work with this change. will attempt a follow-up CL with that change Review URL: http://codereview.chromium.org/6626045
90 lines
4.1 KiB
C
90 lines
4.1 KiB
C
/* Copyright (c) 2011 The Chromium OS Authors. All rights reserved.
|
|
* Use of this source code is governed by a BSD-style license that can be
|
|
* found in the LICENSE file.
|
|
*
|
|
* High-level firmware API for loading and verifying kernel.
|
|
* (Firmware Portion)
|
|
*/
|
|
|
|
#ifndef VBOOT_REFERENCE_LOAD_KERNEL_FW_H_
|
|
#define VBOOT_REFERENCE_LOAD_KERNEL_FW_H_
|
|
|
|
#include "sysincludes.h"
|
|
#include "vboot_nvstorage.h"
|
|
|
|
/* Interface provided by verified boot library to BDS */
|
|
|
|
/* Return codes for LoadKernel() */
|
|
#define LOAD_KERNEL_SUCCESS 0 /* Success; good kernel found on device */
|
|
#define LOAD_KERNEL_NOT_FOUND 1 /* No kernel found on device */
|
|
#define LOAD_KERNEL_INVALID 2 /* Only invalid kernels found on device */
|
|
#define LOAD_KERNEL_RECOVERY 3 /* Internal error; reboot to recovery mode */
|
|
#define LOAD_KERNEL_REBOOT 4 /* Internal error; reboot to current mode */
|
|
|
|
|
|
/* Boot flags for LoadKernel().boot_flags */
|
|
/* Developer switch is on */
|
|
#define BOOT_FLAG_DEVELOPER UINT64_C(0x01)
|
|
/* In recovery mode */
|
|
#define BOOT_FLAG_RECOVERY UINT64_C(0x02)
|
|
/* Skip check of kernel buffer address */
|
|
#define BOOT_FLAG_SKIP_ADDR_CHECK UINT64_C(0x04)
|
|
/* Active main firmware is developer-type, not normal-type or recovery-type. */
|
|
#define BOOT_FLAG_DEV_FIRMWARE UINT64_C(0x08)
|
|
|
|
typedef struct LoadKernelParams {
|
|
/* Inputs to LoadKernel() */
|
|
void* shared_data_blob; /* Buffer for data shared between
|
|
* LoadFirmware() and LoadKernel(). Pass the
|
|
* same buffer which was passed to
|
|
* LoadFirmware(). */
|
|
uint64_t shared_data_size; /* Size of shared data blob buffer, in bytes.
|
|
* On output, this will contain the actual
|
|
* data size placed into the buffer. */
|
|
void* gbb_data; /* Pointer to GBB data */
|
|
uint64_t gbb_size; /* Size of GBB data in bytes */
|
|
uint64_t bytes_per_lba; /* Bytes per lba sector on current device */
|
|
uint64_t ending_lba; /* Last addressable lba sector on current
|
|
* device */
|
|
void* kernel_buffer; /* Destination buffer for kernel
|
|
* (normally at 0x100000) */
|
|
uint64_t kernel_buffer_size; /* Size of kernel buffer in bytes */
|
|
uint64_t boot_flags; /* Boot flags */
|
|
VbNvContext* nv_context; /* Context for NV storage. nv_context->raw
|
|
* must be filled before calling
|
|
* LoadKernel(). On output, check
|
|
* nv_context->raw_changed to see if
|
|
* nv_context->raw has been modified and
|
|
* needs saving. */
|
|
|
|
/* Outputs from LoadKernel(); valid only if LoadKernel() returns
|
|
* LOAD_KERNEL_SUCCESS */
|
|
uint64_t partition_number; /* Partition number to boot on current device
|
|
* (1...M) */
|
|
uint64_t bootloader_address; /* Address of bootloader image in RAM */
|
|
uint64_t bootloader_size; /* Size of bootloader image in bytes */
|
|
uint8_t partition_guid[16]; /* UniquePartitionGuid for boot partition */
|
|
} LoadKernelParams;
|
|
|
|
int LoadKernel(LoadKernelParams* params);
|
|
/* Attempts to load the kernel from the current device.
|
|
*
|
|
* Returns LOAD_KERNEL_SUCCESS if successful, error code on failure. */
|
|
|
|
|
|
typedef struct KernelBootloaderOptions {
|
|
/* The bootloader is loaded using the EFI LoadImage() and StartImage()
|
|
* calls. Pass this struct via loaded_image->load_options. */
|
|
uint64_t drive_number; /* Drive number of boot device (0...N) */
|
|
uint64_t partition_number; /* Partition number, as returned from
|
|
* LoadKernel() in
|
|
* LoadKernelParams.partition_number */
|
|
uint64_t original_address; /* Absolute bootloader start adddress,
|
|
* as returned from LoadKernel() in
|
|
* LoadKernelParams.bootloader_start */
|
|
uint8_t partition_guid[16]; /* UniquePartitionGuid for boot partition */
|
|
} KernelBootloaderOptions;
|
|
|
|
|
|
#endif /* VBOOT_REFERENCE_LOAD_KERNEL_FW_H_ */
|