Difference between revisions of "Buildroot"
Line 185: | Line 185: | ||
./build.sh rootfs | ./build.sh rootfs | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | === | + | ===Customize File System=== |
− | + | Put your files in the friendlyelec/rk3399/fs-overlay-64 directory and recompile "rootfs" | |
− | === | + | ===Update U-boot and Kernel=== |
− | + | You can do it by directly updating the files in the u-boot and kernel directories. | |
− | === | + | ===Use Cross Compiler in SDK=== |
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
export PATH=$PWD/buildroot/output/rockchip_rk3399/host/bin/:$PATH | export PATH=$PWD/buildroot/output/rockchip_rk3399/host/bin/:$PATH | ||
aarch64-buildroot-linux-gnu-g++ -v | aarch64-buildroot-linux-gnu-g++ -v | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | + | Version information:<br /> | |
gcc 版本 6.4.0 (Buildroot 2018.02-rc3-g4f000a0797) | gcc 版本 6.4.0 (Buildroot 2018.02-rc3-g4f000a0797) | ||
− | === | + | ===Cross Compile Qt Program=== |
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
git clone https://github.com/friendlyarm/QtE-Demo.git | git clone https://github.com/friendlyarm/QtE-Demo.git |
Revision as of 08:46, 16 May 2019
Contents
1 Introduction to Buildroot
Buildroot is a simple, efficient and easy-to-use tool to generate embedded Linux systems through cross-compilation. It contains a boot-loader, kernel, rootfs, various libraries and utilities(e.g. qt, gstreamer, busybox etc).
FriendlyELEC's Buildroot is based on Rockchip's version which is made with linux-sdk and maintained with git. FriendlyELEC's version is synced with Rockchip's version;
- Rockchip's Buildroot: https://github.com/rockchip-linux/buildroot
- Buildroot's official site: https://buildroot.org
2 Download Images of Trial Version
Visit Download LinkDownload:
Image Files | |
rk3399-sd-buildroot-linux-4.4-arm64-YYYYMMDD.img.zip | OS image booting from SD card |
rk3399-eflasher-buildroot-YYYYMMDD.img.zip | Image used to flash to eMMC |
After extract the file you can use either dd or the win32image utility to flash the image to an SD card.
3 User Name and Password
User name: root
Password: rockchip
4 Obtain Source Code
4.1 Install repo Utility
Install the repo utility:
git clone https://github.com/friendlyarm/repo cp repo/repo /usr/bin/
4.2 Download Source Code
You can retrieve a project's source code in either of the following two ways. The first works better with Mainland Chinese users:
4.2.1 1: Retrieve Repo Package from Cloud Storage
Download link: Click to enter
File location: sources/linuxsdk-friendlyelec-YYYYMMDD.tar (YYYYMMDD stands for the data when the package is generated)
After you get a tar package, untar it and run the following command to extract it:
tar xvf /path/to/netdisk/sources/linuxsdk-friendlyelec-YYYYMMDD.tar cd linuxsdk-friendlyelec repo sync -l
If you want to get the latest official source code you can run the following commands:
cd linuxsdk-friendlyelec repo sync
4.2.2 2: Retrive Repo Package from Github
mkdir linuxsdk-friendlyelec cd linuxsdk-friendlyelec repo init -u https://github.com/friendlyarm/buildroot_manifests -b master -m rk3399_linux_release.xml --repo-url=https://github.com/rockchip-linux/repo repo sync -c
4.2.3 Get Latest Version with Sync
cd linuxsdk-friendlyelec repo sync -c
If your network connection is broken during sync you can run the following script to do it:
#! /bin/bash repo sync -c while [ $? -ne 0 ]; do repo sync -c done
5 Compile Source Code
5.1 Setup Compilation Environment
Under Ubuntu on a host PC run the following command:
sudo apt-get install repo 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 python-linaro-image- tools linaro-image-tools autoconf autotools-dev libsigsegv2 m4 intltool libdrm-dev curl sed make binutils build-essential gcc g++ bash patch gzip bzip2 perl tar cpio python unzip rsync file bc wget libncurses5 libqt4-dev libglib2.0-dev libgtk2.0-dev libglade2-dev cvs git mercurial rsync openssh- client subversion asciidoc w3m dblatex graphviz python-matplotlib libc6:i386 libssl-dev texinfo liblz4-tool genext2fs lib32stdc++6
5.2 Auto Compilation
./build.sh
5.3 Compile Partial Code
5.3.1 kernel
./build.sh kernel
5.3.2 u-boot
./build.sh uboot
5.3.3 rootfs
./build.sh rootfs
5.4 Generate Image for SD Card
sudo ./build.sh sd-img
Flash an image to an SD card:
./friendlyelec/rk3399/sd-fuse_rk3399/fusing.sh /dev/sdX buildroot
The "/dev/sdX" needs to be replaced with your actual SD card device name.
5.5 Generate Image for EMMC(Eflasher)
sudo ./build.sh emmc-img
5.6 Check Help Info
# ./build.sh help ====USAGE: build.sh modules==== uboot -build uboot kernel -build kernel rootfs -build default rootfs, currently build buildroot as default buildroot -build buildroot rootfs ramboot -build ramboot image yocto -build yocto rootfs, currently build ros as default ros -build ros rootfs debian -build debian rootfs pcba -build pcba recovery -build recovery all -build uboot, kernel, rootfs, recovery image cleanall -clean uboot, kernel, rootfs, recovery firmware -pack all the image we need to boot up system updateimg -pack update image sd-img -pack sd-card image, used to create bootable SD card emmc-img -pack sd-card image, used to install buildroot to emmc save -save images, patches, commands used to debug default -build all module
Comments on popular parameters:
uboot -compile uboot only
kernel -compile kernel only
rootfs -compile buildroot only
buildroot -compile buildroot only
sdimg -generate an image which can be flashed to an SD card with the "dd" command and to eMMC with eFlasher
6 Customize Buildroot
6.1 Structure of Directories
├── linuxsdk-friendlyelec │ ├── app │ ├── buildroot buildroot's root directory │ ├── build.sh -> device/rockchip/common/build.sh script for auto-compilation │ ├── device configuration files │ ├── distro debian's root directory │ ├── docs documents │ ├── envsetup.sh -> buildroot/build/envsetup.sh │ ├── external │ ├── friendlyelec configuration files for FriendlyElec's RK3399 │ ├── kernel kernel │ ├── Makefile -> buildroot/build/Makefile │ ├── mkfirmware.sh -> device/rockchip/common/mkfirmware.sh script to update rockdev │ ├── prebuilts │ ├── rkbin │ ├── rkflash.sh -> device/rockchip/common/rkflash.sh flashing script │ ├── rootfs directory of debian's root file system │ ├── tools tools and utilities for flashing and packaging │ └── u-boot u-boot
6.1.1 Update Buildroot Configurations
- List Available Configurations
cd buildroot make list-defconfigs
Here is what you would get:
rockchip_rk3399_defconfig - Build for rockchip_rk3399
- Update Configurations Using menuconfig
make rockchip_rk3399_defconfig make menuconfig make savedefconfig diff .defconfig configs/rockchip_rk3399_defconfig cp .defconfig configs/rockchip_rk3399_defconfig
- Recompile
cd ../ ./build.sh rootfs
6.2 Customize File System
Put your files in the friendlyelec/rk3399/fs-overlay-64 directory and recompile "rootfs"
6.3 Update U-boot and Kernel
You can do it by directly updating the files in the u-boot and kernel directories.
6.4 Use Cross Compiler in SDK
export PATH=$PWD/buildroot/output/rockchip_rk3399/host/bin/:$PATH aarch64-buildroot-linux-gnu-g++ -v
Version information:
gcc 版本 6.4.0 (Buildroot 2018.02-rc3-g4f000a0797)
6.5 Cross Compile Qt Program
git clone https://github.com/friendlyarm/QtE-Demo.git cd QtE-Demo ../buildroot/output/rockchip_rk3399/host/bin/qmake QtE-Demo.pro make
要实现开机自动运行你的Qt程序,可将QtE-Demo拷贝到开发板上,然后修改 /etc/init.d/下的S50launcher,将/usr/local/QLauncher/QLauncher &这一行改为QtE-Demo的文件路径即可。
7 常见问题
7.1 如何获取用于USB Type-C烧写的文件?
执行 build.sh emmc-img 之后,在 friendlyelec/rk3399/sd-fuse_rk3399 下面会有一个 buildroot 目录,使用android_tools工具加载这个目录下的文件即可。