Template:RK3399-BuildFromSource/zh
Contents
1 Linux系统编译
1.1 各个OS对应的内核与u-boot版本
| 操作系统 | 内核版本 | uboot版本 | 交叉编译器 | 分区类型 | 构建脚本 | 内核代码分支 | 内核配置 | uboot代码分支 | uboot配置 |
|---|---|---|---|---|---|---|---|---|---|
| lubuntu | linux v4.4.y | u-boot v2014.10 | 6.4-aarch64 |
MBR | sd-fuse | nanopi4-linux-v4.4.y | nanopi4_linux_defconfig | nanopi4-v2014.10_oreo | rk3399_defconfig |
| friendlycore-arm64 | |||||||||
| friendlydesktop-arm64 | |||||||||
| eflasher | |||||||||
| buildroot | linux v4.19.y | u-boot v2017.09 |
11.3-aarch64 | GPT | sd-fuse | nanopi4-v4.19.y | nanopi4_linux_defconfig | nanopi4-v2017.09 | rk3399_defconfig |
| debian-buster-desktop-arm64 | |||||||||
| debian-bullseye-core-arm64 | |||||||||
| debian-bullseye-desktop-arm64 | |||||||||
| debian-bullseye-minimal-arm64 | |||||||||
| friendlycore-focal-arm64 | |||||||||
| friendlycore-lite-focal-kernel4-arm64 | |||||||||
| friendlywrt21-kernel4 | nanopi4_linux_defconfig friendlywrt.config | ||||||||
| friendlycore-lite-focal-kernel5-arm64 | linux v5.15.y | u-boot v2017.09 |
11.3-aarch64 | GPT | sd-fuse |
nanopi-r2-v5.15.y | nanopi4_linux_defconfig | nanopi4-v2017.09 |
rk3399_defconfig |
| friendlywrt21 | nanopi4_linux_defconfig friendlywrt.config | ||||||||
| friendlywrt21-docker | |||||||||
| friendlywrt22 | |||||||||
| friendlywrt22-docker |
- 内核源代码仓库地址：https://github.com/friendlyarm/kernel-rockchip
- u-boot源代码仓库地址：https://github.com/friendlyarm/uboot-rockchip
- 交叉编译工具链存放在如下路径： /opt/FriendlyARM/toolchain/，使用前需导出到PATH环境变量,例如需要使用11.3-aarch64版本的编译器，使用如下命令:
export PATH=/opt/FriendlyARM/toolchain/11.3-aarch64/bin/:$PATH
- sd-fuse构建脚本可以用于快速编译kernel和uboot、重新打包sd卡固件与卡刷固件等
- 点击表格中的MBR与GPT可查看各系统的分区布局(配置文件)
1.2 编译内核linux-v4.4.y
本节内容适用于如下OS:
| lubuntu | eflasher | friendlydesktop-arm64 | friendlycore-arm64 |
下载源代码并编译:
git clone https://github.com/friendlyarm/kernel-rockchip --single-branch --depth 1 -b nanopi4-linux-v4.4.y kernel-rockchip cd kernel-rockchip export PATH=/opt/FriendlyARM/toolchain/6.4-aarch64/bin/:$PATH touch .scmversion # 配置内核 make ARCH=arm64 CROSS_COMPILE=aarch64-linux- nanopi4_linux_defconfig # 启动配置界面 # make ARCH=arm64 CROSS_COMPILE=aarch64-linux- menuconfig # 编译内核 make ARCH=arm64 CROSS_COMPILE=aarch64-linux- nanopi4-images -j$(nproc) # 编译驱动模块 mkdir -p out-modules make ARCH=arm64 CROSS_COMPILE=aarch64-linux- INSTALL_MOD_PATH="$PWD/out-modules" modules -j$(nproc) make ARCH=arm64 CROSS_COMPILE=aarch64-linux- INSTALL_MOD_PATH="$PWD/out-modules" modules_install KERNEL_VER=$(make CROSS_COMPILE=aarch64-linux-gnu- ARCH=arm64 kernelrelease) rm -rf $PWD/out-modules/lib/modules/${KERNEL_VER}/kernel/drivers/gpu/arm/mali400/ [ ! -f "$PWD/out-modules/lib/modules/${KERNEL_VER}/modules.dep" ] && depmod -b $PWD/out-modules -E Module.symvers -F System.map -w ${KERNEL_VER} (cd $PWD/out-modules && find . -name \*.ko | xargs aarch64-linux-strip --strip-unneeded)
编译完会生成如下文件:
| kernel.img | resource.img | 驱动模块位于out-modules目录 |
安装内核:
请参考 #下载uboot与内核到目标板
1.3 编译u-boot v2014.10
本节内容适用于如下OS:
| lubuntu | eflasher | friendlydesktop-arm64 | friendlycore-arm64 |
下载源代码并编译:
git clone https://github.com/friendlyarm/uboot-rockchip --single-branch --depth 1 -b nanopi4-v2014.10_oreo cd uboot-rockchip export PATH=/opt/FriendlyARM/toolchain/6.4-aarch64/bin/:$PATH make CROSS_COMPILE=aarch64-linux- rk3399_defconfig make CROSS_COMPILE=aarch64-linux-
编译完成后会生成如下文件:
| uboot.img | trust.img | rk3399_loader_v1.22.119.bin (打包时改名为MiniLoaderAll.bin) |
安装u-boot:
请参考 #下载uboot与内核到目标板
1.4 编译内核linux-v4.19.y
本节内容适用于如下OS:
| debian-buster-desktop-arm64 | debian-bullseye-core-arm64 | debian-bullseye-desktop-arm64 | debian-bullseye-minimal-arm64 |
| friendlycore-focal-arm64 | friendlycore-lite-focal-kernel4-arm64 | friendlywrt21-kernel4 | buildroot |
下载源代码并编译:
git clone https://github.com/friendlyarm/kernel-rockchip --single-branch --depth 1 -b nanopi4-v4.19.y kernel-rockchip cd kernel-rockchip export PATH=/opt/FriendlyARM/toolchain/11.3-aarch64/bin/:$PATH touch .scmversion # 配置内核 # option1: 加载Linux系统配置 make ARCH=arm64 CROSS_COMPILE=aarch64-linux- nanopi4_linux_defconfig # option2: 加载FriendlyWrt系统配置 # make ARCH=arm64 CROSS_COMPILE=aarch64-linux- nanopi4_linux_defconfig friendlywrt.config # 启动配置界面 # make ARCH=arm64 CROSS_COMPILE=aarch64-linux- menuconfig # 编译内核 make ARCH=arm64 CROSS_COMPILE=aarch64-linux- nanopi4-images -j$(nproc) # 编译驱动模块 mkdir -p out-modules make ARCH=arm64 CROSS_COMPILE=aarch64-linux- INSTALL_MOD_PATH="$PWD/out-modules" modules -j$(nproc) make ARCH=arm64 CROSS_COMPILE=aarch64-linux- INSTALL_MOD_PATH="$PWD/out-modules" modules_install KERNEL_VER=$(make CROSS_COMPILE=aarch64-linux-gnu- ARCH=arm64 kernelrelease) rm -rf $PWD/out-modules/lib/modules/${KERNEL_VER}/kernel/drivers/gpu/arm/mali400/ [ ! -f "$PWD/out-modules/lib/modules/${KERNEL_VER}/modules.dep" ] && depmod -b $PWD/out-modules -E Module.symvers -F System.map -w ${KERNEL_VER} (cd $PWD/out-modules && find . -name \*.ko | xargs aarch64-linux-strip --strip-unneeded)
编译完会生成如下文件:
| kernel.img | resource.img | 驱动模块位于out-modules目录 |
安装内核:
请参考 #下载uboot与内核到目标板
1.5 编译内核linux-v5.15.y
本节内容适用于如下OS:
| friendlywrt21 | friendlywrt21-docker | friendlywrt22 | friendlywrt22-docker | friendlycore-lite-focal-kernel5-arm64 |
下载源代码并编译:
git clone https://github.com/friendlyarm/kernel-rockchip --single-branch --depth 1 -b nanopi-r2-v5.15.y kernel-rockchip cd kernel-rockchip export PATH=/opt/FriendlyARM/toolchain/11.3-aarch64/bin/:$PATH touch .scmversion # 配置内核 # option1: 加载Linux系统配置 make CROSS_COMPILE=aarch64-linux-gnu- ARCH=arm64 nanopi4_linux_defconfig # option2: 加载FriendlyWrt系统配置 # make CROSS_COMPILE=aarch64-linux-gnu- ARCH=arm64 nanopi4_linux_defconfig friendlywrt.config # 启动配置界面 # make CROSS_COMPILE=aarch64-linux-gnu- ARCH=arm64 menuconfig # 编译内核 make CROSS_COMPILE=aarch64-linux-gnu- ARCH=arm64 -j$(nproc) # 编译驱动模块 mkdir -p out-modules && rm -rf out-modules/* make CROSS_COMPILE=aarch64-linux-gnu- ARCH=arm64 INSTALL_MOD_PATH="$PWD/out-modules" modules -j$(nproc) make CROSS_COMPILE=aarch64-linux-gnu- ARCH=arm64 INSTALL_MOD_PATH="$PWD/out-modules" modules_install KERNEL_VER=$(make CROSS_COMPILE=aarch64-linux-gnu- ARCH=arm64 kernelrelease) [ ! -f "$PWD/out-modules/lib/modules/${KERNEL_VER}/modules.dep" ] && depmod -b $PWD/out-modules -E Module.symvers -F System.map -w ${KERNEL_VER} (cd $PWD/out-modules && find . -name \*.ko | xargs aarch64-linux-strip --strip-unneeded)
打包kernel.img与resource.img:
wget https://raw.githubusercontent.com/friendlyarm/sd-fuse_rk3399/kernel-5.15.y/tools/mkkrnlimg && chmod 755 mkkrnlimg wget https://raw.githubusercontent.com/friendlyarm/sd-fuse_rk3399/kernel-5.15.y/tools/resource_tool && chmod 755 resource_tool wget https://raw.githubusercontent.com/friendlyarm/sd-fuse_rk3399/kernel-5.15.y/prebuilt/boot/logo.bmp wget https://raw.githubusercontent.com/friendlyarm/sd-fuse_rk3399/kernel-5.15.y/prebuilt/boot/logo_kernel.bmp ./mkkrnlimg arch/arm64/boot/Image kernel.img mkdir kernel-dtbs cp -f arch/arm64/boot/dts/rockchip/rk3399-nanopi-r4s.dtb kernel-dtbs/rk3399-nanopi4-rev09.dtb cp -f arch/arm64/boot/dts/rockchip/rk3399-nanopi-r4s.dtb kernel-dtbs/rk3399-nanopi4-rev0a.dtb cp -f arch/arm64/boot/dts/rockchip/rk3399-nanopi-r4se.dtb kernel-dtbs/rk3399-nanopi4-rev0b.dtb cp -f arch/arm64/boot/dts/rockchip/rk3399-nanopc-t4.dtb kernel-dtbs/rk3399-nanopi4-rev00.dtb ./resource_tool --dtbname kernel-dtbs/*.dtb logo.bmp logo_kernel.bmp
完成后会得到如下文件:
| kernel.img | resource.img | 驱动模块位于out-modules目录 |
安装内核:
请参考 #下载uboot与内核到目标板
1.6 编译u-boot v2017.09
本节内容适用于如下OS:
| debian-buster-desktop-arm64 | debian-bullseye-core-arm64 | debian-bullseye-desktop-arm64 | debian-bullseye-minimal-arm64 |
| friendlycore-focal-arm64 | friendlycore-lite-focal-kernel4-arm64 | friendlywrt21-kernel4 | buildroot |
下载源代码并编译:
git clone https://github.com/friendlyarm/rkbin --single-branch --depth 1 -b friendlyelec git clone https://github.com/friendlyarm/uboot-rockchip --single-branch --depth 1 -b nanopi4-v2017.09 export PATH=/opt/FriendlyARM/toolchain/11.3-aarch64/bin/:$PATH cd uboot-rockchip/ ./make.sh nanopi4
编译完成后会生成如下文件:
| uboot.img | trust.img | rk3399_loader_v1.24.126.bin (打包时改名为MiniLoaderAll.bin) |
安装u-boot:
请参考 #下载uboot与内核到目标板
1.7 应用新编译的uboot与内核
1.7.1 安装到目标板
1.7.1.1 MBR分区
本节内容适用于如下OS:
| lubuntu | eflasher | friendlydesktop-arm64 | friendlycore-arm64 |
目前只有linux v4.4内核使用MBR分区，需要参考此链接的partmap文件，计算各分区的偏移地址，用dd命令将img文件写入到相应位置，例如parameter.template文件内容中"0x00014000@0x00014000(kernel)"表示kernel.img的位置位于0x00014000，转换成10进制就是81920, 相应的dd命令如下所示：
dd if=kernel.img of=/dev/mmcblk0 seek=81920
1.7.1.2 GPT分区
本节内容适用于如下OS:
| debian-buster-desktop-arm64 | debian-bullseye-core-arm64 | debian-bullseye-desktop-arm64 | debian-bullseye-minimal-arm64 |
| friendlycore-focal-arm64 | friendlycore-lite-focal-kernel4-arm64 | friendlywrt21-kernel4 | buildroot |
| friendlywrt21 | friendlywrt21-docker | friendlywrt22 | friendlywrt22-docker |
linux v4.19内核和linux v5.15内核的系统默认使用GPT分区, 可以用dd命令直接将image文件烧写至image对应的分区，SD卡与eMMC的设备节点如下：
- SD/TF Card设备节点为 /dev/mmcblk0
- eMMC设备节点为 /dev/mmcblk2
下面将演示如何将内核更新到eMMC:
使用parted命令查看分区布局:
parted /dev/mmcblk2 print
得到如下输出：
Model: MMC BJTD4R (sd/mmc) Disk /dev/mmcblk2: 31.3GB Sector size (logical/physical): 512B/512B Partition Table: gpt Disk Flags: Number Start End Size File system Name Flags 1 8389kB 12.6MB 4194kB uboot 2 12.6MB 16.8MB 4194kB trust 3 16.8MB 21.0MB 4194kB misc 4 21.0MB 25.2MB 4194kB dtbo 5 25.2MB 41.9MB 16.8MB resource 6 41.9MB 83.9MB 41.9MB kernel 7 83.9MB 134MB 50.3MB boot 8 134MB 2500MB 2366MB ext4 rootfs 9 2500MB 31.3GB 28.8GB ext4 userdata
resource分区的序号为5, kernel分区的序号为6，对应的设备节点为/dev/mmcblk2p5和/dev/mmcblk2p6, dd命令如下:
dd if=resource.img of=/dev/mmcblk2p5 bs=1M dd if=kernel.img of=/dev/mmcblk2p6 bs=1M
如果要更新uboot：
dd if=boot.img of=/dev/mmcblk2p1 bs=1M
如果要更新内核驱动模块，将新驱动模块目录上传并替换以下目录下的文件即可：/lib/modules。
1.7.2 打包新的SD Image
sd-fuse 提供一些工具和脚本, 用于制作SD卡固件, 具体用途如下:
- 制作分区镜像文件, 例如将rootfs目录打包成rootfs.img
- 将多个分区镜像文件打包成可直接写SD卡的单一镜像文件
- 简化内核和uboot的编译, 一键编译内核、第三方驱动, 并更新rootfs.img中的内核模块
请根据所用的内核版本点击对应的链接了解详细的使用方法：
| 内核版本 | 构建脚本 |
|---|---|
| linux v4.4.y | sd-fuse |
| linux v4.19.y | sd-fuse |
| linux v5.15.y | sd-fuse |
1.7.3 线刷
1.7.3.1 Linux系统
用upgrade_tool工具烧写uboot与内核, 命令如下所示：
sudo upgrade_tool ul MiniLoaderAll.bin sudo upgrade_tool di -p parameter.txt sudo upgrade_tool di uboot uboot.img sudo upgrade_tool di trust trust.img sudo upgrade_tool di resource resource.img sudo upgrade_tool di kernel kernel.img sudo upgrade_tool RD
注：upgrade_tool是Rockchip提供的Linux下的命令行工具（Linux_Upgrade_Tool）
2 Android系统编译
2.1 编译Android10
2.1.1 下载Android10源代码
有以下两种途径获取 Android10 的源代码，都需要联网:
- 使用网盘里的git repo压缩包
网盘下载地址: 点击进入
文件位于网盘的以下路径：07_源代码/rk3399-android-10.git-YYYYMMDD.tar.xz (YYYYMMDD表示打包的日期)
从网盘中获取的压缩包在解压之后，需要执行一下 sync.sh 脚本，会从gitlab上拉取最新的代码：
tar xf /path/to/netdisk/07_源代码/rk3399-android-10.git-YYYYMMDD.tar.xz cd rk3399-android-10 ./sync.sh
注意: 如果遇到“error: unknown option `recurse-submodules'”，请升级git至v2.0.0或以上版本。
- 直接克隆git仓库
{{{1}}} 源代码托管在 gitlab 上，使用以下命令进行下载：
git clone --recursive https://gitlab.com/friendlyelec/rk3399-android-10.git -b main
2.1.2 编译并生成Image文件
编译Android 10建议使用普通用户登录，运行以下命令编译：
cd rk3399-android-10 ./build-nanopc-t4.sh -F -M
如果需要包含google apps，需要设置一个环境变量再编译，如下所示：
cd rk3399-android-10 export INSTALL_GAPPS_FOR_TESTING=yes ./build-nanopc-t4.sh -F -M
2.1.3 编译OTA Packages
如果需要A/B (Seamless) System Updates的支持，需要先进行以下定制:
a) 搭建自己的更新服务器
b) 定制packages/apps/Updater使其适配自己的更新服务
定制完成后，使用快速编译脚本参数-O或--ota可编译OTA Packages，如下所示:
cd rk3399-android-10 ./build-nanopc-t4.sh -F -O -M
编译成功完成后，OTA更新相关的包位于目录 rockdev/otapackage/ ，请保留此目录。
当完成了某些修改后使用参数-O 再次编译将会生成ota-update-XXXXXXXX.zip，这是增量更新包。
OTA Packages依赖BUILD_NUMBER, 只有它有变化才会生成增量更新包，缺省的生成规则请查看build-nanopc-t4.sh。
修改 device/rockchip/rk3399/nanopc-t4/BoardConfig.mk 中
BOARD_USES_AB_IMAGE := false可禁用 A/B 特性，然后重新编译(包括u-boot和android)。
2.1.4 更新系统为自已编译的Image
编译完成后，image文件会存放在Android10源代码目录的 rockdev/Image-nanopc_t4/ 子目录下，参考以下步骤更新到 {{{1}}}上：
1) 将 EFlasher 启动SD卡 通过读卡器插入电脑，电脑上的Ubuntu系统会自动挂载 SD卡的分区;
2) 我们需要将 rockdev/Image-nanopc_t4/ 子目录下的所有文件，拷贝并覆盖到 SD卡 FRIENDLYARM 分区里的 android10 目录;
3) 将SD卡插入{{{1}}}，重新烧写Andorid系统即可;
也可参考这个github仓库的方法来更新：sd-fuse_rk3399
烧写Android 10时EFlasher 需要 v1.3 或以上版本，通过Type-C烧写时请使用rockchip提供的工具AndroidTool v2.71 或Linux_Upgrade_Tool v1.49 。
2.2 编译Android8.1
2.2.1 下载Android8.1源代码
有以下两种途径获取 Android8.1 的源代码，都需要联网:
- 使用网盘里的git repo压缩包
网盘下载地址: 点击进入
文件位于网盘的以下路径：sources/rk3399-android-8.1.git-YYYYMMDD.tgz (YYYYMMDD表示打包的日期)
从网盘中获取的压缩包在解压之后，需要执行一下 sync.sh 脚本，会从gitlab上拉取最新的代码：
tar xvzf /path/to/netdisk/sources/rk3399-android-8.1.git-YYYYMMDD.tgz cd rk3399-android-8.1 ./sync.sh
- 直接克隆git仓库
{{{1}}} 源代码托管在 gitlab 上，使用以下命令进行下载：
git clone https://gitlab.com/friendlyelec/rk3399-android-8.1 --depth 1 -b master
2.2.2 编译并生成Image文件
使用以下命令编译：
cd rk3399-android-8.1 ./build-nanopc-t4.sh -F -M
2.2.3 更新系统为自已编译的Image
编译完成后，image文件会存放在Android8.1源代码目录的 rockdev/Image-nanopc_t4/ 子目录下，参考以下步骤更新到 {{{1}}}上：
1) 将 EFlasher 启动SD卡 通过读卡器插入电脑，电脑上的Ubuntu系统会自动挂载 SD卡的分区;
2) 我们需要将 rockdev/Image-nanopc_t4/ 子目录下的所有文件，拷贝并覆盖到 SD卡 FRIENDLYARM 分区里的 android8 目录;
3) 将SD卡插入{{{1}}}，重新烧写Andorid系统即可;
也可参考这个github仓库的方法来更新：sd-fuse_rk3399
2.3 编译Android7源代码
2.3.1 下载Android7源代码
有以下两种途径获取 Android7 的源代码，都需要联网:
- 使用网盘里的git repo压缩包
网盘下载地址: 点击进入
文件位于网盘的以下路径：sources/rk3399-android-7.git-YYYYMMDD.tgz (YYYYMMDD表示打包的日期)
从网盘中获取的 repo 压缩包在解压之后，需要执行一下 sync.sh 脚本，会从gitlab上拉取最新的代码：
tar xvzf /path/to/netdisk/sources/rk3399-android-7.git-20181228.tgz cd rk3399-nougat ./sync.sh
- 直接克隆git仓库
{{{1}}} 源代码托管在 gitlab 上，使用以下命令进行下载：
git clone https://gitlab.com/friendlyelec/rk3399-nougat --depth 1 -b nanopc-t4-nougat
2.3.2 编译并生成Image文件
使用以下命令编译：
cd rk3399-nougat ./build-nanopc-t4.sh -F -M
2.3.3 更新系统为自已编译的Image
编译完成后，image文件会存放在Android7源代码目录的 rockdev/Image-nanopc_t4/ 子目录下，参考以下步骤更新到 {{{1}}}上：
1) 将 EFlasher 启动SD卡 通过读卡器插入电脑，电脑上的Ubuntu系统会自动挂载 SD卡的分区;
2) 我们需要将 rockdev/Image-nanopc_t4/ 子目录下的所有文件，拷贝并覆盖到 SD卡 FRIENDLYARM 分区里的 nougat 目录;
3) 将SD卡插入{{{1}}}，重新烧写Andorid系统即可;
也可参考这个github仓库的方法来更新：sd-fuse_rk3399
