长期支持版本

    社区创新版本

      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 电口网卡。

      设备出厂未附送 WiFi 网卡,不具备 WiFi 或蓝牙连接能力。如有需要请自备对应设备。

      镜像种类

      ISO

      ISO 镜像支持 UEFI 方式启动,对应下文的 UEFI 版固件。

      从官网下载页面获取 ISO 文件(如 openEuler-24.03-LTS-riscv64-dvd.iso),并将其烧录至 U盘 中即可。

      • 推荐使用 Balena Etcher 软件进行图形化烧录 [从 https://github.com/balena-io/etcher/releases/latest 下载],烧写过程此处略过
      • 命令行环境下也可采用 dd 方式进行烧录,参考命令如下:
      ~$ sudo dd if=openEuler-24.03-LTS-riscv64-dvd.iso of=/dev/sda bs=512K iflag=fullblock oflag=direct conv=fsync status=progress 
      

      Image

      Image 镜像支持 Legacy 方式启动,对应下文的非 UEFI 版固件

      从官网下载页面获取内含镜像 ImageZip 压缩包(如 openEuler-24.03-LTS-riscv64-sg2042.img.zip),并将其直接烧录至 SDCARD固态硬盘 中即可。

      设备固件

      因设备出厂固件目前并未支持 UEFIISO 版本使用者需先手动替换固件为基于 EDK2UEFI 版固件。

      从官网下载页面 嵌入式分类 中下载设备固件压缩包:sg2042_firmware_uefi.zip,解压后烧录其中 img 文件至 SDCARD

      ~$ 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/s268435456 字节 (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 文件至 SDCARD

      烧录完成后,请将 SDCARD 插入设备的卡槽中。

      启动前检查

      ISO 版本使用者需检查:

      • 载有 UEFI 版固件的 microSD 卡是否插入设备卡槽中。

        UEFI 版固件目前尚无法手动调整或指定启动顺序,敬请谅解。

      • 如使用设备原厂附送固态硬盘,或硬盘上存在另一可启动的 RISC-V 操作系统,则需卸下固态硬盘进行格式化或更换内容为空的另一块固态硬盘,以避免启动顺序上的干涉。

      Image 版本需检查:

      • 如使用设备原厂附送固态硬盘,或硬盘上存在另一可启动的 RISC-V 操作系统,则需卸下固态硬盘进行格式化或更换内容为空的另一块固态硬盘,以避免启动顺序上的干涉。

      使用须知

      ISO 版本使用者:

      • 由于当前版本 UEFI 固件的局限性,启动时若显卡插入 PCIe 槽位,Grub2 启动菜单可能需要花费较长时间 (~15s) 才能加载完成且响应较为迟缓。

      Image 版本使用者:

      • 由于当前出厂固件的局限性,设备启动时 RISC-V 串口回显并不完整,操作系统未加载完成时串口输出即会关闭。需将显卡插入 PCIe 槽位并连接显示器才能观察到完整的启动过程。

      文档捉虫

      “有虫”文档片段

      问题描述

      提交类型 issue

      有点复杂...

      找人问问吧。

      PR

      小问题,全程线上修改...

      一键搞定!

      问题类型
      规范和低错类

      ● 错别字或拼写错误;标点符号使用错误;

      ● 链接错误、空单元格、格式错误;

      ● 英文中包含中文字符;

      ● 界面和描述不一致,但不影响操作;

      ● 表述不通顺,但不影响理解;

      ● 版本号不匹配:如软件包名称、界面版本号;

      易用性

      ● 关键步骤错误或缺失,无法指导用户完成任务;

      ● 缺少必要的前提条件、注意事项等;

      ● 图形、表格、文字等晦涩难懂;

      ● 逻辑不清晰,该分类、分项、分步骤的没有给出;

      正确性

      ● 技术原理、功能、规格等描述和软件不一致,存在错误;

      ● 原理图、架构图等存在错误;

      ● 命令、命令参数等错误;

      ● 代码片段错误;

      ● 命令无法完成对应功能;

      ● 界面错误,无法指导操作;

      风险提示

      ● 对重要数据或系统存在风险的操作,缺少安全提示;

      内容合规

      ● 违反法律法规,涉及政治、领土主权等敏感词;

      ● 内容侵权;

      您对文档的总体满意度

      非常不满意
      非常满意
      提交
      根据您的反馈,会自动生成issue模板。您只需点击按钮,创建issue即可。
      文档捉虫
      编组 3备份