diff --git a/docs/common/radxa-os/install-system/_use_dd_emmc.mdx b/docs/common/radxa-os/install-system/_use_dd_emmc.mdx index f7bef227b..5616449d9 100644 --- a/docs/common/radxa-os/install-system/_use_dd_emmc.mdx +++ b/docs/common/radxa-os/install-system/_use_dd_emmc.mdx @@ -1,16 +1,16 @@ -主要介绍如何使用 `dd` 命令将系统安装到 eMMC 中。 +介绍如何在 MicroSD 卡启动系统正常的情况下，使用 `dd` 命令将系统安装到 eMMC 中。 :::warning -安装系统会格式化 eMMC 模块，如果有重要数据请提前备份！ +安装系统会格式化 eMMC，如果有重要数据请提前备份！ ::: ## 使用前提 您需要满足以下条件才可以使用 `dd` 命令将系统安装到 eMMC 中： -- 系统可以通过其他系统启动介质可以正常启动系统：推荐使用 MicroSD 卡启动系统 +- 系统可以通过 MicroSD 卡正常启动系统 -- eMMC 模块安装到主板上或主板本身板载 eMMC +- eMMC 安装到主板上或主板板载 eMMC ## 硬件连接 @@ -34,7 +34,7 @@ eMMC 模块安装步骤： -若你的主板是含有板载 eMMC 的版本，无需安装。 +若你的主板是板载 eMMC 的版本，无需安装。 @@ -43,7 +43,7 @@ eMMC 模块安装步骤： ### 下载系统镜像 -主板需要访问[资源汇总下载](../../download)页面，直接下载系统镜像文件到本地上。 +主板需要访问 资源汇总下载 页面，下载 **最新系统镜像** 到主板上。 :::tip 镜像说明 下载的系统镜像是压缩文件，需要解压后才能使用！ @@ -61,7 +61,7 @@ wget -其中 `` 为系统镜像文件的下载地址，可以复制[资源汇总下载](../../download)页面中的镜像下载地址进行替换。 +其中 `` 为系统镜像文件的下载地址，可以复制 资源汇总下载 页面中的镜像下载地址进行替换。 下载示例：{`wget ${props?.download_url ?? ''}`} @@ -104,12 +104,10 @@ lsblk ``` NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINTS -mmcblk0 179:0 0 58G 0 disk -├─mmcblk0p1 179:1 0 16M 0 part /config -├─mmcblk0p2 179:2 0 300M 0 part /boot/efi -└─mmcblk0p3 179:3 0 57.6G 0 part / -zram0 254:0 0 982.6M 0 disk [SWAP] -mmcblk1 179:0 0 58G 0 disk +··· +mmcblk1 179:0 0 29.1G 0 disk +└─mmcblk1p1 179:1 0 29.1G 0 part +··· ``` ### 安装系统镜像 @@ -156,13 +154,10 @@ lsblk ``` NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINTS -mmcblk0 179:0 0 58G 0 disk -├─mmcblk0p1 179:1 0 16M 0 part /config -├─mmcblk0p2 179:2 0 300M 0 part /boot/efi -└─mmcblk0p3 179:3 0 57.6G 0 part / -zram0 254:0 0 982.6M 0 disk [SWAP] -mmcblk1 179:0 0 58G 0 disk -├─mmcblk1p1 179:1 0 16M 0 part -├─mmcblk1p2 179:2 0 300M 0 part -└─mmcblk1p3 179:3 0 57.6G 0 part +··· +mmcblk0 179:0 0 29.1G 0 disk +├─mmcblk0p1 179:1 0 16M 0 part +├─mmcblk0p2 179:2 0 300M 0 part +└─mmcblk0p3 179:3 0 28.8G 0 part +··· ``` diff --git a/docs/common/radxa-os/install-system/_use_dd_nvme.mdx b/docs/common/radxa-os/install-system/_use_dd_nvme.mdx index 361565dcb..fcb04300d 100644 --- a/docs/common/radxa-os/install-system/_use_dd_nvme.mdx +++ b/docs/common/radxa-os/install-system/_use_dd_nvme.mdx @@ -1,6 +1,6 @@ import { Image } from "@site/src/utils/docs"; -主要介绍如何使用 `dd` 命令将系统安装到 NVMe SSD 中。 +介绍如何在 MicroSD 卡启动系统正常的情况下，使用 `dd` 命令将系统安装到 NVMe SSD 中。 :::warning 安装系统会格式化 NVMe SSD，如果有重要数据请提前备份！ @@ -10,23 +10,13 @@ import { Image } from "@site/src/utils/docs"; 您需要满足以下条件才可以使用 `dd` 命令将系统安装到 NVMe SSD 中： -- 系统可以通过其他存储设备正常启动系统：推荐使用 MicroSD 卡启动系统 +- 系统可以通过 MicroSD 卡正常启动系统 - NVMe 安装到主板上 ## 硬件连接 -您可以根据自己的主板配置进行操作。 - -:::tip -教程适用于多款主板，你需要根据自己的主板配置选择对应的步骤进行硬件连接。 - -主板安装 NVMe SSD 可分为两种情况： - -- 主板有 M.2 M Key 接口：可直接安装 NVMe SSD - -- 主板无 M.2 M Key 接口且配备 PCIe FPC 接口：可通过 PCIe 转 M.2 M Key HAT 模块安装 NVMe SSD - ::: +将 NVMe SSD 安装到主板上，连接显示器，使用电源适配器给主板供电。 @@ -49,7 +39,7 @@ import { Image } from "@site/src/utils/docs"; src="/img/common/radxa-os/install-system/radxa-#board#-nvme-ssd.webp" board={props.board} fallback={props.board} - width="300" + width="1200" /> @@ -62,7 +52,7 @@ import { Image } from "@site/src/utils/docs"; ### 下载系统镜像 -主板需要访问[资源汇总下载](../../../../download)页面，直接下载系统镜像文件到本地上。 +主板需要访问 资源汇总下载 页面，下载 **最新系统镜像** 到主板上。 :::tip 镜像说明 下载的系统镜像是压缩文件，需要解压后才能使用！ @@ -80,9 +70,11 @@ wget -其中 `` 为系统镜像文件的下载地址，可以复制[资源汇总下载](../../../../download)页面中的镜像下载地址进行替换。 +其中 `` 为系统镜像文件的下载地址，可以复制 资源汇总下载 页面中的 **最新镜像** 下载地址进行替换。 -下载示例：{`wget ${props?.download_url ?? ''}`} +下载示例： + +{`wget ${props?.download_url ?? ""}`} #### 解压系统镜像 @@ -117,21 +109,16 @@ lsblk -系统若识别出 SPI Flash 设备，通常会识别成 `/dev/mtdblock*` 设备。 - -系统若识别出 NVMe 设备，通常会识别成 `/dev/nvme*n*` 设备，若有多个 NVMe 设备，可以通过安全插拔判断对应设备路径。 +系统若识别出 NVMe 设备，通常会识别成 `/dev/nvme*n*` 设备，若有多个存储设备，可以通过安全插拔设备判断对应设备路径。 终端输出示例: ``` NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINTS -mtdblock0 31:0 0 16M 0 disk -mmcblk0 179:0 0 58G 0 disk -├─mmcblk0p1 179:1 0 16M 0 part /config -├─mmcblk0p2 179:2 0 300M 0 part /boot/efi -└─mmcblk0p3 179:3 0 57.6G 0 part / -zram0 254:0 0 982.6M 0 disk [SWAP] +··· nvme0n1 259:0 0 119.2G 0 disk +└─nvme0n1p1 259:1 0 119.2G 0 part +··· ``` ### 安装系统镜像 @@ -178,14 +165,10 @@ lsblk ``` NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT -mtdblock0 31:0 0 16M 0 disk -mmcblk0 179:0 0 58G 0 disk -├─mmcblk0p1 179:1 0 16M 0 part /config -├─mmcblk0p2 179:2 0 300M 0 part /boot/efi -└─mmcblk0p3 179:3 0 57.6G 0 part / -zram0 254:0 0 982.6M 0 disk [SWAP] -nvme0n1 259:0 0 238.5G 0 disk -├─nvme0n1p1 259:1 0 16M 0 part -├─nvme0n1p2 259:2 0 300M 0 part -└─nvme0n1p3 259:3 0 238.2G 0 part +··· +nvme0n1 259:0 0 119.2G 0 disk +├─nvme0n1p1 259:3 0 16M 0 part +├─nvme0n1p2 259:4 0 300M 0 part +└─nvme0n1p3 259:5 0 6.3G 0 part +··· ``` diff --git a/docs/common/radxa-os/install-system/_use_dd_ufs.mdx b/docs/common/radxa-os/install-system/_use_dd_ufs.mdx index f2635ecca..4817393de 100644 --- a/docs/common/radxa-os/install-system/_use_dd_ufs.mdx +++ b/docs/common/radxa-os/install-system/_use_dd_ufs.mdx @@ -1,4 +1,4 @@ -主要介绍如何使用 `dd` 命令将系统安装到 UFS 中。 +主要介绍在 MicroSD 卡启动系统正常的情况下，使用 `dd` 命令将系统安装到 UFS 中。 :::warning 安装系统会格式化 UFS 模块或板载 UFS，如果有重要数据请提前备份！ @@ -8,20 +8,12 @@ 您需要满足以下条件才可以使用 `dd` 命令将系统安装到 UFS 中： -- 系统可以通过其他存储设备正常启动系统：推荐使用 MicroSD 卡启动系统 +- 系统可以通过 MicroSD 卡正常启动系统 -- UFS 模块安装到主板上或主板本身板载 UFS +- UFS 安装到主板上或主板板载 UFS ## 硬件连接 -您可以根据自己的主板配置进行操作。 - -:::tip -教程适用于多款主板，你需要根据自己的主板配置选择对应的步骤进行硬件连接。 - -一般板载 UFS 的主板，无 UFS 模块接口，无需安装。 -::: - @@ -42,7 +34,7 @@ UFS 模块安装步骤： -若你的主板是含有板载 UFS 的版本，无需安装。 +若你的主板是板载 UFS 的版本，无需安装。 @@ -51,69 +43,94 @@ UFS 模块安装步骤： ### 下载系统镜像 -主板需要访问资源汇总下载页面，直接下载系统镜像文件到本地上。 +主板需要访问 资源汇总下载 页面，下载 **最新系统镜像** 到主板上。 :::tip 镜像说明 下载的系统镜像是压缩文件，需要解压后才能使用！ ::: -#### 推荐下载方式 +您可以使用 `wget` 命令下载系统镜像文件到主板上。 + + + +``` +sudo apt update +sudo apt install wget -y +wget +``` + + -- 直接下载 +其中 `` 为系统镜像文件的下载地址，可以复制 资源汇总下载 页面中的镜像下载地址进行替换。 -主板直接访问资源汇总下载页面，下载系统镜像文件到本地上。 +下载示例：{`wget ${props?.download_url ?? ''}`} -- wget 命令下载 +#### 解压系统镜像 -主板通过 `wget` 命令下载系统镜像文件到本地上。 +我们的系统镜像一般为 `*.img.xz` 格式，需要解压后才能使用。 - + ``` -sudo apt update && -sudo apt install wget -y -wget +sudo apt install xz-utils -y +unxz ``` -其中 `` 为系统镜像文件的下载地址，可以复制资源汇总下载页面中的下载地址进行替换。 +其中 `` 为系统镜像文件的路径，需要替换成实际的系统镜像文件路径。 -- PC 端下载 +解压示例： -PC 端访问资源汇总下载页面，直接下载系统镜像文件后，通过 U 盘、FTP、SCP等方式将系统镜像文件传输到主板上。 +{`unxz ${props?.path_to_image_unxz ?? ""}`} -#### 解压系统镜像 +### 确定设备路径 -我们的系统镜像一般为 `*.img.xz` 格式，需要解压后才能使用。 +可以使用 `lsblk` 命令查看设备路径，根据磁盘的容量来确定设备路径。 + +说明：若是磁盘容量接近一致，可以安全插拔（适用于 UFS 模块）来观察出现和消失的设备路径，从而确定设备路径。 - + ``` -sudo apt update -sudo apt install xz-utils -y -unxz +lsblk ``` -其中 `` 为系统镜像文件的路径，需要替换成实际的系统镜像文件路径。 +系统若识别出 UFS 设备，通常会识别成 `/dev/sd*` 设备。 + +终端输出示例: + +``` +NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINTS +··· +sda 8:0 0 119.2G 0 disk +└─sda1 8:1 0 119.2G 0 part +··· +``` ### 安装系统镜像 使用 `dd` 命令将系统镜像安装到 UFS 中。 - + ``` -sudo dd if= of= bs=4M status=progress +sudo dd if= of= bs=4M status=progress ``` +写入示例： + +{`sudo dd if=${ + props?.path_to_image ?? "" +} of=/dev/sda bs=4M status=progress`} + 参数说明： -- ``：系统镜像文件的路径，需要替换成实际的系统镜像文件路径。 +- ``：系统镜像文件的路径，需要替换成实际的系统镜像文件路径。 - ``：UFS 模块的设备路径，需要替换成实际的 UFS 模块的设备路径。 @@ -121,13 +138,11 @@ sudo dd if= of= bs=4M status=progress - `status=progress`：显示写入进度。 -:::tip 确定设备路径 - -可以使用 `lsblk` 命令查看设备路径，根据磁盘的容量来确定设备路径。 +### 验证写入结果 -说明：若是磁盘容量接近一致，可以安全插拔（主板关机插拔 UFS 模块）来观察出现和消失的设备路径，从而确定设备路径。 +安装系统完成后，可以通过 `lsblk` 命令查看 UFS 的分区表是否正常创建。 - + ``` lsblk @@ -135,4 +150,14 @@ lsblk -::: +终端输出示例: + +``` +NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINTS +··· +sda 8:0 0 119.2G 0 disk +├─sda1 8:1 0 128M 0 part +├─sda2 8:2 0 2.3G 0 part +└─sda3 8:3 0 6.4G 0 part +··· +``` diff --git a/docs/common/radxa-os/install-system/_use_etcher_emmc.mdx b/docs/common/radxa-os/install-system/_use_etcher_emmc.mdx new file mode 100644 index 000000000..ebccee127 --- /dev/null +++ b/docs/common/radxa-os/install-system/_use_etcher_emmc.mdx @@ -0,0 +1,123 @@ +介绍如何使用瑞莎 eMMC/UFS 二合一读卡器配合 eMMC 模块，并将系统安装到 eMMC 模块中。 + +:::warning +安装系统会格式化 eMMC 模块，如果有重要数据请提前备份！ +::: + +## 使用前提 + +### 硬件准备 + +您需要提前准备以下硬件设备： + +- eMMC 模块 +- 瑞莎 eMMC/UFS 二合一读卡器 + +:::tip 推荐配件 + +- [瑞莎 eMMC 模块](https://radxa.com/products/accessories/emmc-module) +- [瑞莎 eMMC/UFS 二合一读卡器](https://radxa.com/products/accessories/emmc-ufs-module-reader) + +::: + +### 硬件连接 + +将 eMMC 模块插入瑞莎 eMMC/UFS 二合一读卡器中，再将瑞莎 eMMC/UFS 二合一读卡器插入电脑。 + +:::caution + +eMMC 模块安装步骤： + +1. 确保 eMMC 模块的缺角和读卡器的接口方向一致 +2. 确保 eMMC 模块底部卡槽接口和读卡器的接口对齐 +3. 轻微用力按压 eMMC 模块一端的接口，听到"滴"的声音说明安装成功，同样的方法按压另一端的接口，确保 eMMC 模块安装成功。 + ::: + +
+ +
+ +## 安装系统 + +### 下载系统镜像 + +使用 PC 访问 资源汇总下载 页面，直接下载系统镜像文件到本地上。 + +:::tip 镜像说明 +下载的系统镜像是压缩文件，需要解压后才能使用！ +::: + +### 安装系统镜像 + +使用 Balena Etcher 软件可以将系统镜像安装到 eMMC 模块中。 + +:::tip Balena Etcher +对于 Balena Etcher 的安装和使用，可以参考 [Etcher 使用](/common/radxa-os/install-system/balena-etcher) 教程。 +::: + +#### 选择系统镜像 + +点击 `Flash from file` 选项，选择自己提前下载并解压好的系统镜像文件。 + +
+ +
+ +#### 选择存储设备 + +点击 `Select target` 选项，选择 eMMC 模块设备。 + +
+ +
+ +
+ +
+ +#### 开始烧录 + +点击 `Flash!` 选项，开始烧录系统镜像到 eMMC 模块中。 + +
+ +
+ +
+ 等待系统安装完成 + +
+ +
+ 等待系统校验完成 + +
+ +
+ 成功安装系统镜像后，关闭 Etcher 软件！ + +
diff --git a/docs/common/radxa-os/install-system/_use_etcher_nvme.mdx b/docs/common/radxa-os/install-system/_use_etcher_nvme.mdx index 01326a1ba..51849c3c0 100644 --- a/docs/common/radxa-os/install-system/_use_etcher_nvme.mdx +++ b/docs/common/radxa-os/install-system/_use_etcher_nvme.mdx @@ -1,4 +1,4 @@ -主要介绍如何使用 M.2 NVMe 固态硬盘盒将系统安装到 NVMe SSD 中。 +介绍如何使用 M.2 NVMe 固态硬盘盒将系统安装到 NVMe SSD 中。 :::warning 安装系统会格式化 NVMe SSD，如果有重要数据请提前备份！ @@ -10,25 +10,25 @@ 您需要提前准备以下硬件设备： +- M.2 NVMe SSD - M.2 NVMe 固态硬盘盒 -- 系统启动介质：M.2 M Key 2230 NVMe SSD + +### 硬件连接 + +将 M.2 NVMe SSD 安装到 M.2 NVMe 固态硬盘盒中，再将 M.2 NVMe 固态硬盘盒连接到电脑。
-### 硬件连接 - -将 M.2 NVMe SSD 安装到 M.2 NVMe 固态硬盘盒中，再将 M.2 NVMe 固态硬盘盒连接到电脑。 - ## 安装系统 ### 下载系统镜像 -使用 PC 访问 [资源汇总下载](../../../../download) 页面，直接下载系统镜像文件到本地上。 +使用 PC 访问 资源汇总下载 页面，直接下载系统镜像文件到本地上。 :::tip 镜像说明 下载的系统镜像是压缩文件，需要解压后才能使用！ @@ -48,7 +48,7 @@
@@ -59,14 +59,14 @@
@@ -77,7 +77,7 @@
@@ -85,7 +85,7 @@
等待系统安装完成
@@ -93,7 +93,7 @@
等待系统校验完成
@@ -101,42 +101,7 @@
成功安装系统镜像后，关闭 Etcher 软件！ -
- -## 系统信息 - -您使用我们提供的系统镜像，首次需要使用我们设置的用户名和密码登录系统。 - -- radxa - -用户账号：radxa - -用户密码：radxa - -## 启动系统 - -完成系统的安装后，将主板关机，断开主板电源，按照以下操作完成系统启动： - -① : 将 MicroSD 卡从主板上取下 - -② : 将 NVMe SSD 安装到主板上 - -③ : 使用 HDMI 数据线连接显示器和主板 - -④ : 使用 USB-A 接口连接鼠标或键盘：若有 USB-A 拓展坞，可以通过拓展坞连接鼠标和键盘 - -⑤ : 使用 5V Type-C 电源适配器给主板供电 - -若主板供电正常，主板电源指示灯绿色亮起；若系统启动正常，状态指示灯蓝色闪烁。 - -成功启动系统后，显示器会显示系统桌面，你可以根据系统信息登录并使用系统。 - -
-
diff --git a/docs/common/radxa-os/install-system/_use_etcher_sd.mdx b/docs/common/radxa-os/install-system/_use_etcher_sd.mdx index 8740f65de..dd856b927 100644 --- a/docs/common/radxa-os/install-system/_use_etcher_sd.mdx +++ b/docs/common/radxa-os/install-system/_use_etcher_sd.mdx @@ -1,4 +1,4 @@ -主要介绍如何将系统安装到 MicroSD 卡中。 +介绍如何将系统安装到 MicroSD 卡中。 :::warning 安装系统会格式化 MicroSD 卡，如果有重要数据请提前备份！ @@ -28,7 +28,7 @@ ### 下载系统镜像 -使用 PC 访问 [资源汇总下载](../../download) 页面，直接下载系统镜像文件到本地上。 +使用 PC 访问 资源汇总下载 页面，直接下载系统镜像文件到本地上。 :::tip 镜像说明 下载的系统镜像是压缩文件，需要解压后才能使用！ diff --git a/docs/common/radxa-os/install-system/_use_etcher_udisk.mdx b/docs/common/radxa-os/install-system/_use_etcher_udisk.mdx new file mode 100644 index 000000000..77e9f085b --- /dev/null +++ b/docs/common/radxa-os/install-system/_use_etcher_udisk.mdx @@ -0,0 +1,106 @@ +介绍如何将系统安装到 U 盘中。 + +:::warning +安装系统会格式化 U 盘，如果有重要数据请提前备份！ +::: + +## 使用前提 + +### 硬件准备 + +您需要提前准备以下硬件设备： + +- U 盘 + +### 硬件连接 + +将 U 盘插入电脑的 USB 接口。 + +
+ +
+ +## 安装系统 + +### 下载系统镜像 + +使用 PC 访问 资源汇总下载 页面，直接下载系统镜像文件到本地上。 + +:::tip 镜像说明 +下载的系统镜像是压缩文件，需要解压后才能使用！ +::: + +### 安装系统镜像 + +使用 Balena Etcher 软件可以将系统镜像安装到 U 盘中。 + +:::tip Balena Etcher +对于 Balena Etcher 的安装和使用，可以参考 [Etcher 使用](/common/radxa-os/install-system/balena-etcher) 教程。 +::: + +#### 选择系统镜像 + +点击 `Flash from file` 选项，选择自己提前下载并解压好的系统镜像文件。 + +
+ +
+ +#### 选择存储设备 + +点击 `Select target` 选项，选择 U 盘设备。 + +
+ +
+ +
+ +
+ +#### 开始烧录 + +点击 `Flash!` 选项，开始烧录系统镜像到 U 盘中。 + +
+ +
+ +
+ 等待系统安装完成 + +
+ +
+ 等待系统校验完成 + +
+ +
+ 成功安装系统镜像后，关闭 Etcher 软件！ + +
diff --git a/docs/common/radxa-os/install-system/_use_etcher_ufs.mdx b/docs/common/radxa-os/install-system/_use_etcher_ufs.mdx new file mode 100644 index 000000000..4cba783c6 --- /dev/null +++ b/docs/common/radxa-os/install-system/_use_etcher_ufs.mdx @@ -0,0 +1,123 @@ +介绍如何使用瑞莎 eMMC/UFS 二合一读卡器配合 UFS 模块，并将系统安装到 UFS 模块中。 + +:::warning +安装系统会格式化 UFS 模块，如果有重要数据请提前备份！ +::: + +## 使用前提 + +### 硬件准备 + +您需要提前准备以下硬件设备： + +- UFS 模块 +- 瑞莎 eMMC/UFS 二合一读卡器 + +:::tip 推荐配件 + +- [瑞莎 UFS 模块](https://radxa.com/products/accessories/ufs-module) +- [瑞莎 eMMC/UFS 二合一读卡器](https://radxa.com/products/accessories/emmc-ufs-module-reader) + +::: + +### 硬件连接 + +将 UFS 模块插入瑞莎 eMMC/UFS 二合一读卡器中，再将瑞莎 eMMC/UFS 二合一读卡器插入电脑。 + +:::caution + +UFS 模块安装步骤： + +1. 确保 UFS 模块的缺角和读卡器的接口方向一致 +2. 确保 UFS 模块底部卡槽接口和读卡器的接口对齐 +3. 轻微用力按压 UFS 模块一端的接口，听到"滴"的声音说明安装成功，同样的方法按压另一端的接口，确保 UFS 模块安装成功。 + ::: + +
+ +
+ +## 安装系统 + +### 下载系统镜像 + +使用 PC 访问 资源汇总下载 页面，直接下载系统镜像文件到本地上。 + +:::tip 镜像说明 +下载的系统镜像是压缩文件，需要解压后才能使用！ +::: + +### 安装系统镜像 + +使用 Balena Etcher 软件可以将系统镜像安装到 UFS 模块中。 + +:::tip Balena Etcher +对于 Balena Etcher 的安装和使用，可以参考 [Etcher 使用](/common/radxa-os/install-system/balena-etcher) 教程。 +::: + +#### 选择系统镜像 + +点击 `Flash from file` 选项，选择自己提前下载并解压好的系统镜像文件。 + +
+ +
+ +#### 选择存储设备 + +点击 `Select target` 选项，选择 UFS 模块设备。 + +
+ +
+ +
+ +
+ +#### 开始烧录 + +点击 `Flash!` 选项，开始烧录系统镜像到 UFS 模块中。 + +
+ +
+ +
+ 等待系统安装完成 + +
+ +
+ 等待系统校验完成 + +
+ +
+ 成功安装系统镜像后，关闭 Etcher 软件！ + +
diff --git a/docs/dragon/q6a/README.md b/docs/dragon/q6a/README.md index 01a74bf24..a606fc900 100644 --- a/docs/dragon/q6a/README.md +++ b/docs/dragon/q6a/README.md @@ -12,11 +12,12 @@ Dragon Q6A 搭载高通 QCS6490 SoC，采用 “1+3+4” 三丛集设计（1× K ## 产品外观 +| 序号 | 视图 | 序号 | 视图 | 序号 | 视图 | +| :--: | :---------------: | :--: | :---------------: | :--: | :---------------: | +| ① | Dragon Q6A 正视图 | ② | Dragon Q6A 侧视图 | ③ | Dragon Q6A 背视图 | +
- Dragon Q6A 正面 - - Dragon Q6A 背面 - +
## 产品规格 @@ -38,19 +39,19 @@ Dragon Q6A 搭载高通 QCS6490 SoC，采用 “1+3+4” 三丛集设计（1× K ## 接口说明
- +
-| 序号 | 说明 | 序号 | 说明 | 序号 | 说明 | -| :--: | :--------------- | :--: | :----------------------------------------------------------- | :--: | :------------------------ | -| ① | USB Type-C 接口 | ⑨ | PoE 接口 | ⑰ | 12 V 电源输入接口 | -| ② | LPDDR5 内存 | ⑩ | 千兆以太网接口（支持 PoE） | ⑱ | 麦克风输入接口 | -| ③ | Power 按键 | ⑪ | QSPI Nor Flash | ⑲ | eMMC / UFS 模块二合一接口 | -| ④ | 天线接口 | ⑫ | 2x USB 2.0 Type-A 接口 | ⑳ | RTC 接口 | -| ⑤ | WiFi 6 / BT 5.4 | ⑬ | USB 2.0 Type-A 接口（上层）
USB 3.1 Type-A 接口（下层） | ㉑ | 2x MIPI CSI 2-Lane 接口 | -| ⑥ | M.2 M Key 接口 | ⑭ | EDL 按键 | ㉒ | MIPI DSI 4-Lane 接口 | -| ⑦ | 40 Pin GPIO 排针 | ⑮ | 耳机插孔 | ㉓ | MicroSD 卡槽 | -| ⑧ | Qualcomm QCS6490 | ⑯ | HDMI 接口 | ㉔ | MIPI CSI 4-Lane 接口 | +| 序号 | 说明 | 序号 | 说明 | 序号 | 说明 | +| :--: | :--------------- | :--: | :--------------------------------------------------------------- | :--: | :--------------------- | +| 1 | 高通 QCS6490 | 9 | 电源输入接口 | 17 | 2x USB 2.0 Type-A 接口 | +| 2 | 40 Pin GPIO 接口 | 10 | MIPI CSI（4 Lane） | 18 | EDL 按键 | +| 3 | M.2 M Key 插槽 | 11 | MicroSD 卡槽 | 19 | 耳机插孔 | +| 4 | WiFi 6 / BT 5.4 | 12 | MIPI DSI（4 Lane） | 20 | 标准 HDMI | +| 5 | 天线接口 | 13 | PoE 接口 | 21 | eMMC & UFS 模块二合一 | +| 6 | 电源按键 | 14 | 千兆以太网 | 22 | RTC 电池接口 | +| 7 | LPDDR5 内存 | 15 | QSPI Nor Flash | 23 | 2x MIPI CSI（2 Lane） | +| 8 | USB 2.0 Type-C | 16 | USB 2.0 Type-A 接口（上层）
USB 3.1 OTG Type-A 接口（下层） | | | ## 应用场景 diff --git a/docs/dragon/q6a/download.md b/docs/dragon/q6a/download.md index d019c3b41..5adfb1fe8 100644 --- a/docs/dragon/q6a/download.md +++ b/docs/dragon/q6a/download.md @@ -6,7 +6,17 @@ sidebar_position: 8 ## 系统镜像 -- [Ubuntu 系统镜像](https://dl.radxa.com/q6a/images/ubuntu-preinstalled-desktop-arm64-250731.img.zip) +- Ubuntu 系统镜像 + - [radxa-dragon-q6a_noble_kde_t2.output_512.img.xz](https://github.com/radxa-build/radxa-dragon-q6a/releases/download/rsdk-t2/radxa-dragon-q6a_noble_kde_t2.output_512.img.xz)：适用于 MicroSD 卡 / U 盘 / eMMC / NVMe 启动系统 + - [radxa-dragon-q6a_noble_kde_t2.output_4096.img.xz](https://github.com/radxa-build/radxa-dragon-q6a/releases/download/rsdk-t2/radxa-dragon-q6a_noble_kde_t2.output_4096.img.xz)：适用于 UFS 启动系统 + +:::tip 最新系统镜像发布页面 + +- [Dragon Q6A](https://github.com/radxa-build/radxa-dragon-q6a/releases) + +该页面会发布最新的正式版本和测试版本的系统镜像，测试版本以 `t` 开头，正式版本以 `b` 开头。 + +::: ## 启动固件 @@ -29,7 +39,7 @@ Dragon Q6A 出厂默认烧录 SPI 启动固件，正常情况下无需烧录启 :::tip 最新固件说明 1. 支持 eMMC 启动 -2. 增加默认启动设备顺序：USB > SD > NVMe > eMMC > UFS > USB +2. 增加默认启动设备顺序：USB > SD > NVMe > eMMC > UFS 3. 增加启动设备选择 4. 加快启动速度 diff --git a/docs/dragon/q6a/getting-started/install-system/README.md b/docs/dragon/q6a/getting-started/install-system/README.md index b3b4f43fb..146f33f02 100644 --- a/docs/dragon/q6a/getting-started/install-system/README.md +++ b/docs/dragon/q6a/getting-started/install-system/README.md @@ -1,5 +1,5 @@ --- -sidebar_position: 3 +sidebar_position: 2 --- # 安装系统 diff --git a/docs/dragon/q6a/getting-started/install-system/boot_option.md b/docs/dragon/q6a/getting-started/install-system/boot_option.md deleted file mode 100644 index d1372ae0f..000000000 --- a/docs/dragon/q6a/getting-started/install-system/boot_option.md +++ /dev/null @@ -1,187 +0,0 @@ ---- -sidebar_position: 4 ---- - -# 修改系统启动盘引导选项 - -瑞莎 Dragon Q6A 支持将系统引导盘修改为 MicroSD 卡、U 盘、NVMe SSD 等设备。 - -我们提供的系统镜像文件默认引导盘为 MicroSD 卡，如果需要修改成 U 盘、NVMe SSD 等设备，可以参考下面教程进行修改。 - -## U 盘启动 - -修改 `/boot/grub/grub.cfg` 文件，将 `root` 参数修改为 U 盘的设备路径。 - -:::tip 默认引导盘 -默认引导盘为 MicroSD 卡，root=/dev/mmcblk2p2 -::: - -### 查看 U 盘设备号 - -将 U 盘插入主板，然后使用 `lsblk` 命令查看 U 盘的设备号。 - - - -``` -lsblk -``` - - - -终端输出示例：可以通过安全插拔判断 U 盘设备号。 - -``` -NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT -sda 8:0 1 58G 0 disk -├─sda1 8:1 1 112M 0 part -└─sda2 8:2 1 57.8G 0 part /media/user/9a5bc14a-4269-4786-a4e1-e5604266da9b -``` - -### 挂载 U 盘 BOOT 分区 - - - -``` -sudo mkdir ~/mnt -sudo mount /dev/sda1 ~/mnt -``` - - - -### 修改 GRUB 配置文件 - - - -``` -sudo nano ~/mnt/grub/grub.cfg -``` - - - -修改 GRUB 配置文件：将默认的 `root=/dev/mmcblk2p2` 修改为 `root=/dev/sda2` - -``` -insmod part_gpt -insmod part_msdos -insmod all_video -terminal_input console -terminal_output console -if serial --unit=0 --speed=115200; then - terminal_input --append console - terminal_output --append console -fi -set timeout_style=menu -set timeout=0 -set default=0 -menuentry 'Arch Linux ARM for Radxa Dragon Q6A' { -# insmod fat -# search --no-floppy --fs-uuid --set=root 1778-ABF5 - devicetree /qcs6490-radxa-dragon-q6a.dtb - echo 'Loading Kernel...' - linux /Image panic=30 loglevel=8 rw rootwait=10 root=/dev/sda2 rootfstype=ext4 -# echo 'Loading Initramfs...' -# initrd /initramfs-linux-mainline-aarch64.img - echo 'Booting...' -} -``` - -### 安全退出 U 盘 - - - -``` -sudo umount ~/mnt -``` - - - -然后弹出 U 盘，将 U 盘安装到主板上启动系统。 - -## NVMe SSD 启动 - -修改 `/boot/grub/grub.cfg` 文件，将 `root` 参数修改为 NVMe SSD 的设备路径。 - -:::tip 默认引导盘 -默认引导盘为 MicroSD 卡，root=/dev/mmcblk2p2 -::: - -### 查看 NVMe SSD 设备号 - -将 NVMe SSD 插入主板，然后使用 `lsblk` 命令查看 NVMe SSD 的设备号。 - - - -``` -lsblk -``` - - - -终端输出示例：可以通过安全插拔判断 NVMe SSD 设备号。 - -``` -NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT -nvme0n1 259:0 0 58G 0 disk -├─nvme0n1p1 259:1 0 112M 0 part -└─nvme0n1p2 259:2 0 57.8G 0 part /media/user/2543266-9541-5123-a4e1-e42501125542 -``` - -### 挂载 NVMe SSD BOOT 分区 - - - -``` -sudo mkdir ~/mnt -sudo mount /dev/nvme0n1p2 ~/mnt -``` - - - -### 修改 GRUB 配置文件 - - - -``` -sudo nano ~/mnt/grub/grub.cfg -``` - - - -修改 GRUB 配置文件：将默认的 `root=/dev/mmcblk2p2` 修改为 `root=/dev/nvme0n1p2` - -``` -insmod part_gpt -insmod part_msdos -insmod all_video -terminal_input console -terminal_output console -if serial --unit=0 --speed=115200; then - terminal_input --append console - terminal_output --append console -fi -set timeout_style=menu -set timeout=0 -set default=0 -menuentry 'Arch Linux ARM for Radxa Dragon Q6A' { -# insmod fat -# search --no-floppy --fs-uuid --set=root 1778-ABF5 - devicetree /qcs6490-radxa-dragon-q6a.dtb - echo 'Loading Kernel...' - linux /Image panic=30 loglevel=8 rw rootwait=10 root=/dev/nvme0n1p2 rootfstype=ext4 -# echo 'Loading Initramfs...' -# initrd /initramfs-linux-mainline-aarch64.img - echo 'Booting...' -} -``` - -### 安全退出 NVMe SSD - - - -``` -sudo umount ~/mnt -``` - - - -然后弹出 NVMe SSD，将 NVMe SSD 安装到主板上启动系统。 diff --git a/docs/dragon/q6a/getting-started/install-system/emmc_system/README.md b/docs/dragon/q6a/getting-started/install-system/emmc_system/README.md new file mode 100644 index 000000000..fc1040b08 --- /dev/null +++ b/docs/dragon/q6a/getting-started/install-system/emmc_system/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 4 +--- + +# 安装系统到 eMMC + + diff --git a/docs/dragon/q6a/getting-started/install-system/emmc_system/emmc_reader.md b/docs/dragon/q6a/getting-started/install-system/emmc_system/emmc_reader.md new file mode 100644 index 000000000..658216888 --- /dev/null +++ b/docs/dragon/q6a/getting-started/install-system/emmc_system/emmc_reader.md @@ -0,0 +1,44 @@ +--- +sidebar_position: 4 +--- + +import BalenaEtcherUse from '../../../../../common/radxa-os/install-system/\_use_etcher_emmc.mdx'; + +# 使用读卡器安装系统 + + + +## 启动系统 + +完成系统的安装后，将 eMMC 模块安装到 Dragon Q6A 的 eMMC 模块接口中，然后使用 12V Type-C 电源适配器给 Dragon Q6A 供电，即可启动系统。 + +
+ +
+ +① ：安装 eMMC 模块 + +② ：使用 HDMI 数据线连接显示器和主板 + +③ ：使用 12V Type-C 电源适配器给 Dragon Q6A 供电 + +系统启动正常后，电源指示灯绿色亮起，状态指示灯蓝色闪烁。 + +## 登录系统 + +当您首次启动系统后，需要使用默认的用户名和密码登录。 + +Radxa OS 的默认凭据如下： + +| 项目 | 内容 | +| :----- | :------ | +| 用户名 | `radxa` | +| 密码 | `radxa` | + +## 使用系统 + +成功启动系统后，您就可以在 Dragon Q6A 上正式使用瑞莎系统，对于瑞莎系统的简单使用，可参考 [使用系统](../../use_system.md) 教程。 + +
+ +
diff --git a/docs/dragon/q6a/getting-started/install-system/emmc_system/no_emmc_reader.md b/docs/dragon/q6a/getting-started/install-system/emmc_system/no_emmc_reader.md new file mode 100644 index 000000000..ff84fbeaf --- /dev/null +++ b/docs/dragon/q6a/getting-started/install-system/emmc_system/no_emmc_reader.md @@ -0,0 +1,44 @@ +--- +sidebar_position: 4 +--- + +import InstallSystem from '../../../../../common/radxa-os/install-system/\_use_dd_emmc.mdx'; + +# 从 MicroSD 卡启动并将系统安装到 eMMC + + + +## 启动系统 + +完成系统的安装后，将 MicroSD 卡取下，确认 eMMC 模块已安装到 Dragon Q6A 的 eMMC 模块接口中，然后使用 12V Type-C 电源适配器给 Dragon Q6A 供电。 + +
+ +
+ +① ：确认 eMMC 模块已安装 + +② ：使用 HDMI 数据线连接显示器和主板 + +③ ：使用 12V Type-C 电源适配器给 Dragon Q6A 供电 + +系统启动正常后，电源指示灯绿色亮起，状态指示灯蓝色闪烁。 + +## 登录系统 + +当您首次启动系统后，需要使用默认的用户名和密码登录。 + +Radxa OS 的默认凭据如下： + +| 项目 | 内容 | +| :----- | :------ | +| 用户名 | `radxa` | +| 密码 | `radxa` | + +## 使用系统 + +成功启动系统后，您就可以在 Dragon Q6A 上正式使用瑞莎系统，对于瑞莎系统的简单使用，可参考 [使用系统](../../use_system.md) 教程。 + +
+ +
diff --git a/docs/dragon/q6a/getting-started/install-system/nvme_system/README.md b/docs/dragon/q6a/getting-started/install-system/nvme_system/README.md index 1c6b17b7e..3daf04236 100644 --- a/docs/dragon/q6a/getting-started/install-system/nvme_system/README.md +++ b/docs/dragon/q6a/getting-started/install-system/nvme_system/README.md @@ -1,7 +1,7 @@ --- -sidebar_position: 3 +sidebar_position: 5 --- -# 安装系统到 NVMe SSD +# 安装系统到 NVMe 固态硬盘 diff --git a/docs/dragon/q6a/getting-started/install-system/nvme_system/no_nvme_reader.md b/docs/dragon/q6a/getting-started/install-system/nvme_system/no_nvme_reader.md index 0ca5a810f..431a50d15 100644 --- a/docs/dragon/q6a/getting-started/install-system/nvme_system/no_nvme_reader.md +++ b/docs/dragon/q6a/getting-started/install-system/nvme_system/no_nvme_reader.md @@ -2,151 +2,43 @@ sidebar_position: 2 --- -# 不使用 M.2 M Key NVMe 固态硬盘盒 +import InstallSystem from '../../../../../common/radxa-os/install-system/\_use_dd_nvme.mdx'; -主要介绍在没有 M.2 M Key NVMe 固态硬盘盒的情况下，使用 `dd` 命令将系统镜像烧录到 M.2 M Key 2230 NVMe SSD 上。 +# 从 MicroSD 卡启动并将系统安装到 NVMe SSD -:::warning -安装系统会格式化 NVMe SSD，如果有重要数据请提前备份！ -::: + -## 使用前提 +## 启动系统 -您需要提前准备以下硬件设备： - -- 主板：瑞莎 Dragon Q6A -- 系统启动介质：MicroSD 卡 -- 系统待启动介质：M.2 M Key 2230 NVMe SSD -- 电源适配器：12V Type-C 电源适配器（兼容 PD 协议） - -说明：我们需要基于 MicroSD 卡正常启动主板，然后通过 `dd` 命令将系统镜像安装到 NVMe SSD 上。 - -:::tip 推荐配件 - -- [瑞莎 PD 30W电源适配器(推荐使用)](https://radxa.com/products/accessories/power-pd-30w) -- 标准 12V Type-C 电源适配器，建议电流 2A 以上 - ::: - -## 硬件连接 - -将 M.2 M Key 2230 NVMe SSD 安装到主板的 NVMe SSD 接口上。 +完成系统的安装后，将 MicroSD 卡取下，确认 NVMe SSD 已安装到 Dragon Q6A 的 NVMe SSD 插槽中，然后使用 12V Type-C 电源适配器给 Dragon Q6A 供电。
- +
-## 下载系统镜像 - -您可以在主板上访问 [资源汇总下载](../../../download) 页面下载系统镜像文件。 - -:::tip 下载建议 -我们提供以下方式下载系统镜像文件到主板上，您可以根据自己的实际情况选择合适的方式： - -- 使用 `wget` 命令下载 - -您可以复制 [资源汇总下载](../../../download) 页面的系统镜像文件链接，然后在主板上使用 `wget` 命令下载。 - -``` -sudo apt install wget -wget [url] -``` - -参数解释：其中 `[url]` 需要替换成实际的系统镜像文件下载链接。 - -- PC 下载 - -您可以在 PC 上访问 [资源汇总下载](../../../download) 页面下载系统镜像文件，然后通过 U 盘 、FTP 、SCP 等方式将系统镜像文件传输到主板上。 - -::: - -## 解压系统镜像 - -:::tip 说明 -下载的系统镜像文件是压缩包，需要解压后才能使用。 -::: - -使用 `unxz` 命令解压系统镜像文件。 - - +① ：确认 NVMe SSD 已安装 -``` -sudo apt install xz-utils -unxz [image_path] -``` +② ：使用 HDMI 数据线连接显示器和主板 - -参数解释：其中 `[image_path]` 需要替换成实际的系统镜像文件路径。 +③ ：使用 12V Type-C 电源适配器给 Dragon Q6A 供电 -## 安装系统镜像 +系统启动正常后，电源指示灯绿色亮起，状态指示灯蓝色闪烁。 -使用 `dd` 命令安装系统镜像到 NVMe SSD 上。 +## 登录系统 -### 写入系统镜像 +当您首次启动系统后，需要使用默认的用户名和密码登录。 -:::danger -使用 `dd` 命令时，请确保选择正确的设备文件，否则会格式化错误的设备，造成数据丢失！ -::: +Radxa OS 的默认凭据如下： - +| 项目 | 内容 | +| :----- | :------ | +| 用户名 | `radxa` | +| 密码 | `radxa` | -``` -sudo dd if=[image_path] of=/dev/*** bs=4M status=progress -``` +## 使用系统 - -参数说明： -- `if`：指定写入文件，将 `[image_path]` 替换为解压后的系统镜像文件路径 -- `of`：指定写入设备，将 `/dev/***` 替换为系统待启动介质对应的设备(请根据实际设备修改) -- `bs`：块大小，建议 4M 参数 - `status=progress`：显示写入状态 +成功启动系统后，您就可以在 Dragon Q6A 上正式使用瑞莎系统，对于瑞莎系统的简单使用，可参考 [使用系统](../../use_system.md) 教程。 -:::tip 确定系统待启动介质设备文件 - -对于不同的系统待启动介质，对应的设备文件名称有所不同，以下是常见的系统待启动介质设备文件名称： - -- eMMC 模块：`/dev/mmcblk*` -- UFS 模块：`/dev/sda*` -- NVMe SSD：`/dev/nvme*n*` - -最有效的方法:你可以使用 `lsblk` 命令对比安装系统待启动介质和没有安装系统待启动介质时的设备列表变化，从而确定系统待启动介质对应的设备文件名称。 - -**注意：安装和拆卸系统待启动介质时（如 UFS 模块、NVMe SSD 等），需要将主板断电后进行操作，避免热插拔导致数据或硬件损坏。** -::: - -### 验证系统镜像 - -写入系统镜像完成后，您可以使用 `fdisk` 命令查看系统待启动介质的分区信息，从而确定系统镜像是否写入成功。 - - - -``` -sudo fdisk -l /dev/*** -``` - - - -若系统成功写入，终端会输出类似以下信息： - -``` -Disk /dev/\*\*\*: 119.15 GiB, 127934660608 bytes, 31234048 sectors -Disk model: KLUDG4UHDC-B0E1 -Units: sectors of 1 \* 4096 = 4096 bytes -Sector size (logical/physical): 4096 bytes / 4096 bytes -I/O size (minimum/optimal): 524288 bytes / 524288 bytes -Disklabel type: gpt -Disk identifier: 33349998-C3CC-40F0-B818-DDDD8383A64D - -Device Start End Sectors Size Type -/dev/**_ 32768 65535 32768 128M Linux filesystem -/dev/_** 65536 679935 614400 2.3G EFI System -/dev/\*\*\* 679936 31234014 30554079 116.6G EFI System -``` - -## 修改 grub 设置 - -:::tip - -参考 [修改系统启动盘引导选项](../boot_option) 中 NVMe 启动部分 - -::: - -## 上电开机 +
+ +
diff --git a/docs/dragon/q6a/getting-started/install-system/nvme_system/nvme_reader.md b/docs/dragon/q6a/getting-started/install-system/nvme_system/nvme_reader.md index 989fde8d0..9ec57954b 100644 --- a/docs/dragon/q6a/getting-started/install-system/nvme_system/nvme_reader.md +++ b/docs/dragon/q6a/getting-started/install-system/nvme_system/nvme_reader.md @@ -2,135 +2,43 @@ sidebar_position: 1 --- -# 使用 M.2 M Key NVMe 固态硬盘盒 +import BalenaEtcherUse from '../../../../../common/radxa-os/install-system/\_use_etcher_nvme.mdx'; -主要介绍如何使用 M.2 M Key NVMe 固态硬盘盒将系统镜像烧录到 M.2 M Key 2230 NVMe SSD 上。 +# 使用固态硬盘盒安装系统 -:::warning -安装系统会格式化 M.2 M Key 2230 NVMe SSD，如果有重要数据请提前备份！ -::: + -## 使用前提 +## 启动系统 -您需要提前准备以下硬件设备： - -- M.2 M Key NVMe 固态硬盘盒 -- 系统启动介质：M.2 M Key 2230 NVMe SSD - -## 下载系统镜像 - -您可以在 PC 上访问 [资源汇总下载](../../../download) 页面下载系统镜像文件。 - -## 解压系统镜像 - -下载的系统镜像文件是压缩包，需要解压后才能使用。 - -## 安装系统镜像 - -Balena Etcher 是一款开源镜像烧录工具，使用简单，功能强大，支持 Windows、Mac、Linux 系统使用。 - -### 下载 Balena Etcher - -访问 [Balena Etcher 官网](https://www.balena.io/etcher/) 下载 Balena Etcher。 - -
- -
- -请根据自己的系统平台和架构下载对应的软件安装包。 +完成系统的安装后，将 NVMe SSD 安装到 Dragon Q6A 的 NVMe SSD 插槽中，然后使用 12V Type-C 电源适配器给 Dragon Q6A 供电，即可启动系统。
- +
-### 安装 Balena Etcher +① ：安装 NVMe SSD -下载完成后，可以根据自己的系统平台和架构进行安装。 +② ：使用 HDMI 数据线连接显示器和主板 -:::tip +③ ：使用 12V Type-C 电源适配器给 Dragon Q6A 供电 -- Windows +系统启动正常后，电源指示灯绿色亮起，状态指示灯蓝色闪烁。 -下载的文件是 `*.exe` 格式的安装包，双击程序就可以运行。 +## 登录系统 -- Linux +当您首次启动系统后，需要使用默认的用户名和密码登录。 -推荐下载 `*.zip` 格式的压缩包，解压后双击程序就可以运行。 +Radxa OS 的默认凭据如下： -- MacOS +| 项目 | 内容 | +| :----- | :------ | +| 用户名 | `radxa` | +| 密码 | `radxa` | -根据自己的系统架构下载对应的 `*.dmg` 文件,双击打开后，将软件拖拽到 Applications 文件夹进行安装，安装完成后双击应用图标运行。 +## 使用系统 -::: +成功启动系统后，您就可以在 Dragon Q6A 上正式使用瑞莎系统，对于瑞莎系统的简单使用，可参考 [使用系统](../../use_system.md) 教程。
- +
- -### 使用 Balena Etcher - -使用 Balena Etcher 安装系统镜像文件到 MicroSD 卡上。 - -#### 硬件连接 - -将 M.2 M Key NVMe SSD 安装到 M.2 M Key NVMe 固态硬盘盒中，然后将 M.2 M Key NVMe 固态硬盘盒连接到 PC 上。 - -#### 选择系统镜像 - -点击 `Flash from file` 选项，选择自己提前下载并解压好的系统镜像文件。 - -
- -
- -#### 选择存储设备 - -点击 `Select target` 选项，选择自己待安装系统镜像对应存储设备。 - -:::danger -请勿选错存储设备，否则 Etcher 将格式化被选中的存储设备，造成重要数据丢失！ - -您可以插拔存储设备，观察可选存储设备的变化，从而进一步判断待安装的存储设备。 -::: - -
- -
- -① ： 选择需要安装系统镜像的存储设备 - -② ： 点击 `Select 1` 选项确认设备选择 - -
- -
- -#### 安装系统镜像 - -点击 `Flash` 选项，等待软件自动进行系统镜像的安装和校验。 - -
- -
- -
-等待系统写入完成 - -
- -
-等待系统校验完成 - -
- -成功写入系统镜像后，关闭 Etcher 软件！ - -## 修改 grub 设置 - -:::tip - -参考 [修改系统启动盘引导选项](../boot_option) 中 NVMe 启动部分 - -::: - -## 上电开机 diff --git a/docs/dragon/q6a/getting-started/install-system/sd_system.md b/docs/dragon/q6a/getting-started/install-system/sd_system.md index 806bc1c0c..928bed0dc 100644 --- a/docs/dragon/q6a/getting-started/install-system/sd_system.md +++ b/docs/dragon/q6a/getting-started/install-system/sd_system.md @@ -2,131 +2,43 @@ sidebar_position: 1 --- -# 安装系统到 MicroSD 卡 - -主要介绍如何将系统安装到 MicroSD 卡中。 - -:::warning -安装系统会格式化 MicroSD 卡，如果有重要数据请提前备份！ -::: - -## 使用前提 - -您需要提前准备以下硬件设备： - -- MicroSD 卡读卡器 -- 系统启动介质：MicroSD 卡 - -## 下载系统镜像 - -您可以在 PC 上访问 [资源汇总下载](../../download) 页面下载系统镜像文件。 - -## 解压系统镜像 - -下载的系统镜像文件是压缩包，需要解压后才能使用。 - -## 安装系统镜像 - -Balena Etcher 是一款开源镜像烧录工具，使用简单，功能强大，支持 Windows、Mac、Linux 系统使用。 - -### 下载 Balena Etcher - -访问 [Balena Etcher 官网](https://www.balena.io/etcher/) 下载 Balena Etcher。 - -
- -
- -请根据自己的系统平台和架构下载对应的软件安装包。 - -
- -
- -### 安装 Balena Etcher - -下载完成后，可以根据自己的系统平台和架构进行安装。 - -:::tip - -- Windows - -下载的文件是 `*.exe` 格式的安装包，双击程序就可以运行。 +import BalenaEtcherUse from '../../../../common/radxa-os/install-system/\_use_etcher_sd.mdx'; -- Linux - -推荐下载 `*.zip` 格式的压缩包，解压后双击程序就可以运行。 - -- MacOS - -根据自己的系统架构下载对应的 `*.dmg` 文件,双击打开后，将软件拖拽到 Applications 文件夹进行安装，安装完成后双击应用图标运行。 - -::: - -
- -
- -### 使用 Balena Etcher - -使用 Balena Etcher 安装系统镜像文件到 MicroSD 卡上。 - -#### 硬件连接 - -将 MicroSD 卡安装到读卡器中，然后将读卡器连接到 PC 上。 +# 安装系统到 MicroSD 卡 -
- -
+ -#### 选择系统镜像 +## 启动系统 -点击 `Flash from file` 选项，选择自己提前下载并解压好的系统镜像文件。 +完成系统的安装后，将 MicroSD 卡安装到 Dragon Q6A 的 MicroSD 卡槽中，然后使用 12V Type-C 电源适配器给 Dragon Q6A 供电，即可启动系统。
- +
-#### 选择存储设备 +① ：安装 MicroSD 卡 -点击 `Select target` 选项，选择自己待安装系统镜像对应存储设备。 +② ：使用 HDMI 数据线连接显示器和主板 -:::danger -请勿选错存储设备，否则 Etcher 将格式化被选中的存储设备，造成重要数据丢失！ +③ ：使用 12V Type-C 电源适配器给 Dragon Q6A 供电 -您可以插拔存储设备，观察可选存储设备的变化，从而进一步判断待安装的存储设备。 -::: +系统启动正常后，电源指示灯绿色亮起，状态指示灯蓝色闪烁。 -
- -
+## 登录系统 -① ： 选择需要安装系统镜像的存储设备 +当您首次启动系统后，需要使用默认的用户名和密码登录。 -② ： 点击 `Select 1` 选项确认设备选择 +Radxa OS 的默认凭据如下： -
- -
+| 项目 | 内容 | +| :----- | :------ | +| 用户名 | `radxa` | +| 密码 | `radxa` | -#### 安装系统镜像 +## 使用系统 -点击 `Flash` 选项，等待软件自动进行系统镜像的安装和校验。 +成功启动系统后，您就可以在 Dragon Q6A 上正式使用瑞莎系统，对于瑞莎系统的简单使用，可参考 [使用系统](./use_system.md) 教程。
- +
- -
-等待系统写入完成 - -
- -
-等待系统校验完成 - -
- -成功写入系统镜像后，关闭 Etcher 软件！ - -## 上电开机 diff --git a/docs/dragon/q6a/getting-started/install-system/udisk_system.md b/docs/dragon/q6a/getting-started/install-system/udisk_system.md index e27240edc..58ddb0ad3 100644 --- a/docs/dragon/q6a/getting-started/install-system/udisk_system.md +++ b/docs/dragon/q6a/getting-started/install-system/udisk_system.md @@ -1,139 +1,44 @@ --- -sidebar_position: 2 +sidebar_position: 1 --- -# 安装系统到 U 盘 - -主要介绍如何将系统安装到 U 盘中。 - -:::warning -安装系统会格式化 U 盘，如果有重要数据请提前备份！ -::: - -## 使用前提 - -您需要提前准备以下硬件设备： - -- U 盘 - -## 下载系统镜像 - -您可以在 PC 上访问 [资源汇总下载](../../download) 页面下载系统镜像文件。 - -## 解压系统镜像 - -下载的系统镜像文件是压缩包，需要解压后才能使用。 - -## 安装系统镜像 - -Balena Etcher 是一款开源镜像烧录工具，使用简单，功能强大，支持 Windows、Mac、Linux 系统使用。 - -### 下载 Balena Etcher - -访问 [Balena Etcher 官网](https://www.balena.io/etcher/) 下载 Balena Etcher。 - -
- -
- -请根据自己的系统平台和架构下载对应的软件安装包。 - -
- -
- -### 安装 Balena Etcher - -下载完成后，可以根据自己的系统平台和架构进行安装。 - -:::tip - -- Windows - -下载的文件是 `*.exe` 格式的安装包，双击程序就可以运行。 - -- Linux - -推荐下载 `*.zip` 格式的压缩包，解压后双击程序就可以运行。 +import BalenaEtcherUse from '../../../../common/radxa-os/install-system/\_use_etcher_udisk.mdx'; -- MacOS - -根据自己的系统架构下载对应的 `*.dmg` 文件,双击打开后，将软件拖拽到 Applications 文件夹进行安装，安装完成后双击应用图标运行。 - -::: - -
- -
- -### 使用 Balena Etcher - -使用 Balena Etcher 安装系统镜像文件到 U 盘上。 - -#### 硬件连接 +# 安装系统到 U 盘 -将 U 盘安装到读卡器中，然后将读卡器连接到 PC 上。 + -
- -
+## 启动系统 -#### 选择系统镜像 - -点击 `Flash from file` 选项，选择自己提前下载并解压好的系统镜像文件。 +完成系统的安装后，将 U 盘插到到 Dragon Q6A 的 USB 接口，然后使用 12V Type-C 电源适配器给 Dragon Q6A 供电，即可启动系统。
- +
-#### 选择存储设备 - -点击 `Select target` 选项，选择自己待安装系统镜像对应存储设备。 - -:::danger -请勿选错存储设备，否则 Etcher 将格式化被选中的存储设备，造成重要数据丢失！ +① ：连接 U 盘 -您可以插拔存储设备，观察可选存储设备的变化，从而进一步判断待安装的存储设备。 -::: +② ：使用 HDMI 数据线连接显示器和主板 -
- -
+③ ：使用 12V Type-C 电源适配器给 Dragon Q6A 供电 -① ： 选择需要安装系统镜像的存储设备 +系统启动正常后，电源指示灯绿色亮起，状态指示灯蓝色闪烁。 -② ： 点击 `Select 1` 选项确认设备选择 +## 登录系统 -
- -
+当您首次启动系统后，需要使用默认的用户名和密码登录。 -#### 安装系统镜像 +Radxa OS 的默认凭据如下： -点击 `Flash` 选项，等待软件自动进行系统镜像的安装和校验。 +| 项目 | 内容 | +| :----- | :------ | +| 用户名 | `radxa` | +| 密码 | `radxa` | -
- -
+## 使用系统 -
-等待系统写入完成 - -
+成功启动系统后，您就可以在 Dragon Q6A 上正式使用瑞莎系统，对于瑞莎系统的简单使用，可参考 [使用系统](./use_system.md) 教程。
-等待系统校验完成 - +
- -成功写入系统镜像后，关闭 Etcher 软件！ - -## 修改 grub 设置 - -:::tip - -参考 [修改系统启动盘引导选项](./boot_option) 中 U 盘启动部分 - -::: - -## 上电开机 diff --git a/docs/dragon/q6a/getting-started/install-system/ufs_system/README.md b/docs/dragon/q6a/getting-started/install-system/ufs_system/README.md new file mode 100644 index 000000000..f1d054d92 --- /dev/null +++ b/docs/dragon/q6a/getting-started/install-system/ufs_system/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 3 +--- + +# 安装系统到 UFS + + diff --git a/docs/dragon/q6a/getting-started/install-system/ufs_system/no_ufs_reader.md b/docs/dragon/q6a/getting-started/install-system/ufs_system/no_ufs_reader.md new file mode 100644 index 000000000..b90ff1a3b --- /dev/null +++ b/docs/dragon/q6a/getting-started/install-system/ufs_system/no_ufs_reader.md @@ -0,0 +1,44 @@ +--- +sidebar_position: 4 +--- + +import InstallSystem from '../../../../../common/radxa-os/install-system/\_use_dd_ufs.mdx'; + +# 从 MicroSD 卡启动并将系统安装到 UFS + + + +## 启动系统 + +完成系统的安装后，将 MicroSD 卡取下，确认 UFS 模块已安装到 Dragon Q6A 的 UFS 模块接口中，然后使用 12V Type-C 电源适配器给 Dragon Q6A 供电。 + +
+ +
+ +① ：确认 UFS 模块已安装 + +② ：使用 HDMI 数据线连接显示器和主板 + +③ ：使用 12V Type-C 电源适配器给 Dragon Q6A 供电 + +系统启动正常后，电源指示灯绿色亮起，状态指示灯蓝色闪烁。 + +## 登录系统 + +当您首次启动系统后，需要使用默认的用户名和密码登录。 + +Radxa OS 的默认凭据如下： + +| 项目 | 内容 | +| :----- | :------ | +| 用户名 | `radxa` | +| 密码 | `radxa` | + +## 使用系统 + +成功启动系统后，您就可以在 Dragon Q6A 上正式使用瑞莎系统，对于瑞莎系统的简单使用，可参考 [使用系统](../../use_system.md) 教程。 + +
+ +
diff --git a/docs/dragon/q6a/getting-started/install-system/ufs_system/ufs_reader_system.md b/docs/dragon/q6a/getting-started/install-system/ufs_system/ufs_reader_system.md new file mode 100644 index 000000000..808306d9e --- /dev/null +++ b/docs/dragon/q6a/getting-started/install-system/ufs_system/ufs_reader_system.md @@ -0,0 +1,44 @@ +--- +sidebar_position: 1 +--- + +import BalenaEtcherUse from '../../../../../common/radxa-os/install-system/\_use_etcher_ufs.mdx'; + +# 使用读卡器安装系统 + + + +## 启动系统 + +完成系统的安装后，将 UFS 模块安装到 Dragon Q6A 的 UFS 模块接口中，然后使用 12V Type-C 电源适配器给 Dragon Q6A 供电，即可启动系统。 + +
+ +
+ +① ：安装 UFS 模块 + +② ：使用 HDMI 数据线连接显示器和主板 + +③ ：使用 12V Type-C 电源适配器给 Dragon Q6A 供电 + +系统启动正常后，电源指示灯绿色亮起，状态指示灯蓝色闪烁。 + +## 登录系统 + +当您首次启动系统后，需要使用默认的用户名和密码登录。 + +Radxa OS 的默认凭据如下： + +| 项目 | 内容 | +| :----- | :------ | +| 用户名 | `radxa` | +| 密码 | `radxa` | + +## 使用系统 + +成功启动系统后，您就可以在 Dragon Q6A 上正式使用瑞莎系统，对于瑞莎系统的简单使用，可参考 [使用系统](../../use_system.md) 教程。 + +
+ +
diff --git a/docs/dragon/q6a/getting-started/quickly_start.md b/docs/dragon/q6a/getting-started/quickly_start.md index d5f0940ac..004fdaca3 100644 --- a/docs/dragon/q6a/getting-started/quickly_start.md +++ b/docs/dragon/q6a/getting-started/quickly_start.md @@ -1,5 +1,5 @@ --- -sidebar_position: 2 +sidebar_position: 1 --- # 快速上手 @@ -9,76 +9,185 @@ sidebar_position: 2 ## 产品实物
- Dragon Q6A 正面 - - Dragon Q6A 背面 - +
+| 序号 | 视图 | 序号 | 视图 | 序号 | 视图 | +| :--: | :---------------: | :--: | :---------------: | :--: | :---------------: | +| ① | Dragon Q6A 正视图 | ② | Dragon Q6A 侧视图 | ③ | Dragon Q6A 背视图 | + ## 使用前提 您需要提前准备以下硬件设备： - 主板：瑞莎 Dragon Q6A -- 系统启动介质：MicroSD 卡 -- 电源适配器：12V Type-C 电源适配器（兼容 PD 协议） -- USB 串口数据线（可选）：用于串口调试和登录系统 -- HDMI 数据线和显示器（可选）：用于显示系统界面和图形化界面操作 +- 供电：12V Type-C 电源适配器（兼容 PD 协议） +- 系统启动介质：MicroSD 卡（用于安装系统与启动） +- 显示设备：HDMI 数据线和显示器 +- 输入设备：键盘和鼠标（用于图形界面操作） +- 调试工具（可选）：USB 串口数据线（用于串口登录） :::tip 推荐配件 - [瑞莎 PD 30W电源适配器(推荐使用)](https://radxa.com/products/accessories/power-pd-30w) -- 标准 12V Type-C 电源适配器，建议电流 2A - ::: +- 标准 12V Type-C 电源适配器，建议电流 2A 及以上 + +::: ## 安装系统 -您可以根据自己的系统启动介质和拥有的硬件设备，参考下面教程进行系统安装： +主要介绍安装系统到 MicroSD 卡。 + +:::warning 重要提醒 -- [安装系统到 MicroSD 卡](./install-system/sd_system) -- [安装系统到 U 盘](./install-system/udisk_system) -- [安装系统到 NVMe SSD](./install-system/nvme_system) +**安装系统会完全格式化 MicroSD 卡，所有数据将被永久删除！** -:::tip 系统启动说明 -默认情况下，系统启动盘为 MicroSD 卡，无需其他操作可以直接启动 MicroSD 卡系统，但是无法直接启动 U 盘或者 NVMe SSD 内的系统。 +请在操作前确认： + +- MicroSD 卡中无重要数据或已完成资料备份 +- 选择正确的存储设备，避免格式化其他磁盘 -若您是将系统安装到 U 盘或者 NVMe SSD 上，需要参考 [修改系统启动盘引导选项](./install-system/boot_option) 教程修改系统启动盘引导选项。 ::: -## 启动系统 +## 硬件连接 -完成系统的安装后，将 MicroSD 卡安装到 Dragon Q6A 的 MicroSD 卡槽中，然后使用 12V Type-C 电源适配器给 Dragon Q6A 供电，即可启动系统。 +将 MicroSD 卡插入 MicroSD 卡读卡器，再将 MicroSD 卡读卡器插入电脑。 + +
+ +
+ +### 下载系统镜像 + +请访问 [资源汇总下载](../download) 页面，下载 **系统镜像**。 + +:::tip 软件使用 + +该镜像文件为 `.img.xz` 格式的压缩包，下载后需要先解压，得到 `.img` 格式的镜像文件才能使用。 + +::: + +### 安装系统镜像 + +使用 Balena Etcher 软件可以将系统镜像安装到 MicroSD 卡中。 + +:::tip Balena Etcher + +对于 Balena Etcher 的安装和使用，可以参考 [Etcher 使用](/common/radxa-os/install-system/balena-etcher) 教程。 + +::: + +#### 选择系统镜像 + +点击 `Flash from file` 选项，选择自己提前下载并解压好的系统镜像文件。 + +
+ +
+ +#### 选择存储设备 -① : 安装 MicroSD 卡 +点击 `Select target` 选项，选择 MicroSD 卡设备。 -② : 使用 12V Type-C 电源适配器给 Dragon Q6A 供电 +
+ +
+ +
+ +
+ +#### 开始烧录 + +点击 `Flash!` 选项，开始烧录系统镜像到 MicroSD 卡中。 + +
+ +
+ +
+ 等待系统安装完成 + +
+ +
+ 等待系统校验完成 + +
+ +
+ 成功安装系统镜像后，关闭 Etcher 软件！ + +
+ +## 启动系统 + +完成系统的安装后，将 MicroSD 卡安装到 Dragon Q6A 的 MicroSD 卡槽中，然后使用 12V Type-C 电源适配器给 Dragon Q6A 供电，即可启动系统。
- +
-系统启动正常后，电源指示灯绿色亮起，状态指示灯蓝色闪烁。 +① ：安装 MicroSD 卡 -## 系统信息 +② ：使用 HDMI 数据线连接显示器和主板 -用户账号：ubuntu +③ ：使用 12V Type-C 电源适配器给 Dragon Q6A 供电 -用户密码：ubuntu +系统启动正常后，电源指示灯绿色亮起，状态指示灯蓝色闪烁。 ## 登录系统 -主要介绍 Dragon Q6A 搭配 USB 串口数据线登录系统，串口登录系统可以参考 [串口调试](../system-config/uart_debug) 教程。 +当您首次启动系统后，需要使用默认的用户名和密码登录。 -:::tip -Dragon Q6A 搭配显示器使用，整体操作比较直观和简单，这里便不再介绍！ -::: +Radxa OS 的默认凭据如下： + +| 项目 | 内容 | +| :----- | :------ | +| 用户名 | `radxa` | +| 密码 | `radxa` | ## 使用系统 -### 有屏模式 +成功启动系统后，您就可以在 Dragon Q6A 上正式使用瑞莎系统，对于瑞莎系统的简单使用，可参考 [使用系统](./use_system.md) 教程。 + +
+ +
+ +:::tip 其它启动系统方式 +对于想通过其它方式启动系统的用户（如 eMMC、UFS、以及 NVMe SSD 启动系统），可以参考下面教程完成对应系统启动介质安装系统： -有屏模式是指 Dragon Q6A 搭配显示器使用，整体操作比较直观和简单！ +- [安装系统到 MicroSD 卡](./install-system/sd_system.md) +- [安装系统到 U 盘](./install-system/udisk_system.md) +- [安装系统到 UFS](./install-system/ufs_system/) +- [安装系统到 eMMC](./install-system/emmc_system/) +- [安装系统到 NVMe 固态硬盘](./install-system/nvme_system/) -### 无屏模式 +系统启动优先级：USB > MicroSD > NVMe 固态硬盘 > eMMC 模块 > UFS 模块 -无屏模式是指 Dragon Q6A 不搭配显示器使用，通过串口或者 SSH 登录系统进行操作！ +::: diff --git a/docs/dragon/q6a/getting-started/use_system.md b/docs/dragon/q6a/getting-started/use_system.md new file mode 100644 index 000000000..c8aa81248 --- /dev/null +++ b/docs/dragon/q6a/getting-started/use_system.md @@ -0,0 +1,42 @@ +--- +sidebar_position: 3 +--- + +# 使用系统 + +介绍如何使用使用系统，包括启动系统、系统信息和有无显示器使用 Dragon Q6A 的建议。 + +## 启动系统 + +确保系统启动介质里面已经安装好系统，然后使用电源适配器给 Dragon Q6A 供电，系统启动正常后，电源指示灯绿色亮起，状态指示灯蓝色闪烁。 + +:::tip 使用推荐 + +对于初次使用 Dragon Q6A 的用户，推荐按照 [快速上手](./quickly_start.md) 的教程操作，整个过程比较详细和完整。 + +::: + +## 系统信息 + +当您首次启动系统后，需要使用默认的用户名和密码登录。 + +Radxa OS 的默认凭据如下： + +| 项目 | 内容 | +| :----- | :------ | +| 用户名 | `radxa` | +| 密码 | `radxa` | + +## 使用系统 + +主要无显示器的用户提供一些使用建议，方便大家更好的上手使用我们的 Dragon Q6A。 + +### 有显示器 + +使用 HDMI 数据线连接主板和显示器，系统正常启动的情况下，显示器会显示系统界面；此时，我们可以通过显示器和键盘鼠标来操作 Ubuntu 系统，整个使用过程比较简单。 + +### 无显示器 + +对于无显示器的用户，可以通过 [串口登录](../system-use/uart_debug.md) 和 [SSH 登录](../system-use/ssh.md) 来操作系统。 + +该方式使用命令行进行交互，适合有一定开发经验的用户。 diff --git a/docs/dragon/q6a/hardware-use/hardware_info.md b/docs/dragon/q6a/hardware-use/hardware_info.md index eba4953b6..940b995cd 100644 --- a/docs/dragon/q6a/hardware-use/hardware_info.md +++ b/docs/dragon/q6a/hardware-use/hardware_info.md @@ -13,16 +13,16 @@ sidebar_position: 1 ## 接口说明
- +
-| 序号 | 说明 | 序号 | 说明 | 序号 | 说明 | -| :--: | :--------------- | :--: | :----------------------------------------------------------- | :--: | :------------------------ | -| 1 | USB Type-C 接口 | 9 | PoE 接口 | 17 | 12 V 电源输入接口 | -| 2 | LPDDR5 内存 | 10 | 千兆以太网接口（支持 PoE） | 18 | 麦克风输入接口 | -| 3 | Power 按键 | 11 | SPI Flash | 19 | eMMC / UFS 模块二合一接口 | -| 4 | 天线接口 | 12 | 2x USB 2.0 Type-A 接口 | 20 | RTC 接口 | -| 4 | WiFi 6 / BT 5.4 | 13 | USB 2.0 Type-A 接口（上层）
USB 3.1 Type-A 接口（下层） | 21 | 2x MIPI CSI 2-Lane 接口 | -| 6 | M.2 M Key 接口 | 14 | EDL 按键 | 22 | MIPI DSI 4-Lane 接口 | -| 7 | 40 Pin GPIO 排针 | 15 | 耳机插孔 | 23 | MicroSD 卡槽 | -| 8 | Qualcomm QCS6490 | 16 | HDMI 接口 | 24 | MIPI CSI 4-Lane 接口 | +| 序号 | 说明 | 序号 | 说明 | 序号 | 说明 | +| :--: | :--------------- | :--: | :--------------------------------------------------------------- | :--: | :--------------------- | +| 1 | 高通 QCS6490 | 9 | 电源输入接口 | 17 | 2x USB 2.0 Type-A 接口 | +| 2 | 40 Pin GPIO 接口 | 10 | MIPI CSI（4 Lane） | 18 | EDL 按键 | +| 3 | M.2 M Key 插槽 | 11 | MicroSD 卡槽 | 19 | 耳机插孔 | +| 4 | WiFi 6 / BT 5.4 | 12 | MIPI DSI（4 Lane） | 20 | 标准 HDMI | +| 5 | 天线接口 | 13 | PoE 接口 | 21 | eMMC & UFS 模块二合一 | +| 6 | 电源按键 | 14 | 千兆以太网 | 22 | RTC 电池接口 | +| 7 | LPDDR5 内存 | 15 | QSPI Nor Flash | 23 | 2x MIPI CSI（2 Lane） | +| 8 | USB 2.0 Type-C | 16 | USB 2.0 Type-A 接口（上层）
USB 3.1 OTG Type-A 接口（下层） | | | diff --git a/docs/dragon/q6a/system-use/ssh.md b/docs/dragon/q6a/system-use/ssh.md index ba61eb641..93e07df64 100644 --- a/docs/dragon/q6a/system-use/ssh.md +++ b/docs/dragon/q6a/system-use/ssh.md @@ -2,223 +2,8 @@ sidebar_position: 2 --- -# SSH 远程 +import SSH_REMOTE from '../../../common/radxa-os/system-config/\_ssh_remote.mdx'; -## 使用前提 +# SSH 登录 -SSH 远程需要双方设备处于同一局域网下，且目标设备需要开启 SSH 服务。 - -:::tip -我们提供的系统镜像默认开启 SSH 服务，可以直接 SSH 远程控制， 看如果未安装或者开启 SSH 服务，你可以按照教程进行操作！ -::: - -## 安装 OpenSSH - -SSH 远程控制需要安装 OpenSSH, 在主板的终端运行以下命令安装： - - - -``` -sudo apt update && sudo apt install openssh-server -y -``` - - - -### 启动 SSH 服务 - -在主板的终端运行以下命令启动 SSH 服务： - - - -``` -sudo systemctl start ssh -``` - - - -### 设置 SSH 服务开机自启 - -在主板的终端运行以下命令设置 SSH 服务开机自启： - - - -``` -sudo systemctl enable ssh -``` - - - -### 检查 SSH 服务状态 - -在主板的终端运行以下命令检查 SSH 服务状态： - - - -``` -sudo systemctl status ssh -``` - - - -终端会输出类似信息: 提示您 SSH 服务是否自启动和当前运行状态。 - -``` -● ssh.service - OpenBSD Secure Shell server -Loaded: loaded (/lib/systemd/system/ssh.service; enabled; vendor preset: enabled) -Active: active (running) since Sat 2000-01-01 00:14:50 UTC; 25 years 5 months ago -Docs: man:sshd(8) -man:sshd_config(5) -Main PID: 518 (sshd) -CPU: 284ms -CGroup: /system.slice/ssh.service -└─518 sshd: /usr/sbin/sshd -D [listener] 0 of 10-100 startups -``` - -## SSH 远程控制 - -您可以通过终端命令行或者使用 Tabby 软件进行 SSH 远程登录。 - - - - - -在另一台设备上打开终端，输入以下命令进行远程登录： - - - -``` -ssh @ - -# 示例 -ssh radxa@192.168.2.186 -``` - - - -其中，`` 和 `` 分别是目标设备的实际用户名和 IP 地址。 - -连接过程中需要你输入 `yes` 确认连接。 - -
- -
- - - - -Tabby 是一款功能强大的跨平台串口调试工具，支持串口、SSH 等多种协议; 我们推荐使用 Tabby 软件进行 SSH 远程登录。 - -#### Tabby 下载 - -访问 [Tabby 官网](https://tabby.sh/) 下载并安装 Tabby 软件。 - -#### Tabby 安装 - -- Windows - -根据自己的系统架构选择 `.exe` 文件进行安装。 - -- Linux - -根据自己的系统架构选择 `.deb` 文件进行安装。 - -- MacOS - -根据自己的系统架构选择 `.dmg` 文件进行安装。 - -#### Tabby 使用 - -双击 Tabby 软件图标打开 Tabby 软件。 - -
- -
- -#### SSH 配置 - -① --> `Settings` : 点击设置选项 - -② --> `Profiles & connections` : 点击配置连接选项 - -③ --> `New profile` : 点击添加新的配置选项 - -
- -
- -#### 选择 SSH 模板 - -选择一个基础配置作为模板：选择 `SSH connection` 模板，我们可以在后续配置界面修改设备名称、IP 地址、端口等参数。 - -
- -
- -选择 `SSH connection` 模板后，修改以下参数: - -① --> `Name` : 设置连接名称 - -② --> `Host` : 设置 IP 地址，根据目标设备的实际 IP 地址填写 - -③ --> `User` : 设置用户名，默认出厂用户名为 `radxa` - -④ --> `Save` : 保存配置 - -端口号默认为 `22`，不用修改。 - -
- -
- -#### 运行 SSH 连接 - -点击运行按钮远程连接 SSH 设备。 - -
- -
- -点击运行按钮后，Tabby 软件会弹出密钥验证和输入密码的界面。 - -
- -
- -① --> password : 输入目标设备的密码 - -② --> OK : 确认连接 - -推荐勾选 `Remember` 选项，这样下次连接时就不需要输入密码了。 - -
- -
- -连接成功后，会出现远程的界面。 - -
- -
- - - - -SSH 远程登录成功后，你就可以通过 SSH 运行命令控制系统。 + diff --git a/docs/dragon/q6a/system-use/uart_debug.md b/docs/dragon/q6a/system-use/uart_debug.md index c1aee5396..63133bdec 100644 --- a/docs/dragon/q6a/system-use/uart_debug.md +++ b/docs/dragon/q6a/system-use/uart_debug.md @@ -2,21 +2,16 @@ sidebar_position: 1 --- -# 串口调试 +import UART_DEBUG from '../../../common/radxa-os/system-config/\_uart_debug.mdx'; -串口调试是嵌入式开发中通过串行通信接口 (UART) 与开发板交互的核心手段，通过串口工具可以查看系统输出的信息和进行调试。 +# 串口登录 -## 硬件准备 - -- 开发板：瑞莎 Dragon Q6A -- 系统启动介质：MicroSD 卡 -- 电源适配器：12V Type-C 电源适配器（兼容 PD 协议） -- USB 串口数据线：用于串口调试和登录系统 +串口登录是嵌入式开发中通过串行通信接口 (UART) 与主板交互的核心手段，通过串口工具可以查看系统输出的日志和进行命令行交互。 ## 硬件连接 :::danger -使用 USB 串口数据线和 Dragon Q6A 进行串口调试时，请确保引脚连接正确，接错引脚可能会导致主板硬件损坏。 +使用 USB 串口数据线和 Dragon Q6A 进行串口登录时，请确保引脚连接正确，接错引脚可能会导致主板硬件损坏。 不建议连接 USB 串口数据线的 VCC 接口（红色线），避免接错导致主板损坏。 ::: @@ -45,79 +40,4 @@ sidebar_position: 1 - 流控：无 ::: -### Tabby 使用 - -我们推荐使用 Tabby 软件进行串口登录，Tabby 是一款功能强大、界面友好的串口调试软件，支持串口、SSH 等多种协议，适配 Windows、macOS、Linux 等主流操作系统。 - -#### Tabby 安装 - -通过 [Tabby 官网](https://tabby.sh/) 下载并安装 Tabby 软件。 - -:::tip - -- Windows - -根据自己的系统架构选择 `.exe` 文件进行安装。 - -- Linux - -根据自己的系统架构选择 `.deb` 文件进行安装。 - -- MacOS - -根据自己的系统架构选择 `.dmg` 文件进行安装。 -::: - -#### Tabby 使用（串口） - -双击 Tabby 软件图标打开 Tabby 软件。 - -
- -
- -- 设置串口连接 - -① --> `Settings` : 点击设置选项 - -② --> `Profiles & connections` : 点击配置连接选项 - -③ --> `New profile` : 点击添加新的配置选项 - -
- -
- -- 选择一个基础配置作为模板 - -选择任意 `Serial` 模板，我们可以在后续配置界面修改设备名称、串口设备号、波特率等参数。 - -
- -
- -选择 `Serial` 模板后，修改以下参数: - -① --> `Name` : 设置连接名称,建议填写产品名称 - -② --> `Device` : 设置串口设备号，若只连接一个串口设备，一般为 `/dev/ttyUSB0` - -③ --> `Baud rate` : 设置波特率,填写 `115200` - -④ --> `Save` : 保存配置 - -
- -
- -点击运行按钮连接串口设备: - -
- -
- -连接成功后，按回车会出现登陆信息，然后使用对应系统的用户账号和密码进行登陆（终端输入密码不会显示出来，输入完密码按回车登陆）。 - -
- -
+ diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_dd_emmc.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_dd_emmc.mdx index 8d5aeab6d..4ce230fa7 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_dd_emmc.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_dd_emmc.mdx @@ -1,26 +1,26 @@ -This document explains how to install the system to eMMC using the `dd` command. +This guide explains how to install the system to eMMC using the `dd` command when the system can boot normally from a MicroSD card. :::warning -Installing the system will format the eMMC module. Please back up important data in advance! +Installing the system will format the eMMC. Please back up any important data in advance! ::: ## Prerequisites -You need to meet the following conditions to install the system to eMMC using the `dd` command: +To use the `dd` command to install the system to eMMC, you need to meet the following conditions: -- The system can boot normally via another boot medium. It is recommended to boot the system from a MicroSD card. -- The eMMC module is installed on the board, or the board itself has onboard eMMC. +- The system can boot normally from a MicroSD card +- eMMC is installed on the board or the board has built-in eMMC ## Hardware Connection -### Steps to install the eMMC module: +eMMC Module Installation Steps: -1. Check the notch orientation on the eMMC module and the notch marking on the eMMC connector on the board to determine the correct installation direction. -2. Place the eMMC module above the board's eMMC connector, ensuring the connectors are roughly aligned. -3. Press down on one end of the eMMC module with slight force. A "click" sound indicates a successful insertion. Then press the other end in the same way to ensure the eMMC module is fully seated. +1. Observe the notch direction on the eMMC module and the notch marking on the board's eMMC module interface to determine the correct installation orientation. +2. Place the eMMC module above the board's eMMC module interface, ensuring the eMMC module interface is properly aligned with the board's eMMC module interface. +3. Gently press one end of the eMMC module until you hear a "click" sound, indicating successful installation. Then press the other end in the same way to ensure the eMMC module is properly installed.
-If your board is the version with onboard eMMC, no installation is required. +If your board has onboard eMMC, no installation is required. -## Install the System +## System Installation -### Download the System Image +### Download System Image -On the board, visit the [Resources Download](../../download) page and download the system image file locally. +Access the Resource Download page from your device and download the **latest system image** to the device. :::tip Image Note -The downloaded system image is a compressed file. You need to extract it before use! +The downloaded system image is a compressed file and needs to be extracted before use! ::: -You can use the `wget` command to download the system image file to the board. +You can use the `wget` command to download the system image file to your device. @@ -60,13 +60,13 @@ wget -Here, `` is the download address of the system image file. You can copy the image download link from the [Resources Download](../../download) page and replace it. +Where `` is the download URL of the system image file. You can copy the image download URL from the Resource Download page to replace it. Download example: {`wget ${props?.download_url ?? ''}`} -#### Extract the System Image +#### Extract System Image -Our system images are usually in the `*.img.xz` format and must be extracted before use. +Our system images are generally in `*.img.xz` format and need to be extracted before use. @@ -77,17 +77,17 @@ unxz -Here, `` is the path to the system image file. Replace it with the actual path. +Where `` is the path to the system image file, which needs to be replaced with the actual system image file path. Extraction example: {`unxz ${props?.path_to_image_unxz ?? ""}`} -### Identify the Device Path +### Determine Device Path -You can use the `lsblk` command to view device paths and determine the correct one based on disk capacity. +You can use the `lsblk` command to check the device path and determine it based on the disk capacity. -Note: If the disk capacities are very similar, you can safely hot-plug (applies to an eMMC module) to observe which device path appears and disappears to determine the correct device. +Note: If the disk capacities are similar, you can safely remove and reinsert the eMMC module (for eMMC modules) to observe which device path appears and disappears, thus determining the correct device path. @@ -97,23 +97,21 @@ lsblk -If the eMMC device is recognized, it is usually shown as a `/dev/mmcblk*` device. +If the system recognizes the eMMC device, it will typically be identified as a `/dev/mmcblk*` device. -Example terminal output: +Terminal output example: ``` NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINTS -mmcblk0 179:0 0 58G 0 disk -├─mmcblk0p1 179:1 0 16M 0 part /config -├─mmcblk0p2 179:2 0 300M 0 part /boot/efi -└─mmcblk0p3 179:3 0 57.6G 0 part / -zram0 254:0 0 982.6M 0 disk [SWAP] -mmcblk1 179:0 0 58G 0 disk +··· +mmcblk1 179:0 0 29.1G 0 disk +└─mmcblk1p1 179:1 0 29.1G 0 part +··· ``` -### Install the System Image +### Install System Image -Use the `dd` command to write the system image to the eMMC. +Use the `dd` command to install the system image to the eMMC. @@ -131,14 +129,17 @@ Write example: Parameter description: -- ``: The path to the system image file. Replace it with the actual path. -- ``: The device path of the eMMC module. Replace it with the actual eMMC device path. +- ``: The path to the system image file, which needs to be replaced with the actual system image file path. + +- ``: The device path of the eMMC module, which needs to be replaced with the actual eMMC module's device path. + - `bs=4M`: Block size for writing. -- `status=progress`: Show write progress. -### Verify the Write Result +- `status=progress`: Display write progress. + +### Verify Write Result -After installation, use the `lsblk` command to check whether the partition table on the eMMC has been created correctly. +After the system installation is complete, you can use the `lsblk` command to check if the eMMC partition table has been created correctly. @@ -148,17 +149,14 @@ lsblk -Example terminal output: +Terminal output example: ``` NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINTS -mmcblk0 179:0 0 58G 0 disk -├─mmcblk0p1 179:1 0 16M 0 part /config -├─mmcblk0p2 179:2 0 300M 0 part /boot/efi -└─mmcblk0p3 179:3 0 57.6G 0 part / -zram0 254:0 0 982.6M 0 disk [SWAP] -mmcblk1 179:0 0 58G 0 disk -├─mmcblk1p1 179:1 0 16M 0 part -├─mmcblk1p2 179:2 0 300M 0 part -└─mmcblk1p3 179:3 0 57.6G 0 part +··· +mmcblk0 179:0 0 29.1G 0 disk +├─mmcblk0p1 179:1 0 16M 0 part +├─mmcblk0p2 179:2 0 300M 0 part +└─mmcblk0p3 179:3 0 28.8G 0 part +··· ``` diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_dd_nvme.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_dd_nvme.mdx index c0e8467b5..e08afd144 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_dd_nvme.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_dd_nvme.mdx @@ -1,37 +1,25 @@ import { Image } from "@site/src/utils/docs"; -This document explains how to install the system to an NVMe SSD using the `dd` command. +This guide explains how to install the system to an NVMe SSD using the `dd` command when the system can boot normally from a MicroSD card. :::warning -Installing the system will format the NVMe SSD. Please back up important data in advance! +Installing the system will format the NVMe SSD. Please back up any important data in advance! ::: ## Prerequisites -You need to meet the following conditions to install the system to an NVMe SSD using the `dd` command: - -- The system can boot normally from another storage device: It is recommended to boot the system from a MicroSD card +To use the `dd` command to install the system to an NVMe SSD, you need to meet the following conditions: +- The system can boot normally from a MicroSD card - NVMe SSD is installed on the board ## Hardware Connection -You can proceed according to your board's configuration. - -:::tip -This tutorial is applicable to multiple boards. You need to select the corresponding steps for hardware connection based on your board's configuration. - -There are two scenarios for installing an NVMe SSD on a board: - -- Board with M.2 M Key interface: NVMe SSD can be installed directly - -- Board without M.2 M Key interface but with PCIe FPC interface: NVMe SSD can be installed using a PCIe to M.2 M Key HAT module - - ::: +Install the NVMe SSD on the board, connect a display, and power the board using a power adapter. - - Install NVMe SSD through M.2 M Key 2280 interface. + + Install NVMe SSD via M.2 M Key 2280 interface.
- Install NVMe SSD through M.2 M Key 2230 interface. + Install NVMe SSD via M.2 M Key 2230 Slot. - NVMe SSD can be installed using the PCIe FPC interface with an M.2 M Key HAT. + NVMe SSD can be installed using PCIe FPC interface with M.2 M Key HAT. -## Install the System +## System Installation -### Download the System Image +### Download System Image -On the board, visit the [Resources Download](../../../../download) page and download the system image file locally. +Access the Resource Download page from your device and download the **latest system image** to the device. :::tip Image Note -The downloaded system image is a compressed file. You need to extract it before use! +The downloaded system image is a compressed file and needs to be extracted before use! ::: -You can use the `wget` command to download the system image file to the board. +You can use the `wget` command to download the system image file to your device. @@ -81,13 +69,15 @@ wget -Here, `` is the download address of the system image file. You can copy the image download link from the [Resources Download](../../../../download) page and replace it. +Where `` is the download URL of the system image file. You can copy the **latest image** download URL from the Resource Download page to replace it. + +Download example: -Download example: {`wget ${props?.download_url ?? ''}`} +{`wget ${props?.download_url ?? ""}`} -#### Extract the System Image +#### Extract System Image -Our system images are usually in the `*.img.xz` format and must be extracted before use. +Our system images are generally in `*.img.xz` format and need to be extracted before use. @@ -98,17 +88,17 @@ unxz -Here, `` is the path to the system image file. Replace it with the actual path. +Where `` is the path to the system image file, which needs to be replaced with the actual system image file path. Extraction example: {`unxz ${props?.path_to_image_unxz ?? ""}`} -### Identify the Device Path +### Determine Device Path -You can use the `lsblk` command to view device paths and determine the correct one based on disk capacity. +You can use the `lsblk` command to check the device path and determine it based on the disk capacity. -Note: If the disk capacities are very similar, you can safely hot-plug (applies to NVMe SSD) to observe which device path appears and disappears to determine the correct device path. +Note: If the disk capacities are similar, you can safely remove and reinsert the NVMe SSD to observe which device path appears and disappears, thus determining the correct device path. @@ -118,26 +108,21 @@ lsblk -If the system recognizes an SPI Flash device, it is usually shown as a `/dev/mtdblock*` device. +If the system recognizes the NVMe device, it will typically be identified as a `/dev/nvme*n*` device. If there are multiple storage devices, you can determine the corresponding device path by safely removing and reinserting the device. -If the system recognizes an NVMe device, it is usually shown as a `/dev/nvme*n*` device. If there are multiple NVMe devices, you can determine the corresponding device path by safely hot-plugging. - -Example terminal output: +Terminal output example: ``` NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINTS -mtdblock0 31:0 0 16M 0 disk -mmcblk0 179:0 0 58G 0 disk -├─mmcblk0p1 179:1 0 16M 0 part /config -├─mmcblk0p2 179:2 0 300M 0 part /boot/efi -└─mmcblk0p3 179:3 0 57.6G 0 part / -zram0 254:0 0 982.6M 0 disk [SWAP] +··· nvme0n1 259:0 0 119.2G 0 disk +└─nvme0n1p1 259:1 0 119.2G 0 part +··· ``` -### Install the System Image +### Install System Image -Use the `dd` command to write the system image to the NVMe SSD. +Use the `dd` command to install the system image to the NVMe SSD. @@ -155,17 +140,17 @@ Write example: Parameter description: -- ``: The path to the system image file. Replace it with the actual path. +- ``: The path to the system image file, which needs to be replaced with the actual system image file path. -- ``: The device path of the NVMe SSD module. Replace it with the actual NVMe SSD device path. +- ``: The device path of the NVMe SSD module, which needs to be replaced with the actual NVMe SSD module's device path. - `bs=4M`: Block size for writing. -- `status=progress`: Show write progress. +- `status=progress`: Display write progress. -### Verify the Write Result +### Verify Write Result -After installation, use the `lsblk` command to check whether the partition table on the NVMe SSD has been created correctly. +After the system installation is complete, you can use the `lsblk` command to check if the NVMe SSD partition table has been created correctly. @@ -175,18 +160,14 @@ lsblk -Example terminal output: +Terminal output example: ``` NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT -mtdblock0 31:0 0 16M 0 disk -mmcblk0 179:0 0 58G 0 disk -├─mmcblk0p1 179:1 0 16M 0 part /config -├─mmcblk0p2 179:2 0 300M 0 part /boot/efi -└─mmcblk0p3 179:3 0 57.6G 0 part / -zram0 254:0 0 982.6M 0 disk [SWAP] -nvme0n1 259:0 0 238.5G 0 disk -├─nvme0n1p1 259:1 0 16M 0 part -├─nvme0n1p2 259:2 0 300M 0 part -└─nvme0n1p3 259:3 0 238.2G 0 part +··· +nvme0n1 259:0 0 119.2G 0 disk +├─nvme0n1p1 259:3 0 16M 0 part +├─nvme0n1p2 259:4 0 300M 0 part +└─nvme0n1p3 259:5 0 6.3G 0 part +··· ``` diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_dd_ufs.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_dd_ufs.mdx index 7b44a1052..444eaf1f4 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_dd_ufs.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_dd_ufs.mdx @@ -1,35 +1,26 @@ -This document explains how to install the system to UFS storage using the `dd` command. +This guide explains how to install the system to UFS using the `dd` command when the system can boot normally from a MicroSD card. :::warning -Installing the system will format the UFS module or onboard UFS storage. Please back up any important data in advance! +Installing the system will format the UFS module or onboard UFS. Please back up any important data in advance! ::: ## Prerequisites -To install the system to UFS using the `dd` command, you need to meet the following conditions: +To use the `dd` command to install the system to UFS, you need to meet the following conditions: -- The system can boot normally from another storage device: It is recommended to use a MicroSD card to boot the system - -- The UFS module is installed on the board, or the board has onboard UFS storage +- The system can boot normally from a MicroSD card +- UFS is installed on the board or the board has onboard UFS ## Hardware Connection -You can proceed with the following steps based on your board's configuration. - -:::tip -This tutorial is applicable to multiple board models. Choose the appropriate steps for hardware connection based on your specific board configuration. - -For boards with onboard UFS storage, there is no UFS module interface, so no installation is required. -::: - -### UFS Module Installation Steps: +UFS Module Installation Steps: 1. Observe the notch direction on the UFS module and the notch marking on the board's UFS module interface to determine the correct installation orientation. -2. Place the UFS module above the board's UFS module interface, ensuring the module's interface is roughly aligned with the board's interface. -3. Gently press down on one end of the UFS module until you hear a "click" sound, then press the other end in the same way to ensure the UFS module is properly installed. +2. Place the UFS module above the board's UFS module interface, ensuring the UFS module interface is properly aligned with the board's UFS module interface. +3. Gently press one end of the UFS module until you hear a "click" sound, indicating successful installation. Then press the other end in the same way to ensure the UFS module is properly installed.
-If your board has onboard UFS storage, no installation is required. +If your board has onboard UFS, no installation is required. @@ -51,83 +42,106 @@ If your board has onboard UFS storage, no installation is required. ### Download System Image -The board needs to access the resources download page to directly download the system image file locally. +Access the Resource Download page from your device and download the **latest system image** to the device. :::tip Image Note The downloaded system image is a compressed file and needs to be extracted before use! ::: -#### Recommended Download Methods +You can use the `wget` command to download the system image file to your device. + + + +``` +sudo apt update +sudo apt install wget -y +wget +``` + + -- Direct Download +Where `` is the download URL of the system image file. You can copy the image download URL from the Resource Download page to replace it. -Access the resources download page directly from the board and download the system image file locally. +Download example: {`wget ${props?.download_url ?? ''}`} -- Download using wget +#### Extract System Image -Use the `wget` command on the board to download the system image file. +Our system images are generally in `*.img.xz` format and need to be extracted before use. - + ``` -sudo apt update && -sudo apt install wget -y -wget +sudo apt install xz-utils -y +unxz ``` -Where `` is the download address of the system image file. You can copy the download address from the resources download page and replace it. +Where `` is the path to the system image file, which needs to be replaced with the actual system image file path. -- PC Download +Extraction example: -Access the resources download page from a PC, download the system image file, and then transfer it to the board using a USB drive, FTP, SCP, or other methods. +{`unxz ${props?.path_to_image_unxz ?? ""}`} -#### Extract System Image +### Determine Device Path + +You can use the `lsblk` command to check the device path and determine it based on the disk capacity. -Our system images are typically in `*.img.xz` format and need to be extracted before use. +Note: If the disk capacities are similar, you can safely remove and reinsert the UFS module to observe which device path appears and disappears, thus determining the correct device path. - + ``` -sudo apt update -sudo apt install xz-utils -y -unxz +lsblk ``` -Where `` is the path to the system image file. Replace it with the actual path to your system image file. +If the system recognizes the UFS device, it will typically be identified as a `/dev/sd*` device. + +Terminal output example: + +``` +NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINTS +··· +sda 8:0 0 119.2G 0 disk +└─sda1 8:1 0 119.2G 0 part +··· +``` ### Install System Image -Use the `dd` command to install the system image to UFS storage. +Use the `dd` command to install the system image to the UFS. - + ``` -sudo dd if= of= bs=4M status=progress +sudo dd if= of= bs=4M status=progress ``` -Parameter Description: +Write example: -- ``: The path to the system image file. Replace it with the actual path to your system image file. +{`sudo dd if=${ + props?.path_to_image ?? "" +} of=/dev/sda bs=4M status=progress`} -- ``: The device path of the UFS module. Replace it with the actual device path of your UFS module. +Parameter description: -- `bs=4M`: Block size for writing. +- ``: The path to the system image file, which needs to be replaced with the actual system image file path. -- `status=progress`: Show write progress. +- ``: The device path of the UFS module, which needs to be replaced with the actual UFS module's device path. + +- `bs=4M`: Block size for writing. -:::tip Determine Device Path +- `status=progress`: Display write progress. -You can use the `lsblk` command to view device paths and determine the correct one based on disk capacity. +### Verify Write Result -Note: If disk capacities are similar, you can safely plug and unplug the UFS module (with the board powered off) to observe which device path appears and disappears, thus identifying the correct device path. +After the system installation is complete, you can use the `lsblk` command to check if the UFS partition table has been created correctly. - + ``` lsblk @@ -135,4 +149,14 @@ lsblk -::: +Terminal output example: + +``` +NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINTS +··· +sda 8:0 0 119.2G 0 disk +├─sda1 8:1 0 128M 0 part +├─sda2 8:2 0 2.3G 0 part +└─sda3 8:3 0 6.4G 0 part +··· +``` diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_etcher_emmc.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_etcher_emmc.mdx new file mode 100644 index 000000000..cf0441568 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_etcher_emmc.mdx @@ -0,0 +1,123 @@ +This guide explains how to use the Radxa eMMC/UFS module reader with an eMMC module to install the system onto the eMMC module. + +:::warning +Installing the system will format the eMMC module. Please back up any important data in advance! +::: + +## Prerequisites + +### Hardware Requirements + +You need to prepare the following hardware devices in advance: + +- eMMC module +- Radxa eMMC/UFS Module Reader + +:::tip Recommended Accessories + +- [Radxa eMMC Module](https://radxa.com/products/accessories/emmc-module) +- [Radxa eMMC/UFS Module Reader](https://radxa.com/products/accessories/emmc-ufs-module-reader) + +::: + +### Hardware Connection + +Insert the eMMC module into the Radxa eMMC/UFS Module Reader, then connect the reader to your computer. + +:::caution + +eMMC Module Installation Steps: + +1. Ensure the notch on the eMMC module aligns with the interface direction of the module reader +2. Make sure the slot interface at the bottom of the eMMC module aligns with the module reader's interface +3. Gently press one end of the eMMC module until you hear a "click" sound, indicating successful installation. Use the same method to press the other end to ensure the eMMC module is properly installed. + ::: + +
+ +
+ +## System Installation + +### Download System Image + +Use your PC to access the Resource Download page and download the system image file to your local machine. + +:::tip Image Note +The downloaded system image is a compressed file and needs to be extracted before use! +::: + +### Install System Image + +You can use Balena Etcher software to install the system image onto the eMMC module. + +:::tip Balena Etcher +For installation and usage instructions of Balena Etcher, you can refer to the [Etcher Usage](/common/radxa-os/install-system/balena-etcher) tutorial. +::: + +#### Select System Image + +Click the `Flash from file` option and select the system image file you downloaded and extracted earlier. + +
+ +
+ +#### Select Storage Device + +Click the `Select target` option and choose the eMMC module device. + +
+ +
+ +
+ +
+ +#### Start Flashing + +Click the `Flash!` option to begin writing the system image to the eMMC module. + +
+ +
+ +
+ Waiting for system installation to complete + +
+ +
+ Waiting for system verification to complete + +
+ +
+ After successfully installing the system image, close the Etcher software! + +
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_etcher_nvme.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_etcher_nvme.mdx index 991cdb46a..0db89aa15 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_etcher_nvme.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_etcher_nvme.mdx @@ -8,96 +8,92 @@ Installing the system will format the NVMe SSD. Please back up any important dat ### Hardware Requirements -You will need to prepare the following hardware devices: +You need to prepare the following hardware devices in advance: -- M.2 NVMe SSD enclosure -- System boot medium: M.2 M Key 2230 NVMe SSD +- M.2 NVMe SSD +- M.2 NVMe SSD Enclosure + +### Hardware Connection + +Install the M.2 NVMe SSD into the M.2 NVMe SSD enclosure, then connect the enclosure to your computer.
-### Hardware Connection - -1. Install the M.2 NVMe SSD into the M.2 NVMe SSD enclosure. -2. Connect the M.2 NVMe SSD enclosure to your computer. - ## System Installation ### Download System Image -1. Use a PC to access the [Resources Download](../../../../download) page. -2. Download the system image file to your local storage. +Use a PC to access the Downloads page and download the system image file to your local machine. :::tip Image Note -The downloaded system image is a compressed file. You need to extract it before use! +The downloaded system image is a compressed file that needs to be extracted before use! ::: ### Install System Image -You can use Balena Etcher software to install the system image to the M.2 NVMe SSD. +Use Balena Etcher software to install the system image to the M.2 NVMe SSD. :::tip Balena Etcher -For installation and usage instructions of Balena Etcher, please refer to the [Etcher Usage](/en/common/radxa-os/install-system/balena-etcher) tutorial. +For installation and usage of Balena Etcher, please refer to the [Etcher Guide](/common/radxa-os/install-system/balena-etcher) tutorial. ::: #### Select System Image -1. Click the `Flash from file` button. -2. Select the downloaded and extracted system image file. +Click the `Flash from file` option and select the system image file you downloaded and extracted earlier.
#### Select Storage Device -1. Click the `Select target` button. -2. Choose your M.2 NVMe SSD device. +Click the `Select target` option and choose the M.2 NVMe SSD device.
#### Start Flashing -1. Click the `Flash!` button to begin writing the system image to the M.2 NVMe SSD. +Click the `Flash!` option to start flashing the system image to the M.2 NVMe SSD.
- Wait for the system installation to complete + Waiting for system installation to complete
- Wait for the system verification to complete + Waiting for system verification to complete
@@ -105,38 +101,7 @@ For installation and usage instructions of Balena Etcher, please refer to the [E
After successfully installing the system image, close the Etcher software! -
- -## System Information - -When using our provided system image for the first time, you will need to log in with the following default credentials: - -- **Username**: radxa -- **Password**: radxa - -## Booting the System - -After completing the system installation, follow these steps to boot the system: - -1. Power off the board and disconnect the power supply. -2. Follow these steps to complete the system boot: - - 1. Remove the MicroSD card from the board (if any) - 2. Install the NVMe SSD onto the board - 3. Connect the board to a display using an HDMI cable - 4. Connect a mouse and keyboard using USB-A ports (if you have a USB-A hub, you can connect them through the hub) - 5. Power the board using a 5V Type-C power adapter - -If the power is connected correctly, the board's power indicator LED will light up green. If the system boots normally, the status LED will blink blue. - -After successfully booting the system, the desktop interface will be displayed on your monitor. You can log in using the system credentials mentioned above and start using the system. - -
-
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_etcher_sd.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_etcher_sd.mdx index 25cb8b2c3..43e3c9a51 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_etcher_sd.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_etcher_sd.mdx @@ -1,4 +1,4 @@ -This guide explains how to install the system onto a MicroSD card. +This guide explains how to install the system to a MicroSD card. :::warning Installing the system will format the MicroSD card. Please back up any important data in advance! @@ -8,7 +8,7 @@ Installing the system will format the MicroSD card. Please back up any important ### Hardware Requirements -You will need the following hardware devices: +You need to prepare the following hardware devices in advance: - MicroSD card - MicroSD card reader @@ -28,7 +28,7 @@ Insert the MicroSD card into the MicroSD card reader, then connect the card read ### Download System Image -Use a PC to visit the [Downloads](../../download) page and download the system image file to your local storage. +Use a PC to access the Downloads page and download the system image file to your local machine. :::tip Image Note The downloaded system image is a compressed file that needs to be extracted before use! @@ -36,15 +36,15 @@ The downloaded system image is a compressed file that needs to be extracted befo ### Install System Image -You can use Balena Etcher software to install the system image to the MicroSD card. +Use Balena Etcher software to install the system image to the MicroSD card. :::tip Balena Etcher -For installation and usage instructions of Balena Etcher, please refer to the [Etcher Usage](/en/common/radxa-os/install-system/balena-etcher) tutorial. +For installation and usage of Balena Etcher, please refer to the [Etcher Guide](/common/radxa-os/install-system/balena-etcher) tutorial. ::: #### Select System Image -Click the `Flash from file` option and select the system image file you have downloaded and extracted. +Click the `Flash from file` option and select the system image file you downloaded and extracted earlier.
- Wait for the system installation to complete + Waiting for system installation to complete
- Wait for the system verification to complete + Waiting for system verification to complete + +
+ +## System Installation + +### Download System Image + +Use a PC to access the Downloads page and download the system image file to your local machine. + +:::tip Image Note +The downloaded system image is a compressed file that needs to be extracted before use! +::: + +### Install System Image + +Use Balena Etcher software to install the system image to the USB drive. + +:::tip Balena Etcher +For installation and usage of Balena Etcher, please refer to the [Etcher Guide](/common/radxa-os/install-system/balena-etcher) tutorial. +::: + +#### Select System Image + +Click the `from file` option and select the system image file you downloaded and extracted earlier. + +
+ +
+ +#### Select Storage Device + +Click the `Select target` option and choose the USB drive device. + +
+ +
+ +
+ +
+ +#### Start Flashing + +Click the `Flash!` option to start flashing the system image to the USB drive. + +
+ +
+ +
+ Waiting for system installation to complete + +
+ +
+ Waiting for system verification to complete + +
+ +
+ After successfully installing the system image, close the Etcher software! + +
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_etcher_ufs.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_etcher_ufs.mdx new file mode 100644 index 000000000..80134a849 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/install-system/_use_etcher_ufs.mdx @@ -0,0 +1,123 @@ +This guide explains how to use the Radxa eMMC/UFS module reader with a UFS module to install the system onto the UFS module. + +:::warning +Installing the system will format the UFS module. Please back up any important data in advance! +::: + +## Prerequisites + +### Hardware Requirements + +You need to prepare the following hardware devices in advance: + +- UFS module +- Radxa eMMC/UFS module reader + +:::tip Recommended Accessories + +- [Radxa UFS Module](https://radxa.com/products/accessories/ufs-module) +- [Radxa eMMC/UFS module reader](https://radxa.com/products/accessories/emmc-ufs-module-reader) + +::: + +### Hardware Connection + +Insert the UFS module into the Radxa eMMC/UFS module reader, then connect the module reader to your computer. + +:::caution + +UFS Module Installation Steps: + +1. Ensure the notch on the UFS module aligns with the connector on the module reader +2. Make sure the slot interface at the bottom of the UFS module aligns with the connector on the module reader +3. Gently press down on one end of the UFS module until you hear a "click" sound, then repeat for the other end to ensure the UFS module is properly installed. + ::: + +
+ +
+ +## System Installation + +### Download System Image + +Use a PC to access the Downloads page and download the system image file to your local machine. + +:::tip Image Note +The downloaded system image is a compressed file that needs to be extracted before use! +::: + +### Install System Image + +Use Balena Etcher software to install the system image to the UFS module. + +:::tip Balena Etcher +For installation and usage of Balena Etcher, please refer to the [Etcher Guide](/common/radxa-os/install-system/balena-etcher) tutorial. +::: + +#### Select System Image + +Click the `Flash from file` option and select the system image file you downloaded and extracted earlier. + +
+ +
+ +#### Select Storage Device + +Click the `Select target` option and choose the UFS module device. + +
+ +
+ +
+ +
+ +#### Start Flashing + +Click the `Flash!` option to start flashing the system image to the UFS module. + +
+ +
+ +
+ Waiting for system installation to complete + +
+ +
+ Waiting for system verification to complete + +
+ +
+ After successfully installing the system image, close the Etcher software! + +
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/README.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/README.md index 98896d946..35ce4b493 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/README.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/README.md @@ -13,12 +13,13 @@ The Dragon Q6A is equipped with the Qualcomm QCS6490 SoC, featuring a “1+3+4 ## Product Appearance
- Dragon Q6A front side - - Dragon Q6A reverse side - +
+| No. | View | No. | Side View | No. | Back View | +| :-: | :--------------: | :-: | :-------------: | :-: | :-------------: | +| ① | Dragon Q6A Front | ② | Dragon Q6A Side | ③ | Dragon Q6A Back | + ## Product Specifications | Category | Specification Description | @@ -38,19 +39,19 @@ The Dragon Q6A is equipped with the Qualcomm QCS6490 SoC, featuring a “1+3+4 ## Interface Description
- +
-| No. | Description | No. | Description | No. | Description | -| :-: | :----------------- | :-: | :---------------------------------------------------------- | :-: | :---------------------------- | -| ① | USB Type-C Port | ⑨ | PoE Port | ⑰ | 12 V Power Input Port | -| ② | LPDDR5 Memory | ⑩ | Gigabit Ethernet Port (PoE support) | ⑱ | Microphone Input Jack | -| ③ | Power Button | ⑪ | QSPI Nor Flash | ⑲ | eMMC / UFS Combo Connector | -| ④ | Antenna Connector | ⑫ | 2x USB 2.0 Type-A Ports | ⑳ | RTC Connector | -| ⑤ | WiFi 6 / BT 5.4 | ⑬ | USB 2.0 Type-A Port (Upper)
USB 3.1 Type-A Port (Lower) | ㉑ | 2x MIPI CSI 2-Lane Connectors | -| ⑥ | M.2 M Key Slot | ⑭ | EDL Button | ㉒ | MIPI DSI 4-Lane Connector | -| ⑦ | 40-Pin GPIO Header | ⑮ | Headphone Jack | ㉓ | MicroSD Card Slot | -| ⑧ | Qualcomm QCS6490 | ⑯ | HDMI Port | ㉔ | MIPI CSI 4-Lane Connector | +| No. | Description | No. | Description | No. | Description | +| :-: | :----------------- | :-: | :-------------------------------------------------------------- | :-: | :---------------------- | +| 1 | Qualcomm QCS6490 | 9 | Power input Header | 17 | 2x USB 2.0 Type-A ports | +| 2 | 40 Pin GPIO Header | 10 | MIPI CSI (4 Lane) | 18 | EDL button | +| 3 | M.2 M Key slot | 11 | MicroSD card slot | 19 | Headphone jack | +| 4 | WiFi 6 / BT 5.4 | 12 | MIPI DSI (4 Lane) | 20 | Standard HDMI | +| 5 | Antenna connector | 13 | PoE Header | 21 | eMMC & UFS module | +| 6 | Power button | 14 | Gigabit Ethernet | 22 | RTC battery connector | +| 7 | LPDDR5 memory | 15 | QSPI Nor Flash | 23 | 2x MIPI CSI (2 Lane) | +| 8 | USB 2.0 Type-C | 16 | USB 2.0 Type-A port (upper)
USB 3.1 OTG Type-A port (lower) | | | ## Application Scenarios diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/download.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/download.md index 15d44eef7..e203dbc10 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/download.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/download.md @@ -6,7 +6,17 @@ sidebar_position: 8 ## System Image -- [Ubuntu System Image](https://dl.radxa.com/q6a/images/ubuntu-preinstalled-desktop-arm64-250731.img.zip) +- Ubuntu System Images + - [radxa-dragon-q6a_noble_kde_t2.output_512.img.xz](https://github.com/radxa-build/radxa-dragon-q6a/releases/download/rsdk-t2/radxa-dragon-q6a_noble_kde_t2.output_512.img.xz): For booting from MicroSD card / USB drive / eMMC / NVMe + - [radxa-dragon-q6a_noble_kde_t2.output_4096.img.xz](https://github.com/radxa-build/radxa-dragon-q6a/releases/download/rsdk-t2/radxa-dragon-q6a_noble_kde_t2.output_4096.img.xz): For booting from UFS + +:::tip Latest System Image Releases + +- [Dragon Q6A](https://github.com/radxa-build/radxa-dragon-q6a/releases) + +This page publishes the latest stable and beta system images. Beta versions start with `t`, and stable versions start with `b`. + +::: ## Boot Firmware @@ -29,7 +39,7 @@ For detailed steps on flashing the SPI boot firmware, please refer to the [Flash :::tip Firmware update description 1. Support eMMC boot -2. Add default boot device order: USB > SD > NVMe > eMMC > UFS > USB +2. Add default boot device order: USB > SD > NVMe > eMMC > UFS 3. Add boot device selection 4. Accelerate boot speed diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/README.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/README.md index ffd3f9bec..3fb2f6706 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/README.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/README.md @@ -1,7 +1,7 @@ --- -sidebar_position: 3 +sidebar_position: 2 --- -# Install the system +# Install System diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/boot_option.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/boot_option.md deleted file mode 100644 index 74fd035e1..000000000 --- a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/boot_option.md +++ /dev/null @@ -1,187 +0,0 @@ ---- -sidebar_position: 4 ---- - -# Modify boot settings for the system disk - -The Dragon Q6A supports modifying the system boot disk to MicroSD cards, USB flash drives, NVMe SSDs, and other devices. - -The system image file we provide defaults to a MicroSD card as the boot disk. If you need to modify it to a USB flash drive, NVMe SSD, or other device, you can refer to the tutorial below for instructions. - -## USB flash drive boot - -Edit the `/boot/grub/grub.cfg` file and change the `root` parameter to the device path of the USB flash drive. - -:::tip default boot disk -The default boot disk is a MicroSD card, root=/dev/mmcblk2p2 -::: - -### View the USB device number - -Plug the USB flash drive into the motherboard, then use the `lsblk` command to view the USB device number. - - - -``` -lsblk -``` - - - -Terminal output example: You can determine the USB device number by checking whether it can be safely plugged in and unplugged. - -``` -NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT -sda 8:0 1 58G 0 disk -├─sda1 8:1 1 112M 0 part -└─sda2 8:2 1 57.8G 0 part /media/user/9a5bc14a-4269-4786-a4e1-e5604266da9b -``` - -### Mount the USB flash drive BOOT partition - - - -``` -sudo mkdir ~/mnt -sudo mount /dev/sda1 ~/mnt -``` - - - -### Modify the GRUB configuration file - - - -``` -sudo nano ~/mnt/grub/grub.cfg -``` - - - -Modify the GRUB configuration file: Change the default `root=/dev/mmcblk2p2` to `root=/dev/sda2`. - -``` -insmod part_gpt -insmod part_msdos -insmod all_video -terminal_input console -terminal_output console -if serial --unit=0 --speed=115200; then - terminal_input --append console - terminal_output --append console -fi -set timeout_style=menu -set timeout=0 -set default=0 -menuentry 'Arch Linux ARM for Radxa Dragon Q6A' { -# insmod fat -# search --no-floppy --fs-uuid --set=root 1778-ABF5 - devicetree /qcs6490-radxa-dragon-q6a.dtb - echo 'Loading Kernel...' - linux /Image panic=30 loglevel=8 rw rootwait=10 root=/dev/sda2 rootfstype=ext4 -# echo 'Loading Initramfs...' -# initrd /initramfs-linux-mainline-aarch64.img - echo 'Booting...' -} -``` - -### Safely remove USB flash drive - - - -``` -sudo umount ~/mnt -``` - - - -Then eject the USB flash drive, install it on the motherboard, and start the system. - -## NVMe SSD Boot - -Edit the `/boot/grub/grub.cfg` file and change the `root` parameter to the device path of the NVMe SSD. - -:::tip default boot disk -The default boot disk is a MicroSD card, root=/dev/mmcblk2p2 -::: - -### View the NVMe SSD device number - -Insert the NVMe SSD into the motherboard, then use the `lsblk` command to view the NVMe SSD device number. - - - -``` -lsblk -``` - - - -Terminal output example: The NVMe SSD device number can be determined by safe plugging and unplugging. - -``` -NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT -nvme0n1 259:0 0 58G 0 disk -├─nvme0n1p1 259:1 0 112M 0 part -└─nvme0n1p2 259:2 0 57.8G 0 part /media/user/2543266-9541-5123-a4e1-e42501125542 -``` - -### Mounting the NVMe SSD BOOT partition - - - -``` -sudo mkdir ~/mnt -sudo mount /dev/nvme0n1p2 ~/mnt -``` - - - -### Modify the GRUB configuration file - - - -``` -sudo nano ~/mnt/grub/grub.cfg -``` - - - -Modify the GRUB configuration file: Change the default `root=/dev/mmcblk2p2` to `root=/dev/nvme0n1p2`. - -``` -insmod part_gpt -insmod part_msdos -insmod all_video -terminal_input console -terminal_output console -if serial --unit=0 --speed=115200; then - terminal_input --append console - terminal_output --append console -fi -set timeout_style=menu -set timeout=0 -set default=0 -menuentry 'Arch Linux ARM for Radxa Dragon Q6A' { -# insmod fat -# search --no-floppy --fs-uuid --set=root 1778-ABF5 - devicetree /qcs6490-radxa-dragon-q6a.dtb - echo 'Loading Kernel...' - linux /Image panic=30 loglevel=8 rw rootwait=10 root=/dev/nvme0n1p2 rootfstype=ext4 -# echo 'Loading Initramfs...' -# initrd /initramfs-linux-mainline-aarch64.img - echo 'Booting...' -} -``` - -### Safely eject the NVMe SSD - - - -``` -sudo umount ~/mnt -``` - - - -Then eject the NVMe SSD and install it on the motherboard to start the system. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/emmc_system/README.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/emmc_system/README.md new file mode 100644 index 000000000..15c99b899 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/emmc_system/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 4 +--- + +# Install System to eMMC + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/emmc_system/emmc_reader.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/emmc_system/emmc_reader.md new file mode 100644 index 000000000..8b6668263 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/emmc_system/emmc_reader.md @@ -0,0 +1,44 @@ +--- +sidebar_position: 4 +--- + +import BalenaEtcherUse from '../../../../../common/radxa-os/install-system/\_use_etcher_emmc.mdx'; + +# Installing System Using Card Reader + + + +## Booting the System + +After completing the system installation, install the eMMC module into the eMMC module interface of the Dragon Q6A, then power on the Dragon Q6A using a 12V Type-C power adapter to boot the system. + +
+ +
+ +① : Install the eMMC module + +② : Connect the monitor to the motherboard using an HDMI cable + +③ : Power the Dragon Q6A using a 12V Type-C power adapter + +When the system boots normally, the power indicator will light up green, and the status indicator will flash blue. + +## Logging into the System + +When you start the system for the first time, you need to log in using the default username and password. + +The default credentials for Radxa OS are as follows: + +| Item | Content | +| :------- | :------ | +| Username | `radxa` | +| Password | `radxa` | + +## Using the System + +After successfully booting the system, you can start using the Radxa OS on your Dragon Q6A. For basic usage of the Radxa OS, please refer to the [Using the System](../../use_system.md) tutorial. + +
+ +
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/emmc_system/no_emmc_reader.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/emmc_system/no_emmc_reader.md new file mode 100644 index 000000000..3e3012b2f --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/emmc_system/no_emmc_reader.md @@ -0,0 +1,44 @@ +--- +sidebar_position: 4 +--- + +import InstallSystem from '../../../../../common/radxa-os/install-system/\_use_dd_emmc.mdx'; + +# Booting from MicroSD Card and Installing System to eMMC + + + +## Booting the System + +After completing the system installation, remove the MicroSD card, ensure the eMMC module is properly installed in the eMMC module interface of the Dragon Q6A, then power on the Dragon Q6A using a 12V Type-C power adapter. + +
+ +
+ +① : Verify the eMMC module is installed + +② : Connect the monitor to the motherboard using an HDMI cable + +③ : Power the Dragon Q6A using a 12V Type-C power adapter + +When the system boots normally, the power indicator will light up green, and the status indicator will flash blue. + +## Logging into the System + +When you start the system for the first time, you need to log in using the default username and password. + +The default credentials for Radxa OS are as follows: + +| Item | Content | +| :------- | :------ | +| Username | `radxa` | +| Password | `radxa` | + +## Using the System + +After successfully booting the system, you can start using the Radxa OS on your Dragon Q6A. For basic usage of the Radxa OS, please refer to the [Using the System](../../use_system.md) tutorial. + +
+ +
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/nvme_system/README.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/nvme_system/README.md index 741c292a3..d59974a5c 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/nvme_system/README.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/nvme_system/README.md @@ -1,7 +1,7 @@ --- -sidebar_position: 3 +sidebar_position: 5 --- -# Install the system to NVMe SSD +# Install System to NVMe SSD diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/nvme_system/no_nvme_reader.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/nvme_system/no_nvme_reader.md index dda46c8f7..2bf38f5bc 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/nvme_system/no_nvme_reader.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/nvme_system/no_nvme_reader.md @@ -2,151 +2,43 @@ sidebar_position: 2 --- -# Without an M.2 M Key NVMe SSD enclosure +import InstallSystem from '../../../../../common/radxa-os/install-system/\_use_dd_nvme.mdx'; -This section mainly describes how to use the `dd` command to burn a system image to an M.2 M Key 2230 NVMe SSD without an M.2 M Key NVMe SSD enclosure. +# Booting from MicroSD Card and Installing System to NVMe SSD -:::warning -Installing the system will format the NVMe SSD. Please back up any important data in advance! -::: + -## Prerequisites +## Booting the System -You need to prepare the following hardware devices in advance: - -- Motherboard: Radxa Dragon Q6A -- System boot media: MicroSD card -- System target media: M.2 M Key 2230 NVMe SSD -- Power adapter: 12V Type-C power adapter (compatible with PD protocol) - -Note: We need to boot the motherboard normally using the MicroSD card, then use the `dd` command to install the system image onto the NVMe SSD. - -:::tip Recommended accessories - -- [Radxa PD 30W Power Adapter (Recommended)](https://radxa.com/products/accessories/power-pd-30w) -- Standard 12V Type-C power adapter, recommended current 2A or above - ::: - -## Hardware Connection - -Install the M.2 M Key 2230 NVMe SSD into the NVMe SSD interface on the motherboard. +After completing the system installation, remove the MicroSD card, ensure the NVMe SSD is properly installed in the NVMe SSD slot of the Dragon Q6A, then power on the Dragon Q6A using a 12V Type-C power adapter.
- +
-## Download system image - -You can access the [Resource Summary Download](../../../download) page on the motherboard to download the system image file. - -:::tip Download Recommendations -We provide the following methods for downloading system image files to the motherboard. You can choose the appropriate method based on your actual situation: - -- Download using the `wget` command - -You can copy the system image file link from the [Resource Summary Download](../../../download) page, and then use the `wget` command to download it on the motherboard. - -``` -sudo apt install wget -wget [url] -``` - -Parameter explanation: Replace `[url]` with the actual system image file download link. - -- PC download - -You can access the [Resource Summary Download](../../../download) page on a PC to download the system image file, then transfer the system image file to the motherboard via USB drive, FTP, SCP, etc. - -::: - -## Extract the system image - -:::tip Explanation -The downloaded system image file is a compressed package and must be decompressed before use. -::: - -Use the `unxz` command to decompress the system image file. - - +① : Verify the NVMe SSD is installed -``` -sudo apt install xz-utils -unxz [image_path] -``` +② : Connect the monitor to the motherboard using an HDMI cable - -Parameter explanation: Replace `[image_path]` with the actual system image file path. +③ : Power the Dragon Q6A using a 12V Type-C power adapter -## Install the system image +When the system boots normally, the power indicator will light up green, and the status indicator will flash blue. -Use the `dd` command to install the system image on the NVMe SSD. +## Logging into the System -### Write the system image +When you start the system for the first time, you need to log in using the default username and password. -:::danger -When using the `dd` command, make sure to select the correct device file, otherwise you will format the wrong device and cause data loss! -::: +The default credentials for Radxa OS are as follows: - +| Item | Content | +| :------- | :------ | +| Username | `radxa` | +| Password | `radxa` | -``` -sudo dd if=[image_path] of=/dev/*** bs=4M status=progress -``` +## Using the System - -Parameter description: -- `if`: Specifies the file to write to. Replace `[image_path]` with the path of the unzipped system image file. -- `of`: Specifies the device to write to. Replace `/dev/***` with the device corresponding to the system boot media (please modify according to the actual device). -- `bs`: Block size. Recommended parameter: 4M. - `status=progress`: Displays the write status. +After successfully booting the system, you can start using the Radxa OS on your Dragon Q6A. For basic usage of the Radxa OS, please refer to the [Using the System](../../use_system.md) tutorial. -:::tip Determine the system boot media device file - -The device file names vary depending on the boot media used for different systems. The following are common device file names for boot media: - -- eMMC module: `/dev/mmcblk*` -- UFS module: `/dev/sda*` -- NVMe SSD: `/dev/nvme*n*` - -The most effective method: You can use the `lsblk` command to compare the device list changes between when the system boot media is installed and when it is not installed, thereby determining the device file name corresponding to the system boot media. - -**Note: When installing or removing the system boot media (such as UFS modules, NVMe SSDs, etc.), you must power off the motherboard before performing the operation to avoid data or hardware damage caused by hot-swapping.** -::: - -### Verify the system image - -After writing the system image, you can use the `fdisk` command to view the partition information of the system boot media to determine whether the system image has been written successfully. - - - -``` -sudo fdisk -l /dev/*** -``` - - - -If the system writes successfully, the terminal will output information similar to the following: - -``` -Disk /dev/\*\*\*: 119.15 GiB, 127934660608 bytes, 31234048 sectors -Disk model: KLUDG4UHDC-B0E1 -Units: sectors of 1 \* 4096 = 4096 bytes -Sector size (logical/physical): 4096 bytes / 4096 bytes -I/O size (minimum/optimal): 524288 bytes / 524288 bytes -Disklabel type: gpt -Disk identifier: 33349998-C3CC-40F0-B818-DDDD8383A64D - -Device Start End Sectors Size Type -/dev/**_ 32768 65535 32768 128M Linux filesystem -/dev/_** 65536 679935 614400 2.3G EFI System -/dev/\*\*\* 679936 31234014 30554079 116.6G EFI System -``` - -## Modify grub settings - -:::tip - -Refer to the NVMe boot section in [Modify system boot disk boot options](../boot_option) - -::: - -## Power on and boot +
+ +
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/nvme_system/nvme_reader.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/nvme_system/nvme_reader.md index 7a4766b6f..1da8ef67b 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/nvme_system/nvme_reader.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/nvme_system/nvme_reader.md @@ -2,135 +2,43 @@ sidebar_position: 1 --- -# Using an M.2 M Key NVMe Solid State Drive Enclosure +import BalenaEtcherUse from '../../../../../common/radxa-os/install-system/\_use_etcher_nvme.mdx'; -This section mainly describes how to use an M.2 M Key NVMe solid state drive enclosure to burn a system image to an M.2 M Key 2230 NVMe SSD. +# Installing System Using NVMe SSD Enclosure -:::warning -Installing the system will format the NVMe SSD. Please back up any important data in advance! -::: + -## Prerequisites +## Booting the System -You need to prepare the following hardware devices in advance: - -- M.2 M Key NVMe solid state drive enclosure -- System boot media: M.2 M Key 2230 NVMe SSD - -## Download the system image - -You can access the [Resource Download](../../../download) page on your PC to download the system image file. - -## Unzip the system image - -The downloaded system image file is a compressed package and needs to be unzipped before use. - -## Installing the System Image - -Balena Etcher is an open-source image burning tool that is easy to use and powerful, supporting Windows, Mac, and Linux systems. - -### Download Balena Etcher - -Visit the Balena Etcher website (https://www.balena.io/etcher/) to download Balena Etcher. - -
- -
- -Please download the software installation package corresponding to your system platform and architecture. +After completing the system installation, install the NVMe SSD into the NVMe SSD slot of the Dragon Q6A, then power on the Dragon Q6A using a 12V Type-C power adapter to boot the system.
- +
-### Installing Balena Etcher +① : Install the NVMe SSD -Once the download is complete, you can install it according to your system platform and architecture. +② : Connect the monitor to the motherboard using an HDMI cable -:::tip +③ : Power the Dragon Q6A using a 12V Type-C power adapter -- Windows +When the system boots normally, the power indicator will light up green, and the status indicator will flash blue. -The downloaded file is an installation package in `*.exe` format. Double-click the program to run it. +## Logging into the System -- Linux +When you start the system for the first time, you need to log in using the default username and password. -We recommend downloading the compressed package in `*.zip` format. After unzipping, double-click the program to run it. +The default credentials for Radxa OS are as follows: -- MacOS +| Item | Content | +| :------- | :------ | +| Username | `radxa` | +| Password | `radxa` | -Download the corresponding `*.dmg` file based on your system architecture. After double-clicking to open it, drag the software to the Applications folder to install it. After installation, double-click the application icon to run it. +## Using the System -::: +After successfully booting the system, you can start using the Radxa OS on your Dragon Q6A. For basic usage of the Radxa OS, please refer to the [Using the System](../../use_system.md) tutorial.
- +
- -### Using Balena Etcher - -Use Balena Etcher to install the system image file onto a MicroSD card. - -#### Hardware Connection - -Install the M.2 M Key NVMe SSD into the M.2 M Key NVMe SSD enclosure, then connect the M.2 M Key NVMe SSD enclosure to the PC. - -#### Select System Image - -Click the `Flash from file` option and select the system image file you have previously downloaded and extracted. - -
- -
- -#### Select storage device - -Click the `Select target` option and select the storage device corresponding to the system image you want to install. - -:::danger -Please do not select the wrong storage device, otherwise Etcher will format the selected storage device, causing important data loss! - -You can plug and unplug storage devices to observe changes in the available storage devices, thereby further determining the storage device to be installed. -::: - -
- -
- -① : Select the storage device on which you want to install the system image. - -② : Click the `Select 1` option to confirm your device selection. - -
- -
- -#### Install the system image - -Click the `Flash` option and wait for the software to automatically install and verify the system image. - -
- -
- -
-Wait for the system to finish writing - -
- -
-Waiting for system verification to complete - -
- -After successfully writing the system image, close the Etcher software! - -## Modify grub settings - -:::tip - -Refer to the NVMe boot section in [Modify system boot disk boot options](../boot_option) - -::: - -## Power on and boot diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/sd_system.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/sd_system.md index fa391c8a6..5c364a272 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/sd_system.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/sd_system.md @@ -2,131 +2,43 @@ sidebar_position: 1 --- -# Installing the system to a MicroSD card +import BalenaEtcherUse from '../../../../common/radxa-os/install-system/\_use_etcher_sd.mdx'; -This section mainly introduces how to install the system to a MicroSD card. +# Install System to MicroSD Card -:::warning -The system installation will format the MicroSD card. Please back up any important data in advance! -::: + -## Prerequisites +## Booting the System -You need to prepare the following hardware devices in advance: - -- MicroSD card reader -- System boot media: MicroSD card - -## Download the system image - -You can visit the [Resource Download](../../download) page on your PC to download the system image file. - -## Unzip the System Image - -The downloaded system image file is a compressed archive and must be unzipped before use. - -## Install the System Image - -Balena Etcher is an open-source image burning tool that is easy to use and powerful, supporting Windows, Mac, and Linux systems. - -### Download Balena Etcher - -Visit the [Balena Etcher official website](https://www.balena.io/etcher/) to download Balena Etcher. - -
- -
- -Please download the appropriate software installation package based on your system platform and architecture. - -
- -
- -### Installing Balena Etcher - -Once the download is complete, you can install it according to your system platform and architecture. - -:::tip - -- Windows - -The downloaded file is an installation package in `*.exe` format. Double-click the program to run it. - -- Linux - -We recommend downloading the compressed package in `*.zip` format. After extracting it, double-click the program to run it. - -- MacOS - -Download the corresponding `*.dmg` file based on your system architecture. After double-clicking to open it, drag the software to the Applications folder to install it. After installation is complete, double-click the application icon to run it. - -::: +After completing the system installation, insert the MicroSD card into the MicroSD card slot of the Dragon Q6A, then power on the Dragon Q6A using the 12V Type-C power adapter to boot the system.
- +
-### Using Balena Etcher - -Use Balena Etcher to install the system image file onto a MicroSD card. +① : Insert the MicroSD card -#### Hardware Connection +② : Connect the monitor to the board using an HDMI cable -Insert the MicroSD card into the card reader, then connect the card reader to your PC. +③ : Power on the Dragon Q6A using the 12V Type-C power adapter -
- -
+When the system boots normally, the power indicator will light up green and the status LED will blink blue. -#### Selecting a system image +## System Login -Click the “Flash from file” option and select the system image file that you downloaded and unzipped in advance. - -
- -
+When you first start the system, you'll need to log in using the default username and password. -#### Selecting storage devices +The default credentials for Radxa OS are as follows: -Click the `Select target` option and select the storage device corresponding to the system image you want to install. +| Item | Value | +| :------- | :------ | +| Username | `radxa` | +| Password | `radxa` | -:::danger -Please do not select the wrong storage device, otherwise Etcher will format the selected storage device, resulting in the loss of important data! +## Using the System -You can plug and unplug storage devices to observe changes in the available storage devices, thereby further determining the storage device to be installed. -::: +After successfully booting the system, you can start using the Radxa system on your Dragon Q6A. For basic usage instructions, please refer to the [Using the System](./use_system.md) guide.
- +
- -① : Select the storage device on which you want to install the system image. - -② : Click the `Select 1` option to confirm your device selection. - -
- -
- -#### Install system image - -Click the `Flash` option and wait for the software to automatically install and verify the system image. - -
- -
- -
-Wait for the system to finish writing. - -
- -
-Waiting for system verification to complete - -
- -After successfully writing the system image, close the Etcher software! - -## Power on and start up diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/udisk_system.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/udisk_system.md index d37f64704..4ac4d7053 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/udisk_system.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/udisk_system.md @@ -1,139 +1,44 @@ --- -sidebar_position: 2 +sidebar_position: 1 --- -# Installing the system to a USB flash drive +import BalenaEtcherUse from '../../../../common/radxa-os/install-system/\_use_etcher_udisk.mdx'; -This section mainly introduces how to install the system to a USB flash drive. +# Install System to USB Drive -:::warning -The system installation will format the USB flash drive. Please back up any important data in advance! -::: + -## Prerequisites +## Booting the System -You need to prepare the following hardware devices in advance: - -- USB flash drive - -## Download the system image - -You can visit the [Resource Download](../../download) page on your PC to download the system image file. - -## Unzip the system image - -The downloaded system image file is a compressed package and needs to be unzipped before use. - -## Installing the System Image - -Balena Etcher is an open-source image burning tool that is easy to use and powerful, supporting Windows, Mac, and Linux systems. - -### Download Balena Etcher - -Visit the Balena Etcher website (https://www.balena.io/etcher/) to download Balena Etcher. - -
- -
- -Please download the appropriate software installation package based on your system platform and architecture. - -
- -
- -### Installing Balena Etcher - -Once the download is complete, you can install it according to your system platform and architecture. - -:::tip - -- Windows - -The downloaded file is an installation package in `*.exe` format. Double-click the program to run it. - -- Linux - -We recommend downloading the compressed file in `*.zip` format. After unzipping, double-click the program to run it. - -- MacOS - -Download the corresponding `*.dmg` file based on your system architecture. Double-click to open it, then drag the software to the Applications folder to install it. Once the installation is complete, double-click the application icon to run it. - -::: - -
- -
- -### Using Balena Etcher - -Use Balena Etcher to install the system image file onto a USB flash drive. - -#### Hardware Connection - -Insert the USB flash drive into the card reader, then connect the card reader to your PC. +After completing the system installation, insert the USB drive into the USB port of the Dragon Q6A, then power on the Dragon Q6A using the 12V Type-C power adapter to boot the system.
- +
-#### Select the system image +① : Connect the USB drive -Click the `Flash from file` option and select the system image file that you downloaded and unzipped in advance. +② : Connect the monitor to the board using an HDMI cable -
- -
+③ : Power on the Dragon Q6A using the 12V Type-C power adapter -#### Select storage device +When the system boots normally, the power indicator will light up green and the status LED will blink blue. -Click the `Select target` option and select the storage device corresponding to the system image you want to install. +## System Login -:::danger -Please do not select the wrong storage device, otherwise Etcher will format the selected storage device, resulting in the loss of important data! +When you first start the system, you'll need to log in using the default username and password. -You can plug and unplug storage devices to observe changes in the available storage devices, thereby further determining the storage device to be installed. -::: +The default credentials for Radxa OS are as follows: -
- -
+| Item | Value | +| :------- | :------ | +| Username | `radxa` | +| Password | `radxa` | -① : Select the storage device on which you want to install the system image. +## Using the System -② : Click the `Select 1` option to confirm your device selection. +After successfully booting the system, you can start using the Radxa system on your Dragon Q6A. For basic usage instructions, please refer to the [Using the System](./use_system.md) guide.
- +
- -#### Install the system image - -Click the `Flash` option and wait for the software to automatically install and verify the system image. - -
- -
- -
-Wait for the system to finish writing. - -
- -
-Waiting for system verification to complete - -
- -After successfully writing the system image, close the Etcher software! - -## Modify grub settings - -:::tip - -Refer to the USB flash drive startup section in [Modify system startup disk boot options] (./boot_option). - -::: - -## Power on and start up diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/ufs_system/README.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/ufs_system/README.md new file mode 100644 index 000000000..c6bc5e86c --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/ufs_system/README.md @@ -0,0 +1,7 @@ +--- +sidebar_position: 3 +--- + +# Install System to UFS + + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/ufs_system/no_ufs_reader.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/ufs_system/no_ufs_reader.md new file mode 100644 index 000000000..9309dfa29 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/ufs_system/no_ufs_reader.md @@ -0,0 +1,44 @@ +--- +sidebar_position: 4 +--- + +import InstallSystem from '../../../../../common/radxa-os/install-system/\_use_dd_ufs.mdx'; + +# Boot from MicroSD Card and Install System to UFS + + + +## Booting the System + +After completing the system installation, remove the MicroSD card, ensure the UFS module is properly installed in the UFS module interface of the Dragon Q6A, then power on the Dragon Q6A using the 12V Type-C power adapter. + +
+ +
+ +① : Ensure the UFS module is installed + +② : Connect the monitor to the board using an HDMI cable + +③ : Power on the Dragon Q6A using the 12V Type-C power adapter + +When the system boots normally, the power indicator will light up green and the status LED will blink blue. + +## System Login + +When you first start the system, you'll need to log in using the default username and password. + +The default credentials for Radxa OS are as follows: + +| Item | Value | +| :------- | :------ | +| Username | `radxa` | +| Password | `radxa` | + +## Using the System + +After successfully booting the system, you can start using the Radxa system on your Dragon Q6A. For basic usage instructions, please refer to the [Using the System](../../use_system.md) guide. + +
+ +
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/ufs_system/ufs_reader_system.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/ufs_system/ufs_reader_system.md new file mode 100644 index 000000000..590af2c13 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/install-system/ufs_system/ufs_reader_system.md @@ -0,0 +1,44 @@ +--- +sidebar_position: 1 +--- + +import BalenaEtcherUse from '../../../../../common/radxa-os/install-system/\_use_etcher_ufs.mdx'; + +# Install System Using a Card Reader + + + +## Booting the System + +After completing the system installation, install the UFS module into the UFS module interface of the Dragon Q6A, then power on the Dragon Q6A using the 12V Type-C power adapter to boot the system. + +
+ +
+ +① : Install the UFS module + +② : Connect the monitor to the board using an HDMI cable + +③ : Power on the Dragon Q6A using the 12V Type-C power adapter + +When the system boots normally, the power indicator will light up green and the status LED will blink blue. + +## System Login + +When you first start the system, you'll need to log in using the default username and password. + +The default credentials for Radxa OS are as follows: + +| Item | Value | +| :------- | :------ | +| Username | `radxa` | +| Password | `radxa` | + +## Using the System + +After successfully booting the system, you can start using the Radxa system on your Dragon Q6A. For basic usage instructions, please refer to the [Using the System](../../use_system.md) guide. + +
+ +
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/quickly_start.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/quickly_start.md index dc0a4e284..6549dda84 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/quickly_start.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/quickly_start.md @@ -1,84 +1,193 @@ --- -sidebar_position: 2 +sidebar_position: 1 --- # Quick Start -The purpose of this tutorial is to help you quickly get started with the Dragon Q6A product. +This guide will help you get started with the Radxa Dragon Q6A board. -## Product Details +## Product Overview
- Dragon Q6A Front Side - - Dragon Q6A Reverse Side - +
+| No. | View | No. | Side View | No. | Back View | +| :-: | :--------------: | :-: | :-------------: | :-: | :-------------: | +| ① | Dragon Q6A Front | ② | Dragon Q6A Side | ③ | Dragon Q6A Back | + ## Prerequisites -You need to prepare the following hardware devices in advance: +Before you begin, please prepare the following hardware: -- Motherboard: Radxa Dragon Q6A -- System boot media: MicroSD card -- Power adapter: 12V Type-C power adapter (compatible with PD protocol) -- USB serial data cable (optional): For serial debugging and system login -- HDMI cable and monitor (optional): For displaying the system interface and graphical user interface operations +- Board: Radxa Dragon Q6A +- Power Supply: 12V Type-C Power Adapter (PD compatible) +- Boot Media: MicroSD Card (for system installation and booting) +- Display: HDMI cable and monitor +- Input Devices: Keyboard and mouse (for GUI operation) +- Debug Tool (Optional): USB to UART cable (for serial console access) -:::tip Recommended accessories +:::tip Recommended Accessories - [Radxa PD 30W Power Adapter (Recommended)](https://radxa.com/products/accessories/power-pd-30w) -- Standard 12V Type-C power adapter, recommended current 2A or above - ::: +- Standard 12V Type-C power adapter, 2A or higher recommended + +::: -## Install the System +## System Installation -You can refer to the following tutorials to install the system based on your system boot media and hardware devices: +This section explains how to install the system on a MicroSD card. -- [Install the System to a MicroSD Card](./install-system/sd_system) -- [Install the System to a USB Flash Drive](./install-system/udisk_system) -- [Install the System to an NVMe SSD](./install-system/nvme_system) +:::warning Important Notice -:::tip System Startup Instructions -By default, the system startup disk is a MicroSD card, which can be booted directly without any additional operations. However, you cannot directly boot the system from a USB flash drive or NVMe SSD. +**Installing the system will completely format your MicroSD card, and all data will be permanently deleted!** + +Before proceeding, please confirm: + +- There is no important data on the MicroSD card, or you have backed up all important data +- You have selected the correct storage device to avoid formatting other disks -If you have installed the system on a USB flash drive or NVMe SSD, you need to refer to the [Modify System Startup Disk Boot Options](./install-system/boot_option) tutorial to modify the system startup disk boot options. ::: -## Starting the System +## Hardware Connection -After completing the system installation, insert the MicroSD card into the MicroSD card slot of the Dragon Q6A, then power the Dragon Q6A using a 12V Type-C power adapter to start the system. +Insert the MicroSD card into a card reader, then connect the card reader to your computer. -① : Insert the MicroSD card +
+ +
+ +### Download System Image + +Visit the [Resource Downloads](../download) page to download the **system image**. + +:::tip Software Usage + +The downloaded file is in `.img.xz` compressed format. You need to extract it to get the `.img` file before use. + +::: + +### Install System Image + +Use Balena Etcher software to write the system image to the MicroSD card. + +:::tip Balena Etcher + +For Balena Etcher installation and usage instructions, please refer to the [Etcher Guide](/common/radxa-os/install-system/balena-etcher). + +::: + +#### Select System Image + +Click the `Flash from file` button and select the extracted system image file. + +
+ +
+ +#### Select Storage Device -② : Power the Dragon Q6A using a 12V Type-C power adapter +Click the `Select target` button and choose your MicroSD card device. + +
+ +
+ +
+ +
+ +#### Start Flashing + +Click the `Flash!` button to begin writing the system image to the MicroSD card. + +
+ +
+ +
+ Waiting for system installation to complete + +
+ +
+ Waiting for system verification + +
+ +
+ After successfully installing the system image, close the Etcher software! + +
+ +## Booting the System + +After completing the system installation, insert the MicroSD card into the Dragon Q6A's MicroSD card slot, then power on the Dragon Q6A using the 12V Type-C power adapter to boot the system.
- +
-After the system starts up normally, the power indicator light turns green and the status indicator light flashes blue. +① : Insert the MicroSD card -## System Information +② : Connect the monitor to the board using an HDMI cable -User Account: ubuntu +③ : Power on the Dragon Q6A using the 12V Type-C power adapter -User Password: ubuntu +When the system boots normally, the power indicator will light up green and the status LED will blink blue. -## Logging into the System +## System Login -This section primarily introduces how to log in to the system using the Dragon Q6A with a USB serial port data cable. For instructions on logging in to the system via the serial port, please refer to the [Serial Port Debugging](../system-config/uart_debug) tutorial. +When you first start the system, you'll need to log in using the default credentials. -:::tip -The Dragon Q6A is used in conjunction with a display, and its overall operation is relatively intuitive and simple, so we will not go into further detail here! -::: +The default credentials for Radxa OS are as follows: + +| Item | Value | +| :------- | :------ | +| Username | `radxa` | +| Password | `radxa` | ## Using the System -### Screen Mode +After successfully booting the system, you can start using the Radxa system on your Dragon Q6A. For basic usage instructions, please refer to the [Using the System](./use_system.md) guide. + +
+ +
+ +:::tip Alternative Boot Methods +For users who want to boot the system using other methods (such as eMMC, UFS, or NVMe SSD), please refer to the following guides for installing the system on different boot media: -Screen mode refers to using the Dragon Q6A with a display, which makes overall operation more intuitive and simple! +- [Install System to MicroSD Card](./install-system/sd_system.md) +- [Install System to USB Drive](./install-system/udisk_system.md) +- [Install System to UFS](./install-system/ufs_system/) +- [Install System to eMMC](./install-system/emmc_system/) +- [Install System to NVMe SSD](./install-system/nvme_system/) -### Screenless Mode +Boot priority: USB > MicroSD > NVMe SSD > eMMC Module > UFS Module -Screenless mode refers to using the Dragon Q6A without a display, logging into the system via serial port or SSH for operation! +::: diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/use_system.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/use_system.md new file mode 100644 index 000000000..88f4e0ce9 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/getting-started/use_system.md @@ -0,0 +1,42 @@ +--- +sidebar_position: 3 +--- + +# Using the System + +This guide explains how to use the system, including system startup, system information, and recommendations for using Dragon Q6A with or without a display. + +## Starting the System + +Ensure that the system is properly installed on the boot media, then power on the Dragon Q6A using the power adapter. When the system boots up normally, the power indicator will light up green, and the status LED will blink blue. + +:::tip Recommendation + +For first-time users of Dragon Q6A, we recommend following the [Quick Start](./quickly_start.md) guide for a detailed and complete setup process. + +::: + +## System Information + +When you first start the system, you'll need to log in using the default username and password. + +The default credentials for Radxa OS are as follows: + +| Item | Value | +| :------- | :------ | +| Username | `radxa` | +| Password | `radxa` | + +## Using the System + +This section provides usage recommendations, particularly for users without a display, to help you get started with your Dragon Q6A more easily. + +### With a Display + +Connect the board to a display using an HDMI cable. If the system boots up normally, the display will show the system interface. You can then operate the Ubuntu system using the display, keyboard, and mouse. The process is straightforward. + +### Without a Display + +For users without a display, you can operate the system via [UART Login](../system-use/uart_debug.md) or [SSH Login](../system-use/ssh.md). + +These methods use command-line interaction and are suitable for users with some development experience. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/hardware-use/hardware_info.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/hardware-use/hardware_info.md index b8d074ae9..c08bfc0c9 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/hardware-use/hardware_info.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/hardware-use/hardware_info.md @@ -16,13 +16,13 @@ sidebar_position: 1
-| Serial Number | Description | Serial Number | Description | Serial Number | Description | -| :-----------: | :------------------ | :-----------: | :----------------------------------------------------------------------- | :-----------: | :------------------------------ | -| 1 | USB Type-C port | 9 | PoE port | 17 | 12 V power input port | -| 2 | LPDDR5 memory | 10 | Gigabit Ethernet interface (supports PoE) | 18 | Microphone input interface | -| 3 | Power button | 11 | SPI Flash | 19 | eMMC/UFS module combo interface | -| 4 | Antenna interface | 12 | 2x USB 2.0 Type-A interfaces | 20 | RTC interface | -| 5 | WiFi 6 / BT 5.4 | 13 | USB 2.0 Type-A port (upper layer)
USB 3.1 Type-A port (lower layer) | 21 | 2x MIPI CSI 2-Lane ports | -| 6 | M.2 M Key interface | 14 | EDL button | 22 | MIPI DSI 4-Lane interface | -| 7 | 40-pin GPIO header | 15 | Headphone jack | 23 | MicroSD card slot | -| 8 | Qualcomm QCS6490 | 16 | HDMI interface | 24 | MIPI CSI 4-Lane interface | +| No. | Description | No. | Description | No. | Description | +| :-: | :----------------- | :-: | :-------------------------------------------------------------- | :-: | :---------------------- | +| 1 | Qualcomm QCS6490 | 9 | Power input Header | 17 | 2x USB 2.0 Type-A ports | +| 2 | 40 Pin GPIO Header | 10 | MIPI CSI (4 Lane) | 18 | EDL button | +| 3 | M.2 M Key slot | 11 | MicroSD card slot | 19 | Headphone jack | +| 4 | WiFi 6 / BT 5.4 | 12 | MIPI DSI (4 Lane) | 20 | Standard HDMI | +| 5 | Antenna connector | 13 | PoE Header | 21 | eMMC & UFS module | +| 6 | Power button | 14 | Gigabit Ethernet | 22 | RTC battery connector | +| 7 | LPDDR5 memory | 15 | QSPI Nor Flash | 23 | 2x MIPI CSI (2 Lane) | +| 8 | USB 2.0 Type-C | 16 | USB 2.0 Type-A port (upper)
USB 3.1 OTG Type-A port (lower) | | | diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/system-use/ssh.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/system-use/ssh.md index 50db7c4b8..e1b24e39a 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/system-use/ssh.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/system-use/ssh.md @@ -2,221 +2,8 @@ sidebar_position: 2 --- -# SSH Remote Access +import SSH_REMOTE from '../../../common/radxa-os/system-config/\_ssh_remote.mdx'; -## Prerequisites +# SSH Login -For SSH remote access, both devices must be on the same Local Area Network (LAN), and the target device must have the SSH service enabled. - -:::tip -The system images we provide have the SSH service enabled by default, allowing for direct SSH remote control. If it is not installed or enabled, you can follow the instructions below to set it up! -::: - -## Install OpenSSH - -SSH remote control requires the installation of OpenSSH. Run the following command in the device's terminal to install it: - - - -``` -sudo apt update && sudo apt install openssh-server -y -``` - - - -### Start the SSH Service - -Run the following command in the device's terminal to start the SSH service: - - - -``` -sudo systemctl start ssh -``` - - - -### Enable SSH Service to Start on Boot - -Run the following command in the device's terminal to configure the SSH service to start automatically on boot: - - - -``` -sudo systemctl enable ssh -``` - - - -### Check the SSH Service Status - -Run the following command in the device's terminal to check the status of the SSH service: - - - -``` -sudo systemctl status ssh -``` - - - -The terminal will output information similar to the following: Prompt you whether the SSH service is autostarted and its current running status. - -``` -● ssh.service - OpenBSD Secure Shell server -Loaded: loaded (/lib/systemd/system/ssh.service; enabled; vendor preset: enabled) -Active: active (running) since Sat 2000-01-01 00:14:50 UTC; 25 years 5 months ago -Docs: man:sshd(8) -man:sshd_config(5) -Main PID: 518 (sshd) -CPU: 284ms -CGroup: /system.slice/ssh.service -└─518 sshd: /usr/sbin/sshd -D [listener] 0 of 10-100 startups -``` - -## Remote Control via SSH - -You can log in remotely via SSH using the terminal command line or Tabby software. - - - - - -Open a terminal on another device and enter the following command to log in remotely: - - - -``` -ssh @ - -# Example -ssh radxa@192.168.2.186 -``` - - - -In this case, `` and `` are the actual username and IP address of the target device, respectively. - -During the connection process, you will need to enter “yes” to confirm the connection. - -
- -
- - - - -Tabby is a powerful cross-platform serial port debugging tool that supports multiple protocols such as serial ports and SSH. We recommend using Tabby software for SSH remote login. - -#### Tabby Download - -Visit the Tabby official website (https://tabby.sh/) to download and install the Tabby software. - -#### Tabby Installation - -- Windows - -- Linux - -Select the `.exe` file for installation based on your system architecture. - -- MacOS - -Select the `.dmg` file for installation based on your system architecture. - -#### Tabby Usage - -Double-click the Tabby software icon to open the Tabby software. - -
- -
- -#### SSH Configuration - -① --> `Settings` : Click the Settings option. - -② --> `Profiles & connections` : Click Configure Connection Options - -③ --> `New profile` : Click to add a new configuration option. - -
- -
- -#### Select SSH Template - -Select a basic configuration as a template: Select the `SSH connection` template, and we can modify parameters such as device name, IP address, and port in the subsequent configuration interface. - -
- -
- -After selecting the `SSH connection` template, modify the following parameters: - -① --> `Name` : Set connection name - -② --> `Host` : Set the IP address according to the actual IP address of the target device. - -③ --> `User` : Set the username. The default factory username is `radxa`. - -④ --> `Save` : Save configuration - -The default port number is `22`, so no modification is necessary. - -
- -
- -#### Run SSH connection - -Click the Run button to connect remotely to the SSH device. - -
- -
- -Click the Run button to connect remotely to the SSH device. - -
- -
- -① --> password : Enter the password for the target device. - -② --> OK : Confirm connection - -We recommend checking the “Remember” option so that you don't have to enter your password the next time you connect. - -
- -
- -After the connection is successful, the remote interface will appear. - -
- -
- - - - -After successfully logging in remotely via SSH, you can run commands to control the system via SSH. + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/system-use/uart_debug.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/system-use/uart_debug.md index 99450b10a..3c953f226 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/system-use/uart_debug.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/system-use/uart_debug.md @@ -2,41 +2,36 @@ sidebar_position: 1 --- -# Serial Port Debugging +import UART_DEBUG from '../../../common/radxa-os/system-config/\_uart_debug.mdx'; -Serial port debugging is a core method of interacting with the development board through a serial communication interface (UART) in embedded development. Serial port tools can be used to view system output information and perform debugging. +# Serial Port Login -## Hardware Preparation - -- Development board: Radxa Dragon Q6A -- System boot media: MicroSD card -- Power adapter: 12V Type-C power adapter (compatible with PD protocol) -- USB serial port data cable: Used for serial port debugging and system login +Serial port login is a fundamental method for interacting with the motherboard through a UART (Universal Asynchronous Receiver/Transmitter) interface in embedded development. It allows you to view system logs and perform command-line interactions. ## Hardware Connection :::danger -When using a USB serial cable and Dragon Q6A for serial debugging, make sure the pins are connected correctly. Incorrect pin connections may damage the motherboard hardware. +When using a USB-to-serial cable with the Dragon Q6A for serial port login, ensure the pins are connected correctly. Incorrect connections may damage the motherboard hardware. -It is not recommended to connect the VCC interface (red wire) of the USB serial cable to avoid damage to the motherboard due to incorrect connection. +It is not recommended to connect the VCC (red wire) of the USB-to-serial cable to prevent potential damage from incorrect connections. ::: -Connect the USB serial data cable to the Dragon Q6A's UART0 interface, and connect the other end to the PC's USB port. +Connect the USB-to-serial cable to the UART0 interface of the Dragon Q6A, and connect the other end to a USB port on your PC.
- +
-| Dragon Q6A Pin Function | Connection Method | -| ------------------------------ | --------------------------------------------------------------------------------------- | -| Dragon Q6A: GND (Pin 6) | The Dragon Q6A's GND pin connects to the GND pin of the USB serial data cable | -| Dragon Q6A: UART0_TXD (Pin 8) | The Dragon Q6A's UART0_TXD pin connects to the RXD pin of the USB serial data cable | -| Dragon Q6A: UART0_RXD (Pin 10) | The Dragon Q6A's UART0_RXD pin is connected to the TXD pin of the USB serial data cable | +| Dragon Q6A Pin Function | Connection Method | +| ------------------------------ | --------------------------------------------- | +| Dragon Q6A: GND (Pin 6) | Connect to GND pin of the USB-to-serial cable | +| Dragon Q6A: UART0_TXD (Pin 8) | Connect to RXD pin of the USB-to-serial cable | +| Dragon Q6A: UART0_RXD (Pin 10) | Connect to TXD pin of the USB-to-serial cable | -Serial Port Login +## Serial Port Login :::info -Serial Port Communication Parameters +Serial Communication Parameters - Baud Rate: 115200 - Data Bits: 8 @@ -45,79 +40,4 @@ Serial Port Communication Parameters - Flow Control: None ::: -### Using Tabby - -We recommend using Tabby software for serial port login. Tabby is a powerful and user-friendly serial port debugging software that supports multiple protocols such as serial ports and SSH, and is compatible with mainstream operating systems such as Windows, macOS, and Linux. - -#### Tabby Installation - -Download and install the Tabby software from the [Tabby official website](https://tabby.sh/). - -:::tip - -- Windows - -Select the `.exe` file based on your system architecture for installation. - -- Linux - -Select the `.deb` file based on your system architecture for installation. - -- MacOS - -Select the `.dmg` file based on your system architecture for installation. -::: - -#### Using Tabby (serial port) - -Double-click the Tabby software icon to open the Tabby software. - -
- -
- -- Set up serial port connection - -① --> `Settings` : Click the Settings option. - -② --> `Profiles & connections` : Click Configure Connection Options - -③ --> `New profile` : Click to add a new configuration option. - -
- -
- -- Select a basic configuration as a template - -Select any `Serial` template, and we can modify parameters such as device name, serial port device number, and baud rate in the subsequent configuration interface. - -
- -
- -After selecting the `Serial` template, modify the following parameters: - -① --> `Name` : Set the connection name. It is recommended to enter the product name. - -② --> `Device` : Set the serial port device number. If only one serial port device is connected, it is generally `/dev/ttyUSB0`. - -③ --> `Baud rate` : Set the baud rate. Enter `115200`. - -④ --> `Save`: Save the configuration - -
- -
- -Click the Run button to connect the serial port device: - -
- -
- -After the connection is successful, press Enter to display the login information, then login using the user account and password for the corresponding system (the password will not be displayed when entered on the terminal; press Enter after entering the password to login). - -
- -
+ diff --git a/static/img/common/radxa-os/install-system/emmc-reader.webp b/static/img/common/radxa-os/install-system/emmc-reader.webp new file mode 100644 index 000000000..f54b616ad Binary files /dev/null and b/static/img/common/radxa-os/install-system/emmc-reader.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-completed-emmc.webp b/static/img/common/radxa-os/install-system/etcher-completed-emmc.webp new file mode 100644 index 000000000..9436403e2 Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-completed-emmc.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-completed-nvme.webp b/static/img/common/radxa-os/install-system/etcher-completed-nvme.webp new file mode 100644 index 000000000..9436403e2 Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-completed-nvme.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-completed-udisk.webp b/static/img/common/radxa-os/install-system/etcher-completed-udisk.webp new file mode 100644 index 000000000..9436403e2 Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-completed-udisk.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-completed-ufs.webp b/static/img/common/radxa-os/install-system/etcher-completed-ufs.webp new file mode 100644 index 000000000..9436403e2 Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-completed-ufs.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-flash-emmc.webp b/static/img/common/radxa-os/install-system/etcher-flash-emmc.webp new file mode 100644 index 000000000..be01b63bc Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-flash-emmc.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-flash-nvme.webp b/static/img/common/radxa-os/install-system/etcher-flash-nvme.webp new file mode 100644 index 000000000..073fbec49 Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-flash-nvme.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-flash-udisk.webp b/static/img/common/radxa-os/install-system/etcher-flash-udisk.webp new file mode 100644 index 000000000..742a165af Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-flash-udisk.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-flash-ufs.webp b/static/img/common/radxa-os/install-system/etcher-flash-ufs.webp new file mode 100644 index 000000000..5fbc357bb Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-flash-ufs.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-flashing-emmc.webp b/static/img/common/radxa-os/install-system/etcher-flashing-emmc.webp new file mode 100644 index 000000000..04250f740 Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-flashing-emmc.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-flashing-nvme.webp b/static/img/common/radxa-os/install-system/etcher-flashing-nvme.webp new file mode 100644 index 000000000..0ccb72119 Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-flashing-nvme.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-flashing-udisk.webp b/static/img/common/radxa-os/install-system/etcher-flashing-udisk.webp new file mode 100644 index 000000000..8fd0a69b9 Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-flashing-udisk.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-flashing-ufs.webp b/static/img/common/radxa-os/install-system/etcher-flashing-ufs.webp new file mode 100644 index 000000000..3920fe334 Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-flashing-ufs.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-select-emmc-01.webp b/static/img/common/radxa-os/install-system/etcher-select-emmc-01.webp new file mode 100644 index 000000000..9b79df0b6 Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-select-emmc-01.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-select-emmc-02.webp b/static/img/common/radxa-os/install-system/etcher-select-emmc-02.webp new file mode 100644 index 000000000..2f6b4f9e1 Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-select-emmc-02.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-select-image-emmc.webp b/static/img/common/radxa-os/install-system/etcher-select-image-emmc.webp new file mode 100644 index 000000000..37f4b085d Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-select-image-emmc.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-select-image-nvme.webp b/static/img/common/radxa-os/install-system/etcher-select-image-nvme.webp new file mode 100644 index 000000000..37f4b085d Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-select-image-nvme.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-select-image-udisk.webp b/static/img/common/radxa-os/install-system/etcher-select-image-udisk.webp new file mode 100644 index 000000000..37f4b085d Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-select-image-udisk.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-select-image-ufs.webp b/static/img/common/radxa-os/install-system/etcher-select-image-ufs.webp new file mode 100644 index 000000000..37f4b085d Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-select-image-ufs.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-select-nvme-01.webp b/static/img/common/radxa-os/install-system/etcher-select-nvme-01.webp new file mode 100644 index 000000000..9b79df0b6 Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-select-nvme-01.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-select-nvme-02.webp b/static/img/common/radxa-os/install-system/etcher-select-nvme-02.webp new file mode 100644 index 000000000..12fb9b0b7 Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-select-nvme-02.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-select-udisk-01.webp b/static/img/common/radxa-os/install-system/etcher-select-udisk-01.webp new file mode 100644 index 000000000..9b79df0b6 Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-select-udisk-01.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-select-udisk-02.webp b/static/img/common/radxa-os/install-system/etcher-select-udisk-02.webp new file mode 100644 index 000000000..9c96dfda3 Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-select-udisk-02.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-select-ufs-01.webp b/static/img/common/radxa-os/install-system/etcher-select-ufs-01.webp new file mode 100644 index 000000000..9b79df0b6 Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-select-ufs-01.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-select-ufs-02.webp b/static/img/common/radxa-os/install-system/etcher-select-ufs-02.webp new file mode 100644 index 000000000..73dde52c3 Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-select-ufs-02.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-valid-emmc.webp b/static/img/common/radxa-os/install-system/etcher-valid-emmc.webp new file mode 100644 index 000000000..9b1060367 Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-valid-emmc.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-valid-nvme.webp b/static/img/common/radxa-os/install-system/etcher-valid-nvme.webp new file mode 100644 index 000000000..b2d5ee1b9 Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-valid-nvme.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-valid-udisk.webp b/static/img/common/radxa-os/install-system/etcher-valid-udisk.webp new file mode 100644 index 000000000..08fcd0109 Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-valid-udisk.webp differ diff --git a/static/img/common/radxa-os/install-system/etcher-valid-ufs.webp b/static/img/common/radxa-os/install-system/etcher-valid-ufs.webp new file mode 100644 index 000000000..5bc4c5217 Binary files /dev/null and b/static/img/common/radxa-os/install-system/etcher-valid-ufs.webp differ diff --git a/static/img/common/radxa-os/install-system/nvme-box.webp b/static/img/common/radxa-os/install-system/nvme-box.webp index 5e12847c8..b5086b117 100644 Binary files a/static/img/common/radxa-os/install-system/nvme-box.webp and b/static/img/common/radxa-os/install-system/nvme-box.webp differ diff --git a/static/img/common/radxa-os/install-system/radxa-dragon-q6a-nvme-ssd.webp b/static/img/common/radxa-os/install-system/radxa-dragon-q6a-nvme-ssd.webp new file mode 100644 index 000000000..07816bdff Binary files /dev/null and b/static/img/common/radxa-os/install-system/radxa-dragon-q6a-nvme-ssd.webp differ diff --git a/static/img/common/radxa-os/install-system/u-disk.webp b/static/img/common/radxa-os/install-system/u-disk.webp new file mode 100644 index 000000000..370e34d0d Binary files /dev/null and b/static/img/common/radxa-os/install-system/u-disk.webp differ diff --git a/static/img/dragon/q6a/dragon-q6a-boot-system-emmc.webp b/static/img/dragon/q6a/dragon-q6a-boot-system-emmc.webp new file mode 100644 index 000000000..5c579ad8f Binary files /dev/null and b/static/img/dragon/q6a/dragon-q6a-boot-system-emmc.webp differ diff --git a/static/img/dragon/q6a/dragon-q6a-boot-system-nvme.webp b/static/img/dragon/q6a/dragon-q6a-boot-system-nvme.webp new file mode 100644 index 000000000..07816bdff Binary files /dev/null and b/static/img/dragon/q6a/dragon-q6a-boot-system-nvme.webp differ diff --git a/static/img/dragon/q6a/dragon-q6a-boot-system-udisk.webp b/static/img/dragon/q6a/dragon-q6a-boot-system-udisk.webp new file mode 100644 index 000000000..7d1e02168 Binary files /dev/null and b/static/img/dragon/q6a/dragon-q6a-boot-system-udisk.webp differ diff --git a/static/img/dragon/q6a/dragon-q6a-boot-system-ufs.webp b/static/img/dragon/q6a/dragon-q6a-boot-system-ufs.webp new file mode 100644 index 000000000..18ba371ef Binary files /dev/null and b/static/img/dragon/q6a/dragon-q6a-boot-system-ufs.webp differ diff --git a/static/img/dragon/q6a/dragon-q6a-boot-system.webp b/static/img/dragon/q6a/dragon-q6a-boot-system.webp new file mode 100644 index 000000000..57030aa5c Binary files /dev/null and b/static/img/dragon/q6a/dragon-q6a-boot-system.webp differ diff --git a/static/img/dragon/q6a/dragon-q6a-login.webp b/static/img/dragon/q6a/dragon-q6a-login.webp new file mode 100644 index 000000000..2e12a40f4 Binary files /dev/null and b/static/img/dragon/q6a/dragon-q6a-login.webp differ diff --git a/static/img/dragon/q6a/dragon-q6a-view.webp b/static/img/dragon/q6a/dragon-q6a-view.webp new file mode 100644 index 000000000..35483bea5 Binary files /dev/null and b/static/img/dragon/q6a/dragon-q6a-view.webp differ diff --git a/static/img/dragon/q6a/q6a_boot_system.webp b/static/img/dragon/q6a/q6a_boot_system.webp deleted file mode 100644 index c6dedaccb..000000000 Binary files a/static/img/dragon/q6a/q6a_boot_system.webp and /dev/null differ diff --git a/static/img/dragon/q6a/q6a_bottom.webp b/static/img/dragon/q6a/q6a_bottom.webp deleted file mode 100644 index 0d3a04052..000000000 Binary files a/static/img/dragon/q6a/q6a_bottom.webp and /dev/null differ diff --git a/static/img/dragon/q6a/q6a_interface.webp b/static/img/dragon/q6a/q6a_interface.webp index 299360c24..71bfca1fa 100644 Binary files a/static/img/dragon/q6a/q6a_interface.webp and b/static/img/dragon/q6a/q6a_interface.webp differ diff --git a/static/img/dragon/q6a/q6a_top.webp b/static/img/dragon/q6a/q6a_top.webp deleted file mode 100644 index 800db28ff..000000000 Binary files a/static/img/dragon/q6a/q6a_top.webp and /dev/null differ