长期支持版本

    社区创新版本

      在 Licheepi4A 上安装

      硬件准备

      • Sipeed LicheePi 4A 设备 1 台(8 GB16 GB 款均可)

      • 显示器一台

      • USB 键盘及鼠标一套

      • 串口操作所需设备/组件(可选)

      • RJ45 网线 1 条以上及路由器/交换机等设备供有线网络连接使用

      设备固件

      LicheePi4A 不同内存版本需要使用不同的固件。

      • u-boot-with-spl-lpi4a.bin 为 8 GB 版本的 u-boot 文件。
      • u-boot-with-spl-lpi4a-16g.bin 为 16 GB 版本的 u-boot 文件。

      以下的烧录方式以 16GB + 128GB 核心板为例,假设你已经下载好了 base 镜像和对应的固件文件。

      烧录方法

      烧录工具

      主要利用 fastboot 烧录,可以从 https://dl.sipeed.com/shareURL/LICHEE/licheepi4a/07_Tools 下载 burn_tools.zip,压缩包内包含了针对 Windows/macOS/Linux 三个系统的烧录工具。

      设置硬件进入烧录模式

      请先注意检查底板的拨码开关是否为 EMMC 启动模式,在确认无误之后即可烧录。

      按住板上的 BOOT 按键不放,然后插入 USB-C 线缆上电(线缆另一头接 PC ),即可进入 USB 烧录模式。

      Windows 下使用设备管理器查看,会出现 USB download gadget 设备。

      Linux 下,使用 lsusb 查看设备,会显示以下设备: ID 2345:7654 T-HEAD USB download gadget

      Windows 下驱动安装

      注意:

      我们提供下载的镜像内并未包含 Windows 侧的驱动程序。你可以从这里下载 burn_tools.zip,在压缩包内找到 windows/usb_driver-fullmask 的文件夹,这个文件夹内的文件是 Windows 系统下需要安装的驱动。

      Windows 下烧录时,需要先进入高级启动模式,禁用数字签名。才能正常安装下面的驱动。禁用数字签名请按照下面的步骤操作。

      Windows 10

      1. 进入 Windows 10 的设置,点击"更新和安全"。
      2. 点击左侧的恢复,之后在右边点击高级启动下面的重新启动,此时电脑会重新启动。如果当前有未完成的工作,请先保存后再执行。

      Windows 11

      1. 进入 Windows 11 的设置,找到系统菜单之后,点击恢复

      2. 之后在右边点击高级启动下面的"重新启动",此时电脑会重新启动。如果当前有未完成的工作,请先保存后再执行。

      重启之后
      1. 点击疑难解答,然后点击高级 -> 启动设置,随后系统将再次重启。

      2. 重启之后会进入启动设置,在这里我们需要选择禁用强制驱动程序签名。通常这个选项为数字 7,但实际可能有变。在按下对应选项的数字后,系统会再次重新启动。

      3. 在重启进入系统之后,我们可以开始安装驱动了。打开设备管理器,找到其它设备内的 USB download gadget,双击该设备。

      4. 点击常规选项卡下方的更新驱动程序

      5. 随后,在浏览计算机上的驱动程序页面粘贴你复制的 usb_driver-fullmask 目录的路径。

      6. 点击下一步,此时驱动可以被安装成功。

      烧录镜像

      进入烧录模式后,我们就可以使用 fastboot 进行烧录操作,在 macOS 或者 Linux 下,若 fastboot 为自行安装的,则你可能需要先赋予 fastboot 可执行权限。

      Windows 系统步骤

      请先将 fastboot 添加至系统环境变量 PATH 内,或者将 fastboot 放置于同一目录下。不要忘记将镜像也解压。随后打开 PowerShell,执行以下命令:

      # 将这里的文件替换成跟板子版本对应的 u-boot 文件 
      fastboot flash ram u-boot-with-spl-lpi4a-16g.bin
      fastboot reboot
      # 在执行重启命令之后,等待 5 秒钟后继续执行
      # 将这里的文件替换成跟板子版本对应的 u-boot 文件
      fastboot flash uboot u-boot-with-spl-lpi4a-16g.bin
      fastboot flash boot openEuler-24.03-LTS-riscv64-lpi4a-base-boot.ext4
      fastboot flash root openEuler-24.03-LTS-riscv64-lpi4a-base-root.ext4
      

      Linux/macOS 系统步骤

      你可能需要在 fastboot 指令前加入 sudo 指令。

      # 将这里的文件替换成跟板子版本对应的 u-boot 文件 
      fastboot flash ram u-boot-with-spl-lpi4a-16g.bin
      fastboot reboot
      # 在执行重启命令之后,等待 5 秒钟后继续执行
      # 将这里的文件替换成跟板子版本对应的 u-boot 文件
      fastboot flash uboot u-boot-with-spl-lpi4a-16g.bin
      fastboot flash boot openEuler-24.03-LTS-riscv64-lpi4a-base-boot.ext4
      fastboot flash root openEuler-24.03-LTS-riscv64-lpi4a-base-root.ext4
      

      硬件可用性

      官方发布版本基于 openEuler kernel6.6 同源版本构建,并非所有内核模块都完整支持。该版本强调官方生态体验完整一致,如果需要更完善的硬件功能,需要使用第三方发布版本。

      文档捉虫

      “有虫”文档片段

      问题描述

      提交类型 issue

      有点复杂...

      找人问问吧。

      PR

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

      一键搞定!

      问题类型
      规范和低错类

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

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

      ● 英文中包含中文字符;

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

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

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

      易用性

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

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

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

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

      正确性

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

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

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

      ● 代码片段错误;

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

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

      风险提示

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

      内容合规

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

      ● 内容侵权;

      您对文档的总体满意度

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