Erase / Flash SPI Flash with Rsetup

Maskrom mode

To put the board into Maskrom mode, please refer to the Maskrom Mode guide.

Note

This guide only applies to Radxa OS.

Use the Rsetup tool to enable SPI Flash.

Enable SPI Flash

Because eMMC and SPI Flash are mutually exclusive, the system enables eMMC and disables SPI Flash by default. If you need to enable SPI Flash, follow the steps below.

Rsetup Usage Guide

• Select option: The corresponding option will be highlighted
• Confirm selection: Press Enter
• Cancel selection: Press ESC
• Navigate options: Use Up, Down, Left, and Right
• Multiple selection interface: Press Space to select, then Enter to confirm; a * next to the option indicates that it is enabled

1. Open a terminal and run sudo rsetup to launch the Rsetup tool.

radxa@device$

sudo rsetup

2. Go to Overlays -> Manage overlays, then press Enter to confirm.

3. Press the spacebar to select Enable SPI Flash, then press Enter to confirm.

4. Reboot the system after SPI Flash is enabled.

radxa@device$

sudo reboot

Verify SPI Flash

After the system reboots, run the following command to verify whether SPI Flash has been enabled successfully:

lsblk

If you see the mtdblock0 device, SPI Flash has been enabled successfully.

Erase / Flash SPI Flash

Note

This tutorial is only applicable to Radxa OS

Use the system configuration tool Rsetup to flash or erase the SPI boot firmware.

SPI Boot Firmware

The core task of the SPI boot firmware (BootROM + Bootloader) is to initialize hardware in stages (CPU → Memory → Storage) and ultimately load the operating system kernel through the storage device.

To boot the system from an NVMe SSD, you need to flash the SPI boot firmware for normal system startup.

Prerequisites

Ensure that the board can boot normally from a MicroSD card and has a working network connection. The following operations require accessing the board's system.

Update System

Use the Rsetup tool to update the system and obtain the latest SPI boot firmware.

Rsetup Usage Guide

• Select option: The corresponding option will be highlighted
• Confirm selection: Press Enter
• Cancel selection: Press ESC
• Navigate options: Use Up, Down, Left, Right arrow keys
• Multi-selection interface: Press Space to select, then Enter to confirm; a * will appear next to the selected option

1. Open the terminal and enter the command sudo rsetup to launch the Rsetup tool

radxa@e24c$

sudo rsetup

2. Navigate to System -> System Update and press Enter to confirm, then follow the Rsetup tool prompts to complete the system update.

System Update

The System Update option is used to update the system and is safer than using the apt update && apt upgrade commands.

Note: Using apt update && apt upgrade to update the system may result in incomplete updates or system abnormalities.

3. After the update is complete, reboot the system.

radxa@e24c$

sudo reboot

Flash SPI Boot Firmware

Use the Rsetup tool to update the SPI boot firmware, which will automatically flash the latest SPI boot firmware.

1. Navigate to System -> Bootloader Management and press Enter to confirm.

2. Select Update SPI Bootloader and press Enter to confirm.

3. Use the spacebar to select the SPI boot firmware option corresponding to your board (a * indicates the option is selected), then press Enter to confirm. Follow the Rsetup tool prompts to complete the SPI boot firmware update.

4. After the update is complete, reboot the system.

radxa@e24c$

sudo reboot

Erase SPI Boot Firmware (Optional)

Erasing SPI Boot Firmware

After erasing the SPI Bootloader, boot media that relies on the SPI boot firmware will not be able to boot the system (for example: some boards may not be able to boot from NVMe SSD).

Use the Rsetup tool to erase the SPI boot firmware.

1. Navigate to System -> Bootloader Management

2. Select Erase SPI Bootloader and press Enter to confirm.

3. After the erase is complete, reboot the system.

radxa@e24c$

sudo reboot