Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 1 addition & 1 deletion .github/copilot-instructions.md
Original file line number Diff line number Diff line change
Expand Up @@ -167,4 +167,4 @@
- 要求自检清单:在回复末尾添加“自检清单”并列出上面『质量检查』项的逐项确认。

> 例子 (英文提示词)
> "Using `docs/cubie/a7z/README.md` as a reference, produce an English `README.md` for a new board `XYZ`: include product overview, specs (table), quick start, install system (MicroSD/eMMC/UFS/NVMe), tips/ warnings. Add frontmatter: `sidebar_position: 1`, `slug: /xyz`, `description`. Ensure English files contain no Chinese. Return the full markdown file and a self-check list confirming frontmatter + local image paths + internal links are valid."
> "Using `docs/cubie/a7z/README.md` as a reference, produce an English `README.md` for a new board `XYZ`: include product overview, specs (table), quick start, install system (microSD/eMMC/UFS/NVMe), tips/ warnings. Add frontmatter: `sidebar_position: 1`, `slug: /xyz`, `description`. Ensure English files contain no Chinese. Return the full markdown file and a self-check list confirming frontmatter + local image paths + internal links are valid."
2 changes: 1 addition & 1 deletion .github/terminology.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
| system image | 系统镜像(或 system image) | system image | 镜像文件的正式称呼,中文可并列原文。 |
| flash / 刷机 | 刷机 / 写入镜像 | flash / write image | 建议首选译法为“写入镜像”;用词受上下文影响时可在术语表中注明替代用法。 |
| bootloader | 引导加载程序 | bootloader | 统一译法为“引导加载程序”。 |
| MicroSD / SD card | MicroSD 卡 | MicroSD / SD card | 存储卡命名;写作 `MicroSD 卡` 时保留大小写。 |
| microSD / SD card | microSD 卡 | microSD / SD card | 存储卡命名;写作 `microSD 卡` 时保留大小写。 |
| GPIO | GPIO | GPIO | 通用 I/O,首现可扩展为“通用输入输出(GPIO)”。 |
| PCIe | PCIe | PCIe | e 必须是小写 | |

Expand Down
1 change: 1 addition & 0 deletions contents
Submodule contents added at 5d5878
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ sidebar_position: 1
- 显示设备:HDMI 数据线和显示器
- 输入设备:USB 键盘和鼠标

说明:若树莓派 CM5 无板载 eMMC,需要额外准备 MicroSD 卡用于系统安装。
说明:若树莓派 CM5 无板载 eMMC,需要额外准备 microSD 卡用于系统安装。

:::tip 推荐配件

Expand All @@ -40,7 +40,7 @@ sidebar_position: 1
请根据树莓派 CM5 是否有板载 eMMC,选择不同的安装方式:

- 若树莓派 CM5 有板载 eMMC,参考 [安装系统到 eMMC](./install-system/emmc-system) 教程
- 若树莓派 CM5 无板载 eMMC,需要安装系统到 MicroSD 卡,参考 [安装系统到 MicroSD 卡](./install-system/sd-system) 教程
- 若树莓派 CM5 无板载 eMMC,需要安装系统到 microSD 卡,参考 [安装系统到 microSD 卡](./install-system/sd-system) 教程

## 启动系统

Expand All @@ -54,7 +54,7 @@ sidebar_position: 1

<TabItem value="树莓派 CM5 无板载 eMMC">

完成系统安装后,将 MicroSD 卡安装到瑞莎 Taco 的 microSD 卡槽中,然后使用 12V DC 电源适配器给瑞莎 Taco 供电,系统将从 MicroSD 卡启动。
完成系统安装后,将 microSD 卡安装到瑞莎 Taco 的 microSD 卡槽中,然后使用 12V DC 电源适配器给瑞莎 Taco 供电,系统将从 microSD 卡启动。

</TabItem>

Expand Down
6 changes: 3 additions & 3 deletions docs/cubie/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,9 @@ Cubie 系列是瑞莎基于 Allwinner 芯片推出的一系列单板计算机。

| 型号 | SoC / CPU | NPU 性能 | 内存配置 | 系统/板载存储 | 存储扩展与总线 | 网络与无线 | 显示与摄像头 | 典型接口 |
| --------- | ------------------------------------------------- | ----------------- | ------------------------------------------ | ------------------------------------ | ------------------------------- | ------------------------------------------------------- | -------------------------------------------- | ------------------------------------- |
| Cubie A5E | 全志 A527 / T527,8× Cortex-A55,最高 2.0GHz | T527 版本:2 TOPS | LPDDR4/4x:1GB / 2GB / 4GB | SPI Flash,板载 eMMC(可选 0~32GB) | MicroSD,M.2 M Key NVMe(2230) | 双千兆以太网(1 路 PoE,需 PoE HAT),Wi‑Fi 6,蓝牙 5.4 | HDMI 4K@60,1× MIPI DSI,1× MIPI CSI | 40Pin GPIO,USB 3.0 Type‑A,USB‑C OTG |
| Cubie A7A | 全志 A733,2× A76 + 6× A55,最高 2.0GHz | 3 TOPS | LPDDR5:2GB / 4GB / 6GB / 8GB / 12GB / 16GB | 8MB SPI NOR Flash | MicroSD,eMMC 模块,UFS 模块 | 千兆以太网(PoE,需 PoE HAT),Wi‑Fi 6,蓝牙 5.4 | HDMI 4K@60,1× MIPI DSI,1×/2× MIPI CSI | 40Pin GPIO,PCIe 3.0 FPC,丰富 USB |
| Cubie A7Z | 全志 A733,2× A76 + 6× A55,板卡 65×30mm 超小尺寸 | 3 TOPS@INT8 | LPDDR4/4x:1GB / 2GB / 4GB / 8GB / 16GB | 可选板载 UFS(最高 1TB) | MicroSD,PCIe 3.0 FPC(1‑lane) | 板载 Wi‑Fi 6,蓝牙 5.4 | Micro HDMI 4K@60,USB‑C 3.0 DP Alt,MIPI CSI | 40Pin GPIO,双 USB‑C |
| Cubie A5E | 全志 A527 / T527,8× Cortex-A55,最高 2.0GHz | T527 版本:2 TOPS | LPDDR4/4x:1GB / 2GB / 4GB | SPI Flash,板载 eMMC(可选 0~32GB) | microSD,M.2 M Key NVMe(2230) | 双千兆以太网(1 路 PoE,需 PoE HAT),Wi‑Fi 6,蓝牙 5.4 | HDMI 4K@60,1× MIPI DSI,1× MIPI CSI | 40Pin GPIO,USB 3.0 Type‑A,USB‑C OTG |
| Cubie A7A | 全志 A733,2× A76 + 6× A55,最高 2.0GHz | 3 TOPS | LPDDR5:2GB / 4GB / 6GB / 8GB / 12GB / 16GB | 8MB SPI NOR Flash | microSD,eMMC 模块,UFS 模块 | 千兆以太网(PoE,需 PoE HAT),Wi‑Fi 6,蓝牙 5.4 | HDMI 4K@60,1× MIPI DSI,1×/2× MIPI CSI | 40Pin GPIO,PCIe 3.0 FPC,丰富 USB |
| Cubie A7Z | 全志 A733,2× A76 + 6× A55,板卡 65×30mm 超小尺寸 | 3 TOPS@INT8 | LPDDR4/4x:1GB / 2GB / 4GB / 8GB / 16GB | 可选板载 UFS(最高 1TB) | microSD,PCIe 3.0 FPC(1‑lane) | 板载 Wi‑Fi 6,蓝牙 5.4 | Micro HDMI 4K@60,USB‑C 3.0 DP Alt,MIPI CSI | 40Pin GPIO,双 USB‑C |

## 型号特点与选型建议

Expand Down
6 changes: 3 additions & 3 deletions docs/cubie/a5e/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ Cubie A5E 在紧凑形态中实现了性能与能效的平衡,适合嵌入式
| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 处理器 | 系统级芯片 (SoC): 全志 A527 <br/> 中央处理器 (CPU): 8 核 Cortex-A55 <br/> 图形处理器 (GPU): Arm Mali-G57; 支持 OpenGL® ES 1.1 / 2.0 / 3.1 / 3.2、Vulkan® 1.1、OpenCL™ 1.1 / 1.2 / 2.0 <br/> 神经网络加速器 (NPU): 无 |
| 内存 | LPDDR4 / LPDDR4x,可选:1GB / 2GB / 4GB |
| 存储 | 启动存储: 板载 SPI Flash <br/> 系统存储: 支持 MicroSD 卡 / 板载 eMMC(可选 0GB / 8GB / 16GB / 32GB) / 支持 M.2 M Key NVMe SSD <br/> **启动优先级**:MicroSD 卡 > NVMe SSD > 板载 eMMC |
| 存储 | 启动存储: 板载 SPI Flash <br/> 系统存储: 支持 microSD 卡 / 板载 eMMC(可选 0GB / 8GB / 16GB / 32GB) / 支持 M.2 M Key NVMe SSD <br/> **启动优先级**:microSD 卡 > NVMe SSD > 板载 eMMC |
| 网络 | 有线连接: 2 个千兆以太网口(支持 PoE,需外接 PoE HAT) <br/> 无线连接: Wi-Fi 6、蓝牙 5.4,预留天线座 |
| 视频输出 | HDMI: 1 个 HDMI 接口,最高支持 4K@60fps <br/> MIPI DSI: 1 个 4 通道 MIPI DSI |
| 摄像头 | 1 个 4 通道 MIPI CSI 或 2 个 2 通道 MIPI CSI |
Expand All @@ -56,7 +56,7 @@ Cubie A5E 在紧凑形态中实现了性能与能效的平衡,适合嵌入式
| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 处理器 | 系统级芯片 (SoC): 全志 T527 <br/> 中央处理器 (CPU): 8 核 Cortex-A55 <br/> 图形处理器 (GPU): Arm Mali-G57; 支持 OpenGL® ES 1.1 / 2.0 / 3.1 / 3.2、Vulkan® 1.1、OpenCL™ 1.1 / 1.2 / 2.0 <br/> 神经网络加速器 (NPU): 2TOPS@INT8 |
| 内存 | LPDDR4 / LPDDR4x,可选:1GB / 2GB / 4GB |
| 存储 | 启动存储: 板载 SPI Flash <br/> 系统存储: 支持 MicroSD 卡 / 板载 eMMC(可选 0GB / 8GB / 16GB / 32GB) / 支持 M.2 M Key NVMe SSD <br/> **启动优先级**:MicroSD 卡 > NVMe SSD > 板载 eMMC |
| 存储 | 启动存储: 板载 SPI Flash <br/> 系统存储: 支持 microSD 卡 / 板载 eMMC(可选 0GB / 8GB / 16GB / 32GB) / 支持 M.2 M Key NVMe SSD <br/> **启动优先级**:microSD 卡 > NVMe SSD > 板载 eMMC |
| 网络 | 有线连接: 2 个千兆以太网口(支持 PoE,需外接 PoE HAT) <br/> 无线连接: Wi-Fi 6、蓝牙 5.4,预留天线座 |
| 视频输出 | HDMI: 1 个 HDMI 接口,最高支持 4K@60fps <br/> MIPI DSI: 1 个 4 通道 MIPI DSI |
| 摄像头 | 1 个 4 通道 MIPI CSI 或 2 个 2 通道 MIPI CSI |
Expand All @@ -80,7 +80,7 @@ Cubie A5E 在紧凑形态中实现了性能与能效的平衡,适合嵌入式
| ① | Wi-Fi / 蓝牙模块 | ⑧ | PoE 排针 | ⑭ | LPDDR4 / LPDDR4x 内存 |
| ② | 天线座 | ⑨ | 千兆以太网(支持 PoE) | ⑮ | 全志 A527 / T527 |
| ③ | USB 3.0 Type-A HOST | ⑩ | MIPI DSI | ⑯ | 板载 eMMC(预留) |
| ④ | HDMI | ⑪ | MicroSD 卡槽 | ⑰ | 40 Pin GPIO 排针 |
| ④ | HDMI | ⑪ | microSD 卡槽 | ⑰ | 40 Pin GPIO 排针 |
| ⑤ | SPI Flash | ⑫ | MIPI CSI | ⑱ | USB Type-C (5V 供电 & OTG) |
| ⑥ | UBOOT 按键 | ⑬ | M.2 M Key 2230 插槽 | ⑲ | 千兆以太网(不支持 PoE) |
| ⑦ | 状态指示灯 | | | | |
Expand Down
8 changes: 4 additions & 4 deletions docs/cubie/a5e/download.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,13 +18,13 @@ sidebar_position: 150
## 系统镜像

:::tip 新手入门推荐
我们强烈建议新手用户下载 GPT 格式的 Radxa OS 官方切换分支,并使用 [Balena Etcher](./getting-started/quickly-start#安装系统镜像) 工具将其安装到 MicroSD 卡中。这是最简单、最快捷的上手方式。
我们强烈建议新手用户下载 GPT 格式的 Radxa OS 官方切换分支,并使用 [Balena Etcher](./getting-started/quickly-start#安装系统镜像) 工具将其安装到 microSD 卡中。这是最简单、最快捷的上手方式。

**镜像类型说明**

- GPT 系统镜像(推荐新手):

- 适用于 MicroSD 卡或 NVMe SSD
- 适用于 microSD 卡或 NVMe SSD
- 使用 Balena Etcher 图形化工具,操作简单
- 支持 `dd` 命令行烧录
- 瑞莎推荐的镜像类型,兼容性最佳
Expand Down Expand Up @@ -63,7 +63,7 @@ sidebar_position: 150
- 适用于 GPT 系统镜像
- 界面友好,操作简单
- 自动校验镜像完整性
- 最适合将系统安装到 MicroSD 卡或 NVMe SSD
- 最适合将系统安装到 microSD 卡或 NVMe SSD

- **[PhoenixSuit (Windows)](https://dl.radxa.com/tools/windows/PhoenixSuit_V2.0.4.zip)** / **[LiveSuit (Linux)](https://dl.radxa.com/tools/linux/LiveSuit_Linux_V3.0.8.zip)**

Expand All @@ -73,7 +73,7 @@ sidebar_position: 150
- 需要一定技术基础

- **[PhoenixCard](https://dl.radxa.com/tools/windows/PhoenixCard_V4.3.1.zip)** (Windows)
- 支持 FEL 固件制作可启动 MicroSD
- 支持 FEL 固件制作可启动 microSD
- 可用于批量生产场景

## 硬件设计
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ import DDUse from '../../../../common/radxa-os/install-system/\_use_dd_emmc.mdx'

完成系统的安装后,将主板关机,断开主板电源,按照以下操作完成系统启动:

① : 将 MicroSD 卡从主板上取下
① : 将 microSD 卡从主板上取下

② : 使用 HDMI 数据线连接显示器和主板

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,13 @@ sidebar_position: 1

import BalenaEtcherUse from '../../../../common/radxa-os/install-system/\_use_etcher_sd.mdx';

# 安装系统到 MicroSD
# 安装系统到 microSD

<BalenaEtcherUse />

## 启动系统

① : 将 MicroSD 卡插入 MicroSD 卡槽
① : 将 microSD 卡插入 microSD 卡槽

② : 使用 HDMI 数据线连接显示器和主板

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,4 +17,4 @@ NVMe SSD 是一种高速、高容量、低成本的存储设备,可用于存
你可以根据自己的硬件设备选择不同的写入方式:

- [使用硬盘盒写入系统镜像](./install-system/reader.md):需要使用到 NVMe 固态硬盘盒,操作相对简单!
- [从 SD 卡写入系统镜像到 NVMe](./install-system/no-reader.md):需要基于 MicroSD 卡正常启动 Cubie A5E 系统,然后使用 `dd` 命令将系统安装到 NVMe SSD 上。
- [从 SD 卡写入系统镜像到 NVMe](./install-system/no-reader.md):需要基于 microSD 卡正常启动 Cubie A5E 系统,然后使用 `dd` 命令将系统安装到 NVMe SSD 上。
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ import InstallSystem from '../../../../../../common/radxa-os/install-system/\_us

完成系统的安装后,将主板关机,断开主板电源,按照以下操作完成系统启动:

① : 将 MicroSD 卡从主板上取下
① : 将 microSD 卡从主板上取下

② : 将 NVMe SSD 安装到主板上

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ import InstallSystem from '../../../../../../common/radxa-os/install-system/\_us

完成系统的安装后,将主板关机,断开主板电源,按照以下操作完成系统启动:

① : 将 MicroSD 卡从主板上取下
① : 将 microSD 卡从主板上取下

② : 将 NVMe SSD 安装到主板上

Expand Down
18 changes: 9 additions & 9 deletions docs/cubie/a5e/getting-started/quickly-start.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ sidebar_position: 1

- 主板:瑞莎 Cubie A5E
- 供电:5V Type-C 电源适配器
- 系统启动介质:MicroSD 卡(用于安装系统与启动)
- 系统启动介质:microSD 卡(用于安装系统与启动)
- 显示设备:HDMI 数据线与显示器(用于显示图形界面)
- 输入设备:键盘和鼠标(用于图形界面操作)
- 调试工具(可选):USB 串口数据线(用于串口登录,参考[串口登录](../system-config/uart-login)教程)和 USB-A 拓展坞(用于拓展 USB 外设)
Expand All @@ -39,20 +39,20 @@ Cubie A5E 主板兼容 PD 协议的 5V Type-C 电源输入,建议电流 3A 以

## 安装系统

主要介绍安装系统到 MicroSD 卡。
主要介绍安装系统到 microSD 卡。

:::warning 重要提醒
**安装系统会完全格式化 MicroSD 卡,所有数据将被永久删除!**
**安装系统会完全格式化 microSD 卡,所有数据将被永久删除!**

请在操作前确认:

- MicroSD 卡中没有重要数据,或已完成备份
- microSD 卡中没有重要数据,或已完成备份
- 选择了正确的存储设备(避免误格式化其他磁盘)
:::

### 硬件连接

MicroSD 卡插入 MicroSD 卡读卡器,再将 MicroSD 卡读卡器插入电脑。
microSD 卡插入 microSD 卡读卡器,再将 microSD 卡读卡器插入电脑。

<div style={{ textAlign: "center" }}>
<img
Expand All @@ -71,7 +71,7 @@ Cubie A5E 主板兼容 PD 协议的 5V Type-C 电源输入,建议电流 3A 以

### 安装系统镜像

使用 Balena Etcher 软件可以将系统镜像安装到 MicroSD 卡中。
使用 Balena Etcher 软件可以将系统镜像安装到 microSD 卡中。

:::tip Balena Etcher
对于 Balena Etcher 的安装和使用,可以参考 [Etcher 使用](/common/radxa-os/install-system/balena-etcher) 教程。
Expand All @@ -90,7 +90,7 @@ Cubie A5E 主板兼容 PD 协议的 5V Type-C 电源输入,建议电流 3A 以

#### 选择存储设备

点击 `Select target` 选项,选择 MicroSD 卡设备。
点击 `Select target` 选项,选择 microSD 卡设备。

<div style={{ textAlign: "center" }}>
<img
Expand All @@ -108,7 +108,7 @@ Cubie A5E 主板兼容 PD 协议的 5V Type-C 电源输入,建议电流 3A 以

#### 开始烧录

点击 `Flash!` 选项,开始烧录系统镜像到 MicroSD 卡中。
点击 `Flash!` 选项,开始烧录系统镜像到 microSD 卡中。

<div style={{ textAlign: "center" }}>
<img
Expand Down Expand Up @@ -143,7 +143,7 @@ Cubie A5E 主板兼容 PD 协议的 5V Type-C 电源输入,建议电流 3A 以

## 启动系统

① : 将 MicroSD 卡插入 MicroSD 卡槽
① : 将 microSD 卡插入 microSD 卡槽

② : 使用 HDMI 数据线连接显示器和主板

Expand Down
2 changes: 1 addition & 1 deletion docs/cubie/a5e/getting-started/use-system.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,4 +11,4 @@ import UseSystem from '../../../common/radxa-os/install-system/\_use_system.mdx'

# 使用系统

<UseSystem system_start_priority="系统启动优先级:MicroSD 卡 > NVMe SSD > 板载 eMMC" />
<UseSystem system_start_priority="系统启动优先级:microSD 卡 > NVMe SSD > 板载 eMMC" />
2 changes: 1 addition & 1 deletion docs/cubie/a5e/hardware-use/hardware-info.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ sidebar_position: 1
| ① | Wi-Fi / 蓝牙模块 | ⑧ | PoE 排针 | ⑭ | LPDDR4 / LPDDR4x 内存 |
| ② | 天线座 | ⑨ | 千兆以太网(支持 PoE) | ⑮ | 全志 A527 / T527 |
| ③ | USB 3.0 Type-A HOST | ⑩ | MIPI DSI | ⑯ | 板载 eMMC(预留) |
| ④ | HDMI | ⑪ | MicroSD 卡槽 | ⑰ | 40 Pin GPIO 排针 |
| ④ | HDMI | ⑪ | microSD 卡槽 | ⑰ | 40 Pin GPIO 排针 |
| ⑤ | SPI Flash | ⑫ | MIPI CSI | ⑱ | USB Type-C (5V 供电 & OTG) |
| ⑥ | UBOOT 按键 | ⑬ | M.2 M Key 2230 插槽 | ⑲ | 千兆以太网(不支持 PoE) |
| ⑦ | 状态指示灯 | | | | |
Expand Down
Loading
Loading