Rock3/dev/Debian
ROCK 3 > Development > Build Debian
Contents
- 1 Rockchip Debian SDK
- 1.1 Get the source code
- 1.2 Update the source code
- 1.3 Install toolchain from Linaro
- 1.4 Install other build tools
- 1.5 Build u-boot
- 1.6 Apply u-boot
- 1.7 Build kernel
- 1.8 Build kernel deb package (optional)
- 1.9 Make rootfs image
- 1.10 Combine everything into one image
- 1.11 Flash the image
- 1.12 FAQs
- 1.13 Troubleshooting
Rockchip Debian SDK
Below is the instructions of how to build image for ROCK 3 on a HOST PC.
Get the source code
You need Git to get multiple git repositories to build the image.
Install Git if you don't have it.
sudo apt-get update sudo apt-get install git
Clone the source code
git clone -b stable-4.19-rock3 https://github.com/radxa/rockchip-bsp.git cd rockchip-bsp git submodule init git submodule update
You will get
build kernel README.md rkbin rootfs u-boot
Directories usage introductions:
- 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 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.
Troubleshooting
Check ROCK 3 FAQs first, if it doesn't help, start a new post on the forum https://forum.radxa.com/c/rock3.