Difference between revisions of "APITestPage/zh"

From FriendlyELEC WiKi
Jump to: navigation, search
(→‎各个OS对应的内核与u-boot版本)
(updated by API)
 
(111 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
===Linux系统编译===
 
−
====各个OS对应的内核与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" | nanopi4-linux-v4.4.y
 
−
| rowspan="4" | nanopi4_linux_defconfig
 
−
| rowspan="4" | nanopi4-v2014.10_oreo
 
−
| rowspan="4" | rk3399_defconfig
 
−
|-
 
−
| friendlycore-arm64
 
−
|-
 
−
| friendlydesktop-arm64
 
−
|-
 
−
| eflasher
 
−
|-
 
−
| buildroot
 
−
| rowspan="8" | linux v4.19.y
 
−
| rowspan="8" | u-boot <br />v2017.09
 
−
| rowspan="8" | 11.3-aarch64
 
−
| rowspan="8" | nanopi4-v4.19.y
 
−
| rowspan="7" | nanopi4_linux_defconfig
 
−
| rowspan="8" | nanopi4-v2017.09
 
−
| rowspan="8" | 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
 
−
| rowspan="5" | linux v5.15.y
 
−
| rowspan="5" | u-boot <br />v2017.09
 
−
| rowspan="5" | 11.3-aarch64
 
−
| rowspan="5" | nanopi-r2-v5.15.y
 
−
| nanopi4_linux_defconfig
 
−
| rowspan="5" | nanopi4-v2017.09
 
−
| rowspan="5" | rk3399_defconfig
 
−
|-
 
−
| friendlywrt21
 
−
| rowspan="4" | 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版本的编译器，使用如下命令:
 
−
<syntaxhighlight lang="bash">
 
−
export PATH=/opt/FriendlyARM/toolchain/11.3-aarch64/bin/:$PATH
 
−
</syntaxhighlight>
 
  
−
====编译内核linux-v4.4.y====
+
{{RockchipUnbrick/zh|NanoPC-T6}}
−
本节内容适用于如下OS:
+
−
{| class="wikitable"
+
−
|-
+
−
! lubuntu
+
−
! eflasher
+
−
! friendlydesktop-arm64
+
−
! friendlycore-arm64
+
−
|}
+
−
下载源代码并编译:
+
−
<syntaxhighlight lang="bash">
+
−
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)
+
−
</syntaxhighlight>
+
−
编译完会生成如下文件:
+
−
{| class="wikitable"
+
−
|-
+
−
! kernel.img
+
−
! resource.img
+
−
! 驱动模块位于out-modules目录
+
−
|}
+
−
安装内核: <br>
+
−
请参考 [xxxxx]<br>
+
−
====编译u-boot v2014.10====
+
−
本节内容适用于如下OS:
+
−
{| class="wikitable"
+
−
|-
+
−
| lubuntu
+
−
| eflasher
+
−
| friendlydesktop-arm64
+
−
| friendlycore-arm64
+
−
|}
+
−
下载源代码并编译:
+
−
<syntaxhighlight lang="bash">
+
−
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>
+
−
编译完成后会生成如下文件:
+
−
{| class="wikitable"
+
−
|-
+
−
! uboot.img
+
−
! trust.img
+
−
! rk3399_loader_v1.22.119.bin
+
−
|}
+
−
安装u-boot: <br />
+
−
请参考: [XXXXXX]
+
−
 
+
−
====编译内核linux-v4.19.y====
+
−
本节内容适用于如下OS:
+
−
{| class="wikitable"
+
−
|-
+
−
| 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
+
−
|}
+
−
下载源代码并编译:
+
−
<syntaxhighlight lang="bash">
+
−
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)
+
−
</syntaxhighlight>
+
−
编译完会生成如下文件:
+
−
{| class="wikitable"
+
−
|-
+
−
! kernel.img
+
−
! resource.img
+
−
! 驱动模块位于out-modules目录
+
−
|}
+
−
安装内核: <br>
+
−
请参考 [xxxxx]<br>
+
−
 
+
−
====编译u-boot v2017.09====
+
−
本节内容适用于如下OS:
+
−
{| class="wikitable"
+
−
|-
+
−
| 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
+
−
|}
+
−
下载源代码并编译:
+
−
<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 -j$(nproc)
+
−
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
+
−
|}
+
−
安装u-boot: <br />
+
−
请参考: [XXXXXX]
+
−
 
+
−
===制作用于量产的启动卡或者烧写文件===
+
−
如果要自已做启动卡，或制作用于批量生产的img文件，可参考这个github仓库：[https://github.com/friendlyarm/sd-fuse_rk3399 sd-fuse_rk3399]<br />
+
−
===Android系统编译===
+
−
====编译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 的源代码，都需要联网:
+
−
* '''使用网盘里的git repo压缩包'''
+
−
网盘下载地址: [http://download.friendlyelec.com/{{#replace:{{#replace:{{BASEPAGENAME}}| |}}|/zh|}} 点击进入]<br />
+
−
文件位于网盘的以下路径：sources/rk3399-android-8.1.git-YYYYMMDD.tgz (YYYYMMDD表示打包的日期)<br />
+
−
从网盘中获取的压缩包在解压之后，需要执行一下 sync.sh 脚本，会从gitlab上拉取最新的代码：
+
−
<syntaxhighlight lang="bash">
+
−
tar xvzf /path/to/netdisk/sources/rk3399-android-8.1.git-YYYYMMDD.tgz
+
−
cd rk3399-android-8.1
+
−
./sync.sh
+
−
</syntaxhighlight>
+
−
* '''直接克隆git仓库'''
+
−
{{{1}}} 源代码托管在 gitlab 上，使用以下命令进行下载：
+
−
<syntaxhighlight lang="bash">
+
−
git clone https://gitlab.com/friendlyelec/rk3399-android-8.1 --depth 1 -b master
+
−
</syntaxhighlight>
+
−
 
+
−
=====编译并生成Image文件=====
+
−
使用以下命令编译：
+
−
<syntaxhighlight lang="bash">
+
−
cd rk3399-android-8.1
+
−
./build-nanopc-t4.sh -F -M
+
−
</syntaxhighlight>
+
−
 
+
−
=====更新系统为自已编译的Image=====
+
−
编译完成后，image文件会存放在Android8.1源代码目录的 rockdev/Image-nanopc_t4/ 子目录下，参考以下步骤更新到 {{{1}}}上： <br />
+
−
1) 将 EFlasher 启动SD卡 通过读卡器插入电脑，电脑上的Ubuntu系统会自动挂载 SD卡的分区; <br />
+
−
2) 我们需要将 rockdev/Image-nanopc_t4/ 子目录下的所有文件，拷贝并覆盖到 SD卡 FRIENDLYARM 分区里的 android8 目录; <br />
+
−
3) 将SD卡插入{{{1}}}，重新烧写Andorid系统即可; <br />
+
−
也可参考这个github仓库的方法来更新：[https://github.com/friendlyarm/sd-fuse_rk3399 sd-fuse_rk3399]<br />
+
−
 
+
−
====编译Android7源代码====
+
−
=====下载Android7源代码=====
+
−
有以下两种途径获取 Android7 的源代码，都需要联网:
+
−
* '''使用网盘里的git repo压缩包'''
+
−
网盘下载地址: [http://download.friendlyelec.com/{{#replace:{{#replace:{{BASEPAGENAME}}| |}}|/zh|}}  点击进入]<br />
+
−
文件位于网盘的以下路径：sources/rk3399-android-7.git-YYYYMMDD.tgz (YYYYMMDD表示打包的日期)<br />
+
−
从网盘中获取的 repo 压缩包在解压之后，需要执行一下 sync.sh 脚本，会从gitlab上拉取最新的代码：
+
−
<syntaxhighlight lang="bash">
+
−
tar xvzf /path/to/netdisk/sources/rk3399-android-7.git-20181228.tgz
+
−
cd rk3399-nougat
+
−
./sync.sh
+
−
</syntaxhighlight>
+
−
* '''直接克隆git仓库'''
+
−
{{{1}}} 源代码托管在 gitlab 上，使用以下命令进行下载：
+
−
<syntaxhighlight lang="bash">
+
−
git clone https://gitlab.com/friendlyelec/rk3399-nougat --depth 1 -b nanopc-t4-nougat
+
−
</syntaxhighlight>
+
−
 
+
−
=====编译并生成Image文件=====
+
−
使用以下命令编译：
+
−
<syntaxhighlight lang="bash">
+
−
cd rk3399-nougat
+
−
./build-nanopc-t4.sh -F -M
+
−
</syntaxhighlight>
+
−
 
+
−
=====更新系统为自已编译的Image=====
+
−
编译完成后，image文件会存放在Android7源代码目录的 rockdev/Image-nanopc_t4/ 子目录下，参考以下步骤更新到 {{{1}}}上： <br />
+
−
1) 将 EFlasher 启动SD卡 通过读卡器插入电脑，电脑上的Ubuntu系统会自动挂载 SD卡的分区; <br />
+
−
2) 我们需要将 rockdev/Image-nanopc_t4/ 子目录下的所有文件，拷贝并覆盖到 SD卡 FRIENDLYARM 分区里的  nougat 目录; <br />
+
−
3) 将SD卡插入{{{1}}}，重新烧写Andorid系统即可; <br />
+
−
也可参考这个github仓库的方法来更新：[https://github.com/friendlyarm/sd-fuse_rk3399 sd-fuse_rk3399]<br />
+

Latest revision as of 07:13, 4 June 2024

1 救砖办法

如何固件没有正确安装，导致开发板变砖，而且可能没有机会通过SD卡重新安装固件，这时，就需要进入Maskrom模式，通过擦除存储设备的办法救砖。

1.1 Windows用户

1.1.1 下载所需文件

  • 获取所需工具：访问这里，在 05_Tools 目录中找到 RKDevTool_v3.19_for_window.zip, DriverAssitant_v5.12.zip 下载到本地
  • 安装Rockchip USB驱动和RKDevTool: 解压 DriverAssitant_v5.12.zip 安装Rockchip USB驱动, 解压 RKDevTool_v3.19_for_window.zip 获得 Rockchip烧写工具 RKDevTool
  • 获取loader: 访问这里，进入CPU型号对应的tools目录，下载 MiniLoaderAll.bin

1.1.2 进入Maskrom模式擦除存储设备

  • 使用USB数据线将NanoPC-T6与电脑相连接
  • 在电脑上启动 RKDevTool
  • 将NanoPC-T6断开电源，按住 MASK 键，连接电源，当看到界面下方显示 Found One MASKROM Device 时松开按键, 如下图所示:

Rkdevtool found one maskrom device.png

  • 在 RKDevTool 界面上点击 Advanced Function 选项卡
  • 在 Boot 编辑框中选择 MiniLoaderAll.bin，然后点击 Download 按钮
  • 选中 EMMC，点 Switch Storage，再点击 ErashAll 按钮擦除eMMC

Rkdevtool erase emmc.png

  • (可选）: 如果你的NanoPC-T6上有SPI Nor Flash，选中 SPINOR, 点 Switch Storage，再点击 ErashAll 按钮擦除SPI Nor Flash

Rkdevtool erase spinorflash.png

  • 至此，NanoPC-T6恢复至初始状态，可以正常通过SD卡或eMMC引导系统了

1.2 Linux/Mac用户

1.2.1 下载所需文件

  • 获取所需工具：访问这里，在 05_Tools 目录中找到 upgrade_tool_v2.30_for_linux.tgz (或Mac用户选upgrade_tool_v2.25_for_mac.tgz) 下载到本地
  • 获取loader: 访问这里，进入CPU型号对应的tools目录，下载 MiniLoaderAll.bin

1.2.2 安装upgrade_tool工具

以下命令以Linux为例，Mac用户只有文件和目录名略有不同： 

tar xzf upgrade_tool_v2.30_for_linux.tgz
cd upgrade_tool_v2.30_for_linux
sudo cp upgrade_tool /usr/local/sbin/
sudo chmod 755 /usr/local/sbin/upgrade_tool

1.2.3 进入Maskrom模式擦除存储设备

  • 使用USB数据线将NanoPC-T6与电脑相连接
  • 将NanoPC-T6断开电源，按住 MASK 键，连接电源，4秒后松开按键
  • 用如下命令检查连接:
upgrade_tool LD

显示类似 "DevNo=1 Vid=0x2207,Pid=0x350b,LocationID=13 Mode=Maskrom SerialNo=" 的内容表示已检测到设备。

  • 用如下命令擦除eMMC:
upgrade_tool EF MiniLoaderAll.bin
  • (可选）: 如果你的NanoPC-T6上有SPI Nor Flash，用如下命令擦除SPI Nor Flash:
upgrade_tool DB MiniLoaderAll.bin
upgrade_tool SSD   #选5, SPINOR
dd if=/dev/zero of=zero.img bs=1M count=16   # 针对16M NOR FLASH
upgrade_tool WL 0 zero.img
  • 至此，NanoPC-T6恢复至初始状态，可以正常通过SD卡或eMMC引导系统了
Retrieved from "https://wiki.friendlyelec.com/wiki/index.php?title=APITestPage/zh&oldid=25989"