U-Boot on Orange Pi 4 - Revision history

Dejvino at 18:11, 28 March 2020

2020-03-28T18:11:17Z

Dejvino at 17:57, 28 March 2020

2020-03-28T17:57:50Z

Dejvino at 17:55, 28 March 2020

2020-03-28T17:55:43Z

Dejvino at 12:01, 27 March 2020

2020-03-27T12:01:10Z

Dejvino at 23:46, 26 March 2020

2020-03-26T23:46:32Z

Dejvino at 23:42, 26 March 2020

2020-03-26T23:42:31Z

Dejvino at 23:41, 26 March 2020

2020-03-26T23:41:50Z

Dejvino at 23:40, 26 March 2020

2020-03-26T23:40:43Z

Dejvino at 22:45, 26 March 2020

2020-03-26T22:45:13Z

Dejvino at 22:27, 26 March 2020

2020-03-26T22:27:51Z

@@ Line 2: / Line 2: @@
 This is the first step to getting the device booted and running any software. For the actual OS installation, see [[Linux on Orange Pi 4]].
 {{Info|1=
@@ Line 23: / Line 19: @@
 See [[U-Boot]] for general concepts and definitions.
-[[U-Boot]] takes care of the initial booting. It is device (board) specific and so needs to be compiled specifically for [[Orange Pi 4]] as it initializes the hardware, e.g. the RAM modules. Internally there are 3 (!) bootloaders which form a boot chain: TPL -> SPL -> U-Boot. To boot an actual operating system, U-Boot executes the OS's bootloader, which brings this to 4 (!!) bootloaders in total. Crazy, right?
+[[U-Boot]] takes care of the initial booting. It is device (board) specific and so needs to be compiled specifically for [[Orange Pi 4]] as it initializes the hardware, e.g. the RAM modules.
-'''Note on orangepi-rk3399:''' Though there is an ''orangepi-rk3399'' board available, this is NOT the same as Orange Pi 4. It does have the same processor, but the [[device tree]] is different. Notably there is difference in RAM: DDR3 vs LPDDR4.
+Internally there are 3 (!) bootloaders which form a boot chain: TPL -> SPL -> U-Boot. To boot an actual operating system, U-Boot executes the OS's bootloader, which brings this to 4 (!!) bootloaders in total. Crazy, right?
 See [[ARM Trusted Firmware]] for ATF / trust related terminology.
@@ Line 33: / Line 29: @@
 # Loader 1:
-#* option 1: miniloader
+#* <span style="color: gray">option 1: miniloader</span>
 #* option 2: SPL/TPL
 # Loader 2:
-#* option 1: uboot.img
+#* <span style="color: gray">option 1: uboot.img</span>
 #* option 2: u-boot.itb
 # trust.img
@@ Line 42: / Line 38: @@
 # rootfs.img
-{{Warning|Option 1 (recommended by [[Rockchip]]) uses closed source tools and binaries.
+{{Warning|Option 1 (recommended by [[Rockchip]]) uses closed source tools and binaries!
 [https://github.com/rockchip-linux/rkbin.git rkbin/tools] are pre-built x86 binaries and are therefore not usable on the target device. The source code is not available for audit or compilation on a different architecture.
-Therefore this is not a usable route.}}
+Therefore this is not a usable route and will not be discussed further.}}
 == Setup ==
@@ Line 53: / Line 49: @@
 * dtc (device tree compiler)
 * bc (basic calculator)
-{{Todo|Not complete}}
+{{Todo|Not complete. Add packages needed bases on testing on an x86_64 computer.}}
 ==== Ubuntu ====
-{{Todo|Not complete}}
+{{Todo|Not complete. Add packages needed based on testing on Orange Pi 4.}}
 === Cross-compilation ===
@@ Line 64: / Line 60: @@
 === U-Boot Sources ===
 {{Todo|1=
-'''orangepi-4-rk3399''' doesn't exist in mainline as of 2020-03-25, [[Applying a git patch|apply this patch]] from [[Armbian]]: [https://github.com/armbian/build/blob/master/patch/u-boot/u-boot-rk3399/add-board-orangepi-4.patch]}}
+'''orangepi-4-rk3399''' doesn't exist in mainline as of 2020-03-25, [[Applying a git patch|apply this patch]] from [[Armbian]] to add the board definition: [https://github.com/armbian/build/blob/master/patch/u-boot/u-boot-rk3399/add-board-orangepi-4.patch]}}
 <pre>git clone https://gitlab.denx.de/u-boot/u-boot.git

@@ Line 2: / Line 2: @@
 This is the first step to getting the device booted and running any software. For the actual OS installation, see [[Linux on Orange Pi 4]].
 '''Note on native compilation:''' The officially expected compilation environment for most (if not all) of the tools mentioned is an x86_64 machine running Ubuntu (Bionic or Xenial) with a cross-compilation toolchain. I've tested that with a few tweaks these instructions for mainline repositories are usable also on the target device, i.e. ARMv8 machine (running Ubuntu Bionic to be precise).
@@ Line 26: / Line 22: @@
 See [[U-Boot]] for general concepts and definitions.
 See [[ARM Trusted Firmware]] for ATF / trust related terminology.

← Older revision		Revision as of 17:55, 28 March 2020
Line 2:		Line 2:

	This is the first step to getting the device booted and running any software. For the actual OS installation, see [[Linux on Orange Pi 4]].		This is the first step to getting the device booted and running any software. For the actual OS installation, see [[Linux on Orange Pi 4]].
		+
		+	[[U-Boot]] takes care of the initial booting. It is device (board) specific and so needs to be compiled specifically for [[Orange Pi 4]] as it initializes the hardware, e.g. the RAM modules. Internally there are 3 (!) bootloaders which form a boot chain: TPL -> SPL -> U-Boot. To boot an actual operating system, U-Boot executes the OS's bootloader, which brings this to 4 (!!) bootloaders in total. Crazy, right?

	'''Note on orangepi-rk3399:''' Though there is an ''orangepi-rk3399'' board available, this is NOT the same as Orange Pi 4. It does have the same processor, but the [[device tree]] is different. Notably there is difference in RAM: DDR3 vs LPDDR4.		'''Note on orangepi-rk3399:''' Though there is an ''orangepi-rk3399'' board available, this is NOT the same as Orange Pi 4. It does have the same processor, but the [[device tree]] is different. Notably there is difference in RAM: DDR3 vs LPDDR4.

@@ Line 1: / Line 1: @@
 [[U-Boot]] used on an [[Orange Pi 4]] which sports an [[RK3399]] processor.
 '''Note on orangepi-rk3399:''' Though there is an ''orangepi-rk3399'' board available, this is NOT the same as Orange Pi 4. It does have the same processor, but the [[device tree]] is different. Notably there is difference in RAM: DDR3 vs LPDDR4.
@@ Line 5: / Line 7: @@
 '''Note on native compilation:''' The officially expected compilation environment for most (if not all) of the tools mentioned is an x86_64 machine running Ubuntu (Bionic or Xenial) with a cross-compilation toolchain. I've tested that with a few tweaks these instructions for mainline repositories are usable also on the target device, i.e. ARMv8 machine (running Ubuntu Bionic to be precise).
-{{Todo|THIS PAGE!}}
+{{Todo|Cleanup}}
 == Introduction ==

@@ Line 50: / Line 50: @@
 === U-Boot Sources ===
 {{Todo|1=
 ''orangepi-4-rk3399'' doesn't exist in mainline as of 2020-03-25, [[Applying a git patch|apply this patch]] from [[Armbian]]: [https://github.com/armbian/build/blob/master/patch/u-boot/u-boot-rk3399/add-board-orangepi-4.patch]}}
 <pre>git clone https://gitlab.denx.de/u-boot/u-boot.git
@@ Line 56: / Line 57: @@
 make orangepi-4-rk3399_defconfig</pre>
-== Compilation ===
+== Compilation ==
 === Export cross compiler for AArch64 ===

@@ Line 49: / Line 49: @@
 === U-Boot Sources ===
-{{Todo|'''orangepi-4-rk3399'' doesn't exist in mainline as of 2020-03-25, [[Applying a git patch|apply this patch]] from [[Armbian]]: [https://github.com/armbian/build/blob/master/patch/u-boot/u-boot-rk3399/add-board-orangepi-4.patch]}}
+{{Todo|''orangepi-4-rk3399'' doesn't exist in mainline as of 2020-03-25, [[Applying a git patch|apply this patch]] from [[Armbian]]: [https://github.com/armbian/build/blob/master/patch/u-boot/u-boot-rk3399/add-board-orangepi-4.patch]}}
 <pre>git clone https://gitlab.denx.de/u-boot/u-boot.git
 cd u-boot

@@ Line 1: / Line 1: @@
 [[U-Boot]] used on an [[Orange Pi 4]] which sports an [[RK3399]] processor.
-The officially expected compilation environment for most (if not all) of the tools mentioned is an x86_64 machine running Ubuntu (Bionic or Xenial) with a cross-compilation toolchain.
+'''Note on orangepi-rk3399:''' Though there is an ''orangepi-rk3399'' board available, this is NOT the same as Orange Pi 4. It does have the same processor, but the [[device tree]] is different. Notably there is difference in RAM: DDR3 vs LPDDR4.
-I've tested that with a few tweaks these instructions are usable also on the target device, i.e. ARMv8 machine (running Ubuntu Bionic to be precise).
+'''Note on native compilation:''' The officially expected compilation environment for most (if not all) of the tools mentioned is an x86_64 machine running Ubuntu (Bionic or Xenial) with a cross-compilation toolchain. I've tested that with a few tweaks these instructions for mainline repositories are usable also on the target device, i.e. ARMv8 machine (running Ubuntu Bionic to be precise).
 {{Todo|THIS PAGE!}}
@@ Line 28: / Line 26: @@
 # boot.img
 # rootfs.img
 == Setup ==
-=== Build Packages ===
+=== Base Build Tools ===
 ==== Arch Linux ====
 * dtc (device tree compiler)
@@ Line 39: / Line 43: @@
 {{Todo|Not complete}}
-=== Crosstool ===
+=== Cross-compilation ===
 * Binaries for aarch64-linux-gnu: [https://releases.linaro.org/components/toolchain/binaries/7.3-2018.05/aarch64-linux-gnu/]
-=== U-Boot Setup ===
+=== U-Boot Sources ===
-{{Todo|'''orangepi-4-rk3399'' doesn't exist in mainline as of 2020-03-25, apply this patch from [[Armbian]]: [https://github.com/armbian/build/blob/master/patch/u-boot/u-boot-rk3399/add-board-orangepi-4.patch]}}
+{{Todo|'''orangepi-4-rk3399'' doesn't exist in mainline as of 2020-03-25, [[Applying a git patch|apply this patch]] from [[Armbian]]: [https://github.com/armbian/build/blob/master/patch/u-boot/u-boot-rk3399/add-board-orangepi-4.patch]}}
 <pre>git clone https://gitlab.denx.de/u-boot/u-boot.git
 cd u-boot
 make orangepi-4-rk3399_defconfig</pre>
-=== Option 1: Package the image with Rockchip miniloader ===
+== Compilation ===
-[https://github.com/rockchip-linux/rkbin.git rkbin/tools] are pre-built x86 binaries and are therefore not usable on the target device. The source code is not available for audit or compilation on a different architecture.
+=== Export cross compiler for AArch64 ===
+Export cross compiler path for aarch64:
 # 'wget' the toolchain binaries (see above)
@@ Line 68: / Line 66: @@
 #* 'CROSS_COMPILE=$CROSS_COMPILE_AARCH64'
-(needed only when not running on the target device)
+The usage is this: <code>CROSS_COMPILE=$CROSS_COMPILE</code> (needed only when not running on the target device)
 ==== Compile ATF ====
@@ Line 77: / Line 75: @@
 	(export cross compiler path for Cortex-M0 MCU likely arm-none-eabi-)
 	=> make realclean
-	=> make CROSS_COMPILE=aarch64-linux-gnu- PLAT=rk3399
+	=> make CROSS_COMPILE=$CROSS_COMPILE PLAT=rk3399
 	(export bl31.elf)
@@ Line 83: / Line 81: @@
 </pre>
-==== Compile PMU M0 firmware ====
+==== Compile PMU M0 firmware (optional) ====
 {{Todo|The internally provided cross-compile toolchain for cortex-m0 seems outdated (it wouldn't compile). Skipping for now.}}
@@ Line 106: / Line 104: @@
       => cd /path/to/u-boot
       => make orangepi-4-rk3399_defconfig
-      => make
+      => make CROSS_COMPILE=$CROSS_COMPILE
       (Get idbloader.img and u-boot.itb)
 </pre>
 == Booting from an SD card ==
 === Flashing ===
@@ Line 128: / Line 127: @@
 </pre>
-==== Booting ====
+=== Booting ===
 Put this microSD card into your board and reset it. You should see
 something like:
 <pre class="mw-collapsed mw-collapsible">
-U-Boot TPL board init
+U-Boot TPL 2020.04-rc3-00171-g0aadc0786e-dirty (Mar 27 2020 - 00:08:45)
 Trying to boot from BOOTROM
 Returning to boot ROM...
-U-Boot SPL board init
+U-Boot SPL 2020.04-rc3-00171-g0aadc0786e-dirty (Mar 27 2020 - 00:08:45 +0100)
 Trying to boot from MMC1
-U-Boot 2019.07-rc1-00241-g5b3244767a (May 08 2019 - 10:51:06 +0530)
+U-Boot 2020.04-rc3-00171-g0aadc0786e-dirty (Mar 27 2020 - 00:08:45 +0100)
 In:    serial@ff1a0000
 Out:   serial@ff1a0000
 Err:   serial@ff1a0000
-Model: Orange Pi RK3399 Board
+Model: OrangePi 4 AI board
 Net:   eth0: ethernet@fe300000
 Hit any key to stop autoboot:  0
 =>
 </pre>

@@ Line 4: / Line 4: @@
 I've tested that with a few tweaks these instructions are usable also on the target device, i.e. ARMv8 machine (running Ubuntu Bionic to be precise).
 {{Todo|THIS PAGE!}}
 == Introduction ==
@@ Line 49: / Line 43: @@
 === U-Boot Setup ===
 <pre>git clone https://gitlab.denx.de/u-boot/u-boot.git
 cd u-boot
-make orangepi-rk3399_defconfig</pre>
+make orangepi-4-rk3399_defconfig</pre>
 === Option 1: Package the image with Rockchip miniloader ===
@@ Line 107: / Line 102: @@
 ==== Compile U-Boot ====
 [[File:U-boot dependencies digraph.png|thumb|right|U-Boot Makefile build dependencies [https://kb.d5o.eu/index.php/U-boot_dependencies_digraph_source] ]]
 <pre>
       => cd /path/to/u-boot
-      => make orangepi-rk3399_defconfig
+      => make orangepi-4-rk3399_defconfig
       => make
@@ Line 132: / Line 115: @@
 {{Todo|Tested with OPi4 until here. Verify the rest.}}
-=== Flashing with TPL ===
+=== Flashing ===
 ==== Write tpl+spl at 64th sector ====
 <pre>
-    => sudo dd if=idbloader.img of=/dev/sdc seek=64
+  sudo dd if=idbloader.img of=/dev/sdc seek=64
 </pre>
 ==== Write U-Boot proper at 16384 sector ====
 <pre>
-    => sudo dd if=u-boot.itb of=/dev/sdc seek=16384
+  sudo dd if=u-boot.itb of=/dev/sdc seek=16384
-    => sync
+  sync
 </pre>

@@ Line 106: / Line 106: @@
 ==== Compile U-Boot ====
-[[File:U-boot dependencies digraph.png|thumb|right|U-Boot Makefile build dependencies [[https://kb.d5o.eu/index.php/U-boot_dependencies_digraph_source]] ]]
+[[File:U-boot dependencies digraph.png|thumb|right|U-Boot Makefile build dependencies [https://kb.d5o.eu/index.php/U-boot_dependencies_digraph_source] ]]
 {{Todo|orangepi-rk3399_defconfig is close but not the right board!}}