Difference between revisions of "Rockpi4/dev/usb-install/zh cn"

Revision as of 07:56, 13 September 2021

English

    ROCK Pi 4 >  Development >  Install from USB OTG port

Rock PI支持Maskrom模式，这是一种CPU等待USB OTG口命令的特殊操作模式。rkdevelopment和AndroidTool是我们在Maskrom模式下用来与Rock PI通信的PC端烧录工具。在Linux/MacOS下使用的是rkdevelopment工具，而在Windows下使用的是AndroidTool工具。

使用RK驱动助手工具来安装驱动。在此过程中，不需要连接您的Rockchip设备，只需下载压缩包并解压RKDriverAssistant.zip。然后双击RKDriverAssistant目录下的DriverInstall.exe，启动工具并点击Install Driver安装驱动。如果你已经为其他Rockchip设备安装过Rockchip USB驱动，请先点击 "卸载驱动"。

Linux

对于Linux，我们从源代码来编译构建rkdeveloptool工具。要在基于Debian的Linux发行版上编译rkdeveloptool工具，请按照以下说明操作。

安装编译依赖:

 sudo apt-get install libudev-dev libusb-1.0-0-dev dh-autoreconf

克隆源码并编译:

 git clone https://github.com/rockchip-linux/rkdeveloptool
 cd rkdeveloptool
 autoreconf -i
 ./configure
 make

如果你遇到像下面这样的编译错误：

   ./configure: line 4269: syntax error near unexpected token `LIBUSB1,libusb-1.0'
   ./configure: line 4269: `PKG_CHECK_MODULES(LIBUSB1,libusb-1.0)'

你可以安装 pkg-config libusb-1.0

   sudo apt-get install pkg-config libusb-1.0

然后重新执行以下操作

   autoreconf -i
   ./configure
   make

现在你在当前目录下会有rkdeveloptool的可执行文件，并添加到系统工具中。

 sudo cp rkdeveloptool /usr/local/bin/

MacOS

对于 macOS, 我们从源码来编译redeveloptool工具

为了在macOS上编译rkdeveloptool，你需要安装这个支持包homebrew。

安装编译依赖:

   brew install automake autoconf libusb lsusb

克隆源码并编译:

   git clone https://github.com/rockchip-linux/rkdeveloptool
   cd rkdeveloptool
   autoreconf -i
   ./configure
   make

如果出现像下面一样的编译错误

   ./configure: line 4269: syntax error near unexpected token `LIBUSB1,libusb-1.0'
   ./configure: line 4269: `PKG_CHECK_MODULES(LIBUSB1,libusb-1.0)'

你可以安装 pkg-config libusb-1.0

   brew install pkg-config

然后重新编译

   autoreconf -i
   ./configure
   make

现在，在当前目录下就会有rkdeveloptool的可执行文件

   sudo cp rkdeveloptool /usr/local/bin/

引导Rock PI4 进入Maskrom模式

将ROCK Pi引导到maskrom模式很简单，如下：

1. 断电
- 拔掉SD卡。
- 如果你的rock pi4上有可拆卸的eMMC模块，请将其移除。
- 如果你的是rock pi4 Plus版本，有焊接的eMMC，则需要按住maskrom键 (1: Maskrom 2: Reset 3: Recovery)

2. 用A对A的USB线，连接PC端的USB和ROCK PI4的OTG接口（上面的USB3.0 接口），
3. 按住Maskrom按键并且给ROCK PI4上电

- 4. 对于 Linux/macOS

在Linux PC端, 使用lsusb命令可以看到下面的USB设备。

   Bus 003 Device 005: ID 2207:330c

- 4. 对于 Windows

在 Windows PC端，打开设备管理器：

这就意味着ROCK PI 4已经进入maskrom 模式.

5. 现在插入eMMC模块，并进行下一步的烧写

另外，如果你运行的是安卓系统并且可以访问ADB，你可以将设备重启到loader模式adb rebootloader，然后使用rkdeveloptool将设备重置到maskrom模式`rkdeveloptool rd 3'`或者Windows AndroidTool Switch 按钮来进入maskrom模式。

通过USB烧写镜像到eMMC模块

Linux/macOS

在你的PC端,运行rkdeveloptool工具

   rkdeveloptool ld        # List the device
   DevNo=1	Vid=0x2207,Pid=0x330c,LocationID=305	Maskrom

loader文件用于启动并初始化RAM，并准备好烧录环境。如果你没有loader的bin文件，可以在这里下载。

   rkdeveloptool db rk3399_loader_vxxxx.bin

从0开始烧写GPT镜像到eMMC

   rkdeveloptool wl 0 /path/to/rockpi4b-xxx-gpt.img

重新启动设备

   rkdeveloptool rd

现在，设备应该会重新启动eMMC里的新镜像。

请注意，当你想擦除板上的eMMC时，你可以使用这个命令。可以从这里下载到zero.img。

   rkdeveloptool db rk3399_loader_vxxxx.bin
   rkdeveloptool wl 0 zero.img

Windows

双击 AndroidTool.exe 会看到下面的界面: 如果你的ROCK Pi 4已经进入Maskrom模式并连接上电脑，你可以看到红框里面的字样：

步骤 1: 选择 Loader

点击下面红框并选择这个"rk3399_ loader_ xxxxx.bin "文件

提示：loader用于启动初始化RAM，并准备好烧录环境。如果你没有loader的bin文件，可以在这里下载。

步骤 2: 选择镜像

点击图片中的右侧最后一列的...，选择你要烧录的镜像

通常情况下，镜像的名字应该以xxx-gpt.img结尾。如果镜像名称以xxx-rkupdate.img结尾，你就不能用这个方法进行烧录。

步骤 3: 运行

点击下面红框中的 "run "按钮，你会看到右边红框中的内容。当进度达到100%时，说明下载就完成了。

按分区进行安装（高级）

Linux/macOS

有时我们只想更新镜像的一个分区，比如只更新boot分区，只更新kernel。我们可以通过分区来烧写

| Part Number | Offset | Name    | Description                |
| ----------- | ------ | ------- | -------------------------- |
| 1           | 32KB   | loader1 | First stage loader         |
| 2           | 8MB    | loader2 | U-boot image               |
| 3           | 12MB   | trust   | ATF                        |
| 4           | 16MB   | boot    | Kernel partition, bootable |
| 5           | 128MB  | rootfs  | Rootfs                     |

当ROCK pi 4处于maskrom模式时，可以根据下面的命令来烧写不同位置的分区

   rkdeveloptool db rk3399_loader_*.bin
   rkdeveloptool wl 64 idbloader.img
   rkdeveloptool wl 16384 uboot.img
   rkdeveloptool wl 24576 trust.img
   rkdeveloptool wl 32768 boot.img
   rkdeveloptool wl 262144 rootfs.img

Windows

TBD.

常见问题

如果你遇到了类似的问题，你可以试试rk3399_loader_v1.20.119.bin这个bin文件

故障排除

如果你在通过USB OTG烧写时遇到了问题，可以在论坛上发一个新帖子。 https://forum.radxa.com/c/dev

Difference between revisions of "Rockpi4/dev/usb-install/zh cn"

Revision as of 07:56, 13 September 2021

Contents

准备

安装工具以及驱动

Windows

步骤 1：安装 Android 工具

步骤 2：安装驱动

Linux

MacOS

引导Rock PI4 进入Maskrom模式

通过USB烧写镜像到eMMC模块

Linux/macOS

Windows

步骤 1: 选择 Loader

步骤 2: 选择镜像

步骤 3: 运行

按分区进行安装（高级）

Linux/macOS

Windows

常见问题

故障排除

@@ Line 1: / Line 1: @@
 {{rockpi4_header}}
-{{Languages|rockpi4/dev/usb-install}}
+{{Languages|rockpi4/dev/usb-install/zh_cn}}
      [[rockpi4 | ROCK Pi 4]] > [[rockpi4/dev | Development]] > [[rockpi4/dev/usb-install | Install from USB OTG port]]
-Rock PI supports Maskrom mode, which is a special operation mode for CPU to wait for USB OTG port command.
+Rock PI支持Maskrom模式，这是一种CPU等待USB OTG口命令的特殊操作模式。'''rkdevelopment和AndroidTool'''是我们在Maskrom模式下用来与Rock PI通信的PC端烧录工具。在Linux/MacOS下使用的是'''rkdevelopment'''工具，而在Windows下使用的是'''AndroidTool'''工具。
-The PC tools we use to communicate with rock PI in Maskrom mode are the '''rkdevelopment tool''' and '''AndroidTool tool'''.
-We use '''the rkdevelopment tool in Linux/macOS ''' and '''the AndroidTool tool under Windows'''.
-=== Requirement ===
+=== 准备 ===
-* ROCK Pi 4 mainboard
+* ROCK Pi 4 主板
-* eMMC module
+* eMMC 模块
-* Power adapter
+* 电源适配器
-* '''USB Male A to Male A cable'''(important) USB C to USB A cable does not working on all PCs. [https://forum.radxa.com/t/otg-flashing-not-working/717 See discussion].
+* USB A对A 的数据线 [https://forum.radxa.com/t/otg-flashing-not-working/717 （参考）].
-=== Install Tools&Drivers ===
+=== 安装工具以及驱动 ===
 <div class="toccolours mw-collapsible" style="width:800px; overflow:auto;">
 ==== Windows ====
 <div class="mw-collapsible-content">
-=====Step 1：Install Android tool=====
+=====步骤 1：安装 Android 工具=====
-The tool is provided in a compressed package. First, download the compressed package of this tool, and click the download link [https://dl.radxa.com/tools/windows/AndroidTool_Release_v2.69.zip (AndroidTool_Release_v2.69.zip)]. After downloading, unzip it. Installation is complete.
+这个工具是以压缩包的形式提供的。首先，下载这个工具的压缩包，点击这个链接下载[https://dl.radxa.com/tools/windows/AndroidTool_Release_v2.69.zip (AndroidTool_Release_v2.69.zip)]。下载之后解压并完成安装。
-=====Step 2：Install driver=====
+=====步骤 2：安装驱动=====
-Using the RK driver assistant tool to install the driver.
+使用RK驱动助手工具来安装驱动。
+在此过程中，不需要连接您的Rockchip设备，只需下载压缩包并解压[https://dl.radxa.com/tools/windows/DriverAssitant_v5.0.zip RKDriverAssistant.zip]。
-There’s no need to connect your Rockchip device during this procedure just download and extract [https://dl.radxa.com/tools/windows/DriverAssitant_v5.0.zip RKDriverAssistant.zip]
+然后双击RKDriverAssistant目录下的DriverInstall.exe，启动工具并点击'''Install Driver'''安装驱动。
+如果你已经为其他Rockchip设备安装过Rockchip USB驱动，请先点击 "卸载驱动"。
-Then double click on DriverInstall.exe in the RKDriverAssistant directory to start the utility. If you installed the Rockchip USB drivers for any other Rockchip devices already, make sure you click “Uninstall Driver” first.
 [[File:RK_Driver_Assistant_Install_Uninstall.jpg]]
-Then click “Install Driver”, the driver has finish installing.
 </div>
@@ Line 39: / Line 34: @@
 ==== Linux====
 <div class="mw-collapsible-content">
-For Linux, we build the rkdeveloptool from source code.
+对于Linux，我们从源代码来编译构建'''rkdeveloptool'''工具。
+要在基于Debian的Linux发行版上编译rkdeveloptool工具，请按照以下说明操作。
-To build rkdeveloptool on a Debian based Linux distribution, follow the instruction below:
-Install build dependency:
+安装编译依赖:
    sudo apt-get install libudev-dev libusb-1.0-0-dev dh-autoreconf
-Clone the source code and build:
+克隆源码并编译:
    git clone https://github.com/rockchip-linux/rkdeveloptool
    cd rkdeveloptool
@@ Line 53: / Line 47: @@
    make
-If you encounter compile error like below
+如果你遇到像下面这样的编译错误：
      ./configure: line 4269: syntax error near unexpected token `LIBUSB1,libusb-1.0'
      ./configure: line 4269: `PKG_CHECK_MODULES(LIBUSB1,libusb-1.0)'
-You should install pkg-config libusb-1.0
+你可以安装 '''pkg-config libusb-1.0'''
      sudo apt-get install pkg-config libusb-1.0
-Then re-run
+然后重新执行以下操作
      autoreconf -i
      ./configure
      make
-Now you have rkdeveloptool executable at the current directory.
+现在你在当前目录下会有rkdeveloptool的可执行文件，并添加到系统工具中。
    sudo cp rkdeveloptool /usr/local/bin/
 </div>
@@ Line 74: / Line 68: @@
 ==== MacOS ====
 <div class="mw-collapsible-content">
-For macOS, we build the rkdeveloptool from source code.
+对于 macOS, 我们从源码来编译redeveloptool工具
-To build rkdeveloptool on macOS, you need [https://brew.sh/ homebrew](or similar package manager) to install required packages.
+为了在macOS上编译rkdeveloptool，你需要安装这个支持包[https://brew.sh/ homebrew]。
-Install build dependency:
+安装编译依赖:
      brew install automake autoconf libusb lsusb
-Clone the source code and build:
+克隆源码并编译:
      git clone https://github.com/rockchip-linux/rkdeveloptool
@@ Line 90: / Line 84: @@
      make
-If you encounter compile error like below
+如果出现像下面一样的编译错误
      ./configure: line 4269: syntax error near unexpected token `LIBUSB1,libusb-1.0'
      ./configure: line 4269: `PKG_CHECK_MODULES(LIBUSB1,libusb-1.0)'
-You should install pkg-config libusb-1.0
+你可以安装 pkg-config libusb-1.0
      brew install pkg-config
-Then re-run
+然后重新编译
      autoreconf -i
      ./configure
      make
-Now you have rkdeveloptool executable at the current directory.
+现在，在当前目录下就会有rkdeveloptool的可执行文件
      sudo cp rkdeveloptool /usr/local/bin/
 </div>
 </div>
-=== Boot the board to maskrom mode ===
+=== 引导Rock PI4 进入Maskrom模式 ===
+将ROCK Pi引导到maskrom模式很简单，如下：
-To boot ROCK Pi into maskrom mode is simple:
+* 1. 断电
+** 拔掉SD卡。
-* 1. Power off the board
+** 如果你的rock pi4上有可拆卸的eMMC模块，请将其移除。
-** remove microSD card
+** 如果你的是rock pi4 Plus版本，有焊接的eMMC，则需要按住maskrom键 (1: Maskrom 2: Reset 3: Recovery)
-** if your board has removable eMMC module, remove it
-** if your board is Plus version with soldered eMMC, press and hold the maskrom key. (1: Maskrom 2: Reset 3: Recovery)
 [[File:Rockpi4bplus_key.jpg|400px]]
-* 2. Plug the USB Male A to Mail A cable to ROCK Pi 4 OTG port(the upper USB3 port), the other side to PC
+* 2. 用A对A的USB线，连接PC端的USB和ROCK PI4的OTG接口（上面的USB3.0 接口），
-* 3. Power on the board, release the maskrom key(important)
+* 3. 按住Maskrom按键并且给ROCK PI4上电
-** 4. For Linux/macOS
+** 4. 对于 Linux/macOS
-Now on your Linux PC, '''lsusb''' command show show the following usb devices
+在Linux PC端, 使用'''lsusb'''命令可以看到下面的USB设备。
      Bus 003 Device 005: ID 2207:330c
-** 4. For Windows
+** 4. 对于 Windows
-Open device manager in your Windows PC, check the Device Manager:
+在 Windows PC端，打开设备管理器：
 [[File:RK_Driver_Assistant_Install_Usb_driver.png]]
-It means the device is in '''maskrom mode''' now.
+这就意味着ROCK PI 4已经进入'''maskrom 模式'''.
-* 5. Now plug the eMMC module and proceed the next step to flash.
+* 5. 现在插入eMMC模块，并进行下一步的烧写
-Alternatively, if you are running Android and can access ADB, you can reboot the device to loader mode `adb reboot bootloader` then use the rkdeveloptool to reset the device into maskrom mode `rkdeveloptool rd 3` or Windows AndroidTool '''Switch''' button to go to maskrom mode.
+另外，如果你运行的是安卓系统并且可以访问ADB，你可以将设备重启到loader模式'''adb rebootloader'''，然后使用rkdeveloptool将设备重置到maskrom模式`'''rkdeveloptool rd 3'''`或者Windows AndroidTool '''Switch'' 按钮来进入maskrom模式。
-=== Begin Installation USB -> eMMC ===
+=== 通过USB烧写镜像到eMMC模块 ===
 <div class="toccolours mw-collapsible " style="width:800px; overflow:auto;">
 ==== Linux/macOS ====
 <div class="mw-collapsible-content">
-On your PC, run the rkdeveloptool
+在你的PC端,运行rkdeveloptool工具
      rkdeveloptool ld        # List the device
      DevNo=1	Vid=0x2207,Pid=0x330c,LocationID=305	Maskrom
-Download the loader (flash helper) to init the ram and prepare the flashing environment etc. If you don't have it, you can download it from [https://dl.radxa.com/rockpi/images/loader/ here]
+loader文件用于启动并初始化RAM，并准备好烧录环境。如果你没有loader的bin文件，可以在[https://dl.radxa.com/rockpi/images/loader/ 这里]下载。
      rkdeveloptool db rk3399_loader_vxxxx.bin
-Write the GPT image to eMMC, start to write from offset '''0'''.
+从'''0'''开始烧写GPT镜像到eMMC
      rkdeveloptool wl 0 /path/to/rockpi4b-xxx-gpt.img
-Reboot the device
+重新启动设备
      rkdeveloptool rd
-Now the device should boot the new image on eMMC
+现在，设备应该会重新启动eMMC里的新镜像。
-Please notice that when you want to erase eMMC on board, you can use this command. Get zero.img from [https://dl.radxa.com/rockpi4/images/others/zero.img.gz here].
+请注意，当你想擦除板上的eMMC时，你可以使用这个命令。可以从 [https://dl.radxa.com/rockpi4/images/others/zero.img.gz 这里]下载到zero.img。
      rkdeveloptool db rk3399_loader_vxxxx.bin
@@ Line 176: / Line 169: @@
 <div class="mw-collapsible-content">
-Double click the '''AndroidTool.exe''' and you will see the following interface:
+双击 '''AndroidTool.exe''' 会看到下面的界面:
-If your ROCK Pi is in maskrom mode and connects to PC, you can see that the program detect it, as the red box shown below:
+如果你的ROCK Pi 4已经进入Maskrom模式并连接上电脑，你可以看到红框里面的字样：
 [[File:AndroidTool1.PNG | 600px]]
-===== Step 1: Select Loader =====
+===== 步骤 1: 选择 Loader =====
-Next, click the button in the red box on the right last columns select the loader "rk3399_ loader_ xxxxx.bin ",
+点击下面红框并选择这个"rk3399_ loader_ xxxxx.bin "文件
 [[File:AndroidTool8.PNG | 600px]]
-''Note:'' the loader (flash helper) is used to init the ram and prepare the flashing environment etc. If you don't have it, you can download it from [https://dl.radxa.com/rockpi/images/loader/ here]
+提示：loader用于启动初始化RAM，并准备好烧录环境。如果你没有loader的bin文件，可以在[https://dl.radxa.com/rockpi/images/loader/ 这里]下载。
-===== Step 2: Select Image =====
+===== 步骤 2: 选择镜像 =====
-Then click the right last columns to in the Image row and choose the image you want to flash.
+点击图片中的右侧最后一列的'''...'''，选择你要烧录的镜像
-''Note'': Normally the image name should ends with xxx-gpt.img. If the image name ends with xxx-rkupdate.img, you can not flash with this method.
+通常情况下，镜像的名字应该以xxx-gpt.img结尾。如果镜像名称以xxx-rkupdate.img结尾，你就不能用这个方法进行烧录。
-===== Step 3: Run =====
+===== 步骤 3: 运行 =====
-Finally, click the "run" button in the red box below, and you will see the content in the red box on the right. When the progress reaches 100%, the download is completed.
+点击下面红框中的 "run "按钮，你会看到右边红框中的内容。当进度达到100%时，说明下载就完成了。
 [[File:Androidtool5.PNG | 600px]]
@@ Line 204: / Line 198: @@
 </div>
-=== Install by partitions(Advanced) ===
+=== 按分区进行安装（高级）===
 <div class="toccolours mw-collapsible mw-collapsed" style="width:800px; overflow:auto;">
 ==== Linux/macOS ====
 <div class="mw-collapsible-content">
-Sometimes we only want to update a partition of the image, for example only the boot partition to update kernel only. We can flash by partitions
+有时我们只想更新镜像的一个分区，比如只更新boot分区，只更新kernel。我们可以通过分区来烧写
 <pre>
@@ Line 220: / Line 214: @@
 </pre>
-When the board is in maskrom mode, flash the partitions with the following command and offset:
+当ROCK pi 4处于maskrom模式时，可以根据下面的命令来烧写不同位置的分区
      rkdeveloptool db rk3399_loader_*.bin
@@ Line 238: / Line 232: @@
 </div>
-=== FAQ ===
+=== 常见问题 ===
-If you meet such these situations, you can try to change the bin file by [https://dl.radxa.com/rockpi/images/loader/ rk3399_loader_v1.20.119.bin]
+如果你遇到了类似的问题，你可以试试[https://dl.radxa.com/rockpi/images/loader/ rk3399_loader_v1.20.119.bin]这个bin文件
 [[File:error-loader1.png | 500px]]
 [[File:error-loader2.png | 500px]]
-=== Troubleshooting ===
+=== 故障排除 ===
-* If you have issue with flashing via USB OTG, start a new post on the forum. https://forum.radxa.com/c/dev
+* 如果你在通过USB OTG烧写时遇到了问题，可以在论坛上发一个新帖子。 https://forum.radxa.com/c/dev