Difference between revisions of "Rockchip Kernel"

From Rockchip open source Document
Jump to: navigation, search
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
  
In your linux SDK root directory. enter to kernel directory. 
+
== Download Kernel ==
<pre>cd kernel
+
 
 +
You can clone the rockchip kernel repository from github which is kernel 4.4 based:
 +
<pre>git clone https://github.com/rockchip-linux/kernel.git</pre>
 +
 
 +
&nbsp;
 +
 
 +
= Supported SoCs and Devices =
 +
 
 +
Rockchip kernel 4.4 supports:
 +
 
 +
RK3036, RK3066, RK312X, RK3188, RK322X,[http://opensource.rock-chips.com/wiki_RK3288 RK3288],&nbsp;[http://opensource.rock-chips.com/wiki_RK3328 RK3328], RK3368,&nbsp;[http://opensource.rock-chips.com/wiki_RK3399 RK3399], PX30
 +
 
 +
&nbsp;
 +
 
 +
= Configure and Build =
 +
 
 +
You will need to use rockchip_linux_defconfig for Linux OS
 +
 
 +
For ARM v7
 +
<pre>make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- rockchip_linux_defconfig
 +
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- -j4
 
</pre>
 
</pre>
  
Config your kernel.
+
For ARM V8
 +
<pre>make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- rockchip_linux_defconfig
 +
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- -j4</pre>
  
For ARM v7: RK3288
+
Then you can get Image/zImage and dtb file and used for LInux Distro boot.
<pre>make ARCH=arm32 rockchip_linux_defconfig
+
 
 +
'''Rockchip RKIMG format image'''
 +
 
 +
RKIMG is a format customized by Rockchip from Android boot image, usually only used by kernel developers. It's support by Rockchip&nbsp; U-Boot.
 +
 
 +
For example, build for rk3399-evb with&nbsp;command:
 +
<pre>make rk3399-evb.img</pre>
 +
 
 +
The output will be as below, boot.img is ramdisk with rockchip header, kernel is zImage/Image with rockchip header, resource is dtb and boot logo with rockchip header.
 +
<pre>kernel/
 +
├── boot.img
 +
├── kernel.img
 +
└── resource.img</pre>
 +
 
 +
 
 +
= Install Boot/kernel for Distro =
 +
 
 +
We use distro boot in U-Boot, so we need to make a boot partition for U-Boot with kernel image and dtb inside.
 +
<pre>mkdir boot
 +
cp arch/arm64/boot/dts/rockchip/rk3399-evb.dtb boot/rk3399.dtb
 +
cp arch/arm64/boot/Image boot/</pre>
 +
 
 +
Add&nbsp;[http://opensource.rock-chips.com/images/6/60/Boot_extlinux.zip extlinux/extlinux.conf]&nbsp;for distro boot.
 +
<pre>mkdir boot/extlinux
 +
vi boot/extlinux/extlinux.conf</pre>
 +
 
 +
&nbsp;
 +
<pre>label rockchip-kernel-4.4
 +
    kernel /Image
 +
    fdt /rk3399.dtb
 +
    append earlycon=uart8250,mmio32,0xff1a0000 root=PARTUUID=B921B045-1D rootwait rootfstype=ext4 init=/sbin/init</pre>
 +
 
 +
For armv7
 +
<pre>label rockchip-kernel-4.4
 +
    kernel /zImage
 +
    fdt /rk3288.dtb
 +
    append earlyprintk console=ttyS2,1500000n8 rw root=PARTUUID=69dad710-2c rootwait rootfstype=ext4 init=/sbin/init</pre>
 +
 
 +
You need to change the base address of debug UART, root partition for your board.
 +
 
 +
Pls reference to&nbsp;[http://opensource.rock-chips.com/wiki_Partitions rockchip Linux parttion definition]&nbsp;for rootfs partition and where boot to flash.
 +
 
 +
After all these files prepare completely, we write the file to the boot partition
 +
 
 +
Folder tree for armv8(rk3399, rk3328):
 +
<pre>boot
 +
├── extlinux
 +
│  └── extlinux.conf
 +
├── Image
 +
└── rk3399-evb.dtb</pre>
 +
 
 +
Folder tree for armv7(rk3288), rootfs is optional, and we usually use compressed 'zImage':
 +
<pre>boot_rk3288/
 +
├── extlinux
 +
│  └── extlinux.conf
 +
├── rk3288-evb-rk808.dtb
 +
├── rootfs.cpio.gz
 +
└── zImage
 
</pre>
 
</pre>
  
For ARM V8: RK3399, RK3328
+
== Generate ext2fs&nbsp;boot partition ==
<pre>make ARCH=arm64 rockchip_linux_defconfig
+
 
</pre>
+
by genext2fs:
 +
<pre>genext2fs -b 32768 -B $((32*1024*1024/32768)) -d boot/ -i 8192 -U boot_rk3399.img</pre>
 +
 
 +
According to Rockchip partition definition, you need to flash this image to boot partiton which offset is 0x8000.
 +
 
 +
&nbsp;
 +
 
 +
== Generate fatfs boot partition ==
 +
 
 +
=== Generate boot.img in fatfs ===
 +
 
 +
Below commands can generate a fatfs boot.img
 +
<pre>dd if=/dev/zero of=boot.img bs=1M count=32
 +
sudo mkfs.fat boot.img
 +
mkdir tmp
 +
sudo mount boot.img tmp/
 +
cp -r boot/* tmp/
 +
umount tmp</pre>
 +
 
 +
Done!
  
For RK3399&nbsp;sapphire-excavator board, VS-RK3399 board,&nbsp;Rock960 board. Use below command to build the kernel:&nbsp;
+
Flash this boot.img to boot partition, which is offset 0x8000 in Rockchip partition definition.
<pre>./make.sh evb-rk3399
 
</pre>
 
  
For firefly-rk3399&nbsp;board. Use below command to build the kernel:&nbsp;
+
=== Update boot.img via U-Boot in target ===
<pre>./make.sh firefly-rk3399
 
</pre>
 
  
For firefly-rk3288 board. Use below command to build the kernel:&nbsp;
+
After flash and&nbsp;boot the U-Boot, write the gpt table from default partition table
<pre>./make.sh firefly-rk3288
+
<pre>gpt write mmc 0 $partitions
</pre>
+
gpt verify mmc 0 $partitions</pre>
  
For rk3288-evb-act8846&nbsp;board. Use below command to build the kernel:&nbsp;
+
connect target to PC and start the ums in command line:
<pre>./make.sh evb-rk3288
+
<pre>ums 0 mmc 1:6</pre>
</pre>
 
  
For rk3288-evb-rk808&nbsp;board. Use below command to build the kernel:&nbsp;
+
We should able to see a device connect to PC, formate and copy data into the partition(dev/sdb6 for example).
<pre>./make.sh fennec-rk3288
+
<pre>sudo mkfs.fat /dev/sdb6
 +
cp -r boot/* /media/machine/9F35-9565/
 
</pre>
 
</pre>
  
For rk3288 tinker&nbsp;board. Use below command to build the kernel:&nbsp;
+
Done!
<pre>./make.sh tinker-rk3288
 
</pre>
 
  
For phytec-rk3288&nbsp;board. Use below command to build the kernel:&nbsp;
+
&nbsp;
<pre>./make.sh phycore-rk3288
 
</pre>
 
  
For rk3288 miqi&nbsp;board. Use below command to build the kernel:&nbsp;
 
<pre>./make.sh miqi-rk3288
 
</pre>
 
  
It will generate 2 binary image: kernel.img, resource.img.&nbsp;
+
== Boot from U-Boot ==
  
kernel image: Please flash this binary to kernel partition
+
If you are using genext2fs to genarate the boot.img, you need write the gpt table in U-Boot command line:
 +
<pre>gpt write mmc 0 $partitions</pre>
  
resource image: it contain kernel dtb. Please flash this binary to resource partition
+
Then boot from eMMC or reset:
 +
<pre>boot</pre>
  
See [[Rockchip_Kernel|Rockchip kernel]] for more detail.
+
If everything is OK, you should able to see the U-Boot log like this:
 +
<pre>switch to partitions #0, OK
 +
mmc0(part 0) is current device
 +
Scanning mmc 0:6...
 +
Found /extlinux/extlinux.conf
 +
Retrieving file: /extlinux/extlinux.conf
 +
205 bytes read in 82 ms (2 KiB/s)
 +
1:      upstream-4.10
 +
Retrieving file: /Image
 +
13484040 bytes read in 1833 ms (7 MiB/s)
 +
append: earlycon=uart8250,mmio32,0xff1a0000 console=ttyS2,1500000n8 rw root=PARTUUID=B921B045-1D rootwait rootfstype=ext4 init=/sbin/init
 +
Retrieving file: /rk3399.dtb
 +
61714 bytes read in 54 ms (1.1 MiB/s)
 +
## Flattened Device Tree blob at 01f00000
 +
  Booting using the fdt blob at 0x1f00000
 +
  Loading Device Tree to 000000007df14000, end 000000007df26111 ... OK
  
&nbsp;
+
Starting kernel ...</pre>

Latest revision as of 10:08, 2 September 2019

Download Kernel

You can clone the rockchip kernel repository from github which is kernel 4.4 based:

git clone https://github.com/rockchip-linux/kernel.git

 

Supported SoCs and Devices

Rockchip kernel 4.4 supports:

RK3036, RK3066, RK312X, RK3188, RK322X,RK3288RK3328, RK3368, RK3399, PX30

 

Configure and Build

You will need to use rockchip_linux_defconfig for Linux OS

For ARM v7

make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- rockchip_linux_defconfig
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- -j4

For ARM V8

make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- rockchip_linux_defconfig
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- -j4

Then you can get Image/zImage and dtb file and used for LInux Distro boot.

Rockchip RKIMG format image

RKIMG is a format customized by Rockchip from Android boot image, usually only used by kernel developers. It's support by Rockchip  U-Boot.

For example, build for rk3399-evb with command:

make rk3399-evb.img

The output will be as below, boot.img is ramdisk with rockchip header, kernel is zImage/Image with rockchip header, resource is dtb and boot logo with rockchip header.

kernel/
├── boot.img
├── kernel.img
└── resource.img


Install Boot/kernel for Distro

We use distro boot in U-Boot, so we need to make a boot partition for U-Boot with kernel image and dtb inside.

mkdir boot
cp arch/arm64/boot/dts/rockchip/rk3399-evb.dtb boot/rk3399.dtb
cp arch/arm64/boot/Image boot/

Add extlinux/extlinux.conf for distro boot.

mkdir boot/extlinux
vi boot/extlinux/extlinux.conf

 

label rockchip-kernel-4.4
    kernel /Image
    fdt /rk3399.dtb
    append earlycon=uart8250,mmio32,0xff1a0000 root=PARTUUID=B921B045-1D rootwait rootfstype=ext4 init=/sbin/init

For armv7

label rockchip-kernel-4.4
    kernel /zImage
    fdt /rk3288.dtb
    append earlyprintk console=ttyS2,1500000n8 rw root=PARTUUID=69dad710-2c rootwait rootfstype=ext4 init=/sbin/init

You need to change the base address of debug UART, root partition for your board.

Pls reference to rockchip Linux parttion definition for rootfs partition and where boot to flash.

After all these files prepare completely, we write the file to the boot partition

Folder tree for armv8(rk3399, rk3328):

boot
├── extlinux
│   └── extlinux.conf
├── Image
└── rk3399-evb.dtb

Folder tree for armv7(rk3288), rootfs is optional, and we usually use compressed 'zImage':

boot_rk3288/
├── extlinux
│   └── extlinux.conf
├── rk3288-evb-rk808.dtb
├── rootfs.cpio.gz
└── zImage

Generate ext2fs boot partition

by genext2fs:

genext2fs -b 32768 -B $((32*1024*1024/32768)) -d boot/ -i 8192 -U boot_rk3399.img

According to Rockchip partition definition, you need to flash this image to boot partiton which offset is 0x8000.

 

Generate fatfs boot partition

Generate boot.img in fatfs

Below commands can generate a fatfs boot.img

dd if=/dev/zero of=boot.img bs=1M count=32
sudo mkfs.fat boot.img
mkdir tmp
sudo mount boot.img tmp/
cp -r boot/* tmp/
umount tmp

Done!

Flash this boot.img to boot partition, which is offset 0x8000 in Rockchip partition definition.

Update boot.img via U-Boot in target

After flash and boot the U-Boot, write the gpt table from default partition table

gpt write mmc 0 $partitions
gpt verify mmc 0 $partitions

connect target to PC and start the ums in command line:

ums 0 mmc 1:6

We should able to see a device connect to PC, formate and copy data into the partition(dev/sdb6 for example).

sudo mkfs.fat /dev/sdb6
cp -r boot/* /media/machine/9F35-9565/

Done!

 


Boot from U-Boot

If you are using genext2fs to genarate the boot.img, you need write the gpt table in U-Boot command line:

gpt write mmc 0 $partitions

Then boot from eMMC or reset:

boot

If everything is OK, you should able to see the U-Boot log like this:

switch to partitions #0, OK
mmc0(part 0) is current device
Scanning mmc 0:6...
Found /extlinux/extlinux.conf
Retrieving file: /extlinux/extlinux.conf
205 bytes read in 82 ms (2 KiB/s)
1:      upstream-4.10
Retrieving file: /Image
13484040 bytes read in 1833 ms (7 MiB/s)
append: earlycon=uart8250,mmio32,0xff1a0000 console=ttyS2,1500000n8 rw root=PARTUUID=B921B045-1D rootwait rootfstype=ext4 init=/sbin/init
Retrieving file: /rk3399.dtb
61714 bytes read in 54 ms (1.1 MiB/s)
## Flattened Device Tree blob at 01f00000
   Booting using the fdt blob at 0x1f00000
   Loading Device Tree to 000000007df14000, end 000000007df26111 ... OK

Starting kernel ...