[触觉智能RK3568]指定单个OpenHarmony镜像进行独立编译

头像
离北况归
     江苏
    阅读 9 分钟

    一、OpenHarmony master最新分支提供支持独立编译镜像的功能

    • OpenHarmony master最新分支提供支持独立编译镜像的功能。支持独立编译的镜像有
      chip_prod.img、sys_prod.img、system.img、usedata.img、vendor.img、ramdisk.img、updater.img。

      • 例如./build.sh --product-name rk3568 --ccache --build-target system_image可以单独编译出system.img镜像

    • OpenHarmony Beta4和5编译构建过程中，只可以在编译命令./build.sh --product-name rk3568 --ccache指定--build-target images或者--build-target make_images对所有镜像进行编译。无法通过指定单个镜像进行独立编译，同时单个镜像与platform关联，无法直接指定单个镜像的名称。

      out/rk3568/packages/phone/images下镜像文件：MiniLoaderAll.bin boot_linux.img chip_prod.img config.cfg parameter.txt ramdisk.img resource.img sys_prod.img system.img uboot.img updater.img userdata.img vendor.img

    二、修改OpenHarmonyBeta4源码新增独立编译镜像的功能

    • 1、在OpenHarmonyBeta4源码build/ohos/images/BUILD.gn第48行添加如下内容

      group("chip_prod_image") {
deps = []
if (is_standard_system) {
  deps += [
    "//third_party/e2fsprogs:e2fsprogs_host_toolchain",
    "//third_party/f2fs-tools:f2fs-tools_host_toolchain",
  ]
}
foreach(_platform, target_platform_list) {
  deps += [ ":${_platform}_chip_prod_image" ]
}
}

group("sys_prod_image") {
deps = []
if (is_standard_system) {
  deps += [
    "//third_party/e2fsprogs:e2fsprogs_host_toolchain",
    "//third_party/f2fs-tools:f2fs-tools_host_toolchain",
  ]
}
foreach(_platform, target_platform_list) {
  deps += [ ":${_platform}_sys_prod_image" ]
}
}

group("system_image") {
deps = []
if (is_standard_system) {
  deps += [
    "//third_party/e2fsprogs:e2fsprogs_host_toolchain",
    "//third_party/f2fs-tools:f2fs-tools_host_toolchain",
  ]
}
foreach(_platform, target_platform_list) {
  deps += [ ":${_platform}_system_image" ]
}
}

group("userdata_image") {
deps = []
if (is_standard_system) {
  deps += [
    "//third_party/e2fsprogs:e2fsprogs_host_toolchain",
    "//third_party/f2fs-tools:f2fs-tools_host_toolchain",
  ]
}
foreach(_platform, target_platform_list) {
  deps += [ ":${_platform}_userdata_image" ]
}
}

group("vendor_image") {
deps = []
if (is_standard_system) {
  deps += [
    "//third_party/e2fsprogs:e2fsprogs_host_toolchain",
    "//third_party/f2fs-tools:f2fs-tools_host_toolchain",
  ]
}
foreach(_platform, target_platform_list) {
  deps += [ ":${_platform}_vendor_image" ]
}
}

group("ramdisk_image") {
deps = []
if (is_standard_system) {
  deps += [
    "//third_party/e2fsprogs:e2fsprogs_host_toolchain",
    "//third_party/f2fs-tools:f2fs-tools_host_toolchain",
  ]
}
foreach(_platform, target_platform_list) {
  if (enable_ramdisk) {
    deps += [ ":${_platform}_ramdisk_image" ]
  }
}
}

group("updater_ramdisk_image") {
deps = []
if (is_standard_system) {
  deps += [
    "//third_party/e2fsprogs:e2fsprogs_host_toolchain",
    "//third_party/f2fs-tools:f2fs-tools_host_toolchain",
  ]
}
foreach(_platform, target_platform_list) {
  if (enable_ramdisk) {
    deps += [ ":${_platform}_updater_ramdisk_image" ]
  }
}
}

group("updater_image") {
deps = []
if (is_standard_system) {
  deps += [
    "//third_party/e2fsprogs:e2fsprogs_host_toolchain",
    "//third_party/f2fs-tools:f2fs-tools_host_toolchain",
  ]
}
foreach(_platform, target_platform_list) {
  if (!enable_ramdisk) {
    deps += [ ":${_platform}_updater_image" ]
  }
}
}
    • 2、镜像单独编译前需要执行一次全量编译./build.sh --product-name rk3568 --ccache生成全部镜像

    • 3、然后在./build.sh --product-name rk3568 --ccache 后指定--build-target chip_prod_image、sys_prod_image、system_image、userdata_image、vendor_image、updater_image/updater_ramdisk_image、ramdisk_image分别生成对应的单独镜像

      • --build-target updater_ramdisk_image是编译出ramdisk类型的updater.img

      • --build-target updater_image是编译出非ramdisk类型的updater.img

        • 目前Beta5版本的仍然可以选择编译非ramdisk类型和ramdisk类型的updater.img，但是最新分支master版本updater与enable_ramdisk 不再关联，都编译ramdisk类型的updater.img镜像，相关issue：南向适配，归一化一级二级启动

    例如执行./build.sh --product-name rk3568 --ccache --build-target updater_image生成非ramdisk类型的updater.img

    image.png

    image.png

    三、修改OpenHarmonyBeta5源码新增独立编译镜像的功能

    • OpenHarmonyBeta5 已经支持单独编译 多产品各自的chipprod镜像，且前面提到目前Beta5版本的仍然可以选择编译非ramdisk类型和ramdisk类型的updater.img

      • 所以和OpenHarmonyBeta4中添加的代码不同，Beta5不需要添加group("chip_prod_image")的部分

    • 1、在OpenHarmonyBeta5源码build/ohos/images/BUILD.gn第48行添加如下内容

      group("sys_prod_image") {
deps = []
if (is_standard_system) {
  deps += [
    "//third_party/e2fsprogs:e2fsprogs_host_toolchain",
    "//third_party/f2fs-tools:f2fs-tools_host_toolchain",
  ]
}
foreach(_platform, target_platform_list) {
  deps += [ ":${_platform}_sys_prod_image" ]
}
}

group("system_image") {
deps = []
if (is_standard_system) {
  deps += [
    "//third_party/e2fsprogs:e2fsprogs_host_toolchain",
    "//third_party/f2fs-tools:f2fs-tools_host_toolchain",
  ]
}
foreach(_platform, target_platform_list) {
  deps += [ ":${_platform}_system_image" ]
}
}

group("userdata_image") {
deps = []
if (is_standard_system) {
  deps += [
    "//third_party/e2fsprogs:e2fsprogs_host_toolchain",
    "//third_party/f2fs-tools:f2fs-tools_host_toolchain",
  ]
}
foreach(_platform, target_platform_list) {
  deps += [ ":${_platform}_userdata_image" ]
}
}

group("vendor_image") {
deps = []
if (is_standard_system) {
  deps += [
    "//third_party/e2fsprogs:e2fsprogs_host_toolchain",
    "//third_party/f2fs-tools:f2fs-tools_host_toolchain",
  ]
}
foreach(_platform, target_platform_list) {
  deps += [ ":${_platform}_vendor_image" ]
}
}

group("ramdisk_image") {
deps = []
if (is_standard_system) {
  deps += [
    "//third_party/e2fsprogs:e2fsprogs_host_toolchain",
    "//third_party/f2fs-tools:f2fs-tools_host_toolchain",
  ]
}
foreach(_platform, target_platform_list) {
  if (enable_ramdisk) {
    deps += [ ":${_platform}_ramdisk_image" ]
  }
}
}

group("updater_ramdisk_image") {
deps = []
if (is_standard_system) {
  deps += [
    "//third_party/e2fsprogs:e2fsprogs_host_toolchain",
    "//third_party/f2fs-tools:f2fs-tools_host_toolchain",
  ]
}
foreach(_platform, target_platform_list) {
  if (enable_ramdisk) {
    deps += [ ":${_platform}_updater_ramdisk_image" ]
  }
}
}

group("updater_image") {
deps = []
if (is_standard_system) {
  deps += [
    "//third_party/e2fsprogs:e2fsprogs_host_toolchain",
    "//third_party/f2fs-tools:f2fs-tools_host_toolchain",
  ]
}
foreach(_platform, target_platform_list) {
  if (!enable_ramdisk) {
    deps += [ ":${_platform}_updater_image" ]
  }
}
}
    • 3、镜像单独编译前同样需要执行一次全量编译生成全部镜像
    • 4、然后在./build.sh --product-name rk3568 --ccache 后指定--build-target chip_prod_image、sys_prod_image、system_image、userdata_image、vendor_image、updater_image/updater_ramdisk_image、ramdisk_image分别生成对应的单独镜像

    四、指定userdata.img镜像进行独立编译并且刷入触觉智能RK3568

    • 1、笔者基于OpenHarmony Beta5源码如上述步骤修改源码后执行./build.sh --product-name rk3568 --ccache --build-target userdata_image单独编译生成userdata.img

    • 2、触觉智能rk3568这款开发板镜像链接如下

      链接：https://pan.baidu.com/s/1JXEBH9CQb4ruzOGz1prrjA?pwd=1234 
提取码：1234
    • 3、解压触觉智能rk3568开发板镜像后替换userdata.img，将完整镜像刷入开发板

    image.png

    • 4、烧录完毕，系统正常启动。

    知识点附送

    如何更改OpenHarmony版本信息、SDK和NDK版本信息

    • 源码目录下/sources/build/version.gni文件是OpenHarmony版本信息、SDK和NDK版本信息，要修改版本信息只需要在这个文件修改就好了

    • 例如，Beta5的版本信息如下

      # OHOS version
declare_args() {
sdk_version = "3.2.10.6"
api_version = "9"

# Release type, optional values: Betax, RCx...
release_type = "Beta5"
meta_version = "3.0.0"
}

# ohos SDK version
declare_args() {
current_sdk_version = sdk_version
}

# ohos NDK version
declare_args() {
current_ndk_version = current_sdk_version
}

    改变一个镜像文件的名称需要做哪些工作

    • 以该issues为参考 https://gitee.com/openharmony... 学习将vendor.img改为chipset.img，其实只要把vendor字符全部替换成chipset。通过这个issue可以知道vendor.img涉及到源码中哪些文件

    关于 --build-target

    • build-target 是传给ninja的参数，out/rk3568/build.ninja里面的任务都可以。

      • 1、gn里面的一个target都可以，包括可执行程序，动态库，group，action，部件名
      • 2、如果直接指定名称报unkonw target的话，可能是重名等原因，按照gn的全名称指定：{目标所在BUILD.gn的路径}:{目标名}， 比如： --build-target commonlibrary/c_utils/base:utils
      • 3、build-target参数一次可以指定多，比如：--build-target A --build-target B
      • 4、subsystem_name不是编译目标
      • 5、部件名是一个特殊的目标，根据ohos.build编译系统生产的gn目标，如果直接指定部件名，使用--build-target {部件名} 报错unkonw target，可以使用一个部件的全名称指定：--build-target out/{device_name}/build_configs/{subsystem_name}/{part_name}:{part_name}
    编译流程主要分为：preloader->loader->gn->ninja这四个过程

    如何修改分区文件系统类型由ext4为f2fs

    以该issues为例学习将修改/data分区文件系统由ext4为f2fs。

    • 1、修改镜像文件打包描述文件
      每个系统镜像文件都是由一个image_conf.txt描述文件来描述。将镜像文件系统类型由ext4改为f2fs。userdata.img 由build/ohos/images/mkimage/userdata_image_conf.txt描述。在其中
      将--fs_type=ext4改为--fs_type=f2fs
    • 2、在rk3568标准系统的defconfig文件中打开prjquota 使能开关，在源码目录在kernel/linux/config/linux-5.10/arch/arm64/configs/rk3568_standard_defconfig中第5945行中# CONFIG_QUOTA is not set改为CONFIG_QUOTA=y
    • 3、修改具体设备的fstab文件（这里修改的是rk3568的fstab文件,位于/device/board/hihope/rk3568/cfg/fstab.rk3568）中修改分区的文件系统类型、mnt_flags and options和fs_mgr_flags参数

    image.png

    fstab文件：启动的时候，系统会自动地从这个文件读取信息，并且会自动将此文件中指定的文件系统挂载到指定的目录image.png

    修改镜像打包的配置参数调整分区大小

    • 以该issue为例学习将rk3568 updater分区从20MB调整为30MB。
    • 1、如果要修改某个镜像的打包参数，只需要修改//build/ohos/images/mkimage目录下对应的{镜像名}_image_config.txt文件即可。
    • 2、在ramdisk类型的updater.img对应的描述文件build/ohos/images/mkimage/updater_ramdisk_image_conf.txt第二行将20971520KB改为33554432KB。
    openharmony
    离北况归
    7 声望4 粉丝

    OpenHarmony啃论文俱乐部PIMF团队。 位于南京一学生，可私信。

    « 上一篇
    [触觉智能RK3568使用体验]NAPI 类对象导出及其生命周期管理(上)
    下一篇 »
    【OpenHarmony设备开发】修改屏幕 DPI(像素密度)

    引用和评论

    推荐阅读
    头像
    [触觉智能RK3568使用体验]NAPI 类对象导出及其生命周期管理(下)

    离北况归阅读 947

    头像
    飞凌嵌入式受邀亮相OpenHarmony人才生态大会2024

    王三金阅读 297

    头像
    【HarmonyOS NEXT】ArkTS 线程模型解析与使用

    冉冉同学阅读 126

    0 条评论
    得票最新