Pioneer Box 上安装
硬件准备
Milk-V Pioneer v1.3版本设备 1 台，或主板（及必需外设） 1 套m.2 NVMe固态硬盘 1 块
若原先有数据则需格式化清除（个人资料请注意备份）。
若有
PCIe转接卡，则可通过转接卡置于设备PCIe第一槽位（较推荐）。若无
PCIe转接卡，则可置于板载NVMe接口。
AMD R5 230显卡 1 块
置于设备
PCIe第二槽位。
U 盘1 个
大小应为
16GiB以上。
microSD 卡1 张
大小应为
4GiB以上。
显示器 1 台（显示接口需与显卡对应）
USB键盘及鼠标 1 套串口操作所需设备/组件（可选）
RJ45网线 1 条以上及路由器/交换机等设备供有线网络连接使用
推荐使用设备板载
RJ45网口而非厂家附送的PCIe电口网卡。设备出厂未附送
Wi-Fi网卡，不具备Wi-Fi或蓝牙连接能力。如有需要请自备对应设备。
镜像种类
ISO
ISO镜像支持UEFI方式启动，对应下文的 UEFI 版固件。
从官网下载页面获取 ISO 文件（如 openEuler-24.03-LTS-SP1-riscv64-dvd.iso），并将其烧录至 U盘 中即可。
- 推荐使用
Balena Etcher软件进行图形化烧录 [从https://github.com/balena-io/etcher/releases/latest下载]，烧写过程此处略过 - 命令行环境下也可采用
dd方式进行烧录，参考命令如下：
~$ sudo dd if=openEuler-24.03-LTS-SP1-riscv64-dvd.iso of=/dev/sda bs=512K iflag=fullblock oflag=direct conv=fsync status=progressImage
Image镜像支持Legacy方式启动，对应下文的非 UEFI 版固件
从官网下载页面获取内含镜像 Image 的 ZIP 压缩包（如 openEuler-24.03-LTS-SP1-riscv64-sg2042.img.zip），并将其直接烧录至 SD Card 或 固态硬盘 中即可。
设备固件
因设备出厂固件目前并未支持
UEFI，ISO版本使用者需先手动替换固件为基于EDK2的UEFI版固件。
从官网下载页面 嵌入式分类 中下载设备固件压缩包：sg2042_firmware_uefi.zip，解压后烧录其中 img 文件至 SD Card
~$ sudo dd if=firmware_single_sg2042-master.img of=/dev/sda bs=512K iflag=fullblock oflag=direct conv=fsync status=progress
261619712 字节 (262 MB，250 MiB) 已复制，20 s，13.1 MB/s 268435456 字节 (268 MB，256 MiB) 已复制，20.561 s，13.1 MB/s
输入了 512+0 块记录
输出了 512+0 块记录
268435456 字节 (268 MB，256 MiB) 已复制，20.5611 s，13.1 MB/s因设备出厂固件版本较老，Image 镜像使用者如果想要使用较新版本的固件，可以更新非 UEFI 版固件。
从官网下载页面 嵌入式分类 中下载设备固件压缩包：sg2042_firmware_uboot.zip，参考 UEFI 版固件的操作，解压后烧录其中 img 文件至 SD Card。
烧录完成后，请将 SD Card 插入设备的卡槽中。
启动前检查
ISO 版本使用者需检查：
载有
UEFI版固件的microSD 卡是否插入设备卡槽中。UEFI版固件目前尚无法手动调整或指定启动顺序，敬请谅解。如使用设备原厂附送固态硬盘，或硬盘上存在另一可启动的
RISC-V操作系统，则需卸下固态硬盘进行格式化或更换内容为空的另一块固态硬盘，以避免启动顺序上的干涉。
Image 版本需检查：
- 如使用设备原厂附送固态硬盘，或硬盘上存在另一可启动的
RISC-V操作系统，则需卸下固态硬盘进行格式化或更换内容为空的另一块固态硬盘，以避免启动顺序上的干涉。
使用须知
ISO 版本使用者：
- 由于当前版本
UEFI固件的局限性，启动时若显卡插入PCIe槽位，Grub2启动菜单可能需要花费较长时间 (~15s) 才能加载完成且响应较为迟缓。
Image 版本使用者：
- 由于当前出厂固件的局限性，设备启动时
RISC-V串口回显并不完整，操作系统未加载完成时串口输出即会关闭。需将显卡插入PCIe槽位并连接显示器才能观察到完整的启动过程。
遵循 木兰宽松许可证第2版（MulanPSL2）
