K1_OH6.1下载编译烧录说明

修订记录

修订版本	修订日期	修订说明
001	2026-04-23	初始版本

1. 环境准备

1.1. Ubuntu 环境（推荐 Ubuntu22.04，其他版本暂未验证）

执行以下命令安装依赖：

sudo apt-get update

sudo apt-get install binutils git git-lfs gnupg gperf build-essential zip curl zlib1g-dev gcc-multilib lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z1-dev libxml2-utils xsltproc unzip m4 bc gnutls-bin python3-pip ruby ccache libgl1-mesa-dev g++-multilib libc6-dev-i386 flex bison openjdk-19-jdk openssl libelf-dev lz4 genext2fs libncurses5 libssl-dev u-boot-tools dosfstools mtools libstdc++-12-dev repo python2 cpio nodejs npm default-jdk mtd-utils scons gcc-arm-none-eabi

1.2. 安装 make_exf4fs（如果已安装，请忽略）

下载 bin.zip 工具包（点我下载）并解压至服务器指定目录。
在 ~/.bashrc 文件中添加工具路径：
```
export PATH=$PATH:~/WorkSpace/bin
```

执行 make_ext4fs 验证安装，若显示以下提示，说明安装成功：

fuqiang@snode2:~/workspace/oh6$ make_ext4fs
Expected filename after options
make_ext4fs [ -l <len> ] [ -j <journal size> ] [ -b <block_size> ]
    [ -g <blocks per group> ] [ -i <inodes> ] [ -I <inode size> ]
    [ -L <label> ] [ -f ] [ -a <android mountpoint> ]
    [ -S file_contexts ] [ -C fs_config ] [ -T timestamp ]
    [ -z | -s ] [ -w ] [ -c ] [ -J ] [ -o ] [ -v ] [ -B <block_list_file> ]
    <filename> [<directory>]

2. 源码准备

2.1. 访问如意社区

代码仓托管于如意社区（代码仓库路径）中，下载代码需要进行如下准备：

注册并登录如意社区账号（若无如意社区账号）
将本地主机的 SSH 公钥添加到如意社区账户（路径：“偏好设置” → “SSH Keys”）
创建个人访问令牌，有部分仓库需要令牌才能下载，

2.2. 下载源码

mkdir oh61
cd oh61
repo init -u git@code.ruyicommunity.cn:risc-verse/ruyi-desktop-os/manifest.git -b OpenHarmony-v6.1-Release-RISC-V --no-repo-verify
## 如果repo init过程中下载repo失败（概率出现过），使用国内源
## 后面添加参数 --repo-url=https://gerrit-googlesource.lug.ustc.edu.cn/git-repo
 
repo sync -c -j4 --retry-fetches=100 --fail-fast
## 2-3小时左右
## 出现报错及时处理

repo forall -c 'git lfs pull'
## 拉一些大文件，haps，音视频等，1-2小时左右
## 如果对源码不熟悉，建议每次repo sync后，都执行此命令

repo start OpenHarmony-v6.1-Release-RISC-V --all

下载完成后的目录结构如下：

fuqiang@snode2:~/workspace/oh61/oh61_r_release$ tree -L 1
.
|-- applications
|-- arkcompiler
|-- base
|-- build
|-- build.py -> build/build_scripts/build.py
|-- build.sh -> build/build_scripts/build.sh
|-- commonlibrary
|-- developtools
|-- device
|-- docs
|-- domains
|-- drivers
|-- foundation
|-- ide
|-- interface
|-- kernel
|-- napi_generator
|-- oh_venv
|-- out
|-- prebuilts
|-- productdefine
|-- qemu-run -> vendor/ohemu/common/qemu-run
|-- test
|-- third_party
`-- vendor

22 directories, 3 files

2.3. 安装编译器

在源码根目录下执行以下脚本，安装编译器及二进制工具。

cd oh61
bash build/prebuilts_download.sh

下载的文件默认存放在与 OpenHarmony 同目录下的 openharmony_prebuilts 下。

fuqiang@snode2:~/workspace/oh61$ tree -L 1
.
|-- oh61_r_release
`-- openharmony_prebuilts

2 directories, 0 files

openharmony_prebuilts 里面的内容如下：

fuqiang@snode2:~/workspace/oh61/openharmony_prebuilts$ ls -al
total 5875564
drwxr-xr-x 2 fuqiang dc-zh-apd-app1-users      4096 Apr 11 00:07 .
drwxr-xr-x 4 fuqiang dc-zh-apd-app1-users      4096 Apr 11 00:02 ..
-rw-r----- 1 fuqiang dc-zh-apd-app1-users 666931661 Apr 11 00:04 0c53737f631d9066e67e52e235b8001d.clang_windows-x86_64-feef13-20251209.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users 118696253 Apr 11 00:03 0c65e233a7c5b1ecf6585a38903cc52e.clang-mingw-20240510.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users    298786 Apr 11 00:02 1ad55caffc571c067e7748967b86f477.ninja-windows-x86-1.12.0-20240523.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  37434318 Apr 11 00:02 1d9cac0be980c9030ae8ace9c1c9c948.rust-std-nightly-x86_64-unknown-linux-ohos.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users    530721 Apr 11 00:02 20738011b324e100f6aab09353a7e7fa.bpftool_v5.10.93_20221114.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users 787632085 Apr 11 00:04 31a220188f127bc5ddb5120af3f40567.clang_linux-x86_64-feef13-20251209.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users   9012065 Apr 11 00:02 3a809a26c729112318dbf63a52e674a5.python-linux-x86-GLIBC2.35-3.11.4_20251107.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  71384139 Apr 11 00:02 3cd635b2e65395d32595fa7db326f4e5.libcxx-ndk_linux-x86_64-feef13-20251209.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  35031005 Apr 11 00:02 44f2993d118ed3cefe4792a2fd62547f.node-v14.21.1-linux-x64.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  71381052 Apr 11 00:02 45e5679a4dbf25be778cccb5ba1566a7.libcxx_ndk_ohos-arm64-feef13-20251209.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users   5302793 Apr 11 00:02 48e90aacf221fa3b7b30a9f67f898d4a.packing_tool_libs_20260129.zip
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  32430467 Apr 11 00:02 5084e36f83c59ea4aa08675172857d08.rust-std-nightly-armv7-unknown-linux-ohos.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users 194623101 Apr 11 00:03 59325cdd5538f70910f66328acedea7d.prebuilts_gcc_linux-x86_arm_gcc-linaro-7.5.0-arm-linux-gnueabi.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users 335994880 Apr 11 00:08 5b91aae49e9ac9ca2471ea5fddfcc8a2.command-line-tools.tar
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  99758853 Apr 11 00:03 61b48b0d64d7692c1254d22b97dc06f6.rust-nightly-x86_64-unknown-linux-gnu.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users   6649961 Apr 11 00:02 65887c3114071af35157ce536b625ef9.python-mingw-x86-3.11.4_20251107.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users 329772635 Apr 11 00:07 6a4909fc4262070aea24465c9a3aabc4.ark_js_prebuilts_20230713.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  71381731 Apr 11 00:02 6e50d643b5d0b1656bb136223c179084.libcxx-ndk_windows-x86_64-feef13-20251209.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users 572079732 Apr 11 00:03 74bedcabb1a88f3e12bc6356eed4023f.cangjie-linux-x64-1.1.0-alpha.66-hwasan.zip
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  15699808 Apr 11 00:02 7c11e64dfa76a531a02bf4683342b5de.llvm-15.0.4-ark18-release-aarch64.tar.xz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users   3980846 Apr 11 00:02 822e2159e4f9dc82b6b3f6d158a1fdd0.cangjie-api-tools-1.1.0-alpha.66.zip
-rw-r----- 1 fuqiang dc-zh-apd-app1-users 562077952 Apr 11 00:03 87865ae7a3214ca6ba4e08f8abf00db6.cangjie-linux-x64-1.1.0-alpha.66.zip
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  28246064 Apr 11 00:02 915d0b40868587b71043eda64318ca4a.llvm-15.0.4-ark18-debug-x86_64.tar.xz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  44343888 Apr 11 00:02 9a42f763a78e35ac85f11241a4b8b631.node-v18.20.1-linux-x64.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  52840113 Apr 11 00:02 9b1ca53ad98ebfaa0fbfa26d20d534df.cmake-linux-x86-3.28.2.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  18509664 Apr 11 00:02 9e93cc8ab027a6a1bdf539c6c1072b52.taihe-linux-x86_64-1.3.1-20260120.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  15005708 Apr 11 00:02 a2239e0c72b12af0076f4eebffde3ffc.llvm-15.0.4-ark18-release-ohos-gn_20250306.tar.xz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  14159960 Apr 11 00:02 ae6e51d45cdf0e95aad4a529d43b6ca8.llvm-15.0.4-ark18-release-ohos.tar.xz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  12397424 Apr 11 00:02 ae867132e2a2bdbbae5b58aa89eb883e.pahole_v1.21_20221124.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  36182712 Apr 11 00:07 bbc64c11f71c0c4a42239e5a5dc478c0.rust-std-nightly-aarch64-unknown-linux-ohos.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  13870107 Apr 11 00:02 be58b2c455b3cfa97b8aa07c1b24942e.taihe-windows-x86_64-1.3.1-20260120.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users   8977140 Apr 11 00:02 be83a54d64aae51286009fb532aa997f.python-linux-arm64-3.11.4_20240715.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users   1184356 Apr 11 00:02 cb03ae812e574586b54ce5af5bb43b4f.gn-linux-x86-20260122.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users 117896452 Apr 11 00:03 cd98ff85e2af3869cf318497e6a1d559.gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu.tar.xz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  25790324 Apr 11 00:02 d5688b62b9da1c78c621e7277620d1c9.llvm-15.0.4-ark18-debug-aarch64.tar.xz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  15135801 Apr 11 00:07 d699eb29e0a9c9febb2b13bb779c1ebb.cmake-ohos-3.28.2-20240827.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users 699392996 Apr 11 00:04 dea57ad91e78773553dddff479233fe2.clang_ohos-arm64-feef13-20251209.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users    128365 Apr 11 00:02 dfcaa71177f12992d9542b6c8e60d363.ninja-linux-x86-1.12.0-20240523.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users    270405 Apr 11 00:02 e0c9e1b221277cd431bc9dcba432c3e1.ninja-ohos-1.12.0-20240827.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users 551082885 Apr 11 00:04 e3edbae8598de27b4b3979b83a6c8b70.cangjie-windows-x64-1.1.0-alpha.66.zip
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  33784208 Apr 11 00:02 e778f29e95d22f8e3cb6e604936229dc.node-v16.20.2-linux-x64.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  39492529 Apr 11 00:02 ebe7c49b8fdbb8cebc06adb7fef9cb4b.cmake-windows-x86-3.28.2.tar.gz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users 206659072 Apr 11 00:03 f32370c3eb724ad7a6b2ce58e8604a03.command-line-tools.tar
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  18931400 Apr 11 00:02 f37dca93a7202ea9ae85160b20106156.llvm-15.0.4-ark18-release-x86_64.tar.xz
-rw-r----- 1 fuqiang dc-zh-apd-app1-users  34014641 Apr 11 00:02 f868615b69ef8c04d1bfa4f6ed91c9d5.rust-std-nightly-x86_64-pc-windows-gnullvm.tar.gz

3. 完整编译

3.1. 编译流程说明

进入源码根目录，执行以下命令进行版本编译。

cd oh61
./build.sh --product-name xxx --ccache --prebuilt-sdk

其中，xxx 代表产品方案，目前支持的产品方案包括：

deb1（内部研发用开发版）
musepaper（生态产品平板电脑 MUSE Paper，旧版硬件）
musepaper2（生态产品平板电脑 MUSE Paper，新版硬件，目前在售的都是新版硬件）
musepipro（生态产品新款开发板 MUSE Pi Pro）

示例：编译 MUSE Paper 新版硬件固件：

./build.sh --product-name musepaper2 --ccache --prebuilt-sdk

注意：报下面错误是正常现象，不影响下载：

Invalid clone.bundle file; ignoring.
Invalid clone.bundle file; ignoring.
Invalid clone.bundle file; ignoring.
Invalid clone.bundle file; ignoring.
Invalid clone.bundle file; ignoring.

3.2. 编译卡启动固件

暂未支持

3.3. MIPI-DSI vs HDMI

暂未支持

3.4. 常用构建参数说明

3.4.1. --fast-rebuild

./build.sh --product-name musepaper2 --ccache --no-prebuilt-sdk --fast-rebuild
## 编译流程主要分为四个阶段：preloader->loader->gn->ninja
## 如果本地 没有修改 gn 或产品配置相关文件，则使用参数 --fast-rebuild 时，
## 编译会 直接从 ninja 阶段开始，从而 显著减少编译时间。

3.4.2. --prebuilt-sdk

在执行完整编译前，建议 先编译 SDK。编译完成后，将生成的 SDK 拷贝到 目录：prebuilts/ohos-sdk。

build.sh 脚本支持通过参数 sdk_platform=xxx 来指定 SDK 的运行平台，包括：mac、win、linux、ohos、default。

注意：

当平台为 Linux 主机 时，default 表示 {windows, linux, ohos}。
当平台为 Mac 主机 时，default 表示 {mac}。

示例命令：

./build.sh --product-name xxx --ccache --prebuilt-sdk sdk_platform=default

如果后续 SDK 没有变化，或者 无需重新编译 SDK，可使用参数 --no-prebuilt-sdk，以 加快编译速度。

4. 生成可烧录镜像

执行：

./build/gen_zip.sh xxx

其中，xxx 代表产品方案，目前支持的产品方案包括：

deb1（内部研发用开发版）
musepaper（生态产品平板电脑 MUSE Paper，旧版硬件）
musepaper2（生态产品平板电脑 MUSE Paper，新版硬件）
musepipro（生态产品新款开发板 MUSE Pi Pro）

生成的可烧录的镜像路径：

out/xxx/packages/phone/images/openharmony-spacemit-xxx.zip

进入烧录模式后，可以通过进迭时空的烧录工具 TitanFlasher 烧录, 下面的章节详细说明。

5. 刷机

5.1. USB 刷机

参考 TitanFlasher 烧录工具点我查看的 “单机烧录” 章节

5.1.1. 进入烧录模式

5.1.1.1. MUSE Paper

方式一：按键进入

长按 POWER键 关机
按住 音量+键，同时按下 POWER键 开机
保持按住 音量+键 一段时间，即可进入刷机模式
使用顶部中间的 Type-C 接口连接 USB 线进行烧录

方式二：通过 hdc 命令进入

开机后，连接上 hdc
执行以下命令进入刷机模式：

hdc shell
reboot fastboot

使用顶部中间的 Type-C 接口连接 USB 线进行烧录
注意：hdc 调试口与烧录口不同。执行完命令后，需要切换到中间的 Type-C 接口进行烧录

方式三：通过串口命令进入

开机后，通过串口执行以下命令：

reboot fastboot

使用顶部中间的 Type-C 接口连接 USB 线进行烧录

5.1.1.2. MUSE Pi Pro

方式一：FDL + RST 组合进入

插入 Type-C 接口，开机
按住 FDL键，同时按下 RST键，进入刷机模式

方式二：FDL + 上电进入

插入 Type-C 接口，开机
按住 FDL 键 的同时上电，设备将自动进入刷机模式

方式三：通过 hdc 命令进入

插入 Type-C 接口，开机
连接上 hdc
执行以下命令进入刷机模式：

hdc shell
reboot fastboot

方式四：通过串口命令进入

插入 Type-C 接口，开机
通过串口执行以下命令：

reboot fastboot

5.2. 卡刷机

暂未支持

6. 单独编译模块

6.1. 单独编译内核

执行以下命令单独编译内核：

./build.sh --product-name xxx --ccache --prebuilt-sdk -T build_kernel

上面的 build_kernel 定义在 device/board/spacemit/xxx/kernel/BUILD.gn：

action("build_kernel") {
  script = "build_kernel.sh"
  sources = [ kernel_source_dir ]
  outputs = [ "$root_build_dir/packages/phone/images/Image" ]
  args = [
      rebase_path(kernel_build_script_dir,root_build_dir),
      rebase_path("$root_build_dir/../.."),
      rebase_path("$root_build_dir/packages/phone/images"),
      rebase_path(kernel_source_dir),
      rebase_path(kernel_build_script_dir),
      kernel_ramdisk,
      product_company,
      product_name,
  ]
}

源码及输出路径说明：

内核源码路径：kernel/linux/spacemit_kernel-6.6
out 目录下生成的 patching 后的内核源码路径：out/kernel/OBJ/xxx
编译生成的内核镜像路径：out/kernel/OBJ/xxx/arch/riscv/boot/Image.itb
编译生成的 dtb 文件路径在：out/kernel/OBJ/xxx/arch/riscv/boot/dts/spacemit/k1-x_xxx.dtb

生成的内核镜像和 dtb 文件会自动拷贝到 out/xxx/packages/phone/images/bootfs 目录中，并在打包脚本中一并打包进镜像文件。

6.1.1. 修改内核的 config

编译过内核后，会生成 out/kernel/OBJ/xxx/.config，这个是未改动的原始的配置。

进入 out/kernel/OBJ/xxx/ 目录下，执行命令进入图形化的配置页面，如下：
```
cd out/kernel/OBJ/xxx/
make ARCH=riscv menuconfig
```
修改完配置并退出图形界面后，执行命令保存配置，如下：
```
make ARCH=riscv savedefconfig
```
执行命令后，会生成 out/kernel/OBJ/xxx/defconfig，这个是修改生效后的 defconfig，将这个 defconfig 覆盖到原始目录下的 k1_defconfig 即可
```
cp defconfig ../../../../kernel/linux/spacemit_kernel-6.6/arch/riscv/configs/k1_defconfig
```
删除目录 out/kernel/OBJ/xxx/ 后，重新编译内核

6.2. 单独编译 HDF 适配层

以 display 模块为例，可通过以下命令单独编译：

./build.sh -product-name xxx --ccache --prebuilt-sdk -T display_composer_vendor

display 的适配代码在 device/soc/spacemit/k1/hardware/display，display_composer_vendor 的定义在 device/soc/spacemit/k1/hardware/display/BUILD.gn

ohos_shared_library("display_composer_vendor") {
  sources = [
    "src/display_device/drm_connector.cpp",
    "src/display_device/drm_crtc.cpp",
    "src/display_device/drm_device.cpp",
    ...

编译后生成的 .so 在：

-rwxr-x---+ 1 fuqiang dc-sw-users 181000 Jun  7 08:55 ./out/deb1/hdf/spacemit_products/libdisplay_composer_vendor.z.so

而下面文件夹中的 .so 不会自动更新，可通过对比时间戳或 MD5 值确认文件是否为最新版本。

-rwxr-x---+ 1 fuqiang dc-sw-users 180968 Jun  6 16:02 ./out/deb1/packages/phone/vendor/lib64/libdisplay_composer_vendor.z.so

生成的动态库可以通过 hdc 推送到机器中，方便调试，避免重新烧固件，命令如下：

D:\>hdc shell
# mount -o remount,rw /                #system分区可读写
# mount -o remount,rw /vendor          #vendor分区可读写
# exit

D:\>hdc file send xxx.so /vendor/lib64/
D:\>hdc shell
# reboot

6.3. 单独编译 SDK

使用以下命令单独编译 OpenHarmony SDK：

./build.py --product-name ohos-sdk --ccache=true --xcache=false --load-test-config=false --get-warning-list=false --stat-ccache=false --compute-overlap-rate=false --deps-guard=false --generate-ninja-trace=false --gn-args skip_generate_module_list_file=true sdk_platform=linux ndk_platform=linux use_cfi=false use_thin_lto=false enable_lto_O0=true sdk_check_flag=false enable_ndk_doxygen=false archive_ndk=false sdk_for_hap_build=true enable_archive_sdk=false enable_notice_collection=false enable_process_notice=false

说明:

通过更改 sdk_platform 和 ndk_platform 参数可以编译在不同 OS 运行的 SDK
编译完成后，NDK 输出位于 out/sdk/sdk-native

6.4. 快速编译

如果只想快速编译某个目标模块，可以使用 ninja 命令：

ninja -w dupbuild=warn -C out/xxx yyy -j8

# xxx表示方案名
# yyy表示构建目标

示例：编译 MUSEPaper 方案的 libomxvpu_dec 目标，命令如下：

ninja -w dupbuild=warn -C out/musepaper libomxvpu_dec -j8

7. FAQ

7.1. 编译报错相关

7.1.1. `make_ext4fs: command not found`

报错示例如下：

make: Leaving directory '/data/home2/duancheng/WorkSpace/oh5/out/kernel/OBJ/musepaper2'
../../device/board/spacemit/musepaper2/kernel/build_kernel.sh: line 129: make_ext4fs: command not found

解决方案：按照文档上面 1.2 章节的说明来安装 make_ext4fs

修订记录​

1. 环境准备​

1.1. Ubuntu 环境（推荐 Ubuntu22.04，其他版本暂未验证）​

1.2. 安装 make_exf4fs（如果已安装，请忽略）​

2. 源码准备​

2.1. 访问如意社区​

2.2. 下载源码​

2.3. 安装编译器​

3. 完整编译​

3.1. 编译流程说明​

3.2. 编译卡启动固件​

3.3. MIPI-DSI vs HDMI​

3.4. 常用构建参数说明​

3.4.1. --fast-rebuild​

3.4.2. --prebuilt-sdk​

4. 生成可烧录镜像​

5. 刷机​

5.1. USB 刷机​

5.1.1. 进入烧录模式​

5.1.1.1. MUSE Paper​

5.1.1.2. MUSE Pi Pro​

5.2. 卡刷机​

6. 单独编译模块​

6.1. 单独编译内核​

6.1.1. 修改内核的 config​

6.2. 单独编译 HDF 适配层​

6.3. 单独编译 SDK​

6.4. 快速编译​

7. FAQ​

7.1. 编译报错相关​

7.1.1. make_ext4fs: command not found​

修订记录

1. 环境准备

1.1. Ubuntu 环境（推荐 Ubuntu22.04，其他版本暂未验证）

1.2. 安装 make_exf4fs（如果已安装，请忽略）

2. 源码准备

2.1. 访问如意社区

2.2. 下载源码

2.3. 安装编译器

3. 完整编译

3.1. 编译流程说明

3.2. 编译卡启动固件

3.3. MIPI-DSI vs HDMI

3.4. 常用构建参数说明

3.4.1. --fast-rebuild

3.4.2. --prebuilt-sdk

4. 生成可烧录镜像

5. 刷机

5.1. USB 刷机

5.1.1. 进入烧录模式

5.1.1.1. MUSE Paper

5.1.1.2. MUSE Pi Pro

5.2. 卡刷机

6. 单独编译模块

6.1. 单独编译内核

6.1.1. 修改内核的 config

6.2. 单独编译 HDF 适配层

6.3. 单独编译 SDK

6.4. 快速编译

7. FAQ

7.1. 编译报错相关

7.1.1. `make_ext4fs: command not found`