Skip to content
Closed
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
Jump to file
Failed to load files.
Loading
Diff view
Diff view
145 changes: 145 additions & 0 deletions Pioneer/RevyOS/README_20251030.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,145 @@
---
sys: revyos
sys_ver: "20251030"
sys_var: null

status: good
last_update: 2025-10-29
---

# RevyOS Pioneer Test Report

## Test Environment

### Operating System Information

- System Version: RevyOS 20241230
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- System Version: RevyOS 20241230
- System Version: RevyOS 20251030

- Download Link: [https://fast-mirror.isrc.ac.cn/revyos/extra/images/sg2042/20251030/](https://fast-mirror.isrc.ac.cn/revyos/extra/images/sg2042/20251030/)
- Firmware: [https://fast-mirror.isrc.ac.cn/revyos/extra/images/sg2042/20251030/](https://fast-mirror.isrc.ac.cn/revyos/extra/images/sg2042/20251030/)
- Reference Installation Document: [https://docs.revyos.dev/docs/Installation/milkv-pioneer/](https://docs.revyos.dev/docs/Installation/milkv-pioneer/)

### Hardware Information

- Milk-V Pioneer Box v1.3
- A microSD card
- NVME SSD and Reader
- HDMI cable + monitor

## Installation Steps

### Flashing Firmware

#### SD card (suggest for fist-time)
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

issue (typo): Typo: 'fist-time' should be 'first-time'.

Suggested change
#### SD card (suggest for fist-time)
#### SD card (suggest for first-time)


Get the firmware and flash to the SD card:
```bash
wget https://fast-mirror.isrc.ac.cn/revyos/extra/images/sg2042/20251030/firmware_sg2042-single-sg2042-upstream-v6.17.y-sg204x-v1.7.img
sudo dd if=firmware_sg2042-single-sg2042-upstream-v6.17.y-sg204x-v1.7.img of=/dev/your/sd/card
sync
```

Insert the SD card into the Pioneer Box.

#### SPI Flash

To flash the SPI flash, you need to have a running system on Pioneer Box.

Install mtd relative software:
```bash
sudo apt install mtd-utils
sudo modprobe mtdblock
```

Download and flash into SPI Flash **Notice this time the firmware ends with `.bin`**
```bash
wget https://fast-mirror.isrc.ac.cn/revyos/extra/images/sg2042/20251030/firmware_sg2042-single-sg2042-upstream-v6.17.y-sg204x-v1.7.bin
sudo flashcp -v firmware_sg2042-single-sg2042-upstream-v6.17.y-sg204x-v1.7.bin /dev/mtd1
```

### Flashing Image

Decompress the image using `zstd`.
Write the image to the microSD card using `dd`.

```bash
zstd -d /path/to/revyos-pioneer-20251030-004123.img.zst
dd if=/path/to/revyos-pioneer-20251030-004123.img.zst of=/dev/yout-device bs=4M status=progress
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

issue (typo): Typo: 'yout-device' should be 'your-device'.

Update the dd command to use '/dev/your-device' instead of '/dev/yout-device'.

Suggested change
dd if=/path/to/revyos-pioneer-20251030-004123.img.zst of=/dev/yout-device bs=4M status=progress
dd if=/path/to/revyos-pioneer-20251030-004123.img.zst of=/dev/your-device bs=4M status=progress

```

### Common Issues

- To boot from the SD card, manually add Fip.bin and ZSBL to it.
- If you see random mess from serial port, which means you probably needs to update your firmware.

### Logging into the System

Logging into the system via the graphical interface.

Default username: `debian`
Default password: `debian`

## Expected Results

The system boots up normally and allows login through the graphical interface.

## Actual Results

The system boots up normally and login through the graphical interface is successful.

### Boot Log

```log
Linux revyos-pioneer 6.17.5-pioneer #2025.10.24.07.33+1a3936919 SMP Fri Oct 24 08:22:44 UTC 2025 riscv64

The programs included with the Debian GNU/Linux system are free software;
the exact distribution terms for each program are described in the
individual files in /usr/share/doc/*/copyright.

Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
permitted by applicable law.
debian@revyos-pioneer:~$ fastfetch
_,met$$$$$gg. debian@revyos-pioneer
,g$$$$$$$$$$$$$$$P. ---------------------
,g$$P"" """Y$$.". OS: Debian GNU/Linux 13 (trixie) riscv64
,$$P' `$$$. Host: Milk-V Pioneer
',$$P ,ggs. `$$b: Kernel: Linux 6.17.5-pioneer
`d$$' ,$P"' . $$$ Uptime: 32 mins
$$P d$' , $$P Packages: 2220 (dpkg)
$$: $$. - ,d$$' Shell: bash 5.2.37
$$; Y$b._ _,d$P' Display (IDVED11): 1920x1080 @ 60 Hz in 28" [External]
Y$$. `.`"Y$$$$P"' Theme: Breeze [GTK2/3]
`$$b "-.__ Icons: breeze [GTK2/3/4]
`Y$$b Font: Noto Sans (10pt) [GTK2/3/4]
`Y$$. Cursor: breeze (24px)
`$$b. Terminal: /dev/pts/0
`Y$$b. CPU: sg2042 (64)
`"Y$b._ GPU: AMD Radeon HD 6450/7450/8450 / R5 230 OEM [Discrete]
`"""" Memory: 1.68 GiB / 124.88 GiB (1%)
Swap: Disabled
Disk (/): 8.01 GiB / 936.80 GiB (1%) - ext4
Local IP (enP3p5s0): 10.0.0.12/24
Locale: C



debian@revyos-pioneer:~$ uname -a
Linux revyos-pioneer 6.17.5-pioneer #2025.10.24.07.33+1a3936919 SMP Fri Oct 24 08:22:44 UTC 2025 riscv64 GNU/Linux
debian@revyos-pioneer:~$
```


![revyos](./revyos.jpg)

Serial logs (from flashing the system to booting up):

[![asciicast](https://asciinema.org/a/wtn7JGIWTSIlLSNmscCBgctCR.svg)](https://asciinema.org/a/wtn7JGIWTSIlLSNmscCBgctCR)

## Test Criteria

Successful: The actual result matches the expected result.

Failed: The actual result does not match the expected result.

## Test Conclusion

Test successful.
138 changes: 138 additions & 0 deletions Pioneer/RevyOS/README_20251030_zh.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,138 @@
# RevyOS Pioneer 测试报告

## 测试环境

### 操作系统信息

- 系统版本:RevyOS 20251030
- 下载链接:[https://fast-mirror.isrc.ac.cn/revyos/extra/images/sg2042/20251030/](https://fast-mirror.isrc.ac.cn/revyos/extra/images/sg2042/20251030/)
- 固件: [https://fast-mirror.isrc.ac.cn/revyos/extra/images/sg2042/20251030/](https://fast-mirror.isrc.ac.cn/revyos/extra/images/sg2042/20251030/)
- 参考安装文档:[https://docs.revyos.dev/docs/Installation/milkv-pioneer/](https://docs.revyos.dev/docs/Installation/milkv-pioneer/)

### 硬件信息

- Milk-V Pioneer Box v1.3
- microSD 卡一张
- NMVE SSD 及硬盘盒
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

issue (typo): Typo: 'NMVE' should be 'NVME'.

Update the spelling to 'NVME' to ensure technical accuracy.

Suggested change
- NMVE SSD 及硬盘盒
- NVME SSD 及硬盘盒

- HDMI 线 + 显示器

## 安装步骤

### 刷写固件

#### SD 卡(推荐第一次使用)

下载固件并刷入 SD 卡中:
```bash
wget https://fast-mirror.isrc.ac.cn/revyos/extra/images/sg2042/20251030/firmware_sg2042-single-sg2042-upstream-v6.17.y-sg204x-v1.7.img
sudo dd if=firmware_sg2042-single-sg2042-upstream-v6.17.y-sg204x-v1.7.img of=/dev/your/sd/card
sync
```

插入 SD 卡到 Pioneer Box。

#### SPI Flash

你需要在 Pioneer Box 上有一个正在运行的系统才能刷写 SPI Flash。

安装 mtd 相关软件:
```bash
sudo apt install mtd-utils
sudo modprobe mtdblock
```

下载固件并刷入 SPI Flash *注意此处固件以 `.bin` 结尾*
```bash
wget https://fast-mirror.isrc.ac.cn/revyos/extra/images/sg2042/20251030/firmware_sg2042-single-sg2042-upstream-v6.17.y-sg204x-v1.7.bin
sudo flashcp -v firmware_sg2042-single-sg2042-upstream-v6.17.y-sg204x-v1.7.bin /dev/mtd1
```


### 刷写镜像

使用 `zstd` 解压镜像。
使用 `dd` 将镜像写入 microSD 卡。

```bash
zstd -d /path/to/revyos-pioneer-20251030-004123.img.zst
dd if=/path/to/revyos-pioneer-20251030-004123.img.zst of=/dev/yout-device bs=4M status=progress
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

issue (typo): Typo: 'yout-device' should be 'your-device'.

Update the dd command to use '/dev/your-device' instead of '/dev/yout-device'.

Suggested change
dd if=/path/to/revyos-pioneer-20251030-004123.img.zst of=/dev/yout-device bs=4M status=progress
dd if=/path/to/revyos-pioneer-20251030-004123.img.zst of=/dev/your-device bs=4M status=progress

```

### 常见问题

- 若需要从 SD 卡启动,需要手动向其中添加 Fip.bin 和 ZSBL。
- 若串口出现乱码,可能需要升级固件。

### 登录系统

通过图形界面登录系统。

默认用户名:`debian`
默认密码:`debian`

## 测试判定标准

测试成功:实际结果与预期结果相符。

测试失败:实际结果与预期结果不符。

## 预期结果

系统正常启动,能够通过图形界面登录。

## 实际结果

系统正常启动,成功通过图形界面登录。

### 启动信息

![revyos](./revyos.jpg)

```log
Linux revyos-pioneer 6.17.5-pioneer #2025.10.24.07.33+1a3936919 SMP Fri Oct 24 08:22:44 UTC 2025 riscv64

The programs included with the Debian GNU/Linux system are free software;
the exact distribution terms for each program are described in the
individual files in /usr/share/doc/*/copyright.

Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
permitted by applicable law.
debian@revyos-pioneer:~$ fastfetch
_,met$$$$$gg. debian@revyos-pioneer
,g$$$$$$$$$$$$$$$P. ---------------------
,g$$P"" """Y$$.". OS: Debian GNU/Linux 13 (trixie) riscv64
,$$P' `$$$. Host: Milk-V Pioneer
',$$P ,ggs. `$$b: Kernel: Linux 6.17.5-pioneer
`d$$' ,$P"' . $$$ Uptime: 32 mins
$$P d$' , $$P Packages: 2220 (dpkg)
$$: $$. - ,d$$' Shell: bash 5.2.37
$$; Y$b._ _,d$P' Display (IDVED11): 1920x1080 @ 60 Hz in 28" [External]
Y$$. `.`"Y$$$$P"' Theme: Breeze [GTK2/3]
`$$b "-.__ Icons: breeze [GTK2/3/4]
`Y$$b Font: Noto Sans (10pt) [GTK2/3/4]
`Y$$. Cursor: breeze (24px)
`$$b. Terminal: /dev/pts/0
`Y$$b. CPU: sg2042 (64)
`"Y$b._ GPU: AMD Radeon HD 6450/7450/8450 / R5 230 OEM [Discrete]
`"""" Memory: 1.68 GiB / 124.88 GiB (1%)
Swap: Disabled
Disk (/): 8.01 GiB / 936.80 GiB (1%) - ext4
Local IP (enP3p5s0): 10.0.0.12/24
Locale: C



debian@revyos-pioneer:~$ uname -a
Linux revyos-pioneer 6.17.5-pioneer #2025.10.24.07.33+1a3936919 SMP Fri Oct 24 08:22:44 UTC 2025 riscv64 GNU/Linux
debian@revyos-pioneer:~$
```


串口日志(从刷写系统到启动系统):

[![asciicast](https://asciinema.org/a/wtn7JGIWTSIlLSNmscCBgctCR.svg)](https://asciinema.org/a/wtn7JGIWTSIlLSNmscCBgctCR)


## 测试结论

测试成功。
Binary file added Pioneer/RevyOS/revyos.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading