Difference between revisions of "Template:RK3588-BuildFromSource"

Latest revision as of 08:18, 1 July 2024

mkdir friendlywrt21-rk3588
cd friendlywrt21-rk3588
git clone https://github.com/friendlyarm/repo --depth 1 tools
tools/repo init -u https://github.com/friendlyarm/friendlywrt_manifests -b master-v21.02 \
        -m rk3588.xml --repo-url=https://github.com/friendlyarm/repo  --no-clone-bundle
tools/repo sync -c  --no-clone-bundle

1.1.2 FriendlyWrt 23.05

mkdir friendlywrt23-rk3588
cd friendlywrt23-rk3588
git clone https://github.com/friendlyarm/repo --depth 1 tools
tools/repo init -u https://github.com/friendlyarm/friendlywrt_manifests -b master-v23.05 \
        -m rk3588.xml --repo-url=https://github.com/friendlyarm/repo  --no-clone-bundle
tools/repo sync -c  --no-clone-bundle

1.2 First compilation step

./build.sh rk3588.mk  # or rk3588-docker.mk

All the components (including u-boot, kernel, and friendlywrt) are compiled and the sd card image will be generated, then execute the following command to generate the image file for installing the system into the emmc:

./build.sh emmc-img

After making changes to the project, the sd card image needs to be repackaged by running the following command:

./build.sh sd-img

1.3 Secondary compilation steps

cd friendlywrt
make menuconfig
rm -rf ./tmp
make -j${nproc}
cd ../
./build.sh sd-img
./build.sh emmc-img

1.4 Build u-boot only

./build.sh uboot

1.5 Build kernel only

./build.sh kernel

1.6 Build friendlywrt only

./build.sh friendlywrt

Or go to the friendlywrt directory and follow the standard openwrt commands. If you get an error with the above command, try using the following command to compile in a single thread:

cd friendlywrt
make -j1 V=s

2 Build Buildroot

please refer to: Buildroot

3 Build Other Linux

3.1 Kernel and u-boot versions

Operating System	Kernel Version	U-boot version	Cross-compiler	Partition type	Packaging Tool	Kernel branch	Kernel configuration	U-boot branch	U-boot configuration
buildroot	linux v5.10.y	u-boot v2017.09	11.3-aarch64	GPT	sd-fuse	nanopi5-v5.10.y_opt	nanopi6_linux_defconfig	nanopi6-v2017.09	nanopi6_defconfig
openmediavault-arm64	linux v6.1.y			GPT	sd-fuse	nanopi6-v6.1.y
ubuntu-jammy-desktop-arm64				GPT
ubuntu-jammy-minimal-arm64
ubuntu-jammy-x11-desktop-arm64
ubuntu-focal-desktop-arm64
friendlycore-focal-arm64
debian-bookworm-core-arm64
debian-bullseye-desktop-arm64
debian-bullseye-minimal-arm64
friendlywrt21							nanopi6_linux_defconfig friendlywrt.config
friendlywrt21-docker
friendlywrt23
friendlywrt23-docker

Kernel git repo：https://github.com/friendlyarm/kernel-rockchip
U-boot git repo：https://github.com/friendlyarm/uboot-rockchip
The cross-compile toolchain is located in the path: /opt/FriendlyARM/toolchain/
The sd-fuse is a helper script to make bootable SD card image.

3.2 Build kernel linux-v6.1.y

Clone the repository to your local drive then build:

git clone https://github.com/friendlyarm/kernel-rockchip --single-branch --depth 1 -b nanopi6-v6.1.y kernel-rockchip
cd kernel-rockchip
export PATH=/opt/FriendlyARM/toolchain/11.3-aarch64/bin/:$PATH
touch .scmversion
# Configuring the Kernel
# Load default configuration
make CROSS_COMPILE=aarch64-linux-gnu- ARCH=arm64 nanopi6_linux_defconfig
# Optionally, load configuration for FriendlyWrt
# make CROSS_COMPILE=aarch64-linux-gnu- ARCH=arm64 nanopi6_linux_defconfig friendlywrt.config
# Optionally, if you want to change the default kernel config
# make CROSS_COMPILE=aarch64-linux-gnu- ARCH=arm64 menuconfig
# Start building kernel
make CROSS_COMPILE=aarch64-linux-gnu- ARCH=arm64 nanopi6-images -j$(nproc)
# Start building kernel modules
mkdir -p out-modules && rm -rf out-modules/*
make CROSS_COMPILE=aarch64-linux-gnu- ARCH=arm64 INSTALL_MOD_PATH="$PWD/out-modules" modules -j$(nproc)
make CROSS_COMPILE=aarch64-linux-gnu- ARCH=arm64 INSTALL_MOD_PATH="$PWD/out-modules" modules_install
KERNEL_VER=$(make CROSS_COMPILE=aarch64-linux-gnu- ARCH=arm64 kernelrelease)
[ ! -f "$PWD/out-modules/lib/modules/${KERNEL_VER}/modules.dep" ] && depmod -b $PWD/out-modules -E Module.symvers -F System.map -w ${KERNEL_VER}
(cd $PWD/out-modules && find . -name \*.ko | xargs aarch64-linux-strip --strip-unneeded)

The generated files:

kernel.img	resource.img	~~boot.img This img is deprecated~~	The kernel modules are located in the out-modules directory

Run your build:
Please refre to #Running the build

3.3 Build u-boot v2017.09

Clone the repository to your local drive then build:

git clone https://github.com/friendlyarm/rkbin --single-branch --depth 1 -b nanopi6
git clone https://github.com/friendlyarm/uboot-rockchip --single-branch --depth 1 -b nanopi6-v2017.09
export PATH=/opt/FriendlyARM/toolchain/11.3-aarch64/bin/:$PATH
cd uboot-rockchip/
./make.sh nanopi6

After the compilation, the following files will be generated:

uboot.img	rk3588_spl_loader_xx.yy.zzz.bin (aka MiniLoaderAll.bin)

Run your build:
Please refre to #Running the build

3.4 Running the build

3.4.1 Install to target board

RK3588 uses GPT partitions by default, you can use the dd command, but be careful to choose the right output device:

The SD/TF Card device node: /dev/mmcblk0
The eMMC device node: /dev/mmcblk2

Use the 'parted' command to view the partition layout:

parted /dev/mmcblk2 print

Sample outputs:

Model: MMC A3A551 (sd/mmc)
Disk /dev/mmcblk2: 31.0GB
Sector size (logical/physical): 512B/512B
Partition Table: gpt
Disk Flags:
 
Number  Start   End     Size    File system  Name      Flags
 1      8389kB  12.6MB  4194kB               uboot
 2      12.6MB  16.8MB  4194kB               misc
 3      16.8MB  21.0MB  4194kB               dtbo
 4      21.0MB  37.7MB  16.8MB               resource
 5      37.7MB  79.7MB  41.9MB               kernel
 6      79.7MB  113MB   33.6MB               boot
 7      113MB   147MB   33.6MB               recovery
 8      147MB   31.0GB  30.9GB  ext4         rootfs

as shown above, the resource partition is located at 4 and the kernel partition is located at 5. Use the dd command to write the resource.img and kernel.img files to these partitions, the commands are as follows:

dd if=resource.img of=/dev/mmcblk2p4 bs=1M
dd if=kernel.img of=/dev/mmcblk2p5 bs=1M

If you want to update u-boot:

dd if=uboot.img of=/dev/mmcblk2p1 bs=1M

To update new driver modules, copy the newly compiled driver modules to the appropriate directory under /lib/modules.

3.4.2 Packaging and creating an SD image

To create a new OS image file, you need to use the "sd-fuse" packaging tool.

"sd-fuse" is a collection of scripts that can be used to create bootable SD card images for FriendlyElec boards. Its main features include:

Creation of root filesystem images from a directory
Building of bootable SD card images
Simple compilation of kernel, U-Boot, and third-party drivers

Please click on the following link to find out more:

Kernel version	Packaging Tool
linux v6.1.y	sd-fuse_rk3588

3.4.3 USB flashing

3.4.3.1 Linux

Reboot the board and enter loader mode with the following command:

sudo reboot loader

To flash U-Boot and kernel using the "upgrade_tool_v2.17_for_linux" tool, please use the following command:

sudo upgrade_tool di -k kernel.img
sudo upgrade_tool di -re resource.img
sudo upgrade_tool di -u uboot.img
sudo upgrade_tool RD

Note: "upgrade_tool" is a command-line tool provided by Rockchip for Linux operating systems (Linux_Upgrade_Tool).

4 Build the code using scripts

4.1 Download scripts and image files

git clone https://github.com/friendlyarm/sd-fuse_rk3588.git --single-branch -b kernel-6.1.y
cd sd-fuse_rk3588
tar xvzf /path/to/netdrive/03_Partition\ image\ files/friendlycore-focal-arm64-images.tgz

4.2 Compile the kernel

Download the kernel source code and compile it. the relevant image files in the friendlycore-focal-arm64 directory will be automatically updated, including the kernel modules in the file system:

git clone https://github.com/friendlyarm/kernel-rockchip --depth 1 -b nanopi6-v6.1.y kernel-rk3588
KERNEL_SRC=$PWD/kernel-rk3588 ./build-kernel.sh friendlycore-focal-arm64

4.3 Compile the kernel headers

git clone https://github.com/friendlyarm/kernel-rockchip --depth 1 -b nanopi6-v6.1.y kernel-rk3588
MK_HEADERS_DEB=1 BUILD_THIRD_PARTY_DRIVER=0 KERNEL_SRC=$PWD/kernel-rk3588 ./build-kernel.sh friendlycore-focal-arm64

4.4 Compile the uboot

Download the uboot source code and compile it. the relevant image files in the friendlycore-focal-arm64 directory will be automatically updated:

git clone https://github.com/friendlyarm/uboot-rockchip --depth 1 -b nanopi6-v2017.09
UBOOT_SRC=$PWD/uboot-rockchip ./build-uboot.sh friendlycore-focal-arm64

4.5 Generate new image

Repackage the image file in the friendlycore-focal-arm64 directory into sd card image:

./mk-sd-image.sh friendlycore-focal-arm64

After the command is completed, the image is in the out directory, you can use the dd command to make the SD boot card, for example:

dd if=out/rk3588-sd-friendlycore-focal-5.10-arm64-YYYYMMDD.img of=/dev/sdX bs=1M

5 Building AOSP from source

5.1 Hardware and Software Requirements

Your computer should have at least 16GB of RAM and 300GB of disk space. We recommend using a machine with 32GB of RAM and a large-capacity, high-speed SSD, and we do not recommend using virtual machines.
If you encounter compilation errors, they may be caused by problems with the compilation environment. We recommend using the following Docker container for compilation: docker-cross-compiler-novnc.

5.2 Download source from the netdrive

Netdisk URL: Click here
File location on netdisk："07_Source codes/rk35xx-android12-xxxxxxx-YYYYMMDD.tgz" (YYYYMMDD represents the date of the package, and xxxxxxx represents the final commit-id)
Unzip and fetch updates:

tar xzf '/path/to/netdisk/07_Source codes/rk35xx-android12-xxxxxxx-YYYYMMDD.tgz'
cd rk35xx-android12
git pull

5.3 Tablet profile build (First Build)

echo "ROCKCHIP_DEVICE_DIR := device/rockchip/rk3588/nanopi6" > .rockchip_device.mk
# export INSTALL_GAPPS_FOR_TESTING=yes  # include google apps
. setenv.sh
./build.sh -FMu

5.4 TV profile build (First Build)

echo "ROCKCHIP_DEVICE_DIR := device/rockchip/rk3588/nanopi6_box" > .rockchip_device.mk
# export INSTALL_GAPPS_FOR_TESTING=yes  # include google apps
. setenv.sh
./build.sh -FMu

5.5 Second build

# export INSTALL_GAPPS_FOR_TESTING=yes  # include google apps
. setenv.sh
make
./build.sh -Mu

5.6 Running your AOSP build

After the Android compilation is completed, the image file will be stored in the rockdev/Image-aosp_nanopi3 subdirectory of the Android source code directory.

5.6.1 USB Flashing

Use the rockchip tool to flash the following file: rockdev/Image-aosp_nanopi3/update.img

5.6.2 SD-to-eMMC Flashing

Refer to the following steps：
1) Insert the SD card of the eflasher system into the host;
2) Copy the files in the rockdev/Image-aosp_nanopi3 directory to the android12 or androidtv directory in the FRIENDLYARM partition of the SD card:

sudo cp -af parameter.txt config.cfg MiniLoaderAll.bin uboot.img \
    dtbo.img vbmeta.img boot.img recovery.img \
    misc.img pcba_small_misc.img pcba_whole_misc.img \
    baseparameter.img super.img /media/$USER/FriendlyARM/android12

3) Insert the SD card into {{{1}}} and re-flash;

5.7 Pack the new SD Image

git clone https://github.com/friendlyarm/sd-fuse_rk3588.git
SDFUSE=$PWD/sd-fuse_rk3588
mkdir $SDFUSE/android12
 
cd /path/to/rk35xx-android12/rockdev/Image-aosp_nanopi3
cp -af parameter.txt config.cfg MiniLoaderAll.bin uboot.img \
    dtbo.img vbmeta.img boot.img recovery.img \
    misc.img pcba_small_misc.img pcba_whole_misc.img \
    baseparameter.img super.img $SDFUSE/android12
 
cd $SDFUSE/
./mk-sd-image.sh android12
 
tar xvzf /path/to/netdrive/03_Partition\ image\ files/emmc-flasher-images.tgz
./mk-emmc-image.sh android12

For more information, please refer to #Packaging and creating an SD image

@@ Line 11: / Line 11: @@
 tools/repo sync -c  --no-clone-bundle
 </syntaxhighlight>
-=====FriendlyWrt 22.03.2=====
+=====FriendlyWrt 23.05=====
 <syntaxhighlight lang="bash">
-mkdir friendlywrt22-rk3588
+mkdir friendlywrt23-rk3588
-cd friendlywrt22-rk3588
+cd friendlywrt23-rk3588
 git clone https://github.com/friendlyarm/repo --depth 1 tools
-tools/repo init -u https://github.com/friendlyarm/friendlywrt_manifests -b master-v22.03 \
+tools/repo init -u https://github.com/friendlyarm/friendlywrt_manifests -b master-v23.05 \
          -m rk3588.xml --repo-url=https://github.com/friendlyarm/repo  --no-clone-bundle
 tools/repo sync -c  --no-clone-bundle
@@ Line 59: / Line 59: @@
 make -j1 V=s
 </syntaxhighlight>
+===Build Buildroot===
+please refer to: [[Buildroot|Buildroot]]
 ===Build Other Linux===
@@ Line 76: / Line 79: @@
 |-
 | buildroot
-| rowspan="12" | linux v5.10.y
+| linux v5.10.y
-| rowspan="12" | u-boot <br />v2017.09
+| rowspan="14" | u-boot <br />v2017.09
-| rowspan="12" | 11.3-aarch64
+| rowspan="14" | 11.3-aarch64
-| rowspan="12" | [https://github.com/friendlyarm/sd-fuse_rk3588/blob/master/prebuilt/parameter.template GPT]
+| [https://github.com/friendlyarm/sd-fuse_rk3588/blob/master/prebuilt/parameter.template GPT]
-| rowspan="12" | [https://github.com/friendlyarm/sd-fuse_rk3588/tree/master sd-fuse]
+| [https://github.com/friendlyarm/sd-fuse_rk3588/tree/master sd-fuse]
-| rowspan="12" | [https://github.com/friendlyarm/kernel-rockchip/tree/nanopi5-v5.10.y_opt nanopi5-v5.10.y_opt]
+| [https://github.com/friendlyarm/kernel-rockchip/tree/nanopi5-v5.10.y_opt nanopi5-v5.10.y_opt]
-| rowspan="8" | nanopi6_linux_defconfig
+| rowspan="10" | nanopi6_linux_defconfig
-| rowspan="12" | [https://github.com/friendlyarm/uboot-rockchip/tree/nanopi6-v2017.09 nanopi6-v2017.09]
+| rowspan="14" | [https://github.com/friendlyarm/uboot-rockchip/tree/nanopi6-v2017.09 nanopi6-v2017.09]
-| rowspan="12" | rk3588_defconfig
+| rowspan="14" | nanopi6_defconfig
+|-
+| openmediavault-arm64
+| rowspan="13" | linux v6.1.y
+| [https://github.com/friendlyarm/sd-fuse_rk3588/blob/kernel-6.1.y/prebuilt/parameter-ext4.txt GPT]
+| rowspan="13" | [https://github.com/friendlyarm/sd-fuse_rk3588/tree/kernel-6.1.y sd-fuse]
+| rowspan="13" | [https://github.com/friendlyarm/kernel-rockchip/tree/nanopi6-v6.1.y nanopi6-v6.1.y]
 |-
 | ubuntu-jammy-desktop-arm64
+| rowspan="12" | [https://github.com/friendlyarm/sd-fuse_rk3588/blob/kernel-6.1.y/prebuilt/parameter.template GPT]
 |-
 | ubuntu-jammy-minimal-arm64
+|-
+| ubuntu-jammy-x11-desktop-arm64
+|-
+| ubuntu-focal-desktop-arm64
 |-
 | friendlycore-focal-arm64
 |-
-| debian-bullseye-core-arm64
+| debian-bookworm-core-arm64
 |-
 | debian-bullseye-desktop-arm64
 |-
 | debian-bullseye-minimal-arm64
-|-
-| debian-buster-desktop-arm64
 |-
 | friendlywrt21
@@ Line 105: / Line 117: @@
 | friendlywrt21-docker
 |-
-| friendlywrt22
+| friendlywrt23
 |-
-| friendlywrt22-docker
+| friendlywrt23-docker
 |}
 * Kernel git repo：https://github.com/friendlyarm/kernel-rockchip
 * U-boot git repo：https://github.com/friendlyarm/uboot-rockchip
 * The cross-compile toolchain is located in the path: /opt/FriendlyARM/toolchain/
-* The [https://github.com/friendlyarm/sd-fuse_rk3588/tree/master sd-fuse] is a  helper script to make bootable SD card image.
+* The [https://github.com/friendlyarm/sd-fuse_rk3588/tree/kernel-6.1.y sd-fuse] is a  helper script to make bootable SD card image.
-====Build kernel linux-v5.10.y====
+====Build kernel linux-v6.1.y====
 Clone the repository to your local drive then build:
 <syntaxhighlight lang="bash">
-git clone https://github.com/friendlyarm/kernel-rockchip --single-branch --depth 1 -b nanopi5-v5.10.y_opt kernel-rockchip
+git clone https://github.com/friendlyarm/kernel-rockchip --single-branch --depth 1 -b nanopi6-v6.1.y kernel-rockchip
 cd kernel-rockchip
 export PATH=/opt/FriendlyARM/toolchain/11.3-aarch64/bin/:$PATH
@@ Line 160: / Line 172: @@
 |-
 | uboot.img
-| rk3588_spl_loader_v1.08.111.bin (aka MiniLoaderAll.bin)
+| rk3588_spl_loader_xx.yy.zzz.bin (aka MiniLoaderAll.bin)
 |}
 Run your build: <br>
@@ Line 200: / Line 212: @@
 If you want to update u-boot:
 <syntaxhighlight lang="bash">
-dd if=boot.img of=/dev/mmcblk2p1 bs=1M
+dd if=uboot.img of=/dev/mmcblk2p1 bs=1M
 </syntaxhighlight>
 To update new driver modules, copy the newly compiled driver modules to the appropriate directory under /lib/modules.
@@ Line 217: / Line 229: @@
 ! Packaging Tool
 |-
-| linux v5.10.y
+| linux v6.1.y
-| [https://github.com/friendlyarm/sd-fuse_rk3588/tree/master sd-fuse_rk3588]
+| [https://github.com/friendlyarm/sd-fuse_rk3588/tree/kernel-6.1.y sd-fuse_rk3588]
 |}
 =====USB flashing=====
 ======Linux======
-To flash U-Boot and kernel using the "upgrade_tool" tool, please use the following command:
+Reboot the board and enter loader mode with the following command:
 <syntaxhighlight lang="bash">
-sudo upgrade_tool ul MiniLoaderAll.bin
+sudo reboot loader
-sudo upgrade_tool di -p parameter.txt
+</syntaxhighlight>
-sudo upgrade_tool di uboot uboot.img
+To flash U-Boot and kernel using the "upgrade_tool_v2.17_for_linux" tool, please use the following command:
-sudo upgrade_tool di resource resource.img
+<syntaxhighlight lang="bash">
-sudo upgrade_tool di kernel kernel.img
+sudo upgrade_tool di -k kernel.img
+sudo upgrade_tool di -re resource.img
+sudo upgrade_tool di -u uboot.img
 sudo upgrade_tool RD
 </syntaxhighlight>
 Note: "upgrade_tool" is a command-line tool provided by Rockchip for Linux operating systems (Linux_Upgrade_Tool).
 ===Build the code using scripts===
 ====Download scripts and image files====
 <syntaxhighlight lang="bash">
-git clone https://github.com/friendlyarm/sd-fuse_rk3588.git --single-branch -b master
+git clone https://github.com/friendlyarm/sd-fuse_rk3588.git --single-branch -b kernel-6.1.y
 cd sd-fuse_rk3588
 tar xvzf /path/to/netdrive/03_Partition\ image\ files/friendlycore-focal-arm64-images.tgz
@@ Line 243: / Line 256: @@
 Download the kernel source code and compile it. the relevant image files in the friendlycore-focal-arm64 directory will be automatically updated, including the kernel modules in the file system:
 <syntaxhighlight lang="bash">
-git clone https://github.com/friendlyarm/kernel-rockchip --depth 1 -b nanopi5-v5.10.y_opt kernel-rk3588
+git clone https://github.com/friendlyarm/kernel-rockchip --depth 1 -b nanopi6-v6.1.y kernel-rk3588
 KERNEL_SRC=$PWD/kernel-rk3588 ./build-kernel.sh friendlycore-focal-arm64
+</syntaxhighlight>
+====Compile the kernel headers====
+<syntaxhighlight lang="bash">
+git clone https://github.com/friendlyarm/kernel-rockchip --depth 1 -b nanopi6-v6.1.y kernel-rk3588
+MK_HEADERS_DEB=1 BUILD_THIRD_PARTY_DRIVER=0 KERNEL_SRC=$PWD/kernel-rk3588 ./build-kernel.sh friendlycore-focal-arm64
 </syntaxhighlight>
 ====Compile the uboot====
@@ Line 275: / Line 293: @@
 git pull
 </syntaxhighlight>
-====Tablet profile build====
+====Tablet profile build (First Build)====
 <syntaxhighlight lang="bash">
 echo "ROCKCHIP_DEVICE_DIR := device/rockchip/rk3588/nanopi6" > .rockchip_device.mk
@@ Line 282: / Line 300: @@
 ./build.sh -FMu
 </syntaxhighlight>
-====TV profile build====
+====TV profile build (First Build)====
 <syntaxhighlight lang="bash">
 echo "ROCKCHIP_DEVICE_DIR := device/rockchip/rk3588/nanopi6_box" > .rockchip_device.mk
@@ Line 288: / Line 306: @@
 . setenv.sh
 ./build.sh -FMu
+</syntaxhighlight>
+====Second build====
+<syntaxhighlight lang="bash">
+# export INSTALL_GAPPS_FOR_TESTING=yes  # include google apps
+. setenv.sh
+make
+./build.sh -Mu
 </syntaxhighlight>
 ====Running your AOSP build====