From 460878caf0106359c3cfefefc036d61bbefb343b Mon Sep 17 00:00:00 2001 From: Jingkun Zheng Date: Fri, 24 Oct 2025 17:38:36 +0800 Subject: [PATCH] unmatched: add openeuler (mainline) Signed-off-by: Jingkun Zheng --- Unmatched/openEuler/README.md | 226 ++++++++++++++++++---- Unmatched/openEuler/README_testing.md | 106 +++++++++++ Unmatched/openEuler/README_testing_zh.md | 96 ++++++++++ Unmatched/openEuler/README_zh.md | 228 +++++++++++++++++++---- 4 files changed, 580 insertions(+), 76 deletions(-) create mode 100644 Unmatched/openEuler/README_testing.md create mode 100644 Unmatched/openEuler/README_testing_zh.md diff --git a/Unmatched/openEuler/README.md b/Unmatched/openEuler/README.md index b89c12ac..349b7c48 100644 --- a/Unmatched/openEuler/README.md +++ b/Unmatched/openEuler/README.md @@ -1,70 +1,134 @@ --- sys: openeuler -sys_ver: "24.09" -sys_var: null +sys_ver: "24.03-LTS-SP2" +sys_var: LTS -status: good -last_update: 2025-04-11 +status: basic +last_update: 2025-10-24 --- -# openEuler RISC-V 24.09 HiFive Unmatched Test Report +# openEuler RISC-V 24.03 LTS SP2 HiFive Unmatched Test Report ## Test Environment ### Operating System Information -- System Version: openEuler 24.09 testing, 20241105 (Xfce) -- Download Link: https://mirror.iscas.ac.cn/openeuler-sig-riscv/openEuler-RISC-V/testing/20241105/v0.1/Unmatched/ -- Reference Installation Document: https://mirror.iscas.ac.cn/openeuler-sig-riscv/openEuler-RISC-V/testing/20241105/v0.1/Unmatched/README.Unmatched.txt +- System Version: openEuler 24.03 LTS SP2 +- Download Link: https://www.openeuler.openatom.cn/en/download/#openEuler%2024.03%20LTS%20SP2 +- Reference Installation Document + - https://ruyisdk.cn/t/topic/1525 + - https://wiki.debian.org/InstallingDebianOn/SiFive/HiFiveUnmatched > [!NOTE] -> This is not an official release image, but one of the CI/dev version images by openEuler RISC-V SIG we found directly on their server, which is NOT listed on oERV SIG's [image download website](https://images.oerv.ac.cn/). -> oERV SIG is working on a newer release, while this is the last known bootable image on a real Unmatched board so far as we've tested. -> More information [here](https://github.com/ruyisdk/support-matrix/issues/228#issuecomment-2785789283). +> This is the official mainline openEuler riscv64 DVD ISO. +> You'll need mainline U-Boot with EFI support to boot. +> In this test report there's no GPU installed. In theory, you should be able to use GUI if there is a GPU. ### Hardware Information - HiFive Unmatched Rev A - A microUSB cable (included with HiFive Unmatched) - An ATX power supply -- A microSD card (Sandisk Extreme Pro 64G UHS-I) +- A microSD card or USB drive (large enough to store the openEuler ISO image) +- M.2 NVMe SSD (Optional, follow the installation document) +- Internet connection The following are for users expecting a desktop experience: -- A PCIe video card +- A PCIe graphics card - USB Keyboard & Mouse -- HDMI Display / Capture Card & Cable -- M.2 NVMe SSD (Optional, follow the installation document) +- Display (and its cables) ## Installation Steps +### Build and flash U-Boot to SPI Flash + +Need a running OS on the Unmatched. + +You can obtain U-Boot binary from Debian. + +```shell +wget http://deb.debian.org/debian/pool/main/u/u-boot/u-boot-sifive_2025.01-3_riscv64.deb +dpkg -x u-boot-sifive_2025.01-3_riscv64.deb . +# If you're not on Debian, you may try 7-Zip +# 7z x u-boot-sifive_2025.01-3_riscv64.deb +# tar xvf data.tar +# Or with ar +# ar x u-boot-sifive_2025.01-3_riscv64.deb +# tar xvf data.tar.xz +cd usr/lib/u-boot/sifive_unmatched +sudo modprobe mtdblock +sgdisk --clear -a 1 \ + --new=1:40:2087 --change-name=1:spl --typecode=1:5B193300-FC78-40CD-8002-E86C45580B47 \ + --new=2:2088:10279 --change-name=2:uboot --typecode=2:2E54B353-1271-4842-806F-E436D6AF6985 \ + --new=3:10280:10535 --change-name=3:env --typecode=3:3DE21764-95BD-54BD-A5C3-4ABE786F38A8 \ + /dev/mtdblock0 +dd if=u-boot-spl.bin of=/dev/mtdblock0 bs=4096 seek=5 conv=sync +dd if=u-boot.itb of=/dev/mtdblock0 bs=4096 seek=261 conv=sync +``` + +After flashing, poweroff the board normally. + ### Boot Device Selection -Ensure the dip switch is set to boot from the microSD card. If not changed, the factory default is to boot from the microSD card. +Ensure the dip switch is set to boot from SPI Flash. If not changed, the factory default is to boot from the microSD card. The dip switch should be set as follows: `MSEL[3:0]=1011` ### Use `dd` to Flash the Image to the microSD Card ```shell -wget https://mirror.iscas.ac.cn/openeuler-sig-riscv/openEuler-RISC-V/testing/20241105/v0.1/Unmatched/openEuler-24.09-V1-xfce-unmatched-testing.img.zst -zstd -T0 -dkv openEuler-24.09-V1-xfce-unmatched-testing.img.zst -sudo dd if=openEuler-24.09-V1-xfce-unmatched-testing.img of=/dev/sdX bs=1M status=progress; sync +wget https://dl-cdn.openeuler.openatom.cn/openEuler-24.03-LTS-SP2/ISO/riscv64/openEuler-24.03-LTS-SP2-netinst-riscv64-dvd.iso +sudo wipefs -af /dev/sdX +sudo dd if=openEuler-24.03-LTS-SP2-netinst-riscv64-dvd.iso of=/dev/sdX bs=1M status=progress +sync; sudo eject /dev/sdX ``` -### Notes +Unplug the USB drive/microSD card, and insert it into any USB ports/microSD slot on Unmatched. + +### OS Installation + +There are 2 serial ports on Unmatched, the second of which is the CPU serial. + +If there's no GPU installed, openEuler's Anaconda installer will fallback to output on serial. -See the installation document for instructions on booting with SSD. If U-Boot is flashed into the onboard SPI Flash, microSD-free boot setups could be achieved by editing the drive configurations in `extlinux.conf`. +In this report we're using serial terminal, with the text installer. -Remember to toggle the DIP switch (boot mode) accordingly. +(This is not the most convenient way however, it's more recommended to plug in a GPU and use the GUI installer instead.) -Refer to the U-Boot official documentation for flashing instructions: https://docs.u-boot.org/en/latest/board/sifive/unmatched.html +See [this]() screen record for installation process. + +Some notable issues: + +1. You'll need to fill in the network install source manually, e.g. https://repo.openeuler.org/openEuler-24.03-LTS-SP2/OS/riscv64/ +2. You may have troubles installing GRUB, when prompting as below, choose yes: +``` +Question + +The following error occurred while installing the boot loader. The system will +not be bootable. Would you like to ignore this and continue with installation? + +Failed to set new efi boot target. This is most likely a kernel or firmware bug. + +Please respond 'yes' or 'no' +``` +3. By default U-Boot can't pick up GRUB EFI. After the installation finished and rebooted, remove the installation media, enters U-Boot, interrupt autoboot and run the following commands to boot temporarily: +```shell +nvme scan +load nvme 0:1 $kernel_addr_r /EFI/openEuler/grubriscv64.efi +bootefi $kernel_addr_r +``` +4. After entering the system, you'll need to install GRUB as `--removable` to make U-Boot pick up GRUB automatically and boot: +```shell +dnf install -y grub2-efi-riscv64-modules +grub2-install --removable +grub2-mkconfig -o /boot/grub2/grub.cfg +``` ### Logging into the System Log into the system via the onboard serial port (using the microUSB cable connected to another computer). -Default username: `openeuler` or `root` -Default password: `openEuler12#$` +Default username and password are set during the installation process. ## Expected Results @@ -77,23 +141,105 @@ The system booted successfully and login through the onboard serial port was suc ### Boot Log ```log -Welcome to 6.6.0-41.0.0.51.oe2409.riscv64 - -System information as of time: Fri Jan 24 09:09:15 PM CST 2025 - -System load: 2.36 -Memory used: 2.5% -Swap used: 0.0% -Usage On: 22% -IP address: 10.0.0.120 -Users online: 2 -To run a command as administrator(user "root"),use "sudo ". -[openeuler@openeuler-riscv64 ~]$ +Welcome to 6.6.0-98.0.0.103.oe2403sp2.riscv64 + +System information as of time: Fri Sep 19 09:43:03 PM CST 2025 + +System load: 3.39 +Memory used: 1.6% +Swap used: 0% +Usage On: 3% +IP address: 10.0.0.116 +Users online: 1 + + +[root@localhost ~]# cat /etc/os-release +NAME="openEuler" +VERSION="24.03 (LTS-SP2)" +ID="openEuler" +VERSION_ID="24.03" +PRETTY_NAME="openEuler 24.03 (LTS-SP2)" +ANSI_COLOR="0;31" + +[root@localhost ~]# cat[ 70.739081][ T5034] Btrfs loaded, zoned=yes, fsverity=no + /sys/firmware/[ 72.697419][ T5276] systemd-rc-local-generator[5276]: /etc/rc.d/rc.local is not marked executable, skipping. + +devicetree/ efi/ fdt +[root@localhost ~]# cat /sys/firmware/[ OK ] Reached target Multi-User System. + Starting Record Runlevel Change in UTMP... +[ OK ] Finished openEuler Security Tool. +[ OK ] Finished Record Runlevel Change in UTMP. +devicetree/base/ +#address-cells config/ memory@80000000/ serial-number +aliases/ cpus/ model #size-cells +binman/ fit-images/ name soc/ +chosen/ gpio-poweroff/ reserved-memory/ +compatible hfclk/ rtcclk/ +[root@localhost ~]# cat /sys/firmware/devicetree/base/model +SiFive HiFive Unmatched A00[root@localhost ~]# cat /proc/cpuinfo +processor : 0 +hart : 2 +isa : rv64imafdc_zicntr_zicsr_zifencei_zihpm_zca_zcd +mmu : sv39 +uarch : sifive,bullet0 +mvendorid : 0x489 +marchid : 0x8000000000000007 +mimpid : 0x20181004 + +processor : 1 +hart : 1 +isa : rv64imafdc_zicntr_zicsr_zifencei_zihpm_zca_zcd +mmu : sv39 +uarch : sifive,bullet0 +mvendorid : 0x489 +marchid : 0x8000000000000007 +mimpid : 0x20181004 + +processor : 2 +hart : 3 +isa : rv64imafdc_zicntr_zicsr_zifencei_zihpm_zca_zcd +mmu : sv39 +uarch : sifive,bullet0 +mvendorid : 0x489 +marchid : 0x8000000000000007 +mimpid : 0x20181004 + +processor : 3 +hart : 4 +isa : rv64imafdc_zicntr_zicsr_zifencei_zihpm_zca_zcd +mmu : sv39 +uarch : sifive,bullet0 +mvendorid : 0x489 +marchid : 0x8000000000000007 +mimpid : 0x20181004 + +[root@localhost ~]# cat /sys/firmware/devicetree/base/model +SiFive HiFive Unmatched A00[root@localhost ~]# +[root@localhost ~]# uname -a +Linux localhost.localdomain 6.6.0-98.0.0.103.oe2403sp2.riscv64 #1 SMP PREEMPT Fri Jun 27 10:45:15 UTC 2025 riscv64 riscv64 riscv64 GNU/Linux +[root@localhost ~]# cat /etc/os-release +NAME="openEuler" +VERSION="24.03 (LTS-SP2)" +ID="openEuler" +VERSION_ID="24.03" +PRETTY_NAME="openEuler 24.03 (LTS-SP2)" +ANSI_COLOR="0;31" + +[root@localhost ~]# cat /etc/openEuler-release +openEuler release 24.03 (LTS-SP2) +[root@localhost ~]# lscpu +Architecture: riscv64 + Byte Order: Little Endian +CPU(s): 4 + On-line CPU(s) list: 0-3 +NUMA: + NUMA node(s): 1 + NUMA node0 CPU(s): 0-3 +[root@localhost ~]# ``` -![](image/2025-01-24-21-44-34.png) - -See https://github.com/QA-Team-lo/oscompare/blob/main/openEuler/Unmatched/README.md for our report on its desktop experience. +Screen record: +[![asciicast](https://asciinema.org/a/HncsUaCkyzLLomdo1rmwFT7hF.svg)](https://asciinema.org/a/HncsUaCkyzLLomdo1rmwFT7hF) ## Test Criteria diff --git a/Unmatched/openEuler/README_testing.md b/Unmatched/openEuler/README_testing.md new file mode 100644 index 00000000..b89c12ac --- /dev/null +++ b/Unmatched/openEuler/README_testing.md @@ -0,0 +1,106 @@ +--- +sys: openeuler +sys_ver: "24.09" +sys_var: null + +status: good +last_update: 2025-04-11 +--- + +# openEuler RISC-V 24.09 HiFive Unmatched Test Report + +## Test Environment + +### Operating System Information + +- System Version: openEuler 24.09 testing, 20241105 (Xfce) +- Download Link: https://mirror.iscas.ac.cn/openeuler-sig-riscv/openEuler-RISC-V/testing/20241105/v0.1/Unmatched/ +- Reference Installation Document: https://mirror.iscas.ac.cn/openeuler-sig-riscv/openEuler-RISC-V/testing/20241105/v0.1/Unmatched/README.Unmatched.txt + +> [!NOTE] +> This is not an official release image, but one of the CI/dev version images by openEuler RISC-V SIG we found directly on their server, which is NOT listed on oERV SIG's [image download website](https://images.oerv.ac.cn/). +> oERV SIG is working on a newer release, while this is the last known bootable image on a real Unmatched board so far as we've tested. +> More information [here](https://github.com/ruyisdk/support-matrix/issues/228#issuecomment-2785789283). + +### Hardware Information + +- HiFive Unmatched Rev A +- A microUSB cable (included with HiFive Unmatched) +- An ATX power supply +- A microSD card (Sandisk Extreme Pro 64G UHS-I) + +The following are for users expecting a desktop experience: +- A PCIe video card +- USB Keyboard & Mouse +- HDMI Display / Capture Card & Cable +- M.2 NVMe SSD (Optional, follow the installation document) + +## Installation Steps + +### Boot Device Selection + +Ensure the dip switch is set to boot from the microSD card. If not changed, the factory default is to boot from the microSD card. + +The dip switch should be set as follows: `MSEL[3:0]=1011` + +### Use `dd` to Flash the Image to the microSD Card + +```shell +wget https://mirror.iscas.ac.cn/openeuler-sig-riscv/openEuler-RISC-V/testing/20241105/v0.1/Unmatched/openEuler-24.09-V1-xfce-unmatched-testing.img.zst +zstd -T0 -dkv openEuler-24.09-V1-xfce-unmatched-testing.img.zst +sudo dd if=openEuler-24.09-V1-xfce-unmatched-testing.img of=/dev/sdX bs=1M status=progress; sync +``` + +### Notes + +See the installation document for instructions on booting with SSD. If U-Boot is flashed into the onboard SPI Flash, microSD-free boot setups could be achieved by editing the drive configurations in `extlinux.conf`. + +Remember to toggle the DIP switch (boot mode) accordingly. + +Refer to the U-Boot official documentation for flashing instructions: https://docs.u-boot.org/en/latest/board/sifive/unmatched.html + +### Logging into the System + +Log into the system via the onboard serial port (using the microUSB cable connected to another computer). + +Default username: `openeuler` or `root` +Default password: `openEuler12#$` + +## Expected Results + +The system should boot normally and allow login through the onboard serial port. + +## Actual Results + +The system booted successfully and login through the onboard serial port was successful. + +### Boot Log + +```log +Welcome to 6.6.0-41.0.0.51.oe2409.riscv64 + +System information as of time: Fri Jan 24 09:09:15 PM CST 2025 + +System load: 2.36 +Memory used: 2.5% +Swap used: 0.0% +Usage On: 22% +IP address: 10.0.0.120 +Users online: 2 +To run a command as administrator(user "root"),use "sudo ". +[openeuler@openeuler-riscv64 ~]$ +``` + +![](image/2025-01-24-21-44-34.png) + +See https://github.com/QA-Team-lo/oscompare/blob/main/openEuler/Unmatched/README.md for our report on its desktop experience. + +## Test Criteria + +Successful: The actual result matches the expected result. + +Failed: The actual result does not match the expected result. + +## Test Conclusion + +Test successful. diff --git a/Unmatched/openEuler/README_testing_zh.md b/Unmatched/openEuler/README_testing_zh.md new file mode 100644 index 00000000..d705adb7 --- /dev/null +++ b/Unmatched/openEuler/README_testing_zh.md @@ -0,0 +1,96 @@ +# openEuler RISC-V HiFive Unmatched 版本测试报告 + +## 测试环境 + +### 操作系统信息 + +- 系统版本：openEuler 24.09 testing, 20241105 (Xfce) +- 下载链接：https://mirror.iscas.ac.cn/openeuler-sig-riscv/openEuler-RISC-V/testing/20241105/v0.1/Unmatched/ +- 参考安装文档：https://mirror.iscas.ac.cn/openeuler-sig-riscv/openEuler-RISC-V/testing/20241105/v0.1/Unmatched/README.Unmatched.txt + +> [!NOTE] +> 此镜像为 openEuler RISC-V SIG 组自行发布的 CI/开发版本，非官方发布镜像。 +> oERV SIG 正在开发新版本，截止目前为止，经测试，这是最后已知可在 Unmatched 实机启动的镜像。 +> 更多信息请见 [此处](https://github.com/ruyisdk/support-matrix/issues/228#issuecomment-2785789283)。 + +### 硬件信息 + +- HiFive Unmatched Rev A +- microUSB 线缆一条（随 HiFive Unmatched 附赠） +- ATX 电源一个 +- microSD 卡一张（Sandisk Extreme Pro 64G UHS-I） +- PCI-E 显卡一张 +- USB 键盘&鼠标 +- HDMI 显示器/采集卡，HDMI 线缆（显卡自带 VGA/DVI，亦可使用） +- M.2 NVMe SSD（可选） + - 请参考安装文档进行操作。 + +## 安装步骤 + +### 引导设备选择 + +确保拨码开关已调整为从 microSD 卡引导。若您未更改，出厂默认即为从 microSD 卡引导。 + +拨码开关应如下设置：`MSEL[3:0]=1011` + +### 使用 `dd` 刷写镜像到 microSD 卡 + +```shell +wget https://mirror.iscas.ac.cn/openeuler-sig-riscv/openEuler-RISC-V/testing/20241105/v0.1/Unmatched/openEuler-24.09-V1-xfce-unmatched-testing.img.zst +zstd -T0 -dkv openEuler-24.09-V1-xfce-unmatched-testing.img.zst +sudo dd if=openEuler-24.09-V1-xfce-unmatched-testing.img of=/dev/sdX bs=1M status=progress; sync +``` + +### 其它说明 + +安装文档中已提到使用 SSD 的启动方式，若板载 SPI Flash 已经刷入了主线 U-Boot，可仅修改 extlinux 中的硬盘配置，无须 microSD 卡即可启动。 + +注意需要更改 DIP 开关/启动模式。 + +主线 U-Boot 刷入具体步骤请参照 U-Boot 官方文档：https://docs.u-boot.org/en/latest/board/sifive/unmatched.html + +### 登录系统 + +通过板载串口（使用 microUSB 线缆连接至其他计算机）登录系统。 + +默认用户名：`openeuler` 或 `root` +默认密码：`openEuler12#$` + +## 预期结果 + +系统正常启动，能够通过板载串口登录。 + +## 实际结果 + +系统正常启动，成功通过板载串口登录。 + +### 启动信息 + +```log +Welcome to 6.6.0-41.0.0.51.oe2409.riscv64 + +System information as of time: Fri Jan 24 09:09:15 PM CST 2025 + +System load: 2.36 +Memory used: 2.5% +Swap used: 0.0% +Usage On: 22% +IP address: 10.0.0.120 +Users online: 2 +To run a command as administrator(user "root"),use "sudo ". +[openeuler@openeuler-riscv64 ~]$ +``` +![](image/2025-01-24-21-44-34.png) + +桌面体验测试报告请见 https://github.com/QA-Team-lo/oscompare/blob/main/openEuler/Unmatched/README.md。 + + +## 测试判定标准 + +测试成功：实际结果与预期结果相符。 + +测试失败：实际结果与预期结果不符。 + +## 测试结论 + +测试成功。 \ No newline at end of file diff --git a/Unmatched/openEuler/README_zh.md b/Unmatched/openEuler/README_zh.md index d705adb7..1352b01b 100644 --- a/Unmatched/openEuler/README_zh.md +++ b/Unmatched/openEuler/README_zh.md @@ -4,57 +4,131 @@ ### 操作系统信息 -- 系统版本：openEuler 24.09 testing, 20241105 (Xfce) -- 下载链接：https://mirror.iscas.ac.cn/openeuler-sig-riscv/openEuler-RISC-V/testing/20241105/v0.1/Unmatched/ -- 参考安装文档：https://mirror.iscas.ac.cn/openeuler-sig-riscv/openEuler-RISC-V/testing/20241105/v0.1/Unmatched/README.Unmatched.txt +- 系统版本：openEuler 24.03 LTS SP2 +- 下载链接：https://www.openeuler.openatom.cn/zh/download/#openEuler%2024.03%20LTS%20SP2 +- 参考安装文档 + - https://ruyisdk.cn/t/topic/1525 + - https://wiki.debian.org/InstallingDebianOn/SiFive/HiFiveUnmatched > [!NOTE] -> 此镜像为 openEuler RISC-V SIG 组自行发布的 CI/开发版本，非官方发布镜像。 -> oERV SIG 正在开发新版本，截止目前为止，经测试，这是最后已知可在 Unmatched 实机启动的镜像。 -> 更多信息请见 [此处](https://github.com/ruyisdk/support-matrix/issues/228#issuecomment-2785789283)。 +> 此镜像为 openEuler 主线 riscv64 DVD ISO。 +> 需要搭配支持 EFI 的主线 U-Boot 使用。 +> 本次并未安装显卡进行图形界面测试，理论上安装显卡后应当可以正常使用桌面环境。 ### 硬件信息 - HiFive Unmatched Rev A - microUSB 线缆一条（随 HiFive Unmatched 附赠） - ATX 电源一个 -- microSD 卡一张（Sandisk Extreme Pro 64G UHS-I） +- microSD 卡一张或 U 盘一个（大小足够烧录 openEuler ISO 镜像） +- M.2 NVMe SSD +- 可用的网络连接 + +如需使用图形界面： + - PCI-E 显卡一张 - USB 键盘&鼠标 -- HDMI 显示器/采集卡，HDMI 线缆（显卡自带 VGA/DVI，亦可使用） -- M.2 NVMe SSD（可选） - - 请参考安装文档进行操作。 +- 显示器（以及所需线缆） ## 安装步骤 +### 构建并烧录 U-Boot 至 SPI Flash + +需要在 Unmatched 上已经有能运行的操作系统。 + +可从 Debian 获取可用的 U-Boot 二进制。 + +```shell +wget http://deb.debian.org/debian/pool/main/u/u-boot/u-boot-sifive_2025.01-3_riscv64.deb +dpkg -x u-boot-sifive_2025.01-3_riscv64.deb . +# 如果使用的不是 Debian，可使用 7-Zip +# 7z x u-boot-sifive_2025.01-3_riscv64.deb +# tar xvf data.tar +# 或使用 ar +# ar x u-boot-sifive_2025.01-3_riscv64.deb +# tar xvf data.tar.xz +cd usr/lib/u-boot/sifive_unmatched +sudo modprobe mtdblock +sgdisk --clear -a 1 \ + --new=1:40:2087 --change-name=1:spl --typecode=1:5B193300-FC78-40CD-8002-E86C45580B47 \ + --new=2:2088:10279 --change-name=2:uboot --typecode=2:2E54B353-1271-4842-806F-E436D6AF6985 \ + --new=3:10280:10535 --change-name=3:env --typecode=3:3DE21764-95BD-54BD-A5C3-4ABE786F38A8 \ + /dev/mtdblock0 +dd if=u-boot-spl.bin of=/dev/mtdblock0 bs=4096 seek=5 conv=sync +dd if=u-boot.itb of=/dev/mtdblock0 bs=4096 seek=261 conv=sync +``` + +刷写完成后，正常关闭开发板。 + ### 引导设备选择 -确保拨码开关已调整为从 microSD 卡引导。若您未更改，出厂默认即为从 microSD 卡引导。 +确保拨码开关已调整为从 SPI 引导。若您未更改，出厂默认应为从 microSD 卡引导。 拨码开关应如下设置：`MSEL[3:0]=1011` -### 使用 `dd` 刷写镜像到 microSD 卡 +### 使用 `dd` 刷写镜像到 microSD 卡或 U 盘 + +> [!WARNING] +> U 盘/存储卡上所有数据都将丢失！ +> 数据无价，务必备份好再进行下一步操作。 ```shell -wget https://mirror.iscas.ac.cn/openeuler-sig-riscv/openEuler-RISC-V/testing/20241105/v0.1/Unmatched/openEuler-24.09-V1-xfce-unmatched-testing.img.zst -zstd -T0 -dkv openEuler-24.09-V1-xfce-unmatched-testing.img.zst -sudo dd if=openEuler-24.09-V1-xfce-unmatched-testing.img of=/dev/sdX bs=1M status=progress; sync +wget https://dl-cdn.openeuler.openatom.cn/openEuler-24.03-LTS-SP2/ISO/riscv64/openEuler-24.03-LTS-SP2-netinst-riscv64-dvd.iso +sudo wipefs -af /dev/sdX +sudo dd if=openEuler-24.03-LTS-SP2-netinst-riscv64-dvd.iso of=/dev/sdX bs=1M status=progress +sync; sudo eject /dev/sdX +``` + +拔掉 U 盘，插入 Unmatched 的任意 USB 口。 + +如果是烧录到了存储卡，将存储卡插入 microSD 卡槽。 + +### 系统安装 + +Unmatched 提供两个串口，第二个为 CPU 串口。 + +如果没有安装显卡，openEuler 的 Anaconda 安装器默认会从串口输出。 + +本次使用串口终端，使用纯文本安装器。 + +（此方式操作并不算方便，如果条件允许的情况下，建议还是安装显卡然后使用图形化安装器。） + +参考[此屏幕录像](https://asciinema.org/a/HncsUaCkyzLLomdo1rmwFT7hF)的流程进行安装。 + +需要注意的一些问题： + +1. 需要手动填入网络安装源，例如 https://repo.openeuler.org/openEuler-24.03-LTS-SP2/OS/riscv64/ +2. 安装 GRUB 时可能遇到问题，遇到如下提示时先选择 yes： ``` +Question -### 其它说明 +The following error occurred while installing the boot loader. The system will +not be bootable. Would you like to ignore this and continue with installation? -安装文档中已提到使用 SSD 的启动方式，若板载 SPI Flash 已经刷入了主线 U-Boot，可仅修改 extlinux 中的硬盘配置，无须 microSD 卡即可启动。 +Failed to set new efi boot target. This is most likely a kernel or firmware bug. -注意需要更改 DIP 开关/启动模式。 +Please respond 'yes' or 'no' +``` +3. 默认安装的 GRUB EFI 无法被 U-Boot 识别，安装完成并重启后，拔除安装介质，进入 U-Boot 后，打断启动，运行如下命令临时启动系统： -主线 U-Boot 刷入具体步骤请参照 U-Boot 官方文档：https://docs.u-boot.org/en/latest/board/sifive/unmatched.html +```shell +nvme scan +load nvme 0:1 $kernel_addr_r /EFI/openEuler/grubriscv64.efi +bootefi $kernel_addr_r +``` +4. 进入系统后，需要将 GRUB 以 `--removable` 安装，使 U-Boot 可以自动识别并启动： + +```shell +dnf install -y grub2-efi-riscv64-modules +grub2-install --removable +grub2-mkconfig -o /boot/grub2/grub.cfg +``` ### 登录系统 通过板载串口（使用 microUSB 线缆连接至其他计算机）登录系统。 -默认用户名：`openeuler` 或 `root` -默认密码：`openEuler12#$` +默认用户名和密码为安装时配置。 ## 预期结果 @@ -67,23 +141,105 @@ sudo dd if=openEuler-24.09-V1-xfce-unmatched-testing.img of=/dev/sdX bs=1M statu ### 启动信息 ```log -Welcome to 6.6.0-41.0.0.51.oe2409.riscv64 - -System information as of time: Fri Jan 24 09:09:15 PM CST 2025 - -System load: 2.36 -Memory used: 2.5% -Swap used: 0.0% -Usage On: 22% -IP address: 10.0.0.120 -Users online: 2 -To run a command as administrator(user "root"),use "sudo ". -[openeuler@openeuler-riscv64 ~]$ +Welcome to 6.6.0-98.0.0.103.oe2403sp2.riscv64 + +System information as of time: Fri Sep 19 09:43:03 PM CST 2025 + +System load: 3.39 +Memory used: 1.6% +Swap used: 0% +Usage On: 3% +IP address: 10.0.0.116 +Users online: 1 + + +[root@localhost ~]# cat /etc/os-release +NAME="openEuler" +VERSION="24.03 (LTS-SP2)" +ID="openEuler" +VERSION_ID="24.03" +PRETTY_NAME="openEuler 24.03 (LTS-SP2)" +ANSI_COLOR="0;31" + +[root@localhost ~]# cat[ 70.739081][ T5034] Btrfs loaded, zoned=yes, fsverity=no + /sys/firmware/[ 72.697419][ T5276] systemd-rc-local-generator[5276]: /etc/rc.d/rc.local is not marked executable, skipping. + +devicetree/ efi/ fdt +[root@localhost ~]# cat /sys/firmware/[ OK ] Reached target Multi-User System. + Starting Record Runlevel Change in UTMP... +[ OK ] Finished openEuler Security Tool. +[ OK ] Finished Record Runlevel Change in UTMP. +devicetree/base/ +#address-cells config/ memory@80000000/ serial-number +aliases/ cpus/ model #size-cells +binman/ fit-images/ name soc/ +chosen/ gpio-poweroff/ reserved-memory/ +compatible hfclk/ rtcclk/ +[root@localhost ~]# cat /sys/firmware/devicetree/base/model +SiFive HiFive Unmatched A00[root@localhost ~]# cat /proc/cpuinfo +processor : 0 +hart : 2 +isa : rv64imafdc_zicntr_zicsr_zifencei_zihpm_zca_zcd +mmu : sv39 +uarch : sifive,bullet0 +mvendorid : 0x489 +marchid : 0x8000000000000007 +mimpid : 0x20181004 + +processor : 1 +hart : 1 +isa : rv64imafdc_zicntr_zicsr_zifencei_zihpm_zca_zcd +mmu : sv39 +uarch : sifive,bullet0 +mvendorid : 0x489 +marchid : 0x8000000000000007 +mimpid : 0x20181004 + +processor : 2 +hart : 3 +isa : rv64imafdc_zicntr_zicsr_zifencei_zihpm_zca_zcd +mmu : sv39 +uarch : sifive,bullet0 +mvendorid : 0x489 +marchid : 0x8000000000000007 +mimpid : 0x20181004 + +processor : 3 +hart : 4 +isa : rv64imafdc_zicntr_zicsr_zifencei_zihpm_zca_zcd +mmu : sv39 +uarch : sifive,bullet0 +mvendorid : 0x489 +marchid : 0x8000000000000007 +mimpid : 0x20181004 + +[root@localhost ~]# cat /sys/firmware/devicetree/base/model +SiFive HiFive Unmatched A00[root@localhost ~]# +[root@localhost ~]# uname -a +Linux localhost.localdomain 6.6.0-98.0.0.103.oe2403sp2.riscv64 #1 SMP PREEMPT Fri Jun 27 10:45:15 UTC 2025 riscv64 riscv64 riscv64 GNU/Linux +[root@localhost ~]# cat /etc/os-release +NAME="openEuler" +VERSION="24.03 (LTS-SP2)" +ID="openEuler" +VERSION_ID="24.03" +PRETTY_NAME="openEuler 24.03 (LTS-SP2)" +ANSI_COLOR="0;31" + +[root@localhost ~]# cat /etc/openEuler-release +openEuler release 24.03 (LTS-SP2) +[root@localhost ~]# lscpu +Architecture: riscv64 + Byte Order: Little Endian +CPU(s): 4 + On-line CPU(s) list: 0-3 +NUMA: + NUMA node(s): 1 + NUMA node0 CPU(s): 0-3 +[root@localhost ~]# ``` -![](image/2025-01-24-21-44-34.png) - -桌面体验测试报告请见 https://github.com/QA-Team-lo/oscompare/blob/main/openEuler/Unmatched/README.md。 +屏幕录像： +[![asciicast](https://asciinema.org/a/HncsUaCkyzLLomdo1rmwFT7hF.svg)](https://asciinema.org/a/HncsUaCkyzLLomdo1rmwFT7hF) ## 测试判定标准