RK3399 boot sequence - Revision history

Dsimic: Minor cleanup

2023-11-01T05:51:15Z

Minor cleanup

← Older revision		Revision as of 05:51, 1 November 2023
Line 163:		Line 163:
	* [https://gitlab.com/DeltaGem/levinboot levinboot] is a bootloader developed by CrystalGamma in the Pine64 community. It runs on RockPro64 and Pinebook Pro. Its development is on hiatus as of April 2022, but a fork porting it to the PinePhone Pro exists.		* [https://gitlab.com/DeltaGem/levinboot levinboot] is a bootloader developed by CrystalGamma in the Pine64 community. It runs on RockPro64 and Pinebook Pro. Its development is on hiatus as of April 2022, but a fork porting it to the PinePhone Pro exists.

	[[Category:Pinebook Pro]] [[Category:ROCKPro64]] [[Category:Rockchip RK3399]] [[Category:PinePhone Pro]]		[[Category:Pinebook Pro]]
			[[Category:ROCKPro64]]
			[[Category:Rockchip RK3399]]
			[[Category:PinePhone Pro]]

Saper: /* Hardware root of trust */ +efuse manual

2023-04-04T15:03:24Z

Hardware root of trust: +efuse manual

← Older revision		Revision as of 15:03, 4 April 2023
Line 67:		Line 67:
	* [https://github.com/96boards-tb-96aiot/docs/blob/4224417a08256cc97fb1e28c1ae1d35f8d55e89b/Linux%20reference%20documents/Secure/Rockchip_Developer_Guide_Linux4.4_SecureBoot_EN.pdf Rockchip Developer Guide Linux4.4 Secure Boot EN.pdf] ([https://github.com/96boards-tb-96aiot/docs/blob/4224417a08256cc97fb1e28c1ae1d35f8d55e89b/Linux%20reference%20documents/Secure/Rockchip_Developer_Guide_Linux4.4_SecureBoot_CN.pdf zh_CN])		* [https://github.com/96boards-tb-96aiot/docs/blob/4224417a08256cc97fb1e28c1ae1d35f8d55e89b/Linux%20reference%20documents/Secure/Rockchip_Developer_Guide_Linux4.4_SecureBoot_EN.pdf Rockchip Developer Guide Linux4.4 Secure Boot EN.pdf] ([https://github.com/96boards-tb-96aiot/docs/blob/4224417a08256cc97fb1e28c1ae1d35f8d55e89b/Linux%20reference%20documents/Secure/Rockchip_Developer_Guide_Linux4.4_SecureBoot_CN.pdf zh_CN])
	* [https://blog.3mdeb.com/2021/2021-12-03-rockchip-secure-boot/ Artur Kowalski (3mdeb) - Enabling Secure Boot on RockChip SoCs - December 2021]		* [https://blog.3mdeb.com/2021/2021-12-03-rockchip-secure-boot/ Artur Kowalski (3mdeb) - Enabling Secure Boot on RockChip SoCs - December 2021]
			* [https://usermanual.wiki/Document/RK3399EfuseOperationInstructionsV10020190214.1448491699/view RK3399 Efuse Operation Instructions V1.00 - 14 February 2019]

	=== USB gadget boot ===		=== USB gadget boot ===

Saper: /* Hardware root of trust */ +3mdeb blog

2023-04-04T09:55:24Z

Hardware root of trust: +3mdeb blog

← Older revision		Revision as of 09:55, 4 April 2023
Line 66:		Line 66:
	* [https://fosdem.org/2023/schedule/event/arm_secure_boot_2/ FOSDEM 2023: Tomasz Żyjewski (3mdeb) - Overview of Secure Boot state in the ARM-based SoCs, 2nd edition]		* [https://fosdem.org/2023/schedule/event/arm_secure_boot_2/ FOSDEM 2023: Tomasz Żyjewski (3mdeb) - Overview of Secure Boot state in the ARM-based SoCs, 2nd edition]
	* [https://github.com/96boards-tb-96aiot/docs/blob/4224417a08256cc97fb1e28c1ae1d35f8d55e89b/Linux%20reference%20documents/Secure/Rockchip_Developer_Guide_Linux4.4_SecureBoot_EN.pdf Rockchip Developer Guide Linux4.4 Secure Boot EN.pdf] ([https://github.com/96boards-tb-96aiot/docs/blob/4224417a08256cc97fb1e28c1ae1d35f8d55e89b/Linux%20reference%20documents/Secure/Rockchip_Developer_Guide_Linux4.4_SecureBoot_CN.pdf zh_CN])		* [https://github.com/96boards-tb-96aiot/docs/blob/4224417a08256cc97fb1e28c1ae1d35f8d55e89b/Linux%20reference%20documents/Secure/Rockchip_Developer_Guide_Linux4.4_SecureBoot_EN.pdf Rockchip Developer Guide Linux4.4 Secure Boot EN.pdf] ([https://github.com/96boards-tb-96aiot/docs/blob/4224417a08256cc97fb1e28c1ae1d35f8d55e89b/Linux%20reference%20documents/Secure/Rockchip_Developer_Guide_Linux4.4_SecureBoot_CN.pdf zh_CN])
			* [https://blog.3mdeb.com/2021/2021-12-03-rockchip-secure-boot/ Artur Kowalski (3mdeb) - Enabling Secure Boot on RockChip SoCs - December 2021]

	=== USB gadget boot ===		=== USB gadget boot ===

Saper: /* Hardware root of trust */ + some docs

2023-04-04T09:05:49Z

Hardware root of trust: + some docs

← Older revision		Revision as of 09:05, 4 April 2023
Line 63:		Line 63:

	TOOD details		TOOD details

			* [https://fosdem.org/2023/schedule/event/arm_secure_boot_2/ FOSDEM 2023: Tomasz Żyjewski (3mdeb) - Overview of Secure Boot state in the ARM-based SoCs, 2nd edition]
			* [https://github.com/96boards-tb-96aiot/docs/blob/4224417a08256cc97fb1e28c1ae1d35f8d55e89b/Linux%20reference%20documents/Secure/Rockchip_Developer_Guide_Linux4.4_SecureBoot_EN.pdf Rockchip Developer Guide Linux4.4 Secure Boot EN.pdf] ([https://github.com/96boards-tb-96aiot/docs/blob/4224417a08256cc97fb1e28c1ae1d35f8d55e89b/Linux%20reference%20documents/Secure/Rockchip_Developer_Guide_Linux4.4_SecureBoot_CN.pdf zh_CN])

	=== USB gadget boot ===		=== USB gadget boot ===

Saper: /* Boot loader development */ link syntax

2023-04-04T08:29:12Z

Boot loader development: link syntax

← Older revision		Revision as of 08:29, 4 April 2023
Line 156:		Line 156:

	* coreboot runs on RK3399-based Chromebooks, it has not been ported to Pine64 boards yet.		* coreboot runs on RK3399-based Chromebooks, it has not been ported to Pine64 boards yet.
	* [https://gitlab.com/DeltaGem/levinboot\|levinboot] is a bootloader developed by CrystalGamma in the Pine64 community. It runs on RockPro64 and Pinebook Pro. Its development is on hiatus as of April 2022, but a fork porting it to the PinePhone Pro exists.		* [https://gitlab.com/DeltaGem/levinboot levinboot] is a bootloader developed by CrystalGamma in the Pine64 community. It runs on RockPro64 and Pinebook Pro. Its development is on hiatus as of April 2022, but a fork porting it to the PinePhone Pro exists.

	[[Category:Pinebook Pro]] [[Category:ROCKPro64]] [[Category:Rockchip RK3399]] [[Category:PinePhone Pro]]		[[Category:Pinebook Pro]] [[Category:ROCKPro64]] [[Category:Rockchip RK3399]] [[Category:PinePhone Pro]]

Saper: /* Boot loader development */ levinboot on Gitlab

2023-04-04T08:28:26Z

Boot loader development: levinboot on Gitlab

← Older revision		Revision as of 08:28, 4 April 2023
Line 156:		Line 156:

	* coreboot runs on RK3399-based Chromebooks, it has not been ported to Pine64 boards yet.		* coreboot runs on RK3399-based Chromebooks, it has not been ported to Pine64 boards yet.
	* levinboot is a bootloader developed by CrystalGamma in the Pine64 community. It runs on RockPro64 and Pinebook Pro. Its development is on hiatus as of April 2022, but a fork porting it to the PinePhone Pro exists.		* [https://gitlab.com/DeltaGem/levinboot\|levinboot] is a bootloader developed by CrystalGamma in the Pine64 community. It runs on RockPro64 and Pinebook Pro. Its development is on hiatus as of April 2022, but a fork porting it to the PinePhone Pro exists.

	[[Category:Pinebook Pro]] [[Category:ROCKPro64]] [[Category:Rockchip RK3399]] [[Category:PinePhone Pro]]		[[Category:Pinebook Pro]] [[Category:ROCKPro64]] [[Category:Rockchip RK3399]] [[Category:PinePhone Pro]]

Fxc at 15:32, 20 February 2023

2023-02-20T15:32:40Z

← Older revision		Revision as of 15:32, 20 February 2023
Line 158:		Line 158:
	* levinboot is a bootloader developed by CrystalGamma in the Pine64 community. It runs on RockPro64 and Pinebook Pro. Its development is on hiatus as of April 2022, but a fork porting it to the PinePhone Pro exists.		* levinboot is a bootloader developed by CrystalGamma in the Pine64 community. It runs on RockPro64 and Pinebook Pro. Its development is on hiatus as of April 2022, but a fork porting it to the PinePhone Pro exists.

	[[Category:~~PineBook~~ Pro]] [[Category:ROCKPro64]] [[Category:Rockchip RK3399]] [[Category:PinePhone Pro]]		[[Category:Pinebook Pro]] [[Category:ROCKPro64]] [[Category:Rockchip RK3399]] [[Category:PinePhone Pro]]

CrystalGamma: Fix headings

2022-04-25T16:57:37Z

Fix headings

← Older revision		Revision as of 16:57, 25 April 2022
Line 1:		Line 1:
	~~= Rockchip RK3399 boot sequence =~~

	This article describes the boot sequence of the RK3399, the SoC on which the [[ROCKPro64]] single board computer, [[Pinebook Pro]] laptop and the [[PinePhone Pro]] are based.		This article describes the boot sequence of the RK3399, the SoC on which the [[ROCKPro64]] single board computer, [[Pinebook Pro]] laptop and the [[PinePhone Pro]] are based.

Line 121:		Line 119:
	\|}		\|}

	== General maintenance ==		=== General maintenance ===
	If a new U-Boot is supplied, it is generally installed similar to this:		If a new U-Boot is supplied, it is generally installed similar to this:
	<pre># dd if=/boot/idbloader.img conv=notrunc seek=64 of=/dev/mmcblkX		<pre># dd if=/boot/idbloader.img conv=notrunc seek=64 of=/dev/mmcblkX
	# dd if=/boot/u-boot.itb conv=notrunc seek=16384 of=/dev/mmcblkX</pre>		# dd if=/boot/u-boot.itb conv=notrunc seek=16384 of=/dev/mmcblkX</pre>

	== Different devices ==		=== Different devices ===
	The RK3399 boots to multiple devices. Boot device selection is done in the following order, and it cannot be changed.<br>		The RK3399 boots to multiple devices. Boot device selection is done in the following order, and it cannot be changed.<br>
	If a device is blank / unused, the SoC code moves on to the next device in the list.		If a device is blank / unused, the SoC code moves on to the next device in the list.

CrystalGamma: Separately document BROM behavior and U-Boot conventions

2022-04-25T16:45:43Z

Separately document BROM behavior and U-Boot conventions

Show changes

CrystalGamma: /* Boot sequence details */

2022-04-25T13:52:18Z

Boot sequence details

← Older revision		Revision as of 13:52, 25 April 2022
Line 4:		Line 4:
	== Boot sequence details ==		== Boot sequence details ==

	There are two types of internal memory inside RK3399:		There are two types of internal memory inside RK3399 that are used during boot:

	* ~~32KB~~ BootROM - containing a small program which loads initial bootloader. It supports loading it from SPI, eMMC, SD and USB OTG in so-called maskrom mode.		* 32 KiB BootROM - containing a small program which loads initial bootloader. It supports loading it from SPI, eMMC, SD and USB OTG in so-called maskrom mode.
	* ~~200KB~~ SRAM		* 200 KiB SRAM: 192 KiB main SRAM, 8 KiB PMU SRAM (used to resume from suspend-to-RAM)

	Actual boot sequence:		Actual boot sequence for bootloaders derived from (mainline) U-Boot (including Tow-Boot):

	1. BootROM loads U-Boot TPL into SRAM. Its [https://www.denx.de/wiki/pub/U-Boot/MiniSummitELCE2013/tpl-presentation.pdf job] is to initialize main system ~~RAM~~.~~<br>~~		# BootROM loads U-Boot TPL into SRAM. Its [https://www.denx.de/wiki/pub/U-Boot/MiniSummitELCE2013/tpl-presentation.pdf job] is to initialize DRAM (main system memory).
	2. Control goes back from U-Boot TPL to BootROM.~~<br>~~		# Control goes back from U-Boot TPL to BootROM.
	3. BootROM loads U-Boot SPL.~~<br>~~		# BootROM loads U-Boot SPL into low DRAM.
	4. U-Boot SPL loads ~~ATF~~ and U-Boot itself into main ~~memory~~.~~<br>~~		# U-Boot SPL loads TF-A and U-Boot itself into DRAM, and certain parts of TF-A into main and PMU SRAM.
	~~5. ATF~~ runs U-Boot.~~<br>~~		# Control is given to TF-A, which then runs U-Boot in EL2.
	6. U-Boot loads payload (eg. EFI binaries, grub). Direct Linux kernel load is also supported.		# U-Boot loads payload (eg. EFI binaries, grub). Direct Linux kernel load is also supported.<br>U-Boot can boot from many sources - eMMC, SD, USB, NVMe.

	U-~~boot can boot from many sources~~ - ~~eMMC, SD, USB, NVMe.~~		U-Boot-based bootloaders usually come in 2 images:

	'''idbloader.img''' contains TPL and SPL.~~<br>~~		* '''idbloader.img''' contains TPL and SPL.
	'''u-boot.itb''' contains ~~ATF~~ and U-Boot.		* '''u-boot.itb''' contains TF-A and U-Boot.

	== Description ==		== Description ==