Difference between revisions of "APITestPage"

From FriendlyELEC WiKi
Jump to: navigation, search
(updated by API)
(updated by API)
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[NanoPC-T6 Armbian Installation Guide/zh|查看中文]]
 
== Introduction ==
 
This is a simple guide to install Armbian on NanoPC-T6 and boot through SPI Nor Flash and NVMe SSD, covering the following contents:
 
* Erase SPI Nor Flash and eMMC
 
* Flash BootLoader to SPI Nor Flash
 
* Boot Armbian system from NVMe
 
  
== Prerequisites ==
+
{{RockchipUnbrick|NanoPC-T4}}
Before starting, please ensure you have the following:
+
* A NanoPC T6 with SPI Nor Flash
+
* A USB-C cable
+
* An NVMe SSD
+
* A PC running Windows
+
* A power adapter, etc.
+
All steps in this guide are currently applicable only to Windows systems.
+
 
+
== Download Required Files ==
+
* '''Get the necessary tools''': Visit [https://dl.friendlyelec.com/nanopct6 here], find '''RKDevTool_v3.19_for_window.zip''', '''DriverAssitant_v5.1.1.zip''' and '''win32diskimager.rar''' in the '''05_Tools''' directory, and download them locally.
+
* '''Get Armbian image''': Visit [https://www.armbian.com/nanopct6/ here] to download the Armbian image file.
+
* '''Get RK3588 loader and SPI Images''': Visit [http://112.124.9.243/dvdfiles/RK3588/tools/ here] to download '''MiniLoaderAll.bin''' and '''rkspi_loader.img.zip'''.
+
The downloaded files are in compressed packages, and need to be extracted.
+
 
+
== Install Rockchip USB Driver and RKDevTool ==
+
* Extract '''DriverAssitant_v5.1.1.zip''' to install Rockchip USB driver.
+
* Extract '''RKDevTool_v3.19_for_window.zip''' to obtain the Rockchip flashing tool '''RKDevTool'''.
+
 
+
== Flashing Steps ==
+
=== Let NanoPC-T6 enter Rockusb Maskrom Mode ===
+
* Connect NanoPC-T6 to the computer using a USB Type-C cable.
+
* Launch '''RKDevTool''' on the computer (Note: use version 2.96 or later).
+
* Disconnect the power from NanoPC-T6, hold down the '''MASK''' button, connect the power, and release the button when you see '''Found One MASKROM Device''' at the bottom of the screen, as shown below:
+
[[File:Rkdevtool_found_one_maskrom_device.png|frameless|600px]]
+
 
+
=== Erase SPI Nor Flash and eMMC ===
+
Remove the SD card from the development board (if any). To avoid any residual boot data interfering with the Armbian startup, it is recommended to erase the SPI Nor Flash and eMMC once (optional). The method is as follows:
+
* In the '''RKDevTool''' interface, click the '''Advanced Function''' tab.
+
* Select '''MiniLoaderAll.bin''' in the '''Boot''' text box, then click the '''Download''' button.
+
* Select '''EMMC''', click '''Switch Storage''', and then click the '''EraseAll''' button to erase eMMC.
+
[[File:Rkdevtool_erase_emmc.png|frameless|600px]]
+
* Select '''SPINOR''', click '''Switch Storage''', and then click the '''EraseAll''' button to erase SPI Nor Flash.
+
[[File:Rkdevtool_erase_spinorflash.png|frameless|600px]]
+
 
+
=== Flash BootLoader to SPI Nor Flash ===
+
Refer to the picture below to set the flashing content in the '''RKDevTool''' interface:<br/>
+
[[File:Rkdevtool_flash_spinor.png|frameless|600px]]<br/>
+
You can right-click in the list, choose '''Load Config''', select '''friendlyelec-spinor-config.cfg''' to load the preset settings, then check '''Write by Address''' (important). Finally, click the '''Run''' button and wait for the process to complete.
+
 
+
=== Flash Armbian Image to NVMe SSD ===
+
Use the '''win32diskimager''' tool on Windows to write the '''.img''' format Armbian image to the NVMe SSD.
+
 
+
=== Run Armbian ===
+
Install the NVMe SSD on NanoPC-T6, power on, and follow the Armbian wizard to configure the system.
+
 
+
=== Related information ===
+
* https://github.com/armbian/build/pull/5573
+

Latest revision as of 09:23, 4 June 2024

1 Unbricking Method

If the ROM is not installed correctly, causing the development board to become bricked, and you might not have the opportunity to reinstall the ROM via an SD card, you need to enter Maskrom mode to unbrick it by erasing the storage device.

1.1 Windows Users

1.1.1 Download Required Files

  • Get the necessary tools: Visit here, find RKDevTool_v3.19_for_window.zip and DriverAssitant_v5.12.zip in the 05_Tools directory, and download them to your local machine.
  • Install Rockchip USB driver and RKDevTool: Extract DriverAssitant_v5.12.zip to install the Rockchip USB driver, and extract RKDevTool_v3.19_for_window.zip to obtain the Rockchip flashing tool RKDevTool.
  • Get the loader: Visit here, enter the tools directory corresponding to your CPU model, and download MiniLoaderAll.bin.

1.1.2 Enter Maskrom Mode to Erase the Storage Device

  • Connect NanoPC-T4 to your computer using a USB data cable.
  • Start RKDevTool on your computer.
  • Disconnect the power from NanoPC-T4, hold down the MASK button, connect the power, and release the button when you see Found One MASKROM Device displayed at the bottom of the interface, as shown below:

Rkdevtool found one maskrom device.png

  • Click the Advanced Function tab in the RKDevTool interface.
  • In the Boot text box, select MiniLoaderAll.bin, then click the Download button.
  • Select EMMC, click Switch Storage, then click the EraseAll button to erase the eMMC.

Rkdevtool erase emmc.png

  • At this point, NanoPC-T4 is restored to its initial state and can be normally booted via SD card or eMMC.

1.2 Linux/Mac Users

1.2.1 Download the Required Files

  • Get the necessary tools: Visit here and find upgrade_tool_v2.30_for_linux.tgz (or for Mac users, select upgrade_tool_v2.25_for_mac.tgz) in the 05_Tools directory and download it locally.
  • Get the loader: Visit here, enter the tools directory corresponding to your CPU model, and download MiniLoaderAll.bin.

1.2.2 Installation for upgrade_tool

The following commands are for Linux, with only slight differences in file and directory names for Mac users:

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 Enter Maskrom Mode to Erase the Storage Device

  • Connect NanoPC-T4 to the computer using a USB data cable.
  • Disconnect the power from NanoPC-T4, hold down the MASK button, connect the power, and release the button after 4 seconds.
  • Check the connection with the following command:
upgrade_tool LD

A result similar to "DevNo=1 Vid=0x2207,Pid=0x350b,LocationID=13 Mode=Maskrom SerialNo=" indicates that the device has been detected.

  • Erase the eMMC with the following command:
upgrade_tool EF MiniLoaderAll.bin
  • At this point, NanoPC-T4 has been restored to its initial state and can boot the system normally via SD card or eMMC.