Skip to content

Commit

Permalink
NeZha: frok from D1_LICHEERV
Browse files Browse the repository at this point in the history
  • Loading branch information
panglars committed Dec 4, 2024
1 parent 179aad1 commit 76b6ae8
Show file tree
Hide file tree
Showing 21 changed files with 2,096 additions and 0 deletions.
137 changes: 137 additions & 0 deletions NeZha/ArchLinux/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,137 @@
---
sys: archlinux
sys_ver: null
sys_var: null

status: basic
last_update: 2024-12-04
---

# Arch Linux AWOL Nezha D1 Test Report

## Test Environment

### Operating System Information

- Base Image: Ubuntu 24.10: [ubuntu-24.10](https://ubuntu.com/download/risc-v)
- Or any arbitrary image for D1
- Rootfs:[archriscv-2024-09-22.tar.zst](https://archriscv.felixc.at/images/archriscv-2024-09-22.tar.zst)
- Reference Installation Document: https://github.com/felixonmars/archriscv-packages/wiki/RV64-%E6%9D%BF%E5%AD%90%E6%9B%B4%E6%8D%A2-rootfs-%E6%8C%87%E5%8D%97

### Hardware Information

- Nezha D1
- A Type-C Power Cable
- A UART to USB Debugger
- SD Card

## Installation Steps

### Obtain images and rootfs

Get the base images and rootfs. You can use arbitrary any images for D1 as the base images.

We have used Debian images and Ubuntu images and know that they work well. Below we use the Ubuntu images as an example.

```bash
wget https://archriscv.felixc.at/images/archriscv-2024-09-22.tar.zst
xz -kd ubuntu-24.10-preinstalled-server-riscv64+nezha.img.xz
mkdir rfs
tar -xf archriscv-2024-09-22.tar.zst -C rfs
mkdir mnt
```

### Replace the rootfs

Replace the rootfs with the one from the Ubuntu image. Change the following mount points to the correct rootfs for your image.

```bash
sudo losetup -f
sudo losetup -P /dev/loopX ubuntu-24.10-preinstalled-server-riscv64+nezha.img.xz
sudo mount /dev/loopXp1 mnt
cd mnt
sudo mkdir old
sudo mv etc home media mnt opt root srv var usr old/
sudo cp -r ../rfs/{etc,home,mnt,opt,root,srv,var,usr} .
sudo cp -r old/usr/lib/firmware usr/lib/
sudo cp -r old/usr/lib/modules/ usr/lib/
rm etc/fstab
sudo rm etc/fstab
sudo cp -r old/etc/fstab etc/fstab
```

Don't forget to clean up the files.

```bash
cd ..
sudo umount mnt
sudo losetup -d /dev/loopX
```

### Flash the image

Flash the image to the SD card.

```bash
sudo wipefs -a /dev/sdX
sudo dd if=ubuntu-24.10-preinstalled-server-riscv64+nezha.img.xz of=/dev/sdX bs=4M status=progress
```

### Logging into the System

Logging into the system via the serial port.

Default Username: `root`
Default Password: `archriscv`

## Expected Results

The system should boot normally and allow login via the onboard serial port.

## Actual Results

The system booted successfully and login via the onboard serial port was also successful.

### Boot Log

Screen recording (from flashing the image to logging into the system):
[![asciicast](https://asciinema.org/a/G3j3MjoOZ8rcTD28kfMLDao6a.svg)](https://asciinema.org/a/G3j3MjoOZ8rcTD28kfMLDao6a)

```log
archlinux login: root
Password:
[root@archlinux ~]# cat /etc/os-release
NAME="Arch Linux"
PRETTY_NAME="Arch Linux"
ID=arch
BUILD_ID=rolling
ANSI_COLOR="38;2;23;147;209"
HOME_URL="https://archlinux.org/"
DOCUMENTATION_URL="https://wiki.archlinux.org/"
SUPPORT_URL="https://bbs.archlinux.org/"
BUG_REPORT_URL="https://gitlab.archlinux.org/groups/archlinux/-/issues"
PRIVACY_POLICY_URL="https://terms.archlinux.org/docs/privacy-policy/"
LOGO=archlinux-logo
[root@archlinux ~]# uname -a
Linux archlinux 6.11.0-8-generic #8.1-Ubuntu SMP PREEMPT_DYNAMIC Tue Oct 1 11:40:56 UTC 2024 riscv64 GNU/Linux
[root@archlinux ~]# cat /proc/cpuinfo
processor : 0
hart : 0
isa : rv64imafdc_zicntr_zicsr_zifencei_zihpm_zca_zcd
mmu : sv39
uarch : thead,c906
mvendorid : 0x5b7
marchid : 0x0
mimpid : 0x0
hart isa : rv64imafdc_zicntr_zicsr_zifencei_zihpm_zca_zcd
```

## Test Criteria

Successful: The actual result matches the expected result.

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

## Test Conclusion

Test successful
131 changes: 131 additions & 0 deletions NeZha/ArchLinux/README_zh.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,131 @@
# Arch Linux LicheeRV / AWOL Nezha D1 测试报告

## 测试环境

### 操作系统信息

- 基础镜像:Ubuntu 24.10: [ubuntu-24.10](https://ubuntu.com/download/risc-v)
- 或任意 D1 的镜像
- Rootfs:[archriscv-2024-09-22.tar.zst](https://archriscv.felixc.at/images/archriscv-2024-09-22.tar.zst)
- 参考安装文档:https://github.com/felixonmars/archriscv-packages/wiki/RV64-%E6%9D%BF%E5%AD%90%E6%9B%B4%E6%8D%A2-rootfs-%E6%8C%87%E5%8D%97
h

### 硬件信息

- Nezha D1
- Type-C 电源线一根
- UART 转 USB 调试器一个
- SD 卡

## 安装步骤

### 获取镜像和 rootfs

下载基础镜像和 rootfs。任何 D1 的镜像都可以作为基础镜像。

Debian 镜像和 Ubuntu 镜像曾被验证过能工作。接下来以 Ubuntu 镜像为例。

```bash
wget https://archriscv.felixc.at/images/archriscv-2024-09-22.tar.zst
xz -kd ubuntu-24.10-preinstalled-server-riscv64+nezha.img.xz
mkdir rfs
tar -xf archriscv-2024-09-22.tar.zst -C rfs
mkdir mnt
```

### 替换 rootfs

用 Arch Linux 的 rootfs 替换 Ubuntu 镜像中的 rootfs。将下面的分区更改为正确的 rootfs 分区。

```bash
sudo losetup -f
sudo losetup -P /dev/loopX ubuntu-24.10-preinstalled-server-riscv64+nezha.img.xz
sudo mount /dev/loopXp1 mnt
cd mnt
sudo mkdir old
sudo mv etc home media mnt opt root srv var usr old/
sudo cp -r ../rfs/{etc,home,mnt,opt,root,srv,var,usr} .
sudo cp -r old/usr/lib/firmware usr/lib/
sudo cp -r old/usr/lib/modules/ usr/lib/
sudo rm etc/fstab
sudo cp -r old/etc/fstab etc/fstab
```

清理工作。

```bash
cd ..
sudo umount mnt
sudo losetup -d /dev/loopX
```

### 刷写镜像

将镜像刷写到 SD 卡。

```bash
sudo wipefs -a /dev/sdX
sudo dd if=ubuntu-24.10-preinstalled-server-riscv64+nezha.img.xz of=/dev/sdX bs=4M status=progress
```


### 登录系统

通过串口登录系统。

默认用户名:`root`
默认密码:`archriscv`

## 预期结果

系统正常启动,能够通过板载串口登录。

## 实际结果

系统正常启动,成功通过板载串口登录。

### 启动信息

屏幕录像(从刷写镜像到登录系统):
[![asciicast](https://asciinema.org/a/G3j3MjoOZ8rcTD28kfMLDao6a.svg)](https://asciinema.org/a/G3j3MjoOZ8rcTD28kfMLDao6a)

```log
archlinux login: root
Password:
[root@archlinux ~]# cat /etc/os-release
NAME="Arch Linux"
PRETTY_NAME="Arch Linux"
ID=arch
BUILD_ID=rolling
ANSI_COLOR="38;2;23;147;209"
HOME_URL="https://archlinux.org/"
DOCUMENTATION_URL="https://wiki.archlinux.org/"
SUPPORT_URL="https://bbs.archlinux.org/"
BUG_REPORT_URL="https://gitlab.archlinux.org/groups/archlinux/-/issues"
PRIVACY_POLICY_URL="https://terms.archlinux.org/docs/privacy-policy/"
LOGO=archlinux-logo
[root@archlinux ~]# uname -a
Linux archlinux 6.11.0-8-generic #8.1-Ubuntu SMP PREEMPT_DYNAMIC Tue Oct 1 11:40:56 UTC 2024 riscv64 GNU/Linux
[root@archlinux ~]# cat /proc/cpuinfo
processor : 0
hart : 0
isa : rv64imafdc_zicntr_zicsr_zifencei_zihpm_zca_zcd
mmu : sv39
uarch : thead,c906
mvendorid : 0x5b7
marchid : 0x0
mimpid : 0x0
hart isa : rv64imafdc_zicntr_zicsr_zifencei_zihpm_zca_zcd
```


## 测试判定标准

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

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

## 测试结论

成功
105 changes: 105 additions & 0 deletions NeZha/Debian/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,105 @@
---
sys: debian
sys_ver: 11
sys_var: null

status: good
last_update: 2024-06-21
---

# Debian 11 D1 Test Report

## Test Environment

### Operating System Information

- System Version: Debian
- Download Link: [http://www.perfxlab.cn:8080/rvboards/](http://www.perfxlab.cn:8080/rvboards/)
- Web Disk: [https://pan.baidu.com/s/1leAXR2VPHvTqkaDqfeY9ag](https://pan.baidu.com/s/1leAXR2VPHvTqkaDqfeY9ag) Access Code: 3o5v
- Reference Installation Document: [https://d1.docs.aw-ol.com/strong/strong_4debian/#v041](https://d1.docs.aw-ol.com/strong/strong_4debian/#v041)

### Hardware Information

- AWOL Nezha D1
- Power Adapter
- A microSD card
- A USB to UART Debugger

## Installation Steps

### Flashing Image

Use `unzip` to decompress the image.
Clear your SD card.
Use `dd` to write the image to the microSD card.

```bash
unzip /path/to/RVBoards_D1_Debian_lxde_img_linux.img.zip
sudo wipefs -a /dev/your_device
sudo dd if=/path/to/RVBoards_D1_Debian_lxde_img_linux.img of=/dev/your_device bs=1M status=progress
```

### Logging into the System

Log into the system via the serial port.

Default Username: `root`
Default Password: `rvboards`

## Expected Results

The system should boot normally and allow login via the onboard serial port.

## Actual Results

The system booted successfully and login via the onboard serial port was also successful.

### Boot Log

Screen recording (From flashing image to login):

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

```log
Debian GNU/Linux 11 RVBoards ttyS0
RVBoards login: root
Password:
Login incorrect
RVBoards login: root
Password:
Linux RVBoards 5.4.61 #12 PREEMPT Thu Jun 3 08:39:01 UTC 2021 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.
Last login: Wed May 19 18:39:24 CST 2021 on ttyS0
root@RVBoards:~# uname -a
Linux RVBoards 5.4.61 #12 PREEMPT Thu Jun 3 08:39:01 UTC 2021 riscv64 GNU/Linux
root@RVBoards:~# cat /etc/os-release
PRETTY_NAME="Debian GNU/Linux 11 (bullseye)"
NAME="Debian GNU/Linux"
VERSION_ID="11"
VERSION="11 (bullseye)"
VERSION_CODENAME=bullseye
ID=debian
HOME_URL="https://www.debian.org/"
SUPPORT_URL="https://www.debian.org/support"
BUG_REPORT_URL="https://bugs.debian.org/"
root@RVBoards:~#
```

## Test Criteria

Successful: The actual result matches the expected result.

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

## Test Conclusion

Test successful.
Loading

0 comments on commit 76b6ae8

Please sign in to comment.