Admin: Created page with "
= Overall = This guide provides information which will help you get started with rockchip opensource linux. If you have any questions, please report to us on g..."

2017-12-08T02:25:33Z

Created page with " = Overall = This guide provides information which will help you get started with rockchip opensource linux. If you have any questions, please report to us on g..."

New page

= Overall =

This guide provides information which will help you get started with rockchip opensource linux. If you have any questions, please report to us on github project issue page.

We are providing 3 ways to build rootfs including prebuilt Debian, Yocto, Buildroot. <del>You can choose the way you prefer</del>. '''(Please check the [[Status_Matrix|Software Status]] because different chips have a different support)'''

You will need below firmware/image for a full Linux OS and flash them to different locations:

*U-Boot SPL/Rockchip miniloader  *U-Boot  *boot(including kernel, dtb and config file)  *rootfs(Debian, Ubuntu, etc.) 

Before starting to develop, please refer to '''[[Board_Config|board config]] '''and'' '''''[http://opensource.rock-chips.com/wiki_FAQ#How_to_select_board_config how-to]''' to choose a most matching config as the foundation.

 

= Environment =

Note that our development environment is Ubuntu, you can use 16.04 or later version(with downgraded arm gcc).

Debian-9  and [https://github.com/rockchip-linux/docker-rockchip Docker-Rockchip] are also available.

'''Ubuntu 14.04 is ''deprecated, we don't guarantee that Linux SDK can work on it.'''''

Here are some necessary packages for building the project.
<pre>$ sudo apt-get install git-core gitk git-gui gcc-arm-linux-gnueabihf u-boot-tools device-tree-compiler gcc-aarch64-linux-gnu mtools parted libudev-dev libusb-1.0-0-dev libssl-dev pv e2fsprogs build-essential fakeroot devscripts</pre>

If you insist on developing on your own environment, please make sure the version of gcc-arm-linux-gnueabihf and gcc-aarch64-linux-gnu is less than 6.

= Getting the Sources =

The rockchip linux SDK source tree is located in multi Git repository hosted by Github. The SDK uses repo to sync down source code.

 Create an empty directory to hold your working files.

 
<pre>mkdir rk-linux cd rk-linux </pre>

To initialize Linux SDK source tree, you need to get repo first

 

 
<pre>sudo apt-get install repo </pre>

Basic Linux SDK(standalone kernel/u-boot/rootfs)

 

 
<pre>repo init --repo-url=https://github.com/rockchip-linux/repo -u https://github.com/rockchip-linux/manifests -b master repo sync </pre>

Yocto

 

 
<pre>repo init --repo-url=https://github.com/rockchip-linux/repo -u https://github.com/rockchip-linux/manifests -b yocto repo sync </pre>

Buildroot

 

 
<pre>repo init --repo-url=https://github.com/rockchip-linux/repo -u https://github.com/rockchip-linux/manifests -b buildroot repo sync </pre>

 

Below guides are based on basic Linux SDK, guides for yocto/buildroot could be found in the separate page.

 

= Quick start =

'''ref : [[Partitions|partition]], [[Rockusb|rockusb]], [[Boot_option|boot]]'''

We have provide [https://github.com/rockchip-linux/build build scripts] which essentially wraps the commands, so you can quickly start your development by them.

Please note that those scripts are assumed your directory structure is same with the one created by manifest. We use rk3288-firefly as example. You can change rk3288-firefly to any other board supported(ie. rk3399-firefly)

'''compile kernel'''

 
<pre>build/mk-kernel.sh rk3288-firefly </pre>

'''compile uboot'''

 

 
<pre>build/mk-uboot.sh rk3288-firefly </pre>

 

'''Pack all parts to a complete image'''

`s` is size in Mbyte, `r` is your rootfs image ([http://opensource.rock-chips.com/wiki_Debian prebuilt debian image]) location. Here we use rk3288 as example. You can change it to any other supported chips(ie. rk3399, rk3328).
<pre>build/mk-image.sh -c rk3288 -t system -r rk-debian-build/linaro-rootfs.img </pre>

'''flash image'''

eMMC (Ensure the board is in maskrom mode. [http://opensource.rock-chips.com/wiki_Rockusb#Maskrom_mode maskrom], Not [http://opensource.rock-chips.com/wiki_Rockusb#Miniloader_Rockusb.C2.A0mode rockusb]! ):
<pre>build/flash_tool.sh -c rk3288 -p system -i out/system.img </pre>

SD Card: `d` is your target device
<pre>build/flash_tool.sh -c rk3288 -p loader -i out/u-boot/idbloader.img -d /dev/sdb </pre>

'''bringup(burn kernel, uboot, gpt)'''

 
<pre>build/mk-kernel.sh rk3288-firefly build/mk-uboot.sh rk3288-firefly build/mk-image.sh -c rk3288 -t system -r rk-debian-build/linaro-rootfs.img build/flash_tool.sh -p system -i out/system.img</pre>

'''update kernel'''

 

 
<pre>build/mk-kernel.sh rk3288-firefly build/flash_tool.sh -p boot -i out/boot.img </pre>

'''update uboot (armv7)'''

 

 
<pre>build/mk-uboot.sh rk3288-firefly build/flash_tool.sh -p loader1 -i out/u-boot/idbloader.img </pre>

'''update uboot(armv8 with miniloader)'''

 

 
<pre>build/mk-uboot.sh rk3399-excavator build/flash_tool.sh -p loader1 -i out/u-boot/idbloader.img build/flash_tool.sh -p loader2 -i out/u-boot/uboot.img build/flash_tool.sh -p atf -i out/u-boot/trust.img </pre>

 

Before asking questions, please, read references and follow the setp by setp guide to boot your device.

It's better if you can study those build scripts.

Please refer to [https://github.com/rockchip-linux/rkbin/tree/master/tools/AndroidTool_Release_v2.39 AndroidFlashTool](TODO: wiki) for flashing image on Windows. (For the first time, it's recommended to use a linux host, to save the time.）

= Step By Step =

== Building the sources ==

=== Building uboot ===

Installing the build tools and download source

Compile the Uboot
<pre>CROSS_COMPILE=arm-linux-gnueabihf- make evb-rk3288_defconfig all </pre>

You can get spl/u-boot-spl.bin(if there is) and u-boot.bin when build complete, we will use these files to generate idb.img or uboot.img

See [[U-Boot|U-Boot]] page for more detail.

There are two feasible ways to boot to U-Boot. 1. RK SPL bin(DDR.bin, miniloader) 2. U-Boot SPL

See [[Boot_option|boot option]] page for more detail.

 

=== Building kernel ===

Compile the kernel:

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>

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>

You can get zImage/Image and dtbs when build complete， we will use these files to generate boot.img for boot partition.

See [[Rockchip_Kernel|Rockchip kernel]] for more detail.

 

=== Building rootfs ===

It's recommend to download [http://opensource.rock-chips.com/wiki_Debian prebuilt debian image] for bringup.

==== Debian ====

See [[Debian|debian-guide]] for detail.

You should get xxx-rootfs.img.

==== Yocto ====

See [[Yocto|yocto-user-guide]] for detail.

You should get xxx.ext4 rootfs image.

==== Buildroot ====

See [[Buildroot|buildroot-user-guide]] for detail.

You should get rootfs.img in this step for the Linux OS.

== Booting the Board ==

Then you can chose a suitable way for you to boot the board with flash all the image to media device.

*[[Boot_option#Boot_from_eMMC|''Booting from emmc'']]  *[[Boot_option#Boot_from_SD.2FTF_Card|''Booting from sdcard'']]  *[[Boot_option#Boot_from_USB-Disk|''Booting from udisk'']] 

 

= See also =

[[U-Boot|U-Boot guide]]

[[Rockchip_Kernel|Rockchip kernel guide]]

[[Yocto|Yocto guide]]

[[Buildroot|Buildroot guide]]

 

== Drivers ==

Display:

*[[EDP|eDP]]  *[[MIPI-DSI|MIPI-DSI]]  *[[LVDS|LVDS]]  *[[HDMI|HDMI]]  *[[HDCP|HDCP]] 

Graphic:

*[[Rga|RGA]]  *[[GPU|GPU]]  *[[VOP|VOP]] 

USB:

*[[USB_OTG|D]][[DWC2|WC2]]  *[[USB_HOST|D]][[DWC3|WC3]] 

Storage:

*[[EMMC|eMMC]]  *[[SD-Card|SD-Card]] 

Audio:

*[[HDMI-Audio|HDMI-Audio]]  *[[I2S|I2S]]  *[[SPDIF|SPDIF]] 

Connectivity:

*[[Wireless|Wireless]]  *[[Ethernet|Ethernet]] 

Others:

*[[PWM|PWM]]  *[[I2C|I2C]]  *[[SPI|SPI]]  *[[UART|UART]]  *[[Thermal|Thermal]]  *[[Clock|Clock]]  *[[DVFS|DVFS]]  *[[Suspend/Resume|Suspend/Resume]] 

 

== Customization ==

[[Boot_Time|Boot_Time]]

[[Boot_Logo|Boot_Logo]]

[[Image_Size|Image_Size]]

[[Firmware_Upgrade|Firmware_Upgrade]]

User:Admin - Revision history

Admin: Created page with " = Overall = This guide provides information which will help you get started with rockchip opensource linux. If you have any questions, please report to us on g..."

Admin: Created page with "
= Overall = This guide provides information which will help you get started with rockchip opensource linux. If you have any questions, please report to us on g..."