X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=include%2Fspl.h;h=8afa0856c5889ec9dab554a89f75f47e2b34032e;hb=e120c848bac77cfcc88183541c2e966e625a7840;hp=a7e41da7fd4980ef2362816a63d8680cc26ef1b9;hpb=a7e8c15f71456d55ccb27f843862af03a00e0957;p=u-boot diff --git a/include/spl.h b/include/spl.h index a7e41da7fd..8afa0856c5 100644 --- a/include/spl.h +++ b/include/spl.h @@ -11,11 +11,13 @@ #include #include +/* 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_FAT 2 +#define MMCSD_MODE_FS 2 #define MMCSD_MODE_EMMCBOOT 3 struct spl_image_info { @@ -27,6 +29,36 @@ struct spl_image_info { u32 flags; }; +/* + * 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 + * @filename: Name of the fit image file. + * @read: Function to call to read from the device + */ +struct spl_load_info { + void *dev; + void *priv; + int bl_len; + const char *filename; + ulong (*read)(struct spl_load_info *load, ulong sector, ulong count, + void *buf); +}; + +/** + * spl_load_simple_fit() - Loads a fit image from a device. + * @info: Structure containing the information required to load data. + * @sector: Sector number where FIT image is located in the device + * @fdt: Pointer to the copied FIT header. + * + * Reads the FIT image @sector in the device. Loads u-boot image to + * specified load address and copies the dtb to end of u-boot image. + * Returns 0 on success. + */ +int spl_load_simple_fit(struct spl_load_info *info, ulong sector, void *fdt); + #define SPL_COPY_PAYLOAD_ONLY 1 extern struct spl_image_info spl_image; @@ -34,45 +66,82 @@ 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_parse_image_header(const struct image_header *header); +u32 spl_boot_mode(const u32 boot_device); +void spl_set_header_raw_uboot(void); +int spl_parse_image_header(const struct image_header *header); void spl_board_prepare_for_linux(void); +void spl_board_prepare_for_boot(void); +int spl_board_ubi_load_image(u32 boot_device); 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); +int spl_nand_load_image(void); /* OneNAND SPL functions */ -void spl_onenand_load_image(void); +int spl_onenand_load_image(void); /* NOR SPL functions */ -void spl_nor_load_image(void); +int spl_nor_load_image(void); + +/* UBI SPL functions */ +int spl_ubi_load_image(u32 boot_device); /* MMC SPL functions */ -void spl_mmc_load_image(void); +int spl_mmc_load_image(u32 boot_device); /* YMODEM SPL functions */ -void spl_ymodem_load_image(void); +int spl_ymodem_load_image(void); /* SPI SPL functions */ -void spl_spi_load_image(void); +int spl_spi_load_image(void); /* Ethernet SPL functions */ -void spl_net_load_image(const char *device); +int spl_net_load_image(const char *device); /* USB SPL functions */ -void spl_usb_load_image(void); +int spl_usb_load_image(void); /* SATA SPL functions */ -void spl_sata_load_image(void); +int 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); +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); + +void __noreturn jump_to_image_no_args(struct spl_image_info *spl_image); + +/* SPL EXT image functions */ +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); + +/** + * 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); #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