Revision as of 05:03, 21 January 2021

    ROCK Pi E >  Development >  Build Debian

Rockchip Debian SDK

Below is the instructions of how to build image for ROCK Pi E 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.4-rockpie 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.4.154.
• 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 and Stretch.
• u-boot:
  • u-boot as the second stage bootloader

Update the source code

   cd rockchip-bsp
   git checkout stable-4.4-rockpie
   git fetch origin
   git rebase origin/stable-4.4-rockpie
   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.4-rockpie.

Build u-boot with default rock-pi-e-rk3328_defconfig.

   ./build/mk-uboot.sh rockpie     #For ROCK Pi E

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

   ls out/u-boot/
   idbloader.img  rk3328_loader_ddr333_v1.16.250.bin  trust.img  uboot.img

Build kernel

Need to checkout branch to stable-4.4-rockpie.

Build kernel with default rockchip_linux_defconfig.

   ./build/mk-kernel.sh rockpie    #For ROCK Pi E

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 rockpie    #For ROCK Pi E

You will get the kernel image and dtb file

   ls out/kernel/
   Image  rk3328-rock-pi-e.dtb

Make rootfs image

Check out the rootfs source. The repository is https://github.com/radxa/rk-rootfs-build.git and the branch is 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 rk3328 -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

When install system image, system.img to uSD card, need APP Etcher or tool dd.

FAQs

1.I have built one ROCK Pi E system image using rockchip-bsp SDK. With an USB to TTL serial cable connected with UART2 pins (pin#10, pin#8, ping#6 on 40-PIN Header) on ROCK Pi E, the last one line of system logs is shown as follows.

   [    0.932225] bootconsole [uart0] disabled

In fact the system starts up. If your ROCK Pi E system supports Ethernet/WiFi and SSH, you can access ROCK Pi E via SSH.

If you read the kernel command line of system log, you will find that the default console is ttyS2 (1500000n8). But due to uart2 is disabled by default in file rk3328-rock-pi-e.dts, there will be no more system logs on the screen.

To enable console ttyS2, you need to enable uart2 node. Add the following lines at the end of file rk3328-rock-pi-e.dts.

   &uart2 {
       status = "okay";
   };

Troubleshooting

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