Skip to content

docs: add radxa x5 quickly started #1352

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
EESN-W wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: add radxa x5 quickly started #1352

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
93 changes: 93 additions & 0 deletions docs/x/x5/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
---
sidebar_position: 50
---

# Radxa X5

## 产品概述

瑞莎 X5 是一款基于英特尔® 处理器 N150 (Twin Lake) 的高性能单板计算机，面向边缘计算与嵌入式应用场景，在紧凑尺寸内提供 x86 平台的通用计算与图形能力。

X5 提供 LPDDR5 内存（最大可选 16GB），并支持板载 eMMC（可选）及 M.2 M Key 2230 扩展存储，便于按项目需求灵活配置容量与性能。

显示与连接方面，板载 2× Micro HDMI 显示输出，提供 2.5GbE 有线网络，并集成 Wi‑Fi 6 / 蓝牙 5.2，适用于智能终端、工业网关与多媒体边缘设备等应用。

供电支持 USB Type-C（兼容 PD / QC 协议）或 12V DC 输入，同时板载 40-Pin GPIO 等扩展接口，便于外设连接与系统集成。

## 产品外观

| 位置 | 视图 | 位置 | 视图 | 位置 | 视图 |
| :--: | :-------: | :--: | :-------: | :--: | :-------: |
| 左 | X5 正视图 | 中 | X5 背视图 | 右 | X5 侧视图 |

<div style={{textAlign: 'center'}}>
<img src="/img/x/x5/x5-view.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

## 产品规格

| 类别 | 规格参数 |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| 中央处理器 | 英特尔® 处理器 N150 (Twin Lake)<br />- 内核数: 4<br />- 线程数: 4<br />- 最大睿频频率: 3.6 GHz<br />- 缓存: 6 MB Intel® Smart Cache |
| 图形处理器 | Intel® Graphics<br />- 最大动态频率：1GHz<br />- 最大分辨率：4K@60Hz<br />- 支持 DirectX 12.1 / OpenGL 4.6 / OpenCL 3.0 |
| 微控制器 | RP2350 |
| 内存 | LPDDR5<br />- 最大可选 16 GB |
| 存储 | 板载 eMMC（可选）<br />1× M.2 M Key 2230 插槽 |
| 显示 | 2x Micro HDMI |
| 网络 | 1x 2.5GbE RJ45 端口（支持 PoE，需搭配 PoE 扩展板）<br />板载 WiFi 6 / 蓝牙 5.2 |
| USB | 1x USB 2.0 Type-A 端口 <br />3x USB 3.2 Gen 2 Type-A 端口 |
| 音频 | 3.5mm 耳机接口 |
| 按键 | 1x 电源按键<br />1x BOOTSEL 按键 |
| 其他 | 1x PoE 接口<br />1x 风扇接口<br />1x RTC 电池接口<br />1x 40-Pin GPIO 排针<br />- 支持 UART, I2C, PWM, GPIO 等功能<br />1x 电源按键接口 |
| 供电 | USB Type-C（支持 PD / QC 协议）或 12V DC 电源输入接口 |
| 操作系统 | 支持 Windows 10 / Windows 11<br />支持主流 Linux 发行版（如 Ubuntu、Debian、Fedora 等） |
| 尺寸 | 85 mm x 56 mm |

## 接口说明

<div style={{textAlign: 'center'}}>
<img src="/img/x/x5/x5-interface.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

| 序号 | 说明 | 序号 | 说明 | 序号 | 说明 |
| ---- | ---------------------- | ---- | ------------------------------------------------- | ---- | --------------------------- |
| 1 | 40-Pin GPIO 排针 | 2 | M.2 M Key 2230 卡槽 | 3 | BOOTSEL 按键 |
| 4 | WiFi 6 & 蓝牙 5.2 模组 | 5 | 电源按键 | 6 | USB Type-C 供电接口 |
| 7 | 12V DC 电源输入接口 | 8 | 2x Micro HDMI 接口 | 9 | 电源按键接口 |
| 10 | 风扇接口 | 11 | RTC 电池接口 | 12 | RP2350 |
| 13 | PoE 接口 | 14 | 2.5GbE RJ45 网口 | 15 | 2x USB 3.2 Gen2 Type-A 端口 |
| 16 | 板载 eMMC | 17 | Up: USB 2.0 Type-A<br />Down: USB 3.2 Gen2 Type-A | 18 | 耳机插孔 |
| 19 | LPDDR5 内存 | 20 | 英特尔® 处理器 N150 (Twin Lake) | 21 | SPI Flash |

:::tip 板载 eMMC

板载 eMMC 为可选配置，用户可选择板载 eMMC 容量。

:::

## 应用场景

瑞莎 X5 适合用于需要 x86 通用算力与多媒体能力的边缘计算与嵌入式应用，如工业网关、轻量视觉分析、智能终端与本地服务部署等。

### 边缘 AI 应用

可利用英特尔® 处理器与 Intel® Graphics 的图形/媒体能力，在本地完成图像/视频预处理、轻量推理与可视化展示，并通过 2.5GbE 或 Wi‑Fi 6 将数据接入局域网或边缘集群。

### 嵌入式开发

板载 40-Pin GPIO 排针等扩展接口，结合 USB 3.2、2× Micro HDMI 与 M.2 扩展能力，可用于连接常见外设并搭建原型系统。

### 机器人开发

作为机器人/自动化设备的上位机或边缘控制节点，瑞莎 X5 可用于运行控制与交互程序，并通过有线/无线网络、USB 与 GPIO 连接传感器、执行器及扩展模块。

### 开发者套件

可作为嵌入式爱好者与项目开发的计算平台，便于在 Windows 或 Linux 环境下快速完成应用移植、外设联调与系统集成。

## 系统平台

瑞莎 X5 基于英特尔® 处理器 N150，支持多种操作系统，可按项目生态与部署形态选择：

- Windows 10 / Windows 11
- 主流 Linux 发行版（如 Ubuntu、Debian、Fedora 等）
19 changes: 19 additions & 0 deletions docs/x/x5/download.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
---
sidebar_position: 100
---

# 资源汇总下载

## 系统镜像

- [Windows 10](https://www.microsoft.com/software-download/windows10)
- [Windows 11](https://www.microsoft.com/zh-cn/software-download/windows11)
- [Ubuntu](https://ubuntu.com/download)
- [Debian](https://www.debian.org/download)
- [Fedora](https://fedoraproject.org/workstation/download)
- [FreeBSD](https://www.freebsd.org/where/)

## 硬件设计

- [原理图 V1.20](https://dl.radxa.com/x/x5/docs/hw/radxa_x5_%20v1.20_schematic.pdf)
- [位号图 V1.20](https://dl.radxa.com/x/x5/docs/hw/radxa_x5_v1.20_components_placement_map.pdf)
9 changes: 9 additions & 0 deletions docs/x/x5/getting-started/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
sidebar_position: 1
---

# 上手指南

上手指南可以让大家快速了解和使用瑞莎 X5。

<DocCardList />
226 changes: 226 additions & 0 deletions docs/x/x5/getting-started/quickly-started.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,226 @@
---
sidebar_position: 1
---

# 快速上手

本节教程目的是为了让大家快速上手使用瑞莎 X5 产品。

## 产品实物

| 位置 | 视图 | 位置 | 视图 | 位置 | 视图 |
| :--: | :-------: | :--: | :-------: | :--: | :-------: |
| 左 | X5 正视图 | 中 | X5 背视图 | 右 | X5 侧视图 |

<div style={{textAlign: 'center'}}>
<img src="/img/x/x5/x5-view.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

## 使用前提

### 硬件准备

您需要提前准备以下硬件设备：

- 主板：瑞莎 X5
- 供电：USB Type-C（兼容 PD / QC 协议）电源适配器或 12V DC 电源适配器
- 系统启动盘：U 盘
- 系统安装盘：固态硬盘（M.2 M Key 2230）或板载 eMMC
- 显示设备：Micro HDMI 转 HDMI 线与显示器（用于显示图形界面）
- 输入设备：键盘和鼠标（用于图形界面操作）

:::tip 推荐配件
瑞莎 X5 支持 USB Type-C（兼容 PD / QC 协议）或 12V DC 供电，建议电源适配器功率充足，确保所有外设稳定运行。

- [瑞莎 PD 30W电源适配器(推荐使用)](https://radxa.com/products/accessories/power-pd-30w)
:::

## 安装系统

我们需要提前将 U 盘制作为启动盘，然后通过启动盘给板载 eMMC 或 NVMe 固态硬盘安装系统。

### 下载系统镜像

您可以根据自己的喜好选择对应系统镜像，教程以安装 Windows 11 系统为例。

- [Windows 10](https://www.microsoft.com/software-download/windows10)
- [Windows 11](https://www.microsoft.com/zh-cn/software-download/windows11)
- [Ubuntu](https://ubuntu.com/download)
- [Debian](https://www.debian.org/download)
- [Fedora](https://fedoraproject.org/workstation/download)
- [FreeBSD](https://www.freebsd.org/where/)

### 制作启动 U 盘

使用 [Rufus](https://rufus.ie/) 制作启动 U 盘。

#### 下载 Rufus

访问 [Rufus 下载](https://rufus.ie/en/#download) 页面，下载 Rufus 软件。

#### 开始制作启动盘

打开 Rufus 软件，按照以下步骤操作：

<div style={{textAlign: 'center'}}>
<img src="/img/x/x5/rufus-windows-param.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

① : 选择制作启动盘的 U 盘

② : 选择下载的系统镜像

③ : 开始制作启动盘

④ : 自定义 Windows 用户，选择 `OK` 即可

:::tip

其他选项选择默认设置即可，若有特殊需求，可自行调整选项设置。

:::

#### 制作启动盘成功

等待 Rufus 制作启动盘成功， Rufus 会提示 `Ready`。

<div style={{textAlign: 'center'}}>
<img src="/img/x/x5/rufus-windows-succ.webp" style={{width: '50%', maxWidth: '1200px'}} />
</div>

### 安装系统镜像

将制作好的启动 U 盘安装到主板的 USB Type-A 端口，主板分别连接显示器、鼠标以及键盘，最后使用电源适配器给主板供电。

#### 进入启动菜单

主板上电后，按键盘的 `F7` 键，进入启动菜单，选择 U 盘对应的启动项。

<div style={{textAlign: 'center'}}>
<img src="/img/x/x5/x5-windows-boot-menu.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

#### 设置系统语言

选择 `English (United States)`，点击 `Next`。

<div style={{textAlign: 'center'}}>
<img src="/img/x/x5/x5-windows-language.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

#### 选择键盘设置

选择 `US`，点击 `Next`。

<div style={{textAlign: 'center'}}>
<img src="/img/x/x5/x5-windows-keyboard.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

#### 选择安装选项

选择 `Install Windows 11` 和勾选 `I agree ...`，点击 `Next`。

<div style={{textAlign: 'center'}}>
<img src="/img/x/x5/x5-windows-install.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

#### 填写产品密钥

若无产品密钥，则点击 `I don't have a product key`；若有产品密钥，则输入产品密钥，点击 `Next`。

<div style={{textAlign: 'center'}}>
<img src="/img/x/x5/x5-windows-product-key.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

#### 选择系统镜像

选择自己需要安装的系统镜像，点击 `Next`。

<div style={{textAlign: 'center'}}>
<img src="/img/x/x5/x5-windows-image.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

#### 接受许可协议

选择 `Accept` 选项。

<div style={{textAlign: 'center'}}>
<img src="/img/x/x5/x5-windows-accept.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

#### 选择安装位置

选择安装位置，点击 `Next`。

:::tip 镜像位置

瑞莎 X5 可选板载 eMMC 和外接 M.2 M Key 2230，选择安装位置时，可以根据对应的容量来判断磁盘类型。

:::

<div style={{textAlign: 'center'}}>
<img src="/img/x/x5/x5-windows-install-location.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

#### 正式安装系统

点击 `Install`，等待系统安装完成，整个安装过程中可能会出现重启，这是正常现象，等待安装完成即可。

<div style={{textAlign: 'center'}}>
<img src="/img/x/x5/x5-windows-install-progress.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

#### 设置系统地区

选择 `United States`，点击 `Next`。

<div style={{textAlign: 'center'}}>
<img src="/img/x/x5/x5-windows-region.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

#### 设置键盘布局

选择 `US`，点击 `Next`。

<div style={{textAlign: 'center'}}>
<img src="/img/x/x5/x5-windows-keyboard-layout.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

#### 设置网络连接

可以连接有线网络进行联网，无线网络需要安装驱动，目前演示无网络安装系统。

<div style={{textAlign: 'center'}}>
<img src="/img/x/x5/x5-windows-network.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

#### 设置用户信息

填写用户名、密码、确认密码，然后点击 `Next` 进入下一步。

:::tip 密码

不填写密码并点击 `Next`，系统会默认设置密码为空。

:::

<div style={{textAlign: 'center'}}>
<img src="/img/x/x5/x5-windows-user.webp" style={{width: '100%', maxWidth: '1200px'}} />
<img src="/img/x/x5/x5-windows-password.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

#### 设置隐私信息

自行选择需要开启和关闭的隐私选项，然后点击 `Accept` 进入下一步。

<div style={{textAlign: 'center'}}>
<img src="/img/x/x5/x5-windows-privacy.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>

#### 设置完成

等待几分钟，进入 Windows 11 桌面环境，至此，Windows 11 系统安装完成。

<div style={{textAlign: 'center'}}>
<img src="/img/x/x5/x5-windows-desktop.webp" style={{width: '100%', maxWidth: '1200px'}} />
</div>
Loading
Loading