Rock3/dev/Debian

English

    ROCK 3 >  Development >  Build Debian

build:
- Some script files and configuration files for building u-boot, kernel and rootfs.
kernel:
- kernel source code, current version is 4.19.193.
rkbin:
- Prebuilt Rockchip binaries, include first stage loader and ATF(Arm Trustzone Firmware).
rootfs:
- Bootstrap a Debian based rootfs, support architechture armhf and arm64, support Debian Jessie, Stretch and Buster.
u-boot:
- u-boot as the second stage bootloader

Update the source code

The rockchip-bsp will be updated all the time, so you can update the source before building the system image.

cd rockchip-bsp
git checkout stable-4.19-rock3
git fetch origin
git rebase origin/stable-4.19-rock3
git submodule update

Install toolchain from Linaro

wget https://releases.linaro.org/components/toolchain/binaries/7.3-2018.05/aarch64-linux-gnu/gcc-linaro-7.3.1-2018.05-x86_64_aarch64-linux-gnu.tar.xz
sudo tar xvf gcc-linaro-7.3.1-2018.05-x86_64_aarch64-linux-gnu.tar.xz  -C /usr/local/
export CROSS_COMPILE=/usr/local/gcc-linaro-7.3.1-2018.05-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-
export PATH=/usr/local/gcc-linaro-7.3.1-2018.05-x86_64_aarch64-linux-gnu/bin:$PATH

Check if Linaro toolchain is the default choice:

which aarch64-linux-gnu-gcc
/usr/local/gcc-linaro-7.3.1-2018.05-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-gcc

Install other build tools

sudo apt-get install gcc-aarch64-linux-gnu device-tree-compiler libncurses5 libncurses5-dev build-essential libssl-dev mtools
sudo apt-get install bc python dosfstools

Build u-boot

Need to checkout branch to stable-4.19-rock3.

Build u-boot with default rock-3-a-rk3568_defconfig.

./build/mk-uboot.sh rk3568-rock-3-a     #For ROCK 3-A

The generated images will be copied to out/u-boot folder

ls out/u-boot/
idbloader.img  rk356x_spl_loader_ddr1056_v1.06.110.bin  spi  u-boot.itb

Apply u-boot

1. you shou check file in out/u-boot should be like this:

ls out/u-boot/
idbloader.img  rk356x_spl_loader_ddr1056_v1.06.110.bin  spi  u-boot.itb

2. flash u-boot to you storage

sudo dd if=./idbloader.img of=/path/to/storage/device bs=512 seek=64
sudo dd if=./u-boot.itb of=/path/to/storage/device bs=512 seek=16384

Build kernel

Need to checkout branch to stable-4.19-rock3.

Build kernel with default rockchip_linux_defconfig.

./build/mk-kernel.sh rk3568-rock-3-a    #For ROCK 3 A

Change kernel config(optional)

Optionally, if you want to change the default kernel config

cd kernel
export ARCH=arm64
export CROSS_COMPILE=aarch64-linux-gnu-
make rockchip_linux_defconfig
make menuconfig
cp defconfig arch/arm64/configs/rockchip_linux_defconfig
cd ..
./build/mk-kernel.sh rk3568-rock-3-a    #For ROCK 3 A

You will get the kernel image and dtb file

ls out/kernel/
Image  rk3568-rock-3-a.dtb

Build kernel deb package (optional)

The kernel package build can pack the kernel, device tree, modules and firmware into Debian packages, which makes it easier to install on the ROCK 3.

./build/pack-kernel.sh -d rockchip_linux_defconfig -r 1 # rockchip_linux_defconfig: kernel defconfig; 1: release number

The generated packages will be copied to out/packages direcotry.

$ ls out/packages/
linux-4.19.193-1-rockchip-g6bcb15a5b2d0_4.19.193-1-rockchip_arm64.changes
linux-headers-4.19.193-1-rockchip-g6bcb15a5b2d0_4.19.193-1-rockchip_arm64.deb
linux-image-4.19.193-1-rockchip-g6bcb15a5b2d0_4.19.193-1-rockchip_arm64.deb
linux-image-4.19.193-1-rockchip-g6bcb15a5b2d0-dbg_4.19.193-1-rockchip_arm64.deb
linux-libc-dev_4.19.193-1-rockchip_arm64.deb

When you want to install specified kernel packages to your OS, try the following steps.

copy linux-image-4.19.193-1-rockchip-*_arm64.deb and linux-firmware-image-4.19.193-1-rockchip-*_arm64.deb to your ROCK 3.

Install them on ROCK 3.

# dpkg -i linux-headers-4.19.193-1-rockchip-*_arm64.deb
# dpkg -i linux-image-4.19.193-1-rockchip-*_arm64.deb

Make rootfs image

Check out the rootfs source. The repository is https://github.com/radxa/rk-rootfs-build.git and the branch is rockchip-debian.

To build 32bit rootfs:

export ARCH=armhf

To build 64bit rootfs:

export ARCH=arm64

Building a base debian system by ubuntu-build-service from linaro.

cd rootfs
sudo apt-get install binfmt-support qemu-user-static cpio gdisk
sudo dpkg -i ubuntu-build-service/packages/*        # ignore the broken dependencies, we will fix it next step
sudo apt-get install -f
RELEASE=buster TARGET=desktop ARCH=arm64 ./mk-base-debian.sh

This will bootstrap a Debian Buster image, you will get a rootfs tarball named linaro-buster-alip-xxxx.tar.gz.

Building the rk-debian rootfs.

RELEASE=buster ARCH=arm64 ./mk-rootfs.sh

Creating the ext4 image(linaro-rootfs.img):

./mk-image.sh

Combine everything into one image

./build/mk-image.sh -c rk3568 -t system -r rootfs/linaro-rootfs.img

This will combine u-boot, kernel and rootfs into one image and generate GPT partition table. Output is

out/system.img

Flash the image

FAQs

1.For system image built from rockchip-bsp, what is the user name and password?

The user name is linaro and the password is linaro.

2.For kernel source code, debug serial console is disabled for ROCK 3 boards including ROCK 3A, ROCK 3B, Boards based on Radxa CM3 core board, etc.

To enable it, we need to add the following patch to your target dts.

&fiq_debugger {
    status = "okay";
};

Troubleshooting

Check ROCK 3 FAQs first, if it doesn't help, start a new post on the forum https://forum.radxa.com/c/rock3.