Skip to content

docs: add cm4 ufs boot system #1276

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 3 commits into
base: main
Choose a base branch
from
Open

docs: add cm4 ufs boot system #1276

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
19752ff
docs: add cm4 ufs boot tutorial
EESN-W Jan 13, 2026
ea44cd3
docs: add cm4 ufs boot pin tip
EESN-W Jan 13, 2026
fac5d72
docs: del cm4 not support ufs boot tip
EESN-W Jan 13, 2026
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
11 changes: 11 additions & 0 deletions docs/som/cm/cm4/getting-started/install-system/ufs-boot.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
sidebar_position: 3
---

import DDUse from '../../../../../common/radxa-os/install-system/\_use_dd_ufs.mdx';

# 安装系统到 UFS 模块

<DDUse boot_device="板载 eMMC" tag="ufs_module" download_page="../../download" download_url="https://github.com/radxa-build/radxa-rk3576/releases/download/rsdk-r5/radxa-rk3576_bookworm_kde_r5.output_4096.img.xz" path_to_image_unxz="radxa-rk3576_bookworm_kde_r5.output_4096.img" path_to_image="radxa-rk3576_bookworm_kde_r5.output_4096.img" device_target="/dev/sda" board="cm4" />

说明：UFS 启动需要将 UFS BOOT 引脚使用跳线帽或者杜邦线短接，接口位置可以参考 [其它接口](../../hardware-use/other.md) 文档。
4 changes: 2 additions & 2 deletions docs/som/cm/cm4/getting-started/quickly_start.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -63,9 +63,9 @@ sidebar_position: 1
完成系统的安装后，你可以将 MicroSD 卡安装到 CM4 IO 板的 MicroSD 卡槽上，然后连接电源适配器启动系统。

:::tip 系统启动优先级
若您在主板上安装了多个系统启动介质，系统启动优先级如下：目前暂不支持 UFS 模块启动系统
若您在主板上安装了多个系统启动介质，系统启动优先级如下：

MicroSD 卡 > 板载 eMMC > UFS 模块（暂不支持） > NVMe SSD
MicroSD 卡 > 板载 eMMC > UFS 模块 > NVMe SSD
:::

<div style={{textAlign: 'center'}}>
Expand Down
4 changes: 2 additions & 2 deletions docs/som/cm/cm4/getting-started/use_system.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,9 +15,9 @@ sidebar_position: 3
将系统启动介质安装到主板对应位置，然后使用电源适配器给主板供电并启动系统。

:::tip 系统启动优先级
若您在主板上安装了多个系统启动介质，系统启动优先级如下：目前暂不支持 UFS 模块启动系统
若您在主板上安装了多个系统启动介质，系统启动优先级如下：

MicroSD 卡 > 板载 eMMC > UFS 模块（暂不支持） > NVMe SSD
MicroSD 卡 > 板载 eMMC > UFS 模块 > NVMe SSD
:::

**说明：你可以将优先级较高的系统启动介质取下来，这样系统就会从优先级较低的系统启动介质启动。**
Expand Down
11 changes: 11 additions & 0 deletions ...ugin-content-docs/current/som/cm/cm4/getting-started/install-system/ufs-boot.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
sidebar_position: 3
---

import DDUse from '../../../../../common/radxa-os/install-system/\_use_dd_ufs.mdx';

# Install System to UFS Module

<DDUse boot_device="Onboard eMMC" tag="ufs_module" download_page="../../download" download_url="https://github.com/radxa-build/radxa-rk3576/releases/download/rsdk-r5/radxa-rk3576_bookworm_kde_r5.output_4096.img.xz" path_to_image_unxz="radxa-rk3576_bookworm_kde_r5.output_4096.img" path_to_image="radxa-rk3576_bookworm_kde_r5.output_4096.img" device_target="/dev/sda" board="cm4" />

Note: UFS boot requires shorting the UFS BOOT pin using a jumper cap or DuPont wire. For the interface location, please refer to the [Other Interfaces](../../hardware-use/other.md) document.
2 changes: 1 addition & 1 deletion ...usaurus-plugin-content-docs/current/som/cm/cm4/getting-started/quickly_start.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@ After completing the system installation, insert the MicroSD card into the CM4 I
:::tip Boot Priority
If you have multiple boot media installed, the system will boot in the following priority order:

MicroSD Card > Onboard eMMC > UFS Module (Not Supported) > NVMe SSD
MicroSD Card > Onboard eMMC > UFS Module > NVMe SSD
:::

<div style={{textAlign: 'center'}}>
Expand Down
4 changes: 2 additions & 2 deletions ...docusaurus-plugin-content-docs/current/som/cm/cm4/getting-started/use_system.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,9 +15,9 @@ If you haven't installed the system yet, please refer to the [Install System](./
Install the boot media in the corresponding slot on the motherboard, then power on the board using the power adapter to start the system.

:::tip Boot Priority
If you have multiple boot media installed on the motherboard, the system will boot in the following priority order (Note: UFS module boot is currently not supported):
If you have multiple boot media installed on the motherboard, the system will boot in the following priority order:

MicroSD Card > Onboard eMMC > UFS Module (Not Supported) > NVMe SSD
MicroSD Card > Onboard eMMC > UFS Module > NVMe SSD
:::

**Note:** You can remove the higher priority boot media to force the system to boot from a lower priority media.
Expand Down
Loading