将功能迁移到 Qualcomm Linux 2.0

​

分区布局

​

容器和编排更新

​

迁移设备树和设备树覆盖

FIT_DTB_COMPATIBLE[qcs6490-rb3gen2] = " \
   qcom,qcs5430-iot \
   qcom,qcs6490-iot \
"

 FIT_DTB_COMPATIBLE[qcs9100-ride] = " \
    qcom,qcs9100-qam \
    qcom,qcs9100v2-qam \
"

FIT_DTB_COMPATIBLE[qcs6490-rb3gen2+qcs6490-rb3gen2-vision-mezzanine] = " \
   qcom,qcs5430-iot-subtype2 \
   qcom,qcs6490-iot-subtype2 \
"

# This DT currently exist only as patches against linux-qcom-base recipe.
KERNEL_DEVICETREE:pn-linux-qcom-base = " \
                      qcom/qcs6490-rb3gen2.dtb \
                      "

KERNEL_DEVICETREE:pn-linux-qcom-custom = " \
                      qcom/qcs6490-addons-rb3gen2.dtb \
                      "

# Additional dtbo to overylay on top of kernel devicetree files
KERNEL_TECH_DTBOS[qcs6490-addons-rb3gen2] = " \
    qcm6490-graphics.dtbo qcm6490-wlan-rb3.dtbo \
    qcm6490-video.dtbo qcm6490-wlan-upstream.dtbo \
    qcm6490-camera-rb3.dtbo \
    "

KERNEL_DEVICETREE ?= " \
                      qcom/qcs6490-rb3gen2.dtb \
                      qcom/qcs6490-rb3gen2-industrial-mezzanine.dtbo \
                      qcom/qcs6490-rb3gen2-vision-mezzanine.dtbo \
                      "

# These DTs aren't upstreamed and currently exist only in linux-qcom kernels
LINUX_QCOM_KERNEL_DEVICETREE ?= " \
                      qcom/qcs6490-rb3gen2-vision-mezzanine-camx.dtbo \
                      "

FIT_DTB_COMPATIBLE[qcs6490-rb3gen2] = " \
    qcom,qcs5430-iot \
    qcom,qcs6490-iot \
    "
FIT_DTB_COMPATIBLE[qcs6490-rb3gen2+qcs6490-rb3gen2-industrial-mezzanine] = " \
    qcom,qcs5430-iot-subtype9 \
    qcom,qcs6490-iot-subtype9 \
    "
FIT_DTB_COMPATIBLE[qcs6490-rb3gen2+qcs6490-rb3gen2-vision-mezzanine] = " \
    qcom,qcs5430-iot-subtype2 \
    qcom,qcs6490-iot-subtype2 \
    "
FIT_DTB_COMPATIBLE[qcs6490-rb3gen2+qcs6490-rb3gen2-vision-mezzanine-camx] = " \
    qcom,qcs6490-iot-camx \
    qcom,qcs6490-iot-subtype2-camx \
    "

​

Qualcomm Linux 2.0 中的 UEFI 增强

configurations {
   conf-1 {
         description = "FDT Blob";
         fdt = "fdt-qcs6490-rb3gen2.dtb";
         compatible = "qcom,qcs6490-iot";
   };
   conf-2 {
         description = "FDT Blob";
         fdt = "fdt-qcs6490-rb3gen2.dtb", "fdt-qcs6490-rb3gen2-industrial-mezzanine.dtbo";
         compatible = "qcom,qcs6490-iot-subtype9";
   };
   conf-3 {
         description = "FDT Blob";
         fdt = "fdt-qcs6490-rb3gen2.dtb", "fdt-qcs6490-rb3gen2-vision-mezzanine.dtbo";
         compatible = "qcom,qcs6490-iot-subtype2";
   };
};

​

Qualcomm DTB 元数据概述

• 基于 FIT 的 DTB 打包/选择规范。
• qcom-metadata.dts 源文件,它被编译为元数据 DTB,供固件用于将硬件标识符匹配到 FIT 配置。

• 元数据定义源文件(qcom-metadata.dts),它将允许的 compatible 字符串后缀标记分组到节点中,例如 soc、soc-sku、board、board-subtype-*、softsku 和 oem。
• 参考 FIT ITS 模板(例如 qcom-fitimage.its 和 qcom-next-fitimage.its),其中每个配置声明以下内容:

  • 一个 compatible qcom,<soc>-<...suffixes...> 字符串
  • 要按顺序应用的基础 DTB 和可选覆盖

• 硬件 ID(芯片 ID/版本、CDT 板卡数据、检测到的存储、DDR 大小等)
• 编译后的元数据 DTB
• FIT 配置,以选择其 compatible 标记与元数据定义及硬件报告相匹配的配置

​

使用 qcom-dtb-metadata 的好处

• 标准容器和结构化选择
  • FIT 是一种成熟且广泛使用的格式。它支持在单个镜像中包含多个配置。
  • 该设计强制要求 compatible 字符串后缀必须在元数据中定义,防止在未更新规范的情况下使用不明标记。
• 构建时验证以防止不匹配
  • 执行构建时检查,以检测 FIT compatible 后缀与元数据定义之间的差异。
• 与多 DTB+DTBO 工作流兼容
  • Qualcomm DTB 元数据文档描述了基础 DTB+覆盖。即运行时覆盖参数(例如 CamX 和 EL2KVM),由于它们是运行时控制而非元数据定义的,因此检查脚本会对其进行特殊处理。
• Qualcomm 固件集成细节
  • 当前的 Qualcomm UEFI 固件仅支持外部 FIT。
    • mkimage -E -B 8(外部数据 + 8 字节对齐)
    • 硬编码的文件名要求:qclinux_fit.img

​

FIT 配置和元数据配对条目

• Compatible:qcom,<tokens...>
• 对 FDT 的引用:fdt-<board>.dtb(以及可选的覆盖)

• soc → msm-id:<chip-id chip-version>,带有芯片 ID/版本的位解释。
• soc-sku → msm-id:其中某些位表示封装 ID/代工厂 ID。
• board → board-id:带有类型、主版本和次版本的位定义。
• board-subtype-* → board-subtype:根据子类型类别(外设子类型、存储类型或内存大小)使用不同的位片段。
• oem → oem-id
• softsku → softsku-id

​

推荐的标记顺序(模式)

<soc>-<soc-sku>-<board>-<board-subtype-peripheral-subtype>-<board-subtype-storage-type>-<board-subtype-memory-size>-<softsku>-<oem>

​

添加 QCS9100 板卡变体

1. 使用仓库中建议的模式,选择您要用于该变体的标记(板卡修订版、存储、内存等)。
2. 对于您要在 compatible 字符串中使用的每个标记,确保在正确的组(soc、board、board-subtype-* 等)下存在相应的子节点。如果引入了新后缀,请将其添加到元数据中的相关节点下。
3. 在 conf/machine/include/fit-dtb-compatible.inc 中添加 FIT_DTB_COMPATIBLE["key"] 条目。
4. 使用构建命令,通过更新后的元数据 DTB 构建 FIT 镜像。
5. 为预期应用这些 FIT 更改的机器烧录 .qcomflash/ 目录。
6. 启动时,验证日志中显示新添加的 compatible。UEFI 启动日志会打印以下内容:
   • ParseFitDt:BoardParam 日志行中的配置,其组成部分构成您添加的 compatible
   • FitLoadDtbFromFdt:您映射到您的 compatible 的配置 fdt-<DTB>

​

固件管理中的变更

​

不受支持的配方和相关软件组件

• property-vault_1.0.bb
• syslog-plumber_1.0.bb

​

音频中的变更

• AudioReach 1.0 配方使用 qcom-* 命名约定,而 AudioReach 2.0 配方使用 audioreach-*。例如,AudioReach 1.0 中的 qcom-args 在 AudioReach 2.0 中现在是 audioreach-graphservices。
• 音频软件包名称已从 packagegroup-qcom-audio 更改为 packagegroup-audioreach。
• 为下游驱动添加了额外的配方 audioreach-kernel。

​

设备树和驱动中的变更

​

音频设备树处理中的变更

​

Qualcomm Linux 2.0 中设备树的变更

​

Qualcomm Linux 2.0 中移除的设备树节点

• spf-core
• audio-pkt
• spf-core-platform

  • msm-audio-mem
  • msm-audio-mem-cma

​

Overlay 驱动中的变更

​

Audioreach 用户空间源码组织的变更

​

摄像头中的变更

​

OpenEmbedded 层中摄像头的变更

​

摄像头设备树从 Qualcomm Linux 1.0 迁移到 Qualcomm Linux 2.0

​

编译摄像头 DTS 的 BitBake 命令

​

摄像头 DLKM 从 Qualcomm Linux 1.0 迁移到 2.0

​

CamX 用户空间源码组织的变更

​

启用摄像头功能

echo -n "camx" > /var/data
efivar -n 882f8c2b-9646-435f-8de5-f208ff80c1bd-VendorDtbOverlays -w -f /var/data
sync
reboot

​

显示中的变更

​

图形中的变更

• 统一的设备树架构
• 从 Qualcomm^® Adreno^™ GPU TZ 调速器过渡到用于 GPU 动态时钟和电压调节(DCVS)的 Simple On‑Demand 调速器
• 更新内核图形支持层(KGSL)驱动分发工作流

• 重构的 OpenEmbedded 元数据层
• 重新组织的配方
• 修订的头文件使用方式
• 更新的固件处理
• 集成 OpenGL Vendor-Neutral Dispatch(GLVND),提供厂商中立的用户空间接口

• 简化维护
• 与上游 Yocto 实践对齐
• 精简的图形栈

​

重新组织的元数据层

• 更易于维护
• 图形构建产物的单一事实来源
• 与上游 Yocto 层结构对齐

​

更新的 Adreno 配方

​

移除导出的图形用户空间头文件

• EGL
• OpenGL/OpenGL ES
• OpenCL

• EGL、OpenGL 和 OpenGL ES:由 GLVND include 路径提供
• OpenCL:由 OpenCL loader 提供
• Adreno 专用 OpenCL 扩展:仅 cl_ext_qcom.h 由 Adreno 软件包提供

• 跨厂商一致的 API 接口
• 改进的应用可移植性
• 降低厂商特定的耦合

• 必须更新应用的 include 路径,以依赖 GLVND 和 OpenCL loader 头文件
• 不再支持对厂商导出头文件的直接依赖

​

更新的 KGSL 配方

• 源码仓库:github.com/qualcomm-linux/kgsl
• 分支:gfx-kernel.le.0.0
• 开发模型:私有、封闭

​

固件处理中的变更

​

Overlay 启用

• OpenGL
• EGL
• GLX

​

链接和运行时行为变更

​

安装的组件

• GLVND 核心库
• 仅厂商特定的 EGL/GLES 加载器库

​

Adreno ICD

​

应用级影响

• 应用必须使用 eglGetProcAddress() 获取扩展 API。
• 静态链接到厂商特定符号不再有效。
• 厂商库选择在运行时根据 ICD 优先级进行。

​

环境变量和 overlay 行为

​

GLVND 环境控制

​

通过环境变量选择厂商

export __EGL_VENDOR_LIBRARY_FILENAMES=/usr/share/glvnd/egl_vendor.d/10_EGL_adreno.json

​

为内核模块启用 overlay

install msm /bin/sh -c "( modprobe --ignore msm skip_gpu=1 && modprobe msm_kgsl ) || modprobe --ignore-install msm"

​

上游和统一设备树

• 配方弃用:在过渡到 meta-qcom 2.0 的过程中,不再需要 Qualcomm Linux 1.0 中用于维护下游 DT 的单独配方(qcom-graphicsdevicetree_git.bb)。
• 统一维护:这一转变通过消除对不同 DT 维护工作流的需求,简化了开发过程。

​

GPU DCVS 调速器过渡

• Qualcomm Linux 1.0 使用 Adreno TZ 调速器。
• Qualcomm Linux 2.0 过渡到上游 Simple On-Demand 调速器。

• 性能:Simple On-Demand 调速器提供改进的性能效率。
• 功耗:作为性能提升的权衡,您可能会看到功耗略有增加。

​

Qualcomm^® Intelligent Multimedia(IM)SDK 中的变更

​

GStreamer 插件配方

• 单一配方 gst-plugins-imsdk_git.bb 现在负责所有 GStreamer 插件的编译。
• 配方是统一的,但每个插件仍继续生成单独的软件包。这确保您仍然可以根据需要仅安装特定的插件软件包,而无需使用全部插件。

​

摄像头服务配方更新

​

qcom-multimedia-image 中包含的插件

• qtimlqnn
• qtimlsnpe
• qtismartvencbin
• qtiqmmfsrc

​

qcom-multimedia-proprietary-image 中包含的插件

​

已弃用的 QIM 插件

• qtimlvclassification
• qtimlvdetection
• qtimlvpose
• qtimlvsuperresolution
• qtimlvsegmentation
• qtimlaclassification

​

示例应用中的变更

• 下载并安装 eSDK
• 使用 Qualcomm IM SDK 自定义现有示例应用

​

视频中的变更

• 视频驱动配方已重命名并从 meta-qcom-hwe 移至 meta-qcom。
  • Qualcomm Linux 1.0:qcom-videodlkm_1.0.bb
  • Qualcomm Linux 2.0:recipes-kernel/iris-video-module/iris-video-dlkm_git.bb
• 视频固件配方已从 meta-qcom-hwe 迁移到标准 Linux 固件配方。
  • Qualcomm Linux 1.0:qcom-video-firmware_1.0.bb
  • Qualcomm Linux 2.0:OpenEmbedded-core 中现有的 linux-firmware_<version>.bb
• 视频设备树配置已从早期的 overlay DT 迁移到主线内核中已提供的 DT。
  • Qualcomm Linux 1.0:qcom-videodtb_1.0.bb
  • Qualcomm Linux 2.0:DT 是主线内核 DT 的一部分。