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

From FriendlyELEC WiKi
Jump to: navigation, search
(updated by API)
(updated by API)
 
(19 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
===Linux系统编译===
+
===编译 Openwrt/Friendlywrt ===
 +
====下载源代码====
 +
FriendlyWrt有两个版本, 请根据需要进行选择.
 +
=====版本FriendlyWrt 21.02=====
 +
<syntaxhighlight lang="bash">
 +
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
 +
</syntaxhighlight>
 +
=====版本FriendlyWrt 23.05=====
 +
<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系统编译===
 
====各个OS对应的内核与u-boot版本====
 
====各个OS对应的内核与u-boot版本====
 
{| class="wikitable"  
 
{| class="wikitable"  
Line 8: Line 73:
 
! 交叉编译器
 
! 交叉编译器
 
! 分区类型
 
! 分区类型
−
! 构建脚本
+
! 构建工具集
 
! 内核代码分支
 
! 内核代码分支
 
! 内核配置
 
! 内核配置
Line 23: Line 88:
 
| rowspan="4" | nanopi4_linux_defconfig
 
| rowspan="4" | nanopi4_linux_defconfig
 
| rowspan="4" | [https://github.com/friendlyarm/uboot-rockchip/tree/nanopi4-v2014.10_oreo nanopi4-v2014.10_oreo]
 
| rowspan="4" | [https://github.com/friendlyarm/uboot-rockchip/tree/nanopi4-v2014.10_oreo nanopi4-v2014.10_oreo]
−
| rowspan="4" | rk3399_defconfig
+
| rowspan="4" | rk3399_defconfig<br /><br />
 
|-
 
|-
 
| friendlycore-arm64
 
| friendlycore-arm64
Line 32: Line 97:
 
|-
 
|-
 
| buildroot
 
| buildroot
−
| rowspan="8" | linux v4.19.y
+
| rowspan="7" | linux v4.19.y
−
| rowspan="8" | u-boot <br />v2017.09
+
| rowspan="7" | u-boot <br />v2017.09
−
| rowspan="8" | 11.3-aarch64
+
| rowspan="7" | 11.3-aarch64
−
| rowspan="8" | [https://github.com/friendlyarm/sd-fuse_rk3399/blob/kernel-4.19/prebuilt/parameter.template GPT]
+
| rowspan="7" | [https://github.com/friendlyarm/sd-fuse_rk3399/blob/kernel-4.19/prebuilt/parameter.template GPT]
−
| rowspan="8" | [https://github.com/friendlyarm/sd-fuse_rk3399/tree/kernel-4.19 sd-fuse]
+
| rowspan="7" | [https://github.com/friendlyarm/sd-fuse_rk3399/tree/kernel-4.19 sd-fuse]
−
| rowspan="8" | [https://github.com/friendlyarm/kernel-rockchip/tree/nanopi4-v4.19.y nanopi4-v4.19.y]
+
| rowspan="7" | [https://github.com/friendlyarm/kernel-rockchip/tree/nanopi4-v4.19.y nanopi4-v4.19.y]
 
| rowspan="7" | nanopi4_linux_defconfig
 
| rowspan="7" | nanopi4_linux_defconfig
−
| rowspan="8" | [https://github.com/friendlyarm/uboot-rockchip/tree/nanopi4-v2017.09 nanopi4-v2017.09]
+
| rowspan="12" | [https://github.com/friendlyarm/uboot-rockchip/tree/nanopi4-v2017.09 nanopi4-v2017.09]
−
| rowspan="8" | rk3399_defconfig
+
| rowspan="12" | nanopi4_defconfig
−
|-
+
−
| debian-buster-desktop-arm64
+
 
|-
 
|-
−
| debian-bullseye-core-arm64
+
| ubuntu-focal-desktop-arm64
 
|-
 
|-
 
| debian-bullseye-desktop-arm64
 
| debian-bullseye-desktop-arm64
Line 52: Line 115:
 
| friendlycore-focal-arm64
 
| friendlycore-focal-arm64
 
|-
 
|-
−
| friendlycore-lite-focal-kernel4-arm64
+
| debian-bookworm-core-arm64
 
|-
 
|-
−
| friendlywrt21-kernel4
+
| ubuntu-noble-core-arm64
−
| nanopi4_linux_defconfig<br /> friendlywrt.config
+
 
|-
 
|-
−
| friendlycore-lite-focal-kernel5-arm64
+
| openmediavault-arm64
−
| rowspan="5" | linux v5.15.y
+
| rowspan="5" | linux v6.1.y
 
| rowspan="5" | u-boot <br />v2017.09
 
| rowspan="5" | u-boot <br />v2017.09
 
| rowspan="5" | 11.3-aarch64
 
| rowspan="5" | 11.3-aarch64
−
| rowspan="5" | [https://github.com/friendlyarm/sd-fuse_rk3399/blob/kernel-5.15.y/prebuilt/parameter.template GPT]
+
| [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-5.15.y<br /> sd-fuse]
+
| 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-v5.15.y nanopi-r2-v5.15.y]
+
| 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
 
| nanopi4_linux_defconfig
−
| rowspan="5" | [https://github.com/friendlyarm/uboot-rockchip/tree/nanopi4-v2017.09<br /> nanopi4-v2017.09]
 
−
| rowspan="5" | rk3399_defconfig
 
 
|-
 
|-
 
| friendlywrt21
 
| friendlywrt21
−
| rowspan="4" | nanopi4_linux_defconfig<br /> friendlywrt.config
+
| 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
 
| friendlywrt21-docker
 
|-
 
|-
−
| friendlywrt22
+
| friendlywrt23
 
|-
 
|-
−
| friendlywrt22-docker
+
| friendlywrt23-docker
 
|}
 
|}
 
* 内核源代码仓库地址：https://github.com/friendlyarm/kernel-rockchip
 
* 内核源代码仓库地址：https://github.com/friendlyarm/kernel-rockchip
Line 124: Line 185:
 
|}
 
|}
 
安装内核: <br>
 
安装内核: <br>
−
请参考 [[#下载uboot与内核到目标板]]<br>
+
请参考 [[#应用新编译的uboot与内核]]<br>
  
 
====编译u-boot v2014.10====
 
====编译u-boot v2014.10====
Line 151: Line 212:
 
|}
 
|}
 
安装u-boot: <br />
 
安装u-boot: <br />
−
请参考 [[#下载uboot与内核到目标板]]<br>
+
请参考 [[#应用新编译的uboot与内核]]<br>
  
 
====编译内核linux-v4.19.y====
 
====编译内核linux-v4.19.y====
Line 157: Line 218:
 
{| class="wikitable"  
 
{| class="wikitable"  
 
|-
 
|-
−
| debian-buster-desktop-arm64
+
| ubuntu-focal-desktop-arm64
−
| debian-bullseye-core-arm64
+
 
| debian-bullseye-desktop-arm64
 
| debian-bullseye-desktop-arm64
 
| debian-bullseye-minimal-arm64
 
| debian-bullseye-minimal-arm64
−
|-
 
 
| friendlycore-focal-arm64
 
| friendlycore-focal-arm64
−
| friendlycore-lite-focal-kernel4-arm64
+
| ubuntu-noble-core-arm64
−
| friendlywrt21-kernel4
+
| debian-bookworm-core-arm64
 
| buildroot
 
| buildroot
 
|}
 
|}
Line 199: Line 258:
 
|}
 
|}
 
安装内核: <br>
 
安装内核: <br>
−
请参考 [[#下载uboot与内核到目标板]]<br>
+
请参考 [[#应用新编译的uboot与内核]]<br>
−
====编译内核linux-v5.15.y====
+
====编译内核linux-v6.1.y====
 
本节内容适用于如下OS:
 
本节内容适用于如下OS:
 
{| class="wikitable"  
 
{| class="wikitable"  
Line 206: Line 265:
 
| friendlywrt21
 
| friendlywrt21
 
| friendlywrt21-docker
 
| friendlywrt21-docker
−
| friendlywrt22
+
| friendlywrt23
−
| friendlywrt22-docker
+
| friendlywrt23-docker
−
| friendlycore-lite-focal-kernel5-arm64
+
| openmediavault-arm64
 
|}
 
|}
 
下载源代码并编译:
 
下载源代码并编译:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
−
git clone https://github.com/friendlyarm/kernel-rockchip --single-branch --depth 1 -b nanopi-r2-v5.15.y kernel-rockchip
+
git clone https://github.com/friendlyarm/kernel-rockchip --single-branch --depth 1 -b nanopi-r2-v6.1.y kernel-rockchip
 
cd kernel-rockchip
 
cd kernel-rockchip
 
export PATH=/opt/FriendlyARM/toolchain/11.3-aarch64/bin/:$PATH
 
export PATH=/opt/FriendlyARM/toolchain/11.3-aarch64/bin/:$PATH
Line 235: Line 294:
 
打包kernel.img与resource.img:
 
打包kernel.img与resource.img:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
−
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-6.1.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-6.1.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-6.1.y/prebuilt/boot/logo.bmp
−
wget https://raw.githubusercontent.com/friendlyarm/sd-fuse_rk3399/kernel-5.15.y/prebuilt/boot/logo_kernel.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
 
./mkkrnlimg arch/arm64/boot/Image kernel.img
 
mkdir kernel-dtbs
 
mkdir kernel-dtbs
Line 255: Line 314:
 
|}
 
|}
 
安装内核: <br>
 
安装内核: <br>
−
请参考 [[#下载uboot与内核到目标板]]<br>
+
请参考 [[#应用新编译的uboot与内核]]<br>
 
====编译u-boot v2017.09====
 
====编译u-boot v2017.09====
 
本节内容适用于如下OS:
 
本节内容适用于如下OS:
 
{| class="wikitable"  
 
{| class="wikitable"  
 
|-
 
|-
−
| debian-buster-desktop-arm64
+
| ubuntu-focal-desktop-arm64
−
| debian-bullseye-core-arm64
+
 
| debian-bullseye-desktop-arm64
 
| debian-bullseye-desktop-arm64
 
| debian-bullseye-minimal-arm64
 
| debian-bullseye-minimal-arm64
−
|-
 
 
| friendlycore-focal-arm64
 
| friendlycore-focal-arm64
−
| friendlycore-lite-focal-kernel4-arm64
+
| ubuntu-noble-core-arm64
−
| friendlywrt21-kernel4
+
| debian-bookworm-core-arm64
 
| buildroot
 
| buildroot
 
|}
 
|}
Line 286: Line 343:
 
|}
 
|}
 
安装u-boot: <br />
 
安装u-boot: <br />
−
请参考 [[#下载uboot与内核到目标板]]<br>
+
请参考 [[#应用新编译的uboot与内核]]<br>
  
 
====应用新编译的uboot与内核====
 
====应用新编译的uboot与内核====
Line 308: Line 365:
 
{| class="wikitable"  
 
{| class="wikitable"  
 
|-
 
|-
−
| debian-buster-desktop-arm64
+
| ubuntu-focal-desktop-arm64
−
| debian-bullseye-core-arm64
+
| friendlycore-focal-arm64
 
| debian-bullseye-desktop-arm64
 
| debian-bullseye-desktop-arm64
 
| debian-bullseye-minimal-arm64
 
| debian-bullseye-minimal-arm64
 +
| ubuntu-noble-core-arm64
 
|-
 
|-
−
| friendlycore-focal-arm64
 
−
| friendlycore-lite-focal-kernel4-arm64
 
−
| friendlywrt21-kernel4
 
 
| buildroot
 
| buildroot
−
|-
 
 
| friendlywrt21
 
| friendlywrt21
 
| friendlywrt21-docker
 
| friendlywrt21-docker
−
| friendlywrt22
+
| friendlywrt23
−
| friendlywrt22-docker
+
| friendlywrt23-docker
 
|}
 
|}
 
linux v4.19内核和linux v5.15内核的系统默认使用GPT分区, 可以用dd命令直接将image文件烧写至image对应的分区，SD卡与eMMC的设备节点如下：
 
linux v4.19内核和linux v5.15内核的系统默认使用GPT分区, 可以用dd命令直接将image文件烧写至image对应的分区，SD卡与eMMC的设备节点如下：
Line 357: Line 411:
 
如果要更新uboot：
 
如果要更新uboot：
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
−
dd if=boot.img of=/dev/mmcblk2p1 bs=1M
+
dd if=uboot.img of=/dev/mmcblk2p1 bs=1M
 
</syntaxhighlight>
 
</syntaxhighlight>
 
如果要更新内核驱动模块，将新驱动模块目录上传并替换以下目录下的文件即可：/lib/modules。
 
如果要更新内核驱动模块，将新驱动模块目录上传并替换以下目录下的文件即可：/lib/modules。
Line 378: Line 432:
 
| [https://github.com/friendlyarm/sd-fuse_rk3399/tree/kernel-4.19<br /> sd-fuse]
 
| [https://github.com/friendlyarm/sd-fuse_rk3399/tree/kernel-4.19<br /> sd-fuse]
 
|-
 
|-
−
| linux v5.15.y
+
| linux v6.1.y
−
| [https://github.com/friendlyarm/sd-fuse_rk3399/tree/kernel-5.15.y<br /> sd-fuse]
+
| [https://github.com/friendlyarm/sd-fuse_rk3399/tree/kernel-6.1.y<br /> sd-fuse]
 
|}
 
|}
 
=====线刷=====
 
=====线刷=====
 +
注：不支持内核v4.4.y的固件
 
======Linux系统======
 
======Linux系统======
−
用upgrade_tool工具烧写uboot与内核, 命令如下所示：
+
用以下命令让开发板进入loader模式:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
−
sudo upgrade_tool ul MiniLoaderAll.bin
+
sudo reboot loader
−
sudo upgrade_tool di -p parameter.txt
+
</syntaxhighlight>
−
sudo upgrade_tool di uboot uboot.img
+
用 upgrade_tool_v2.17_for_linux 工具烧写uboot与内核, 命令如下所示：
−
sudo upgrade_tool di trust trust.img
+
<syntaxhighlight lang="bash">
−
sudo upgrade_tool di resource resource.img
+
sudo upgrade_tool di -k kernel.img
−
sudo upgrade_tool di kernel kernel.img
+
sudo upgrade_tool di -re resource.img
 +
sudo upgrade_tool di -u uboot.img
 
sudo upgrade_tool RD
 
sudo upgrade_tool RD
 
</syntaxhighlight>
 
</syntaxhighlight>
−
注：upgrade_tool是Rockchip提供的Linux下的命令行工具（Linux_Upgrade_Tool）
+
注：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系统编译===
 
===Android系统编译===
 +
====电脑的软硬件要求====
 +
* 至少配置16G以上内存+300G磁盘空间，建议使用32G内存+大容量高速SSD的机器，不建议使用虚拟机；
 +
* 如遇到编译错误，可能是编译环境问题，推荐使用如下Docker容器进行编译：[https://github.com/friendlyarm/docker-cross-compiler-novnc docker-cross-compiler-novnc]；
 
====编译Android10====
 
====编译Android10====
 
=====下载Android10源代码=====
 
=====下载Android10源代码=====

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

Retrieved from "https://wiki.friendlyelec.com/wiki/index.php?title=Template:RK3399-BuildFromSource/zh&oldid=26107"