xref: /rk3399_rockchip-uboot/arch/arm/include/asm/arch-rockchip/bootrom.h (revision 7a6ed8e85fb413a7da484e9c30b1e9beab2e594a)
1aade077eSHeiko Stübner /*
2aade077eSHeiko Stübner  * (C) Copyright 2017 Heiko Stuebner <heiko@sntech.de>
33513fb1eSPhilipp Tomsich  * (C) Copyright 2017 Theobroma Systems Design und Consulting GmbH
4aade077eSHeiko Stübner  *
5aade077eSHeiko Stübner  * SPDX-License-Identifier:	GPL-2.0
6aade077eSHeiko Stübner  */
7aade077eSHeiko Stübner 
8aade077eSHeiko Stübner #ifndef _ASM_ARCH_BOOTROM_H
9aade077eSHeiko Stübner #define _ASM_ARCH_BOOTROM_H
10aade077eSHeiko Stübner 
11aade077eSHeiko Stübner /*
12aade077eSHeiko Stübner  * Saved Stack pointer address.
13aade077eSHeiko Stübner  * Access might be needed in some special cases.
14aade077eSHeiko Stübner  */
15aade077eSHeiko Stübner extern u32 SAVE_SP_ADDR;
16aade077eSHeiko Stübner 
17e1bc64eeSSimon Glass /**
183513fb1eSPhilipp Tomsich  * back_to_bootrom() - return to bootrom (for TPL/SPL), passing a
193513fb1eSPhilipp Tomsich  *                     result code
203513fb1eSPhilipp Tomsich  *
213513fb1eSPhilipp Tomsich  * Transfer control back to the Rockchip BROM, restoring necessary
223513fb1eSPhilipp Tomsich  * register context and passing a command/result code to the BROM
233513fb1eSPhilipp Tomsich  * to instruct its next actions (e.g. continue boot sequence, enter
243513fb1eSPhilipp Tomsich  * download mode, ...).
253513fb1eSPhilipp Tomsich  *
263513fb1eSPhilipp Tomsich  * This function does not return.
2750b28820SPhilipp Tomsich  *
2850b28820SPhilipp Tomsich  * @brom_cmd: indicates how the bootrom should continue the boot
2950b28820SPhilipp Tomsich  *            sequence (e.g. load the next stage)
30aade077eSHeiko Stübner  */
313513fb1eSPhilipp Tomsich enum rockchip_bootrom_cmd {
323513fb1eSPhilipp Tomsich 	/*
333513fb1eSPhilipp Tomsich 	* These can not start at 0, as 0 has a special meaning
343513fb1eSPhilipp Tomsich 	* for setjmp().
353513fb1eSPhilipp Tomsich 	*/
363513fb1eSPhilipp Tomsich 
373513fb1eSPhilipp Tomsich 	BROM_BOOT_NEXTSTAGE = 1,  /* continue boot-sequence */
383513fb1eSPhilipp Tomsich 	BROM_BOOT_ENTER_DNL,      /* have BROM enter download-mode */
393513fb1eSPhilipp Tomsich };
403513fb1eSPhilipp Tomsich 
4150b28820SPhilipp Tomsich void back_to_bootrom(enum rockchip_bootrom_cmd brom_cmd);
425cf14c03SPhilipp Tomsich 
435cf14c03SPhilipp Tomsich /**
445cf14c03SPhilipp Tomsich  * Boot-device identifiers as used by the BROM
455cf14c03SPhilipp Tomsich  */
465cf14c03SPhilipp Tomsich enum {
475cf14c03SPhilipp Tomsich 	BROM_BOOTSOURCE_NAND = 1,
485cf14c03SPhilipp Tomsich 	BROM_BOOTSOURCE_EMMC = 2,
495cf14c03SPhilipp Tomsich 	BROM_BOOTSOURCE_SPINOR = 3,
505cf14c03SPhilipp Tomsich 	BROM_BOOTSOURCE_SPINAND = 4,
515cf14c03SPhilipp Tomsich 	BROM_BOOTSOURCE_SD = 5,
525cf14c03SPhilipp Tomsich 	BROM_BOOTSOURCE_USB = 10,
535cf14c03SPhilipp Tomsich 	BROM_LAST_BOOTSOURCE = BROM_BOOTSOURCE_USB
545cf14c03SPhilipp Tomsich };
555cf14c03SPhilipp Tomsich 
56*7a6ed8e8SKever Yang extern const char * const boot_devices[BROM_LAST_BOOTSOURCE + 1];
57*7a6ed8e8SKever Yang 
585cf14c03SPhilipp Tomsich /**
595cf14c03SPhilipp Tomsich  * Locations of the boot-device identifier in SRAM
605cf14c03SPhilipp Tomsich  */
615cf14c03SPhilipp Tomsich #define RK3399_BROM_BOOTSOURCE_ID_ADDR   0xff8c0010
625cf14c03SPhilipp Tomsich 
63aade077eSHeiko Stübner #endif
64