spl.h 3.22 KB
Newer Older
1 2 3 4
/*
 * (C) Copyright 2012
 * Texas Instruments, <www.ti.com>
 *
5
 * SPDX-License-Identifier:	GPL-2.0+
6 7 8 9 10
 */
#ifndef	_SPL_H_
#define	_SPL_H_

/* Platform-specific defines */
11
#include <linux/compiler.h>
12 13
#include <asm/spl.h>

14 15
/* Value in r0 indicates we booted from U-Boot */
#define UBOOT_NOT_LOADED_FROM_SPL	0x13578642
16

17 18 19
/* Boot type */
#define MMCSD_MODE_UNDEFINED	0
#define MMCSD_MODE_RAW		1
20
#define MMCSD_MODE_FS		2
21
#define MMCSD_MODE_EMMCBOOT	3
22 23 24 25 26 27 28

struct spl_image_info {
	const char *name;
	u8 os;
	u32 load_addr;
	u32 entry_point;
	u32 size;
29
	u32 flags;
30 31
};

32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49
/*
 * Information required to load data from a device
 *
 * @dev: Pointer to the device, e.g. struct mmc *
 * @priv: Private data for the device
 * @bl_len: Block length for reading in bytes
 * @read: Function to call to read from the device
 */
struct spl_load_info {
	void *dev;
	void *priv;
	int bl_len;
	ulong (*read)(struct spl_load_info *load, ulong sector, ulong count,
		      void *buf);
};

int spl_load_simple_fit(struct spl_load_info *info, ulong sector, void *fdt);

50 51
#define SPL_COPY_PAYLOAD_ONLY	1

52 53 54 55 56 57
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);
58
void spl_set_header_raw_uboot(void);
59 60
void spl_parse_image_header(const struct image_header *header);
void spl_board_prepare_for_linux(void);
61
void __noreturn jump_to_image_linux(void *arg);
62 63 64 65
int spl_start_uboot(void);
void spl_display_print(void);

/* NAND SPL functions */
66
int spl_nand_load_image(void);
67

68
/* OneNAND SPL functions */
69
int spl_onenand_load_image(void);
70

71
/* NOR SPL functions */
72
int spl_nor_load_image(void);
73

74
/* MMC SPL functions */
75
int spl_mmc_load_image(u32 boot_device);
76 77

/* YMODEM SPL functions */
78
int spl_ymodem_load_image(void);
79 80

/* SPI SPL functions */
81
int spl_spi_load_image(void);
82

83
/* Ethernet SPL functions */
84
int spl_net_load_image(const char *device);
85

86
/* USB SPL functions */
87
int spl_usb_load_image(void);
88

89
/* SATA SPL functions */
90
int spl_sata_load_image(void);
91

92
/* SPL FAT image functions */
93 94 95
int spl_load_image_fat(struct blk_desc *block_dev, int partition,
		       const char *filename);
int spl_load_image_fat_os(struct blk_desc *block_dev, int partition);
96

97 98
void __noreturn jump_to_image_no_args(struct spl_image_info *spl_image);

99
/* SPL EXT image functions */
100 101 102
int spl_load_image_ext(struct blk_desc *block_dev, int partition,
		       const char *filename);
int spl_load_image_ext_os(struct blk_desc *block_dev, int partition);
103

104 105 106 107 108 109 110 111 112 113 114 115
/**
 * spl_init() - Set up device tree and driver model in SPL if enabled
 *
 * Call this function in board_init_f() if you want to use device tree and
 * driver model early, before board_init_r() is called. This function will
 * be called from board_init_r() if not called earlier.
 *
 * If this is not called, then driver model will be inactive in SPL's
 * board_init_f(), and no device tree will be available.
 */
int spl_init(void);

116 117 118
#ifdef CONFIG_SPL_BOARD_INIT
void spl_board_init(void);
#endif
119 120 121 122 123 124 125 126 127 128 129

/**
 * 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);

130
#endif