Rock3/installusb-install-radxa-cm3-rpi-cm4-io - Revision history

RadxaYuntian at 02:40, 28 September 2022

2022-09-28T02:40:41Z

RadxaYuntian at 02:37, 28 September 2022

2022-09-28T02:37:09Z

Hipboi at 10:43, 28 February 2022

2022-02-28T10:43:24Z

Stephen at 07:06, 15 January 2022

2022-01-15T07:06:15Z

Stephen: /* Install Tools&Drivers */

2021-12-27T10:21:17Z

‎Install Tools&Drivers

Stephen: Created page with "{{rock3_header}} {{Languages|rock3/install/installusb-install-radxa-cm3-rpi-cm4-io}} ROCK 3 > Installation > rock3/installusb-install-r..."

2021-11-27T02:20:26Z

Created page with "{{rock3_header}} {{Languages|rock3/install/installusb-install-radxa-cm3-rpi-cm4-io}} ROCK 3 > Installation > rock3/installusb-install-r..."

New page

{{rock3_header}}
{{Languages|rock3/install/installusb-install-radxa-cm3-rpi-cm4-io}}

[[rock3 | ROCK 3]] > [[rock3/install | Installation]] > [[rock3/installusb-install-radxa-cm3-rpi-cm4-io | Install to eMMC from USB port (Radxa CM3 RPI CM4 IO) ]]

Radxa CM3 RPI CM4 IO board supports maskrom mode, which is a special running mode the CPU is waiting for command from USB OTG port. The PC tool we use to communicate with Radxa CM3 RPI CM4 IO board in maskrom mode is rkdeveloptool, an open source tool by Rockchip.

=== Requirement ===

* Radxa CM3 RPI CM4 IO board
* 12V DC Power adapter
* MicroUSB to USB Type-A cable.
* [[rock3/downloads | Radxa CM3 RPI CM4 IO board system images]]
* [https://dl.radxa.com/rock3/images/loader/rk356x_spl_loader_ddr1056_v1.06.110.bin rk356x loader]

=== Install Tools&Drivers ===

==== 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 [https://dl.radxa.com/tools/windows/RKDevTool_Release_v2.81.zip (RKDevTool_Release_v2.81.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 [https://dl.radxa.com/tools/windows/DriverAssitant_v5.0.zip RKDriverAssistant.zip]

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.

==== Linux====
For Linux, we build the rkdeveloptool, '''>=1.32''', from source code.

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

Make sure that its version is at least 1.32.

rkdeveloptool -v
rkdeveloptool ver 1.32

==== MacOS ====
To build rkdeveloptool on macOS, you need [https://brew.sh/ 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 5384: syntax error near unexpected token `LIBUSB1,libusb-1.0'
./configure: line 5384: `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/

Make sure that its version is at least 1.32.

rkdeveloptool -v
rkdeveloptool ver 1.32

=== Boot the board to maskrom mode ===
To boot CM4 IO into maskrom mode is simple:
* Power off the board and remove microSD card
* Plug DC power adapter into RPI CM4 IO board
* Plug MicroUSB to USB Type-A cable into MicroUSB port on RPI CM4 IO board, the other side to PC
* Press and hold the golden button
[[File:Cm4-io-maskrom.jpg |400px]]
* Use one dupont wire to short these two pins. Here it is purple wire.
* Two seconds later release golden button
* Check usb device
** For Linux/macOS: lsusb result: '''Bus 001 Device 112: ID 2207:350a Fuzhou Rockchip Electronics Company'''
** For Windows: Open RKDevTool and you would see the device is in "maskrom mode".
[[File:select-loader-bin.jpeg | 600px]]

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.

=== Begin Installation USB -> eMMC ===

==== Linux/macOS ====

On your PC, run the rkdeveloptool

rkdeveloptool ld
DevNo=1 Vid=0x2207,Pid=0x350a,LocationID=104 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/rock3/images/loader/rk356x_spl_loader_ddr1056_v1.06.110.bin here]

rkdeveloptool db rk356x_spl_loader_ddr1056_v1.06.110.bin

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

rkdeveloptool wl 0 /path/to/radxa-cm3-rpi-cm4-io-xxx-gpt.img

Reboot the device

rkdeveloptool rd

Now the device should boot the new image on 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].

rkdeveloptool db rk356x_spl_loader_ddr1056_v1.06.110.bin
rkdeveloptool wl 0 zero.img

==== Windows ====

Double click the '''RKDevTool.exe''' and you will see the following interface:

Double click this red box and modify it to '''image''' in the second row.

[[File:Modify-options.jpeg | 600px]]

===== Step 1: Select Loader =====
If your ROCK 3 is in maskrom mode and connects to PC, you can see that the program detect it '''Found one MASKROM Device''' in the red box

Next, click the button in the first row on the right last columns select the loader "rk356x_xxx_ loader_ xxxxx.bin ",

[[File:select-loader-bin.jpeg | 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/rock3/images/loader/rk356x_spl_loader_ddr1056_v1.06.110.bin here]

===== Step 2: Select Image =====

Then click the right last columns to in the Image row and choose the image you want to flash.You can download the image from [https://wiki.radxa.com/Rock3/downloads here]

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

===== Step 3: Run =====

Finally, click the "run" button, and you will see the content on the right. When the progress reaches 100% or show '''Download image OK''' in the red box, the download is completed.

[[File:3a-run-image.jpeg | 600px]]

=== Troubleshooting ===

Check [[rock3/FAQs |ROCK 3 FAQs]] first, if it doesn't help, start a new post on the forum https://forum.radxa.com/c/rock3.

← Older revision		Revision as of 02:37, 28 September 2022
Line 39:		Line 39:

	=== Begin Installation USB -> eMMC ===		=== Begin Installation USB -> eMMC ===
		+
		+	'''Unlike balenaEtcher, rkdevtool does not support decompression of the image file, so you will have to decompress it into an img file first before flashing.'''
		+
		+	Failure to perform this step will result in non-working eMMC installation. However, the device is not bricked. You can either restart the flashing process to write the correct system image, or use micro SD card to boot.

	==== Linux/macOS ====		==== Linux/macOS ====

@@ Line 11: / Line 11: @@
 * 12V DC Power adapter
 * MicroUSB to USB Type-A cable.
-* [[rock3/downloads | Radxa CM3 RPI CM4 IO board system images]]
+* [[Rock3/downloads | Radxa CM3 IO system image]], which also supports RPI CM4 IO board
 * [https://dl.radxa.com/rock3/images/loader/rk356x_spl_loader_ddr1056_v1.06.110.bin rk356x loader]

@@ Line 16: / Line 16: @@
 === Install Tools&Drivers ===
 Please check this guide, [[rock3/install/rockchip-flash-tools | Install rockchip flash tools under Windows/Linux/MacOS PC]].
 === Boot the board to maskrom mode ===
 To boot CM4 IO into maskrom mode is simple:
 * Power off the board and remove microSD card
 * Plug MicroUSB to USB Type-A cable into MicroUSB port on RPI CM4 IO board, the other side to PC
 * Press and hold the golden button
-[[File:Cm4-io-maskrom.jpg | 600px]]
+* Power on the CM3(See Power on section)
-* Use one dupont wire to short these two pins. Here it is purple wire.
 * Two seconds later release golden button
 * Check usb device

@@ Line 23: / Line 23: @@
 * Plug MicroUSB to USB Type-A cable into MicroUSB port on RPI CM4 IO board, the other side to PC
 * Press and hold the golden button
-[[File:Cm4-io-maskrom.jpg |400px]]
+[[File:Cm4-io-maskrom.jpg | 600px]]
 * Use one dupont wire to short these two pins. Here it is purple wire.
 * Two seconds later release golden button
@@ Line 29: / Line 29: @@
 ** For Linux/macOS: lsusb result: '''Bus 001 Device 112: ID 2207:350a Fuzhou Rockchip Electronics Company'''
 ** For Windows: Open RKDevTool and you would see the device is in "maskrom mode".
-[[File:select-loader-bin.jpeg | 600px]]
+[[File:select-loader-bin.jpeg | 800px]]
 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.
@@ Line 68: / Line 68: @@
 Double click this red box and modify it to '''image''' in the second row.
-[[File:Modify-options.jpeg | 600px]]
+[[File:Modify-options.jpeg | 800px]]
 ===== Step 1: Select Loader =====
@@ Line 75: / Line 75: @@
 Next, click the button in the first row on the right last columns select the loader "rk356x_xxx_ loader_ xxxxx.bin ",
-[[File:select-loader-bin.jpeg | 600px]]
+[[File:select-loader-bin.jpeg | 800px]]
 ''Note:'' the loader (flash helper) is used to init the ram and prepare the flashing environment etc.
@@ Line 90: / Line 90: @@
 Finally, click the "run" button, and you will see the content on the right. When the progress reaches 100% or show '''Download image OK''' in the red box, the download is completed.
-[[File:3a-run-image.jpeg | 600px]]
+[[File:3a-run-image.jpeg | 800px]]
 === Troubleshooting ===
 Check [[rock3/FAQs |ROCK 3 FAQs]] first, if it doesn't help, start a new post on the forum https://forum.radxa.com/c/rock3.

@@ Line 15: / Line 15: @@
 === Install Tools&Drivers ===
+Please check this guide, [[rock3/install/rockchip-flash-tools | Install rockchip flash tools under Windows/Linux/MacOS PC]].
-==== 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 [https://dl.radxa.com/tools/windows/RKDevTool_Release_v2.81.zip (RKDevTool_Release_v2.81.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 [https://dl.radxa.com/tools/windows/DriverAssitant_v5.0.zip RKDriverAssistant.zip]
-−
-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.
-−
-==== Linux====
-For Linux, we build the rkdeveloptool, '''>=1.32''', from source code.
-−
-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
-  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/
-−
-Make sure that its version is at least 1.32.
-−
-  rkdeveloptool -v
-  rkdeveloptool ver 1.32
-−
-==== MacOS ====
-To build rkdeveloptool on macOS, you need [https://brew.sh/ 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 5384: syntax error near unexpected token `LIBUSB1,libusb-1.0'
-  ./configure: line 5384: `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/
-−
-Make sure that its version is at least 1.32.
-−
-  rkdeveloptool -v
-  rkdeveloptool ver 1.32
 === Boot the board to maskrom mode ===