Boot from microSD card and install the system to NVMe SSD

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 any important data in advance!

Prerequisites

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

Install the NVMe SSD on the board, connect a display, and power the board using a power adapter.

M.2 M 2280 Slot

Install NVMe SSD via M.2 M Key 2280 interface.

M.2 M 2230 Slot

Install NVMe SSD via M.2 M Key 2230 Slot.

PCIe FPC Interface

NVMe SSD can be installed using PCIe FPC interface with M.2 M Key HAT.

System Installation

Download System Image

Access the Resource Download page from your device and download the latest system image to the device.

Image Note

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 your device.

radxa@e24c$

sudo apt update
sudo apt install wget -y
wget <download_url>

Where <download_url> 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:

wget https://github.com/radxa-build/radxa-rk3528/releases/download/rsdk-t2/radxa-rk3528_bookworm_kde_t2.output.img.xz

Extract System Image

Our system images are generally in *.img.xz format and need to be extracted before use.

radxa@e24c$

sudo apt install xz-utils -y
unxz <path_to_image_unxz>

Where <path_to_image_unxz> is the path to the system image file, which needs to be replaced with the actual system image file path.

Extraction example:

unxz radxa-rk3528_bookworm_kde_t2.output.img.xz

Determine Device Path

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 similar, you can safely remove and reinsert the NVMe SSD to observe which device path appears and disappears, thus determining the correct device path.

radxa@e24c$

lsblk

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.

Terminal output example:

NAME        MAJ:MIN RM   SIZE RO TYPE MOUNTPOINTS
···
nvme0n1     259:0    0 119.2G  0 disk
└─nvme0n1p1 259:1    0 119.2G  0 part
···

Install System Image

Use the dd command to install the system image to the NVMe SSD.

radxa@e24c$

sudo dd if=<path_to_image> of=<device_target> bs=4M status=progress

Write example:

sudo dd if=radxa-rk3528_bookworm_kde_t2.output.img of=/dev/nvme0n1 bs=4M status=progress

Parameter description:

• <path_to_image>: The path to the system image file, which needs to be replaced with the actual system image file path.

• <device_target>: 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: Display write progress.

Verify Write Result

After the system installation is complete, you can use the lsblk command to check if the NVMe SSD partition table has been created correctly.

radxa@e24c$

lsblk

Terminal output example:

NAME        MAJ:MIN RM   SIZE RO TYPE MOUNTPOINT
···
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
···

Boot the system

NVMe boot

To boot the system from an NVMe SSD, you must flash the SPI boot firmware first. If you have not flashed the SPI boot firmware yet, please refer to the Erase / Flash SPI Flash guide.

After the system installation is complete, remove the microSD card, make sure the NVMe SSD is installed in the NVMe SSD slot on the Radxa E24C, and then power the Radxa E24C with a 12V DC power adapter.

Detailed steps:

1. Make sure the NVMe SSD is installed

2. Connect the display and the board using an HDMI / DP cable

3. Power the Radxa E24C with a 12V DC power adapter

Log in to the system

When you boot the system for the first time, you need to log in with the default username and password.

The default credentials for Radxa OS are as follows:

Item	Value
Username	radxa
Password	radxa

Use the system

After logging in successfully, you can configure the system and start development on the Radxa E24C.