mirror of
https://source.denx.de/u-boot/u-boot.git
synced 2025-10-31 16:31:25 +01:00
32ba8952cb
For secure boot systems it is common to have a read-only U-Boot which starts the machine and jumps to a read-write U-Boot for actual booting the OS. This allows the read-write U-Boot to be upgraded without risk of permanently bricking the machine. In the event that the read-write U-Boot is corrupted, the read-only U-Boot can detect this with a checksum and boot into a recovery flow. To support this, add a way to detect when U-Boot is run from SPL as opposed to some other method, such as booted directly (no SPL) or started from another source (e.g. a primary U-Boot). This works by putting a special value in r0. For now we rely on board-specific code to actually check the register and set a flag. At some point this could be generalised, perhaps by using a spare register and passing a flag to _main and/or board_init_f(). This commit does not implement any feature, but merely provides the API for boards to implement. Signed-off-by: Simon Glass <sjg@chromium.org>
99 lines
2.3 KiB
C
99 lines
2.3 KiB
C
/*
|
|
* (C) Copyright 2012
|
|
* Texas Instruments, <www.ti.com>
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0+
|
|
*/
|
|
#ifndef _SPL_H_
|
|
#define _SPL_H_
|
|
|
|
/* Platform-specific defines */
|
|
#include <linux/compiler.h>
|
|
#include <asm/spl.h>
|
|
|
|
/* Value in r0 indicates we booted from U-Boot */
|
|
#define UBOOT_NOT_LOADED_FROM_SPL 0x13578642
|
|
|
|
/* Boot type */
|
|
#define MMCSD_MODE_UNDEFINED 0
|
|
#define MMCSD_MODE_RAW 1
|
|
#define MMCSD_MODE_FS 2
|
|
#define MMCSD_MODE_EMMCBOOT 3
|
|
|
|
struct spl_image_info {
|
|
const char *name;
|
|
u8 os;
|
|
u32 load_addr;
|
|
u32 entry_point;
|
|
u32 size;
|
|
u32 flags;
|
|
};
|
|
|
|
#define SPL_COPY_PAYLOAD_ONLY 1
|
|
|
|
extern struct spl_image_info spl_image;
|
|
|
|
/* SPL common functions */
|
|
void preloader_console_init(void);
|
|
u32 spl_boot_device(void);
|
|
u32 spl_boot_mode(void);
|
|
void spl_set_header_raw_uboot(void);
|
|
void spl_parse_image_header(const struct image_header *header);
|
|
void spl_board_prepare_for_linux(void);
|
|
void __noreturn jump_to_image_linux(void *arg);
|
|
int spl_start_uboot(void);
|
|
void spl_display_print(void);
|
|
|
|
/* NAND SPL functions */
|
|
void spl_nand_load_image(void);
|
|
|
|
/* OneNAND SPL functions */
|
|
void spl_onenand_load_image(void);
|
|
|
|
/* NOR SPL functions */
|
|
void spl_nor_load_image(void);
|
|
|
|
/* MMC SPL functions */
|
|
void spl_mmc_load_image(void);
|
|
|
|
/* YMODEM SPL functions */
|
|
void spl_ymodem_load_image(void);
|
|
|
|
/* SPI SPL functions */
|
|
void spl_spi_load_image(void);
|
|
|
|
/* Ethernet SPL functions */
|
|
void spl_net_load_image(const char *device);
|
|
|
|
/* USB SPL functions */
|
|
void spl_usb_load_image(void);
|
|
|
|
/* SATA SPL functions */
|
|
void spl_sata_load_image(void);
|
|
|
|
/* SPL FAT image functions */
|
|
int spl_load_image_fat(block_dev_desc_t *block_dev, int partition, const char *filename);
|
|
int spl_load_image_fat_os(block_dev_desc_t *block_dev, int partition);
|
|
|
|
void __noreturn jump_to_image_no_args(struct spl_image_info *spl_image);
|
|
|
|
/* SPL EXT image functions */
|
|
int spl_load_image_ext(block_dev_desc_t *block_dev, int partition, const char *filename);
|
|
int spl_load_image_ext_os(block_dev_desc_t *block_dev, int partition);
|
|
|
|
#ifdef CONFIG_SPL_BOARD_INIT
|
|
void spl_board_init(void);
|
|
#endif
|
|
|
|
/**
|
|
* spl_was_boot_source() - check if U-Boot booted from SPL
|
|
*
|
|
* This will normally be true, but if U-Boot jumps to second U-Boot, it will
|
|
* be false. This should be implemented by board-specific code.
|
|
*
|
|
* @return true if U-Boot booted from SPL, else false
|
|
*/
|
|
bool spl_was_boot_source(void);
|
|
|
|
#endif
|