Please enable javascript, or click here to visit my ecommerce web site powered by Shopify.
Jump to: navigation, search

Rockpi4/dev/usb-install

< Rockpi4‎ | dev
Revision as of 09:09, 28 May 2020 by Shine (Talk | contribs)

    ROCK Pi 4 >  Development >  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.
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 and MAC systems and the AndroidTool tool in Windows systems.

Requirement

  • ROCK Pi 4 mainboard
  • eMMC module
  • Power adapter
  • USB Male A to Male A cable(important) USB-C has been seen as not working, an adaptor for USB-C to USB-A has worked. See discussion.

Make sure AndroidTool is set up on host computer

Windows

Step 1:Install Android tool:
The tool is provided in a compressed package. First, download the compressed package of this tool, and click the download link (AndroidTool_Release_v2.3.zip). After downloading, unzip it. Installation is complete.

Step 2:Install driver:
Using the RK driver assistant tool to install the driver.

There’s no need to connect your Rockchip device during this procedure just download and extract RKDriverAssistant.zip
Then double click on DriverInstall.exe in the RKDriverAssistant directory to start the utility.If you've previously tried to install
the Rockchip USB drivers for any Rockchip devices make sure you click “Uninstall Driver” first.

RK Driver Assistant Install Uninstall.jpg

Then click “Install Driver”, the driver has finish installing.

Make sure rkdeveloptool is set up on host computer

Linux

To build rkdeveloptool on a debain based Linux distribution, follow the instruction below:

Install build dependecy:

 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
 autoreconf -i
 ./configure
 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

   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.

 sudo cp rkdeveloptool /usr/local/bin/

MacOS

To build rkdeveloptool on macOS, you need homebrew(or similar package manager) to install required packages.

Install build dependency:

   brew install automake autoconf libusb

Clone the source code and build:

   git clone https://github.com/rockchip-linux/rkdeveloptool
   cd rkdeveloptool
   autoreconf -i
   ./configure
   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

   brew install pkg-config

Then re-run

   autoreconf -i
   ./configure
   make

Now you have rkdeveloptool executable at the current directory.

   sudo cp rkdeveloptool /usr/local/bin/

Boot the board to maskrom mode

To boot ROCK Pi into maskrom mode is simple, you don't need to press any key

  • Power off the board and remove any bootable storage media, remove microSD card, remove eMMC module.
  • Plug the USB Male A to Mail A cable to ROCK Pi 4 OTG port(the upper USB3 port), the other side to PC
  • Power on the board

Now on your Linux PC, lsusb command show show the following usb devices

   Bus 003 Device 005: ID 2207:330c

Or open device manager in your Windows PC, and the following devices will be displayed
RK Driver Assistant Install Usb driver.png

It means the device is in maskrom mode now.

  • Now plug the eMMC module and proceed the next step to flash.

Install to eMMC via USB

Linux user follow here:

On your PC, run the 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 here

   rkdeveloptool db rk3399_loader_vxxxx.bin

Write the GPT image to eMMC, start to write from offset 0.

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

Reboot the device

   rkdeveloptool rd

Now the device should boot the new image on eMMC

Windows user follow here:

Open the tool and you will see the following interface:
First, after opening the tool, you can see that the red box shows that the Rock Pi is in the maskrom mode. Then, clean up the redundant items, right-click = > select "Clear Items".
AndroidTool1.PNG

Then, add an item, right-click = > select "add item".
AndroidTool2.PNG

Then, select a profile for the newly added item, right-click = > select "load config".
Android3.PNG
Open the folder of Android tool and select "config_ rockpi_gpt"Configuration file for GPT.
Android4.PNG

Then, you can see "image" in the name column of the newly added item. Next, click the button in the red box on the far right of the first item and select "rk3399_ loader_ xxxxx.bin ",
and then click the right most button of the second item to select the image you want to burn.
AndroidTool8.PNG

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.
Androidtool5.PNG

Install by partitions(optional)

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

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

When the board is in maskrom mode, flash the partitions with the following command and offset:

   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

Troubleshooting