Difference between revisions of "APITestPage"

From FriendlyELEC WiKi
Jump to: navigation, search
(updated by API)
(updated by API)
Line 1: Line 1:
[[NanoPC-T6 Armbian Installation Guide|English]]
+
[[NanoPC-T6 Armbian Installation Guide/zh|查看中文]]
==介绍==
+
== Introduction ==
这是一份简单指南,指引如何在NanoPC-T6上安装Armbian,通过SPI Nor Flash和NVME SSD引导,包含如下内容:
+
This is a simple guide to install Armbian on NanoPC-T6 and boot through SPI Nor Flash and NVMe SSD, covering the following contents:
* 擦除SPI Nor Flash和eMMC
+
* Erase SPI Nor Flash and eMMC
* 烧录BootLoader到SPI Nor Flash
+
* Flash BootLoader to SPI Nor Flash
* 从NVME引导Armbian系统
+
* Boot Armbian system from NVMe
  
==前提条件==
+
== Prerequisites ==
在开始之前,请确保你具备以下条件:
+
Before starting, please ensure you have the following:
* 一块有SPI Nor Flash的NanoPC T6开发板
+
* A NanoPC T6 development board with SPI Nor Flash
* 一条USB-C数据线
+
* A USB-C data cable
* 一块NVMe SSD固态硬盘
+
* An NVMe SSD
* 一台运行Windows的PC
+
* A PC running Windows
 +
* A power adapter, etc.
 +
All steps in this guide are currently applicable only to Windows systems.
  
==下载所需文件==
+
== Download Required Files ==
* 获取所需工具:访问[https://dl.friendlyelec.com/nanopct6 这里],在 "05_Tools" 目录中找到"RKDevTool_v3.19_for_window.zip"和"win32diskimager.rar"
+
* '''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.
* 获取Armbian固件: 访问[https://www.armbian.com/nanopct6/ 这里],下载Armbian的固件文件,本文使用的固件解压后的文件名为 "Armbian_community_24.8.0-trunk.36_Nanopct6_noble_vendor_6.1.43_gnome-oibaf_desktop.img"
+
* '''Get Armbian firmware''': Visit [https://www.armbian.com/nanopct6/ here] to download the Armbian firmware file.
* 获取RK3588 loader与SPI Images: 访问[http://112.124.9.243/dvdfiles/RK3588/tools/ 这里],下载 "MiniLoaderAll.bin" 和 "rkspi_loader.img.zip"
+
* '''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'''.
所有步骤目前仅适用于 Windows 系统,下载下来的文件是压缩包的,均需要解压缩。
+
The downloaded files are in compressed packages, and need to be extracted.
  
==烧写步骤==
+
== Install Rockchip USB Driver and RKDevTool ==
===设置NanoPC-T6为Maskrom模式===
+
* Extract '''DriverAssitant_v5.1.1.zip''' to install Rockchip USB driver.
* 通电状态下,按住mask键,再短按reset键
+
* Extract '''RKDevTool_v3.19_for_window.zip''' to obtain the Rockchip flashing tool '''RKDevTool'''.
* 使用USB Type-C线将NanoPC-T6与电脑相连接
+
 
* 在电脑上启动RKDevTool,界面上应显示“Found One MASKROM Device”,如下图所示:
+
== Flashing Steps ==
 +
=== Put NanoPC-T6 into 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]]
 
[[File:Rkdevtool_found_one_maskrom_device.png|frameless|600px]]
===擦除SPI Nor Flash和eMMC===
+
 
拨出开发板上的SD卡(如果有的话),为了避免存储内有残余的引导数据干扰引导,我们对SPI Nor Flash和eMMC作一次擦除动作 (可选),方法如下:
+
=== Erase SPI Nor Flash and eMMC ===
* 在RKDevTool界面上点击 "Advanced Function" 选项
+
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:
* 先在 "Boot" 编辑框中选择 "MiniLoaderAll.bin",然后点击 "Download" 按钮
+
* In the '''RKDevTool''' interface, click the '''Advanced Function''' tab.
* 选中 "EMMC",点 "Switch Storage",再点击 "ErashAll" 按钮擦除 eMMC
+
* 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]]
 
[[File:Rkdevtool_erase_emmc.png|frameless|600px]]
* 选中 "SPINOR", 点 "Switch Storage",再点击 "ErashAll" 按钮擦除 SPI Nor Flash
+
* Select '''SPINOR''', click '''Switch Storage''', and then click the '''EraseAll''' button to erase SPI Nor Flash.
 
[[File:Rkdevtool_erase_spinorflash.png|frameless|600px]]
 
[[File:Rkdevtool_erase_spinorflash.png|frameless|600px]]
  
===烧写bootloader到SPI Nor Flash===
+
=== Flash BootLoader to SPI Nor Flash ===
参考如下示范图片,在RKDevTool界面上设置烧写的内容:<br/>
+
Refer to the demonstration image below to set the flashing content in the '''RKDevTool''' interface:<br/>
 
[[File:Rkdevtool_flash_spinor.png|frameless|600px]]<br/>
 
[[File:Rkdevtool_flash_spinor.png|frameless|600px]]<br/>
可以在界面上右击,选择"Load Config",选择"friendlyelec-spinor-config.cfg"加载预设的设置,然后钩选"Write by Address", 最后点击"Run"按钮。
+
You can right-click in the interface, 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.
  
===烧写bootloader到SPI Nor Flash===
+
=== Flash Armbian Firmware to NVMe SSD ===
在继续之前,让我们使用 BalenaEtcher 将 Armbian 刷写到 SD 卡上。请按照以下步骤操作:
+
Extract the firmware file with the '''.img''' extension, and use the '''win32diskimager''' tool on Windows to write the '''.img''' format Armbian firmware to the NVMe SSD.
# 打开 BalenaEtcher。
+
# 选择你之前下载的 Armbian 镜像。
+
[[File:balenaetcher-screen.png|thumb|center|801x507px]]
+
刷写后,请记住将 SD 卡从你的 PC 上断开,然后插入 NanoPC T6。
+
  
以下是默认的登录凭据:
+
=== Run Armbian ===
 
+
Install the NVMe SSD on NanoPC-T6, power on, and follow the Armbian wizard to configure the system.
{| class="wikitable"
+
<!--
! 用户名 !! 密码
+
=== Install Armbian Firmware to eMMC ===
|-
+
Launch armbian-config in the command line:
| root || 1234
+
|}
+
 
+
=== 从 NanoPC 刷写 NvME 驱动器 ===
+
现在你已经进入了你的 NanoPC,你需要直接在 NanoPC 上下载操作系统。你可以从互联网下载,也可以使用 SFTP 传输之前下载的文件。记住,一旦你将操作系统加载到 NvME 驱动器上,你需要重置之前更改的密码。
+
 
+
要继续加载镜像,请执行以下命令:
+
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
xz -dc Armbian_community_24.5.0-trunk.433_Nanopct6_bookworm_edge_6.8.7_minimal.img.xz | dd of=/dev/nvme0n1 bs=4k status=progress && sync
+
sudo armbian-config
 
</syntaxhighlight>
 
</syntaxhighlight>
完成后,执行命令
+
Go to '''System''' -> '''Install''', choose '''Boot from eMMC - system on eMMC''', and complete the subsequent operations as needed. After installation, power off, remove the NVMe SSD, and power on to boot Armbian from eMMC.
<syntaxhighlight lang="bash">
+
-->
shutdown -h now
+
</syntaxhighlight>
+
等待 LED 停止闪烁,然后继续移除 SD 卡。
+
 
+
== 安装 Proxmox ==
+
要安装 Proxmox,你需要配置一个静态 IP。建议仅安装“标准”软件包选择,因为 Proxmox VE 包含自己的 qemu 和 lxc 包。不需要桌面环境。
+
 
+
=== 配置主机名和 IP ===
+
在 /etc/hosts 中为你的 IP 地址添加一个条目,确保你的机器的主机名是可解析的。移除默认条目 127.0.1.1。
+
 
+
示例 /etc/hosts 配置:
+
<syntaxhighlight lang="text">
+
127.0.0.1      localhost.localdomain localhost
+
192.168.15.77  prox4m1.proxmox.com prox4m1
+
 
+
# IPv6 行(可选)
+
::1            localhost ip6-localhost ip6-loopback
+
ff02::1        ip6-allnodes
+
ff02::2        ip6-allrouters
+
</syntaxhighlight>
+
使用以下命令验证设置:
+
<syntaxhighlight lang="bash">
+
hostname --ip-address
+
</syntaxhighlight>
+
应返回你的 IP 地址。
+
 
+
=== 安装 Proxmox VE ===
+
添加 Proxmox VE 仓库:
+
<syntaxhighlight lang="bash">
+
echo 'deb [arch=arm64] https://mirrors.apqa.cn/proxmox/debian/pve bookworm port' > /etc/apt/sources.list.d/pveport.list
+
</syntaxhighlight>
+
 
+
添加仓库密钥:
+
<syntaxhighlight lang="bash">
+
curl -L https://mirrors.apqa.cn/proxmox/debian/pveport.gpg -o /etc/apt/trusted.gpg.d/pveport.gpg
+
</syntaxhighlight>
+
 
+
更新仓库和系统:
+
<syntaxhighlight lang="bash">
+
apt update && apt full-upgrade
+
</syntaxhighlight>
+
 
+
安装 Proxmox VE 包和依赖项:
+
<syntaxhighlight lang="bash">
+
apt install ifupdown2 proxmox-ve postfix open-iscsi
+
</syntaxhighlight>
+
 
+
在安装过程中根据你的偏好配置软件包,特别是用于邮件路由的 postfix。如果不确定,请选择 postfix 配置的 local only。
+
 
+
安装后,通过 https://youripaddress:8006 访问管理 Web 界面。如果遇到 ifupdown2 错误,运行以下命令:
+
<syntaxhighlight lang="bash">
+
systemctl enable --now networking.service
+
</syntaxhighlight>
+
然后重试:
+
<syntaxhighlight lang="bash">
+
apt install ifupdown2
+
</syntaxhighlight>
+
你应该不再收到错误。
+
 
+
== 结论 ==
+
完成了,你已经在你的 NanoPC T6 上安装了 Proxmox。下面附上所有有用的链接,以跟踪此移植的开发状态。
+

Revision as of 02:51, 4 June 2024

查看中文

1 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

2 Prerequisites

Before starting, please ensure you have the following:

  • A NanoPC T6 development board with SPI Nor Flash
  • A USB-C data cable
  • An NVMe SSD
  • A PC running Windows
  • A power adapter, etc.

All steps in this guide are currently applicable only to Windows systems.

3 Download Required Files

  • Get the necessary tools: Visit 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 firmware: Visit here to download the Armbian firmware file.
  • Get RK3588 loader and SPI Images: Visit here to download MiniLoaderAll.bin and rkspi_loader.img.zip.

The downloaded files are in compressed packages, and need to be extracted.

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

5 Flashing Steps

5.1 Put NanoPC-T6 into 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:

Rkdevtool found one maskrom device.png

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

Rkdevtool erase emmc.png

  • Select SPINOR, click Switch Storage, and then click the EraseAll button to erase SPI Nor Flash.

Rkdevtool erase spinorflash.png

5.3 Flash BootLoader to SPI Nor Flash

Refer to the demonstration image below to set the flashing content in the RKDevTool interface:
Rkdevtool flash spinor.png
You can right-click in the interface, 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.

5.4 Flash Armbian Firmware to NVMe SSD

Extract the firmware file with the .img extension, and use the win32diskimager tool on Windows to write the .img format Armbian firmware to the NVMe SSD.

5.5 Run Armbian

Install the NVMe SSD on NanoPC-T6, power on, and follow the Armbian wizard to configure the system.