Difference between revisions of "APITestPage/zh"

From FriendlyELEC WiKi
Jump to: navigation, search
(→‎安装自编译的内核与uboot)
(→‎安装至正在使用的系统)
Line 228: Line 228:
 
====安装自编译的内核与uboot====
 
====安装自编译的内核与uboot====
 
=====安装至正在使用的系统=====
 
=====安装至正在使用的系统=====
−
* 如果系统是MBR分区（目前只有linux v4.4内核使用mbr分区)，需要参考此链接的[https://github.com/friendlyarm/sd-fuse_rk3399/blob/kernel-4.19/prebuilt/parameter.template partmap文件]，计算各分区的偏移地址，用dd命令进行写入，例如内容"0x00014000@0x00014000(kernel)"表示kernel.img的位置位于@0x00014000，大小为0x00014000
+
======MBR分区======
−
* 如果系统是GPT分区, 直接dd至相应的分区即可，例如要更新内核到eMMC分区，示例如下, SD卡分区则需将mmcblk2改为mmcblk0:<br />
+
目前只有linux v4.4内核使用mbr分区，需要参考此链接的[https://github.com/friendlyarm/sd-fuse_rk3399/blob/kernel-4.19/prebuilt/parameter.template partmap文件]，计算各分区的偏移地址，用dd命令进行写入，例如内容"0x00014000@0x00014000(kernel)"表示kernel.img的位置位于@0x00014000，大小为0x00014000
 +
======GPT分区======
 +
linux v4.19内核以及linux v5.15内核的系统均使用的是GPT分区, GPT分区的更新比较简单，直接dd至相应的分区即可(注意img的大小不要越界)，在操作时需要注意从不同的介质启动系统，其存储设备的节点是不同的，具体如下所示：
 +
* 从SD/TF Card启动时，设备节点为 /dev/mmcblk0 <br />
 +
* 从eMMC启动时，设备节点为 /dev/mmcblk2 <br />
 +
下面演示如何将内核更新到eMMC分区:<br />
 
使用parted命令查看分区布局:
 
使用parted命令查看分区布局:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 
parted /dev/mmcblk2 print
 
parted /dev/mmcblk2 print
 
</syntaxhighlight>
 
</syntaxhighlight>
−
输出如下：
+
得到如下输出：
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 
Model: MMC A3A551 (sd/mmc)
 
Model: MMC A3A551 (sd/mmc)
Line 252: Line 257:
 
  8      147MB  31.0GB  30.9GB  ext4        rootfs
 
  8      147MB  31.0GB  30.9GB  ext4        rootfs
 
</syntaxhighlight>
 
</syntaxhighlight>
−
可以看到resource分区位置为4, kernel分区位置为5，用dd命令分别写入resource.img与kernel.img到这两个分区:
+
可以看到resource分区位置为4, kernel分区位置为5，用dd命令分别写入resource.img与kernel.img到这两个分区即可:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 
dd if=resource.img of=/dev/mmcblk2p4 bs=1M
 
dd if=resource.img of=/dev/mmcblk2p4 bs=1M
 
dd if=kernel.img of=/dev/mmcblk2p5 bs=1M
 
dd if=kernel.img of=/dev/mmcblk2p5 bs=1M
 
</syntaxhighlight>
 
</syntaxhighlight>
−
如果要更新uboot，则：
+
如果要更新uboot，则命令为：
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 
dd if=boot.img of=/dev/mmcblk2p1 bs=1M
 
dd if=boot.img of=/dev/mmcblk2p1 bs=1M
 
</syntaxhighlight>
 
</syntaxhighlight>
−
内核驱动模块，替换以下目录下的文件即可：/lib/modules
+
内核驱动模块，替换以下目录下的文件即可：/lib/modules，建议使用tar命令打包后再上传到开发板，删除旧目录后再进行解压。
  
 
=====打包新的SD卡启动固件或者SD-to-eMMC卡刷固件=====
 
=====打包新的SD卡启动固件或者SD-to-eMMC卡刷固件=====

Revision as of 07:39, 26 March 2023

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 
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

安装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
# 编译内核
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.5 编译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 -j$(nproc)
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

安装u-boot:
请参考 #安装自编译的内核与uboot

1.6 安装自编译的内核与uboot

1.6.1 安装至正在使用的系统
1.6.1.1 MBR分区

目前只有linux v4.4内核使用mbr分区，需要参考此链接的partmap文件，计算各分区的偏移地址，用dd命令进行写入，例如内容"0x00014000@0x00014000(kernel)"表示kernel.img的位置位于@0x00014000，大小为0x00014000

1.6.1.2 GPT分区

linux v4.19内核以及linux v5.15内核的系统均使用的是GPT分区, GPT分区的更新比较简单，直接dd至相应的分区即可(注意img的大小不要越界)，在操作时需要注意从不同的介质启动系统，其存储设备的节点是不同的，具体如下所示：

  • 从SD/TF Card启动时，设备节点为 /dev/mmcblk0
  • 从eMMC启动时，设备节点为 /dev/mmcblk2

下面演示如何将内核更新到eMMC分区:
使用parted命令查看分区布局: 

parted /dev/mmcblk2 print

得到如下输出： 

Model: MMC A3A551 (sd/mmc)
Disk /dev/mmcblk2: 31.0GB
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               misc
 3      16.8MB  21.0MB  4194kB               dtbo
 4      21.0MB  37.7MB  16.8MB               resource
 5      37.7MB  79.7MB  41.9MB               kernel
 6      79.7MB  113MB   33.6MB               boot
 7      113MB   147MB   33.6MB               recovery
 8      147MB   31.0GB  30.9GB  ext4         rootfs

可以看到resource分区位置为4, kernel分区位置为5，用dd命令分别写入resource.img与kernel.img到这两个分区即可: 

dd if=resource.img of=/dev/mmcblk2p4 bs=1M
dd if=kernel.img of=/dev/mmcblk2p5 bs=1M

如果要更新uboot，则命令为： 

dd if=boot.img of=/dev/mmcblk2p1 bs=1M

内核驱动模块，替换以下目录下的文件即可：/lib/modules，建议使用tar命令打包后再上传到开发板，删除旧目录后再进行解压。

1.6.2 打包新的SD卡启动固件或者SD-to-eMMC卡刷固件

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.6.3 线刷

将编译生成的文件替换同名文件即可，只刷入改动的文件即可，需要注意的是uboot编译生成的rk3399_loader需要改名为MiniLoaderAll.bin，如下命令演示刷入uboot与内核，需要先加载parameter.txt，再刷入其他文件: 

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

Retrieved from "https://wiki.friendlyelec.com/wiki/index.php?title=APITestPage/zh&oldid=24186"