Difference between revisions of "APITestPage/zh"

From FriendlyELEC WiKi
Jump to: navigation, search
(updated by API)
 
(78 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
===Linux系统编译===
 
−
====各个OS对应的内核与u-boot版本====
 
−
{| class="wikitable"
 
−
|-
 
−
! 操作系统
 
−
! 内核版本
 
−
! uboot版本
 
−
! 交叉编译器
 
−
! 分区类型
 
−
! 构建脚本
 
−
! 内核代码分支
 
−
! 内核配置
 
−
! uboot代码分支
 
−
! uboot配置
 
−
|-
 
−
| buildroot
 
−
| rowspan="2" | linux v4.19.y
 
−
| rowspan="7" | u-boot <br />v2017.09
 
−
| rowspan="7" | 11.3-aarch64
 
−
| rowspan="2" | [https://github.com/friendlyarm/sd-fuse_rk3568/blob/kernel-4.19/prebuilt/parameter.template GPT]
 
−
| rowspan="2" | [https://github.com/friendlyarm/sd-fuse_rk3568/tree/kernel-4.19 sd-fuse]
 
−
| rowspan="2" | [https://github.com/friendlyarm/kernel-rockchip/tree/nanopi4-v4.19.y nanopi4-v4.19.y]
 
−
| rowspan="2" | nanopi4_linux_defconfig
 
−
| rowspan="7" | [https://github.com/friendlyarm/uboot-rockchip/tree/nanopi5-v2017.09 nanopi5-v2017.09]
 
−
| rowspan="7" | rk3288_defconfig
 
−
|-
 
−
| buildroot
 
−
| rowspan="10" | linux v5.10.y
 
−
| rowspan="10" | u-boot <br />v2017.09
 
−
| rowspan="10" | 11.3-aarch64
 
−
| rowspan="10" | [https://github.com/friendlyarm/sd-fuse_rk3568/blob/master/prebuilt/parameter.template GPT]
 
−
| rowspan="10" | [https://github.com/friendlyarm/sd-fuse_rk3568/tree/master sd-fuse]
 
−
| rowspan="10" | [https://github.com/friendlyarm/kernel-rockchip/tree/nanopi5-v5.10.y_opt nanopi5-v5.10.y_opt]
 
−
| rowspan="6" | nanopi5_linux_defconfig
 
−
| rowspan="10" | [https://github.com/friendlyarm/uboot-rockchip/tree/nanopi5-v2017.09 nanopi5-v2017.09]
 
−
| rowspan="10" | rk3568_defconfig
 
−
|-
 
−
| friendlycore-focal-arm64
 
−
|-
 
−
| debian-bullseye-core-arm64
 
−
|-
 
−
| debian-bullseye-desktop-arm64
 
−
|-
 
−
| debian-bullseye-minimal-arm64
 
−
|-
 
−
| debian-buster-desktop-arm64
 
−
|-
 
−
| friendlywrt21
 
−
| rowspan="4" | nanopi5_linux_defconfig<br /> 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>
 
−
* sd-fuse构建脚本可以用于快速编译kernel和uboot、重新打包sd卡固件与卡刷固件等
 
−
====编译内核linux-v5.10.y====
 
−
本节内容适用于如下OS:
 
−
{| class="wikitable"
 
−
|-
 
−
| buildroot
 
−
| friendlycore-focal-arm64
 
−
| debian-bullseye-core-arm64
 
−
| debian-bullseye-desktop-arm64
 
−
| debian-bullseye-minimal-arm64
 
−
| debian-buster-desktop-arm64
 
−
| friendlywrt21
 
−
| friendlywrt21-docker
 
−
| friendlywrt22
 
−
| friendlywrt22-docker
 
−
| friendlycore-lite-focal-arm64
 
−
|}
 
−
下载源代码并编译:
 
−
<syntaxhighlight lang="bash">
 
−
git clone https://github.com/friendlyarm/kernel-rockchip --single-branch --depth 1 -b nanopi5-v5.10.y_opt 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 nanopi5_linux_defconfig
 
−
# option2: 加载FriendlyWrt系统配置
 
−
# make CROSS_COMPILE=aarch64-linux-gnu- ARCH=arm64 nanopi5_linux_defconfig friendlywrt.config
 
−
# 启动配置界面
 
−
# make CROSS_COMPILE=aarch64-linux-gnu- ARCH=arm64 menuconfig
 
−
# 编译内核
 
−
make CROSS_COMPILE=aarch64-linux-gnu- ARCH=arm64 nanopi5-images -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>
 
−
完成后会得到如下文件:
 
−
{| class="wikitable"
 
−
|-
 
−
| kernel.img
 
−
| resource.img
 
−
| <del>boot.img (此img弃用)</del>
 
−
| 驱动模块位于out-modules目录
 
−
|}
 
−
安装内核: <br>
 
−
请参考 [[#下载uboot与内核到目标板]]<br>
 
−
====编译u-boot v2017.09====
 
−
本节内容适用于如下OS:
 
−
{| class="wikitable"
 
−
|-
 
−
| buildroot
 
−
| friendlycore-focal-arm64
 
−
| debian-bullseye-core-arm64
 
−
| debian-bullseye-desktop-arm64
 
−
| debian-bullseye-minimal-arm64
 
−
| debian-buster-desktop-arm64
 
−
| friendlywrt21
 
−
| friendlywrt21-docker
 
−
| friendlywrt22
 
−
| friendlywrt22-docker
 
−
| friendlycore-lite-focal-arm64
 
−
|}
 
−
下载源代码并编译:
 
−
<syntaxhighlight lang="bash">
 
−
git clone https://github.com/friendlyarm/rkbin --single-branch --depth 1 -b nanopi5
 
−
git clone https://github.com/friendlyarm/uboot-rockchip --single-branch --depth 1 -b nanopi5-v2017.09
 
−
export PATH=/opt/FriendlyARM/toolchain/11.3-aarch64/bin/:$PATH
 
−
cd uboot-rockchip/
 
−
./make.sh nanopi5
 
−
</syntaxhighlight>
 
−
编译完成后会生成如下文件:
 
−
{| class="wikitable"
 
−
|-
 
−
| uboot.img
 
−
| rk356x_spl_loader_v1.15.112.bin (打包时改名为MiniLoaderAll.bin)
 
−
|}
 
−
安装u-boot: <br />
 
−
请参考 [[#下载uboot与内核到目标板]]<br>
 
  
−
====下载uboot与内核到目标板====
+
{{RockchipUnbrick/zh|NanoPC-T6}}
−
=====下载至已安装的系统=====
+
−
======GPT分区======
+
−
本节内容适用于如下OS:
+
−
{| class="wikitable"
+
−
|-
+
−
| buildroot
+
−
| friendlycore-focal-arm64
+
−
| debian-bullseye-core-arm64
+
−
| debian-bullseye-desktop-arm64
+
−
| debian-bullseye-minimal-arm64
+
−
| debian-buster-desktop-arm64
+
−
| friendlywrt21
+
−
| friendlywrt21-docker
+
−
| friendlywrt22
+
−
| friendlywrt22-docker
+
−
| friendlycore-lite-focal-arm64
+
−
|}
+
−
dd image文件至相应的分区即可(注意image的大小不要越界)，在操作时需要注意存储设备的节点：
+
−
* 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 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
+
−
</syntaxhighlight>
+
−
resource分区的序号为4, kernel分区的序号为5，对应的设备节点为/dev/mmcblk2p4和/dev/mmcblk2p5,  dd命令如下:
+
−
<syntaxhighlight lang="bash">
+
−
dd if=resource.img of=/dev/mmcblk2p4 bs=1M
+
−
dd if=kernel.img of=/dev/mmcblk2p5 bs=1M
+
−
</syntaxhighlight>
+
−
如果要更新uboot：
+
−
<syntaxhighlight lang="bash">
+
−
dd if=boot.img of=/dev/mmcblk2p1 bs=1M
+
−
</syntaxhighlight>
+
−
如果要更新内核驱动模块，将新驱动模块目录上传并替换以下目录下的文件即可：/lib/modules。
+
−
 
+
−
=====打包新的SD卡启动固件或者SD-to-eMMC卡刷固件=====
+
−
sd-fuse 提供一些工具和脚本, 用于制作SD卡固件, 具体用途如下:<br />
+
−
* 制作分区镜像文件, 例如将rootfs目录打包成rootfs.img<br />
+
−
* 将多个分区镜像文件打包成可直接写SD卡的单一镜像文件<br />
+
−
* 简化内核和uboot的编译, 一键编译内核、第三方驱动, 并更新rootfs.img中的内核模块<br />
+
−
请根据所用的内核版本点击对应的链接了解详细的使用方法：
+
−
{| class="wikitable"
+
−
|-
+
−
! 内核版本
+
−
! 构建脚本
+
−
|-
+
−
| linux v5.10.y
+
−
| [https://github.com/friendlyarm/sd-fuse_rk3568/tree/master<br /> sd-fuse_rk3568]
+
−
|}
+
−
=====线刷=====
+
−
======Linux系统======
+
−
用upgrade_tool工具烧写uboot与内核, 命令如下所示：
+
−
<syntaxhighlight lang="bash">
+
−
sudo upgrade_tool ul MiniLoaderAll.bin
+
−
sudo upgrade_tool di -p parameter.txt
+
−
sudo upgrade_tool di uboot uboot.img
+
−
sudo upgrade_tool di resource resource.img
+
−
sudo upgrade_tool di kernel kernel.img
+
−
sudo upgrade_tool RD
+
−
</syntaxhighlight>
+
−
注：upgrade_tool是Rockchip提供的Linux下的命令行工具（Linux_Upgrade_Tool）
+

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模式擦除存储设备

  • 在电脑上启动 RKDevTool
  • 按住Mask按键不放, 插上电源, 保持按住Mask键, 状态灯亮起3秒后即可松开
  • 用USB C-to-A数据线, 将NanoPC-T6与电脑进行连接, 连接到NanoPC-T6的USB C接口

T6LTS-usbflash.jpg

  • 正常情况下，界面下方会显示 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

1.2.1 下载所需文件

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

1.2.2 安装upgrade_tool工具

输入如下命令： 

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引导系统了

1.3 Mac Users

我们测试发现Mac下的upgrade_tool_v2.25无法正常工作，因此建议使用Windows和Linux，除非获得了更新版本的upgrade_tool。

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