Difference between revisions of "Template:RK3399-BuildFromSource/zh"

From FriendlyELEC WiKi
Jump to: navigation, search
(updated by API)
(updated by API)
 
(37 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==如何编译系统==
+
===编译 Openwrt/Friendlywrt ===
===搭建编译环境===
+
====下载源代码====
搭建用于编译Android的环境,建议使用64位的Ubuntu 16.04,需要安装如下软件包:
+
FriendlyWrt有两个版本, 请根据需要进行选择.
 +
=====版本FriendlyWrt 21.02=====
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
sudo apt-get install bison g++-multilib git gperf libxml2-utils make python-networkx zip
+
mkdir friendlywrt21-rk3399
sudo apt-get install flex curl libncurses5-dev libssl-dev zlib1g-dev gawk minicom
+
cd friendlywrt21-rk3399
sudo apt-get install openjdk-8-jdk
+
git clone https://github.com/friendlyarm/repo --depth 1 tools
sudo apt-get install exfat-fuse exfat-utils device-tree-compiler liblz4-tool
+
tools/repo init -u https://github.com/friendlyarm/friendlywrt_manifests -b master-v21.02 \
 +
        -m rk3399.xml --repo-url=https://github.com/friendlyarm/repo  --no-clone-bundle
 +
tools/repo sync ---no-clone-bundle
 
</syntaxhighlight>
 
</syntaxhighlight>
更多说明可查看 https://source.android.com/source/initializing.html; <br />
+
=====版本FriendlyWrt 23.05=====
也可以使用Docker环境:[http://github.com/friendlyarm/friendlyelec-android-docker friendlyelec-android-docker]<br />
+
<syntaxhighlight lang="bash">
 +
mkdir friendlywrt23-rk3399
 +
cd friendlywrt23-rk3399
 +
git clone https://github.com/friendlyarm/repo --depth 1 tools
 +
tools/repo init -u https://github.com/friendlyarm/friendlywrt_manifests -b master-v23.05 \
 +
        -m rk3399.xml --repo-url=https://github.com/friendlyarm/repo  --no-clone-bundle
 +
tools/repo sync -c  --no-clone-bundle
 +
</syntaxhighlight>
 +
====首次编译====
 +
下面的命令是编译不带docker的版本, 如需要编译带docker的版本, 请将'''rk3399.mk'''替换为'''rk3399-docker.mk''':
 +
<syntaxhighlight lang="bash">
 +
./build.sh rk3399.mk
 +
</syntaxhighlight>
 +
会编译所有组件(包含u-boot, kernel 和 friendlywrt)并生成sd卡镜像文件,再执行以下命令,可生成用于安装系统到emmc运行的镜像文件(eflahser固件):
 +
<syntaxhighlight lang="bash">
 +
./build.sh emmc-img
 +
</syntaxhighlight>
 +
对项目进行过修改后, 需要重新打包sd卡镜像, 可执行如下命令:
 +
<syntaxhighlight lang="bash">
 +
./build.sh sd-img
 +
</syntaxhighlight>
 +
====二次编译====
 +
<syntaxhighlight lang="bash">
 +
cd friendlywrt
 +
make menuconfig #改动FriendlyWrt的配置
 +
rm -rf ./tmp
 +
make -j${nproc}
 +
cd ../
 +
./build.sh sd-img
 +
./build.sh emmc-img
 +
</syntaxhighlight>
 +
====单独编译u-boot====
 +
<syntaxhighlight lang="bash">
 +
./build.sh uboot
 +
</syntaxhighlight>
 +
====单独编译kernel====
 +
<syntaxhighlight lang="bash">
 +
./build.sh kernel
 +
</syntaxhighlight>
 +
====单独编译friendlywrt====
 +
<syntaxhighlight lang="bash">
 +
./build.sh friendlywrt
 +
</syntaxhighlight>
 +
或者进入friendlywrt目录, 按标准openwrt的命令操作, 上面的命令出现错误时, 可尝试使用以下命令单线程编译:
 +
<syntaxhighlight lang="bash">
 +
cd friendlywrt
 +
make -j1 V=s
 +
</syntaxhighlight>
 +
 
 +
===编译Buildroot===
 +
请参考: [[Buildroot/zh|Buildroot]]
  
===安装交叉编译器===
+
===其他Linux系统编译===
====安装aarch64-linux-gcc 6.4====
+
====各个OS对应的内核与u-boot版本====
该编译器可用来编译Linux系统的内核和u-boot,用以下命令下载并安装:
+
{| class="wikitable"
 +
|-
 +
! 操作系统
 +
! 内核版本
 +
! uboot版本
 +
! 交叉编译器
 +
! 分区类型
 +
! 构建工具集
 +
! 内核代码分支
 +
! 内核配置
 +
! uboot代码分支
 +
! uboot配置
 +
|-
 +
| lubuntu
 +
| rowspan="4" | linux v4.4.y
 +
| rowspan="4" | u-boot v2014.10
 +
| rowspan="4" | 6.4-aarch64<br />
 +
| rowspan="4" | [https://github.com/friendlyarm/sd-fuse_rk3399/blob/master/prebuilt/parameter.template MBR]
 +
| rowspan="4" | [https://github.com/friendlyarm/sd-fuse_rk3399/tree/master sd-fuse]
 +
| rowspan="4" | [https://github.com/friendlyarm/kernel-rockchip/tree/nanopi4-linux-v4.4.y nanopi4-linux-v4.4.y]
 +
| rowspan="4" | nanopi4_linux_defconfig
 +
| rowspan="4" | [https://github.com/friendlyarm/uboot-rockchip/tree/nanopi4-v2014.10_oreo nanopi4-v2014.10_oreo]
 +
| rowspan="4" | rk3399_defconfig<br /><br />
 +
|-
 +
| friendlycore-arm64
 +
|-
 +
| friendlydesktop-arm64
 +
|-
 +
| eflasher
 +
|-
 +
| buildroot
 +
| rowspan="7" | linux v4.19.y
 +
| rowspan="7" | u-boot <br />v2017.09
 +
| rowspan="7" | 11.3-aarch64
 +
| rowspan="7" | [https://github.com/friendlyarm/sd-fuse_rk3399/blob/kernel-4.19/prebuilt/parameter.template GPT]
 +
| rowspan="7" | [https://github.com/friendlyarm/sd-fuse_rk3399/tree/kernel-4.19 sd-fuse]
 +
| rowspan="7" | [https://github.com/friendlyarm/kernel-rockchip/tree/nanopi4-v4.19.y nanopi4-v4.19.y]
 +
| rowspan="7" | nanopi4_linux_defconfig
 +
| rowspan="12" | [https://github.com/friendlyarm/uboot-rockchip/tree/nanopi4-v2017.09 nanopi4-v2017.09]
 +
| rowspan="12" | nanopi4_defconfig
 +
|-
 +
| ubuntu-focal-desktop-arm64
 +
|-
 +
| debian-bullseye-desktop-arm64
 +
|-
 +
| debian-bullseye-minimal-arm64
 +
|-
 +
| friendlycore-focal-arm64
 +
|-
 +
| debian-bookworm-core-arm64
 +
|-
 +
| ubuntu-noble-core-arm64
 +
|-
 +
| openmediavault-arm64
 +
| rowspan="5" | linux v6.1.y
 +
| rowspan="5" | u-boot <br />v2017.09
 +
| rowspan="5" | 11.3-aarch64
 +
| [https://github.com/friendlyarm/sd-fuse_rk3399/blob/kernel-6.1.y/prebuilt/parameter-ext4.txt GPT]
 +
| rowspan="5" | [https://github.com/friendlyarm/sd-fuse_rk3399/tree/kernel-6.1.y<br /> sd-fuse]<br /><br /><br /><br />
 +
| rowspan="5" | [https://github.com/friendlyarm/kernel-rockchip/tree/nanopi-r2-v6.1.y nanopi-r2-v6.1.y]<br /><br /><br /><br />
 +
| nanopi4_linux_defconfig
 +
|-
 +
| friendlywrt21
 +
| rowspan="4" | [https://github.com/friendlyarm/sd-fuse_rk3399/blob/kernel-6.1.y/prebuilt/parameter.txt GPT]
 +
| rowspan="4" | nanopi4_linux_defconfig<br />+friendlywrt.config
 +
|-
 +
| friendlywrt21-docker
 +
|-
 +
| friendlywrt23
 +
|-
 +
| friendlywrt23-docker
 +
|}
 +
* 内核源代码仓库地址:https://github.com/friendlyarm/kernel-rockchip
 +
* u-boot源代码仓库地址:https://github.com/friendlyarm/uboot-rockchip
 +
* 交叉编译工具链存放在如下路径: /opt/FriendlyARM/toolchain/,使用前需导出到PATH环境变量,例如需要使用11.3-aarch64版本的编译器,使用如下命令:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
git clone https://github.com/friendlyarm/prebuilts.git -b master --depth 1
+
export PATH=/opt/FriendlyARM/toolchain/11.3-aarch64/bin/:$PATH
cd prebuilts/gcc-x64
+
cat toolchain-6.4-aarch64.tar.gz* | sudo tar xz -C /
+
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
* sd-fuse构建脚本可以用于快速编译kernel和uboot、重新打包sd卡固件与卡刷固件等
 +
* 点击表格中的MBR与GPT可查看各系统的分区布局(配置文件)
  
然后将编译器的路径加入到PATH中,用vi编辑vi ~/.bashrc,在末尾加入以下内容:
+
====编译内核linux-v4.4.y====
 +
本节内容适用于如下OS:
 +
{| class="wikitable"
 +
|-
 +
| lubuntu
 +
| eflasher
 +
| friendlydesktop-arm64
 +
| friendlycore-arm64
 +
|}
 +
下载源代码并编译:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
export PATH=/opt/FriendlyARM/toolchain/6.4-aarch64/bin:$PATH
+
git clone https://github.com/friendlyarm/kernel-rockchip --single-branch --depth 1 -b nanopi4-linux-v4.4.y kernel-rockchip
export GCC_COLORS=auto
+
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)
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
编译完会生成如下文件:
 +
{| class="wikitable"
 +
|-
 +
| kernel.img
 +
| resource.img
 +
| 驱动模块位于out-modules目录
 +
|}
 +
安装内核: <br>
 +
请参考 [[#应用新编译的uboot与内核]]<br>
  
执行一下~/.bashrc脚本让设置立即在当前shell窗口中生效,注意"."后面有个空格:
+
====编译u-boot v2014.10====
 +
本节内容适用于如下OS:
 +
{| class="wikitable"  
 +
|-
 +
| lubuntu
 +
| eflasher
 +
| friendlydesktop-arm64
 +
| friendlycore-arm64
 +
|}
 +
下载源代码并编译:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
. ~/.bashrc
+
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-
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
编译完成后会生成如下文件:
 +
{| class="wikitable"
 +
|-
 +
| uboot.img
 +
| trust.img
 +
| rk3399_loader_v1.22.119.bin (打包时改名为MiniLoaderAll.bin)
 +
|}
 +
安装u-boot: <br />
 +
请参考 [[#应用新编译的uboot与内核]]<br>
  
这个编译器是64位的,不能在32位的PC Linux系统上运行,安装完成后,用以下命令可以验证是否安装成功:
+
====编译内核linux-v4.19.y====
 +
本节内容适用于如下OS:
 +
{| class="wikitable"
 +
|-
 +
| ubuntu-focal-desktop-arm64
 +
| debian-bullseye-desktop-arm64
 +
| debian-bullseye-minimal-arm64
 +
| friendlycore-focal-arm64
 +
| ubuntu-noble-core-arm64
 +
| debian-bookworm-core-arm64
 +
| buildroot
 +
|}
 +
下载源代码并编译:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
aarch64-linux-gcc -v
+
git clone https://github.com/friendlyarm/kernel-rockchip --single-branch --depth 1 -b nanopi4-v4.19.y kernel-rockchip
Using built-in specs.
+
cd kernel-rockchip
COLLECT_GCC=aarch64-linux-gcc
+
export PATH=/opt/FriendlyARM/toolchain/11.3-aarch64/bin/:$PATH
COLLECT_LTO_WRAPPER=/opt/FriendlyARM/toolchain/6.4-aarch64/libexec/gcc/aarch64-cortexa53-linux-gnu/6.4.0/lto-wrapper
+
touch .scmversion
Target: aarch64-cortexa53-linux-gnu
+
# 配置内核
Configured with: /work/toolchain/build/aarch64-cortexa53-linux-gnu/build/src/gcc/configure --build=x86_64-build_pc-linux-gnu
+
# option1: 加载Linux系统配置
--host=x86_64-build_pc-linux-gnu --target=aarch64-cortexa53-linux-gnu --prefix=/opt/FriendlyARM/toolchain/6.4-aarch64
+
make ARCH=arm64 CROSS_COMPILE=aarch64-linux- nanopi4_linux_defconfig
--with-sysroot=/opt/FriendlyARM/toolchain/6.4-aarch64/aarch64-cortexa53-linux-gnu/sysroot --enable-languages=c,c++
+
# option2: 加载FriendlyWrt系统配置
--enable-fix-cortex-a53-835769 --enable-fix-cortex-a53-843419 --with-cpu=cortex-a53
+
# make ARCH=arm64 CROSS_COMPILE=aarch64-linux- nanopi4_linux_defconfig friendlywrt.config
...
+
# 启动配置界面
Thread model: posix
+
# make ARCH=arm64 CROSS_COMPILE=aarch64-linux- menuconfig
gcc version 6.4.0 (ctng-1.23.0-150g-FA)
+
# 编译内核
 +
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)
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
编译完会生成如下文件:
 +
{| class="wikitable"
 +
|-
 +
| kernel.img
 +
| resource.img
 +
| 驱动模块位于out-modules目录
 +
|}
 +
安装内核: <br>
 +
请参考 [[#应用新编译的uboot与内核]]<br>
 +
====编译内核linux-v6.1.y====
 +
本节内容适用于如下OS:
 +
{| class="wikitable"
 +
|-
 +
| friendlywrt21
 +
| friendlywrt21-docker
 +
| friendlywrt23
 +
| friendlywrt23-docker
 +
| openmediavault-arm64
 +
|}
 +
下载源代码并编译:
 +
<syntaxhighlight lang="bash">
 +
git clone https://github.com/friendlyarm/kernel-rockchip --single-branch --depth 1 -b nanopi-r2-v6.1.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)
 +
</syntaxhighlight>
 +
打包kernel.img与resource.img:
 +
<syntaxhighlight lang="bash">
 +
wget https://raw.githubusercontent.com/friendlyarm/sd-fuse_rk3399/kernel-6.1.y/tools/mkkrnlimg && chmod 755 mkkrnlimg
 +
wget https://raw.githubusercontent.com/friendlyarm/sd-fuse_rk3399/kernel-6.1.y/tools/resource_tool && chmod 755 resource_tool
 +
wget https://raw.githubusercontent.com/friendlyarm/sd-fuse_rk3399/kernel-6.1.y/prebuilt/boot/logo.bmp
 +
wget https://raw.githubusercontent.com/friendlyarm/sd-fuse_rk3399/kernel-6.1.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
 +
</syntaxhighlight>
 +
完成后会得到如下文件:
 +
{| class="wikitable"
 +
|-
 +
| kernel.img
 +
| resource.img
 +
| 驱动模块位于out-modules目录
 +
|}
 +
安装内核: <br>
 +
请参考 [[#应用新编译的uboot与内核]]<br>
 +
====编译u-boot v2017.09====
 +
本节内容适用于如下OS:
 +
{| class="wikitable"
 +
|-
 +
| ubuntu-focal-desktop-arm64
 +
| debian-bullseye-desktop-arm64
 +
| debian-bullseye-minimal-arm64
 +
| friendlycore-focal-arm64
 +
| ubuntu-noble-core-arm64
 +
| debian-bookworm-core-arm64
 +
| buildroot
 +
|}
 +
下载源代码并编译:
 +
<syntaxhighlight lang="bash">
 +
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
 +
</syntaxhighlight>
 +
编译完成后会生成如下文件:
 +
{| class="wikitable"
 +
|-
 +
| uboot.img
 +
| trust.img
 +
| rk3399_loader_v1.24.126.bin (打包时改名为MiniLoaderAll.bin)
 +
|}
 +
安装u-boot: <br />
 +
请参考 [[#应用新编译的uboot与内核]]<br>
 +
 +
====应用新编译的uboot与内核====
 +
=====安装到目标板=====
 +
======MBR分区======
 +
本节内容适用于如下OS:
 +
{| class="wikitable"
 +
|-
 +
| lubuntu
 +
| eflasher
 +
| friendlydesktop-arm64
 +
| friendlycore-arm64
 +
|}
 +
目前只有linux v4.4内核使用MBR分区,需要参考此链接的[https://github.com/friendlyarm/sd-fuse_rk3399/blob/kernel-4.19/prebuilt/parameter.template partmap文件],计算各分区的偏移地址,用dd命令将img文件写入到相应位置,例如parameter.template文件内容中"0x00014000@0x00014000(kernel)"表示kernel.img的位置位于0x00014000,转换成10进制就是81920, 相应的dd命令如下所示:
 +
<syntaxhighlight lang="bash">
 +
dd if=kernel.img of=/dev/mmcblk0 seek=81920
 +
</syntaxhighlight>
 +
 +
======GPT分区======
 +
本节内容适用于如下OS:
 +
{| class="wikitable"
 +
|-
 +
| ubuntu-focal-desktop-arm64
 +
| friendlycore-focal-arm64
 +
| debian-bullseye-desktop-arm64
 +
| debian-bullseye-minimal-arm64
 +
| ubuntu-noble-core-arm64
 +
|-
 +
| buildroot
 +
| friendlywrt21
 +
| friendlywrt21-docker
 +
| friendlywrt23
 +
| friendlywrt23-docker
 +
|}
 +
linux v4.19内核和linux v5.15内核的系统默认使用GPT分区, 可以用dd命令直接将image文件烧写至image对应的分区,SD卡与eMMC的设备节点如下:
 +
* SD/TF Card设备节点为 /dev/mmcblk0 <br />
 +
* eMMC设备节点为 /dev/mmcblk2 <br />
 +
下面将演示如何将内核更新到eMMC:<br />
 +
使用parted命令查看分区布局:
 +
<syntaxhighlight lang="bash">
 +
parted /dev/mmcblk2 print
 +
</syntaxhighlight>
 +
得到如下输出:
 +
<syntaxhighlight lang="bash">
 +
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
 +
</syntaxhighlight>
 +
resource分区的序号为5, kernel分区的序号为6,对应的设备节点为/dev/mmcblk2p5和/dev/mmcblk2p6,  dd命令如下:
 +
<syntaxhighlight lang="bash">
 +
dd if=resource.img of=/dev/mmcblk2p5 bs=1M
 +
dd if=kernel.img of=/dev/mmcblk2p6 bs=1M
 +
</syntaxhighlight>
 +
如果要更新uboot:
 +
<syntaxhighlight lang="bash">
 +
dd if=uboot.img of=/dev/mmcblk2p1 bs=1M
 +
</syntaxhighlight>
 +
如果要更新内核驱动模块,将新驱动模块目录上传并替换以下目录下的文件即可:/lib/modules。
 +
 +
=====打包新的SD Image=====
 +
sd-fuse 提供一些工具和脚本, 用于制作SD卡固件, 具体用途如下:<br />
 +
* 制作分区镜像文件, 例如将rootfs目录打包成rootfs.img<br />
 +
* 将多个分区镜像文件打包成可直接写SD卡的单一镜像文件<br />
 +
* 简化内核和uboot的编译, 一键编译内核、第三方驱动, 并更新rootfs.img中的内核模块<br />
 +
请根据所用的内核版本点击对应的链接了解详细的使用方法:
 +
{| class="wikitable"
 +
|-
 +
! 内核版本
 +
! 构建脚本
 +
|-
 +
| linux v4.4.y
 +
| [https://github.com/friendlyarm/sd-fuse_rk3399/tree/master sd-fuse]
 +
|-
 +
| linux v4.19.y
 +
| [https://github.com/friendlyarm/sd-fuse_rk3399/tree/kernel-4.19<br /> sd-fuse]
 +
|-
 +
| linux v6.1.y
 +
| [https://github.com/friendlyarm/sd-fuse_rk3399/tree/kernel-6.1.y<br /> sd-fuse]
 +
|}
 +
=====线刷=====
 +
注:不支持内核v4.4.y的固件
 +
======Linux系统======
 +
用以下命令让开发板进入loader模式:
 +
<syntaxhighlight lang="bash">
 +
sudo reboot loader
 +
</syntaxhighlight>
 +
用 upgrade_tool_v2.17_for_linux 工具烧写uboot与内核, 命令如下所示:
 +
<syntaxhighlight lang="bash">
 +
sudo upgrade_tool di -k kernel.img
 +
sudo upgrade_tool di -re resource.img
 +
sudo upgrade_tool di -u uboot.img
 +
sudo upgrade_tool RD
 +
</syntaxhighlight>
 +
注:upgrade_tool是Rockchip提供的Linux下的命令行工具(Linux_Upgrade_Tool),需要使用v2以上版本。
 +
===使用脚本进行编译===
 +
====下载工具与固件====
 +
以friendlycore-focal系统为例,从github克隆下载脚本, 并解压friendlycore-focal系统的映象文件,映象文件可以在网盘的"03_分区镜像文件"目录找到:
 +
<syntaxhighlight lang="bash">
 +
git clone https://github.com/friendlyarm/sd-fuse_rk3399.git -b kernel-4.19
 +
cd sd-fuse_rk3399
 +
tar xvzf /path/to/netdrive/03_分区镜像文件/friendlycore-focal-arm64-images.tgz
 +
</syntaxhighlight>
 +
====编译内核====
 +
下载内核源代码并编译,编译完成后会自动更新 friendlycore-focal-arm64 目录下的相关映象文件,包括文件系统中的内核模块 (rootfs.img会被解包并重新打包):
 +
<syntaxhighlight lang="bash">
 +
git clone https://github.com/friendlyarm/kernel-rockchip --depth 1 -b nanopi4-v4.19.y kernel-rk3399
 +
KERNEL_SRC=$PWD/kernel-rk3399 ./build-kernel.sh friendlycore-focal-arm64
 +
</syntaxhighlight>
 +
====编译内核头文件====
 +
<syntaxhighlight lang="bash">
 +
git clone https://github.com/friendlyarm/kernel-rockchip --depth 1 -b nanopi4-v4.19.y kernel-rk3399
 +
MK_HEADERS_DEB=1 BUILD_THIRD_PARTY_DRIVER=0 KERNEL_SRC=$PWD/kernel-rk3399 ./build-kernel.sh friendlycore-focal-arm64
 +
</syntaxhighlight>
 +
====编译uboot====
 +
下载uboot源代码并编译,编译完成后会自动更新 friendlycore-focal-arm64 目录下的相关映象文件:
 +
<syntaxhighlight lang="bash">
 +
git clone https://github.com/friendlyarm/uboot-rockchip --depth 1 -b nanopi4-v2017.09
 +
UBOOT_SRC=$PWD/uboot-rockchip ./build-uboot.sh friendlycore-focal-arm64
 +
</syntaxhighlight>
 +
====生成新固件====
 +
将friendlycore-focal-arm64目录下的映象文件重新打包成sd卡固件:
 +
<syntaxhighlight lang="bash">
 +
./mk-sd-image.sh friendlycore-focal-arm64
 +
</syntaxhighlight>
 +
命令完成后,固件位于out目录,可以用 dd 命令制作sd启动卡,举例说明:
 +
<syntaxhighlight lang="bash">
 +
dd if=out/rk3399-sd-friendlycore-focal-4.19-arm64-YYYYMMDD.img of=/dev/sdX bs=1M
 +
</syntaxhighlight>
 +
 +
===Android系统编译===
 +
====电脑的软硬件要求====
 +
* 至少配置16G以上内存+300G磁盘空间,建议使用32G内存+大容量高速SSD的机器,不建议使用虚拟机;
 +
* 如遇到编译错误,可能是编译环境问题,推荐使用如下Docker容器进行编译:[https://github.com/friendlyarm/docker-cross-compiler-novnc docker-cross-compiler-novnc];
 +
====编译Android10====
 +
=====下载Android10源代码=====
 +
有以下两种途径获取 Android10 的源代码,都需要联网:
 +
* '''使用网盘里的git repo压缩包'''
 +
网盘下载地址: [http://download.friendlyelec.com/{{#replace:{{#replace:{{BASEPAGENAME}}| |}}|/zh|}} 点击进入]<br />
 +
文件位于网盘的以下路径:07_源代码/rk3399-android-10.git-YYYYMMDD.tar.xz (YYYYMMDD表示打包的日期)<br />
 +
从网盘中获取的压缩包在解压之后,需要执行一下 sync.sh 脚本,会从gitlab上拉取最新的代码:
 +
<syntaxhighlight lang="bash">
 +
tar xf /path/to/netdisk/07_源代码/rk3399-android-10.git-YYYYMMDD.tar.xz
 +
cd rk3399-android-10
 +
./sync.sh
 +
</syntaxhighlight>
 +
注意: 如果遇到“error: unknown option `recurse-submodules'”,请升级git至v2.0.0或以上版本。
 +
* '''直接克隆git仓库'''
 +
{{{1}}} 源代码托管在 gitlab 上,使用以下命令进行下载:
 +
<syntaxhighlight lang="bash">
 +
git clone --recursive https://gitlab.com/friendlyelec/rk3399-android-10.git -b main
 +
</syntaxhighlight>
 +
 +
=====编译并生成Image文件=====
 +
编译Android 10建议使用普通用户登录,运行以下命令编译:
 +
<syntaxhighlight lang="bash">
 +
cd rk3399-android-10
 +
./build-nanopc-t4.sh -F -M
 +
</syntaxhighlight>
 +
如果需要包含google apps,需要设置一个环境变量再编译,如下所示:
 +
<syntaxhighlight lang="bash">
 +
cd rk3399-android-10
 +
export INSTALL_GAPPS_FOR_TESTING=yes
 +
./build-nanopc-t4.sh -F -M
 +
</syntaxhighlight>
 +
 +
=====编译OTA Packages=====
 +
如果需要A/B (Seamless) System Updates的支持,需要先进行以下定制:<br />
 +
a) 搭建自己的更新服务器<br />
 +
b) 定制packages/apps/Updater使其适配自己的更新服务<br />
 +
定制完成后,使用快速编译脚本参数-O或--ota可编译OTA Packages,如下所示:
 +
<syntaxhighlight lang="bash">
 +
cd rk3399-android-10
 +
./build-nanopc-t4.sh -F -O -M
 +
</syntaxhighlight>
 +
编译成功完成后,OTA更新相关的包位于目录 rockdev/otapackage/ ,请保留此目录。<br />
 +
当完成了某些修改后使用参数-O 再次编译将会生成ota-update-XXXXXXXX.zip,这是增量更新包。<br />
 +
OTA Packages依赖BUILD_NUMBER, 只有它有变化才会生成增量更新包,缺省的生成规则请查看build-nanopc-t4.sh。<br />
 +
修改 device/rockchip/rk3399/nanopc-t4/BoardConfig.mk 中 <br />
 +
<syntaxhighlight lang="bash">
 +
BOARD_USES_AB_IMAGE := false
 +
</syntaxhighlight>
 +
可禁用 A/B 特性,然后重新编译(包括u-boot和android)。<br />
 +
=====更新系统为自已编译的Image=====
 +
编译完成后,image文件会存放在Android10源代码目录的 rockdev/Image-nanopc_t4/ 子目录下,参考以下步骤更新到 {{{1}}}上: <br />
 +
1) 将 EFlasher 启动SD卡 通过读卡器插入电脑,电脑上的Ubuntu系统会自动挂载 SD卡的分区; <br />
 +
2) 我们需要将 rockdev/Image-nanopc_t4/ 子目录下的所有文件,拷贝并覆盖到 SD卡 FRIENDLYARM 分区里的 android10 目录; <br />
 +
3) 将SD卡插入{{{1}}},重新烧写Andorid系统即可; <br />
 +
也可参考这个github仓库的方法来更新:[https://github.com/friendlyarm/sd-fuse_rk3399 sd-fuse_rk3399]<br />
 +
烧写Android 10时EFlasher 需要 v1.3 或以上版本,通过Type-C烧写时请使用rockchip提供的工具AndroidTool v2.71 或Linux_Upgrade_Tool v1.49 。
  
===编译Android8.1源代码===
+
====编译Android8.1====
====下载Android8.1源代码====
+
=====下载Android8.1源代码=====
 
有以下两种途径获取 Android8.1 的源代码,都需要联网:
 
有以下两种途径获取 Android8.1 的源代码,都需要联网:
 
* '''使用网盘里的git repo压缩包'''
 
* '''使用网盘里的git repo压缩包'''
网盘下载地址: [http://download.friendlyarm.com/{{#replace:{{#replace:{{BASEPAGENAME}}| |}}|/zh|}} 点击进入]<br />
+
网盘下载地址: [http://download.friendlyelec.com/{{#replace:{{#replace:{{BASEPAGENAME}}| |}}|/zh|}} 点击进入]<br />
 
文件位于网盘的以下路径:sources/rk3399-android-8.1.git-YYYYMMDD.tgz (YYYYMMDD表示打包的日期)<br />
 
文件位于网盘的以下路径:sources/rk3399-android-8.1.git-YYYYMMDD.tgz (YYYYMMDD表示打包的日期)<br />
 
从网盘中获取的压缩包在解压之后,需要执行一下 sync.sh 脚本,会从gitlab上拉取最新的代码:
 
从网盘中获取的压缩包在解压之后,需要执行一下 sync.sh 脚本,会从gitlab上拉取最新的代码:
Line 65: Line 564:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
====编译并生成Image文件====
+
=====编译并生成Image文件=====
 
使用以下命令编译:
 
使用以下命令编译:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
Line 72: Line 571:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
====更新系统为自已编译的Image====
+
=====更新系统为自已编译的Image=====
 
编译完成后,image文件会存放在Android8.1源代码目录的 rockdev/Image-nanopc_t4/ 子目录下,参考以下步骤更新到 {{{1}}}上: <br />
 
编译完成后,image文件会存放在Android8.1源代码目录的 rockdev/Image-nanopc_t4/ 子目录下,参考以下步骤更新到 {{{1}}}上: <br />
 
1) 将 EFlasher 启动SD卡 通过读卡器插入电脑,电脑上的Ubuntu系统会自动挂载 SD卡的分区; <br />
 
1) 将 EFlasher 启动SD卡 通过读卡器插入电脑,电脑上的Ubuntu系统会自动挂载 SD卡的分区; <br />
Line 79: Line 578:
 
也可参考这个github仓库的方法来更新:[https://github.com/friendlyarm/sd-fuse_rk3399 sd-fuse_rk3399]<br />
 
也可参考这个github仓库的方法来更新:[https://github.com/friendlyarm/sd-fuse_rk3399 sd-fuse_rk3399]<br />
  
===编译Android7源代码===
+
====编译Android7源代码====
====下载Android7源代码====
+
=====下载Android7源代码=====
 
有以下两种途径获取 Android7 的源代码,都需要联网:
 
有以下两种途径获取 Android7 的源代码,都需要联网:
 
* '''使用网盘里的git repo压缩包'''
 
* '''使用网盘里的git repo压缩包'''
网盘下载地址: [http://download.friendlyarm.com/{{#replace:{{#replace:{{BASEPAGENAME}}| |}}|/zh|}}  点击进入]<br />
+
网盘下载地址: [http://download.friendlyelec.com/{{#replace:{{#replace:{{BASEPAGENAME}}| |}}|/zh|}}  点击进入]<br />
 
文件位于网盘的以下路径:sources/rk3399-android-7.git-YYYYMMDD.tgz (YYYYMMDD表示打包的日期)<br />
 
文件位于网盘的以下路径:sources/rk3399-android-7.git-YYYYMMDD.tgz (YYYYMMDD表示打包的日期)<br />
 
从网盘中获取的 repo 压缩包在解压之后,需要执行一下 sync.sh 脚本,会从gitlab上拉取最新的代码:
 
从网盘中获取的 repo 压缩包在解压之后,需要执行一下 sync.sh 脚本,会从gitlab上拉取最新的代码:
Line 97: Line 596:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
====编译并生成Image文件====
+
=====编译并生成Image文件=====
 
使用以下命令编译:
 
使用以下命令编译:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
Line 104: Line 603:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
====更新系统为自已编译的Image====
+
=====更新系统为自已编译的Image=====
 
编译完成后,image文件会存放在Android7源代码目录的 rockdev/Image-nanopc_t4/ 子目录下,参考以下步骤更新到 {{{1}}}上: <br />
 
编译完成后,image文件会存放在Android7源代码目录的 rockdev/Image-nanopc_t4/ 子目录下,参考以下步骤更新到 {{{1}}}上: <br />
 
1) 将 EFlasher 启动SD卡 通过读卡器插入电脑,电脑上的Ubuntu系统会自动挂载 SD卡的分区; <br />
 
1) 将 EFlasher 启动SD卡 通过读卡器插入电脑,电脑上的Ubuntu系统会自动挂载 SD卡的分区; <br />
Line 110: Line 609:
 
3) 将SD卡插入{{{1}}},重新烧写Andorid系统即可; <br />
 
3) 将SD卡插入{{{1}}},重新烧写Andorid系统即可; <br />
 
也可参考这个github仓库的方法来更新:[https://github.com/friendlyarm/sd-fuse_rk3399 sd-fuse_rk3399]<br />
 
也可参考这个github仓库的方法来更新:[https://github.com/friendlyarm/sd-fuse_rk3399 sd-fuse_rk3399]<br />
 
===编译 FriendlyCore/FriendlyDesktop/Lubuntu/EFlasher的内核源代码===
 
<syntaxhighlight lang="bash">
 
git clone https://github.com/friendlyarm/kernel-rockchip --depth 1 -b nanopi4-linux-v4.4.y kernel-rockchip
 
cd kernel-rockchip
 
export PATH=/opt/FriendlyARM/toolchain/6.4-aarch64/bin/:$PATH
 
make ARCH=arm64 nanopi4_linux_defconfig
 
make ARCH=arm64 nanopi4-images
 
</syntaxhighlight>
 
 
编译完成后会生成 kernel.img resource.img 这两个文件,将其拷贝到eflasher系统的SD卡覆盖旧文件即可, 假设SD卡的FRIENDLYARM分区挂载到FRIENDLYARM目录,更新命令如下:
 
<syntaxhighlight lang="bash">
 
# for Lubuntu
 
cp kernel.img resource.img /media/FRIENDLYARM/lubuntu/
 
 
# for FriendlyCore
 
cp kernel.img resource.img /media/FRIENDLYARM/friendlycore-arm64/
 
 
# for FriendlyDesktop
 
cp kernel.img resource.img /media/FRIENDLYARM/friendlydesktop-arm64/
 
</syntaxhighlight>
 
也可以用线刷工具来更新。
 
 
===编译FriendlyCore/FriendlyDesktop/Lubuntu/EFlasher的U-boot源代码===
 
<syntaxhighlight lang="bash">
 
git clone https://github.com/friendlyarm/uboot-rockchip --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-
 
</syntaxhighlight>
 
 
编译完成后会生成 uboot.img、trust.img 和 rk3399_loader_v1.22.119.bin这3个文件,其中rk3399_loader_v1.22.119.bin需要重命名为MiniLoaderAll.bin,然后将其拷贝到eflasher系统的SD卡覆盖旧文件。<br />
 
假设SD卡的FRIENDLYARM分区挂载到FRIENDLYARM目录,更新命令如下:
 
<syntaxhighlight lang="bash">
 
# for Lubuntu
 
cp uboot.img trust.img /media/FRIENDLYARM/lubuntu
 
cp rk3399_loader_v1.22.119.bin /media/FRIENDLYARM/lubuntu/MiniLoaderAll.bin
 
 
# for FriendlyCore
 
cp uboot.img trust.img /media/FRIENDLYARM/friendlycore-arm64
 
cp rk3399_loader_v1.22.119.bin /media/FRIENDLYARM/friendlycore-arm64/MiniLoaderAll.bin
 
 
# for FriendlyDesktop
 
cp uboot.img trust.img /media/FRIENDLYARM/friendlydesktop-arm64
 
cp rk3399_loader_v1.22.119.bin /media/FRIENDLYARM/friendlydesktop-arm64/MiniLoaderAll.bin
 
</syntaxhighlight>
 
也可以用线刷工具来更新。
 
 
===制作用于量产的启动卡或者烧写文件===
 
如果要自已做启动卡,或制作用于批量生产的img文件,可参考这个github仓库:[https://github.com/friendlyarm/sd-fuse_rk3399 sd-fuse_rk3399]<br />
 

Latest revision as of 08:18, 1 July 2024

1 编译 Openwrt/Friendlywrt

1.1 下载源代码

FriendlyWrt有两个版本, 请根据需要进行选择.

1.1.1 版本FriendlyWrt 21.02
mkdir friendlywrt21-rk3399
cd friendlywrt21-rk3399
git clone https://github.com/friendlyarm/repo --depth 1 tools
tools/repo init -u https://github.com/friendlyarm/friendlywrt_manifests -b master-v21.02 \
        -m rk3399.xml --repo-url=https://github.com/friendlyarm/repo  --no-clone-bundle
tools/repo sync -c  --no-clone-bundle
1.1.2 版本FriendlyWrt 23.05
mkdir friendlywrt23-rk3399
cd friendlywrt23-rk3399
git clone https://github.com/friendlyarm/repo --depth 1 tools
tools/repo init -u https://github.com/friendlyarm/friendlywrt_manifests -b master-v23.05 \
        -m rk3399.xml --repo-url=https://github.com/friendlyarm/repo  --no-clone-bundle
tools/repo sync -c  --no-clone-bundle

1.2 首次编译

下面的命令是编译不带docker的版本, 如需要编译带docker的版本, 请将rk3399.mk替换为rk3399-docker.mk:

./build.sh rk3399.mk

会编译所有组件(包含u-boot, kernel 和 friendlywrt)并生成sd卡镜像文件,再执行以下命令,可生成用于安装系统到emmc运行的镜像文件(eflahser固件):

./build.sh emmc-img

对项目进行过修改后, 需要重新打包sd卡镜像, 可执行如下命令:

./build.sh sd-img

1.3 二次编译

cd friendlywrt
make menuconfig #改动FriendlyWrt的配置
rm -rf ./tmp
make -j${nproc}
cd ../
./build.sh sd-img
./build.sh emmc-img

1.4 单独编译u-boot

./build.sh uboot

1.5 单独编译kernel

./build.sh kernel

1.6 单独编译friendlywrt

./build.sh friendlywrt

或者进入friendlywrt目录, 按标准openwrt的命令操作, 上面的命令出现错误时, 可尝试使用以下命令单线程编译:

cd friendlywrt
make -j1 V=s

2 编译Buildroot

请参考: Buildroot

3 其他Linux系统编译

3.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 nanopi4_defconfig
ubuntu-focal-desktop-arm64
debian-bullseye-desktop-arm64
debian-bullseye-minimal-arm64
friendlycore-focal-arm64
debian-bookworm-core-arm64
ubuntu-noble-core-arm64
openmediavault-arm64 linux v6.1.y u-boot
v2017.09
11.3-aarch64 GPT
sd-fuse




nanopi-r2-v6.1.y



nanopi4_linux_defconfig
friendlywrt21 GPT nanopi4_linux_defconfig
+friendlywrt.config
friendlywrt21-docker
friendlywrt23
friendlywrt23-docker
export PATH=/opt/FriendlyARM/toolchain/11.3-aarch64/bin/:$PATH
  • sd-fuse构建脚本可以用于快速编译kernel和uboot、重新打包sd卡固件与卡刷固件等
  • 点击表格中的MBR与GPT可查看各系统的分区布局(配置文件)

3.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与内核

3.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与内核

3.4 编译内核linux-v4.19.y

本节内容适用于如下OS:

ubuntu-focal-desktop-arm64 debian-bullseye-desktop-arm64 debian-bullseye-minimal-arm64 friendlycore-focal-arm64 ubuntu-noble-core-arm64 debian-bookworm-core-arm64 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与内核

3.5 编译内核linux-v6.1.y

本节内容适用于如下OS:

friendlywrt21 friendlywrt21-docker friendlywrt23 friendlywrt23-docker openmediavault-arm64

下载源代码并编译:

git clone https://github.com/friendlyarm/kernel-rockchip --single-branch --depth 1 -b nanopi-r2-v6.1.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-6.1.y/tools/mkkrnlimg && chmod 755 mkkrnlimg
wget https://raw.githubusercontent.com/friendlyarm/sd-fuse_rk3399/kernel-6.1.y/tools/resource_tool && chmod 755 resource_tool
wget https://raw.githubusercontent.com/friendlyarm/sd-fuse_rk3399/kernel-6.1.y/prebuilt/boot/logo.bmp
wget https://raw.githubusercontent.com/friendlyarm/sd-fuse_rk3399/kernel-6.1.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与内核

3.6 编译u-boot v2017.09

本节内容适用于如下OS:

ubuntu-focal-desktop-arm64 debian-bullseye-desktop-arm64 debian-bullseye-minimal-arm64 friendlycore-focal-arm64 ubuntu-noble-core-arm64 debian-bookworm-core-arm64 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与内核

3.7 应用新编译的uboot与内核

3.7.1 安装到目标板
3.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
3.7.1.2 GPT分区

本节内容适用于如下OS:

ubuntu-focal-desktop-arm64 friendlycore-focal-arm64 debian-bullseye-desktop-arm64 debian-bullseye-minimal-arm64 ubuntu-noble-core-arm64
buildroot friendlywrt21 friendlywrt21-docker friendlywrt23 friendlywrt23-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=uboot.img of=/dev/mmcblk2p1 bs=1M

如果要更新内核驱动模块,将新驱动模块目录上传并替换以下目录下的文件即可:/lib/modules。

3.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 v6.1.y
sd-fuse
3.7.3 线刷

注:不支持内核v4.4.y的固件

3.7.3.1 Linux系统

用以下命令让开发板进入loader模式:

sudo reboot loader

用 upgrade_tool_v2.17_for_linux 工具烧写uboot与内核, 命令如下所示:

sudo upgrade_tool di -k kernel.img
sudo upgrade_tool di -re resource.img
sudo upgrade_tool di -u uboot.img
sudo upgrade_tool RD

注:upgrade_tool是Rockchip提供的Linux下的命令行工具(Linux_Upgrade_Tool),需要使用v2以上版本。

4 使用脚本进行编译

4.1 下载工具与固件

以friendlycore-focal系统为例,从github克隆下载脚本, 并解压friendlycore-focal系统的映象文件,映象文件可以在网盘的"03_分区镜像文件"目录找到:

git clone https://github.com/friendlyarm/sd-fuse_rk3399.git -b kernel-4.19
cd sd-fuse_rk3399
tar xvzf /path/to/netdrive/03_分区镜像文件/friendlycore-focal-arm64-images.tgz

4.2 编译内核

下载内核源代码并编译,编译完成后会自动更新 friendlycore-focal-arm64 目录下的相关映象文件,包括文件系统中的内核模块 (rootfs.img会被解包并重新打包):

git clone https://github.com/friendlyarm/kernel-rockchip --depth 1 -b nanopi4-v4.19.y kernel-rk3399
KERNEL_SRC=$PWD/kernel-rk3399 ./build-kernel.sh friendlycore-focal-arm64

4.3 编译内核头文件

git clone https://github.com/friendlyarm/kernel-rockchip --depth 1 -b nanopi4-v4.19.y kernel-rk3399
MK_HEADERS_DEB=1 BUILD_THIRD_PARTY_DRIVER=0 KERNEL_SRC=$PWD/kernel-rk3399 ./build-kernel.sh friendlycore-focal-arm64

4.4 编译uboot

下载uboot源代码并编译,编译完成后会自动更新 friendlycore-focal-arm64 目录下的相关映象文件:

git clone https://github.com/friendlyarm/uboot-rockchip --depth 1 -b nanopi4-v2017.09
UBOOT_SRC=$PWD/uboot-rockchip ./build-uboot.sh friendlycore-focal-arm64

4.5 生成新固件

将friendlycore-focal-arm64目录下的映象文件重新打包成sd卡固件:

./mk-sd-image.sh friendlycore-focal-arm64

命令完成后,固件位于out目录,可以用 dd 命令制作sd启动卡,举例说明:

dd if=out/rk3399-sd-friendlycore-focal-4.19-arm64-YYYYMMDD.img of=/dev/sdX bs=1M

5 Android系统编译

5.1 电脑的软硬件要求

  • 至少配置16G以上内存+300G磁盘空间,建议使用32G内存+大容量高速SSD的机器,不建议使用虚拟机;
  • 如遇到编译错误,可能是编译环境问题,推荐使用如下Docker容器进行编译:docker-cross-compiler-novnc

5.2 编译Android10

5.2.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
5.2.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
5.2.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)。

5.2.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 。

5.3 编译Android8.1

5.3.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
5.3.2 编译并生成Image文件

使用以下命令编译:

cd rk3399-android-8.1
./build-nanopc-t4.sh -F -M
5.3.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

5.4 编译Android7源代码

5.4.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
5.4.2 编译并生成Image文件

使用以下命令编译:

cd rk3399-nougat
./build-nanopc-t4.sh -F -M
5.4.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