构建并安装 RT 内核 - Qualcomm Dragonwing Documentation

Qualcomm^® Linux RT 内核使用与标准内核相同的 Yocto 工具链构建。 meta-qcom 层提供了一个专用的 Bitbake 配方，可自动获取 LTS RT 内核源码、应用 PREEMPT_RT 补丁集并启用所需的 Kconfig 选项。

选择正确的 RT 配方

根据目标分支的不同，有两个 RT 配方可用：

配方	内核轨道	适用场景
`linux-qcom-rt_6.18.bb`	LTS 6.18.x	为 QLI 发布版本构建（稳定、可用于生产）
`linux-qcom-next-rt_git.bb`	`qcom-next`	基于最新开发树构建

两个配方都位于 meta-qcom/recipes-kernel/linux/。本页所有示例均使用 LTS 配方。

构建 RT 内核镜像

1. 同步工作区

在构建之前，克隆某个发布标签处的 meta-qcom 并同步所有 Qualcomm Linux meta 层。有关工作区设置说明，请参阅使用 Yocto 构建内核。

2. 打开 RT 内核的 kas shell

kas shell meta-qcom/ci/qcs6490-rb3gen2-core-kit.yml:meta-qcom/ci/linux-qcom-rt-6.18.yml:meta-qcom/ci/qcom-distro-kvm.yml

请将 qcs6490-rb3gen2-core-kit.yml 替换为您目标开发板对应的 kas machine 文件。

3. 构建镜像

bitbake qcom-multimedia-image

构建输出位于：

build/tmp/deploy/images/<Machine>/<Image>-*.rootfs.qcomflash/

4. 烧写到设备

cd build/tmp/deploy/images/<Machine>/<Image>-*.rootfs.qcomflash/
fastboot flash efi efi.bin
fastboot flash dtb_a dtb.bin
fastboot reboot

自定义 RT 内核

添加补丁

将补丁文件放入 recipes-kernel/linux/linux-qcom-6.18/：

meta-qcom/recipes-kernel/linux/linux-qcom-6.18/your_patch.patch

将其追加到 linux-qcom-rt_6.18.bb 中的 SRC_URI：

SRC_URI += " \
    file://your_patch.patch \
"

添加 Kconfig 配置片段

创建一个包含所需 CONFIG_* 符号的 .cfg 文件：

meta-qcom/recipes-kernel/linux/linux-qcom-6.18/configs/qcom_rt_custom.cfg

示例内容：

CONFIG_CPU_ISOLATION=y
CONFIG_HZ_1000=y
# CONFIG_TRANSPARENT_HUGEPAGE is not set

将其追加到 linux-qcom-rt_6.18.bb 中的 SRC_URI：

SRC_URI += " \
    file://configs/qcom_rt_custom.cfg \
"

修改内核命令行

在 meta-qcom/ci/base.yml 中使用 KERNEL_CMDLINE_EXTRA 变量添加或覆盖命令行参数：

KERNEL_CMDLINE_EXTRA:append: " isolcpus=7 nohz_full=7 rcu_nocbs=7"

对于平台特定的命令行调优变量，请在 meta-qcom/conf/machine/<machine-name>.conf 中设置：

QCOM_RT_CPU        = "7"
QCOM_IRQAFF        = "0-6"
QCOM_RCU_NOCBS     = "7"
QCOM_RCU_EXPEDITED = "1"
QCOM_CPUIDLE_OFF   = "1"

这些变量在平台内核命令行上配置 RT 核心隔离、IRQ 亲和性以及 RCU 回调排除。

验证 RT 内核已安装

烧写并重启后，确认 RT 内核已激活：

uname -r
# Expected: a version string with the -rt suffix, e.g. 6.18.0-rt1+

zcat /proc/config.gz | grep CONFIG_PREEMPT_RT
# Expected: CONFIG_PREEMPT_RT=y

有关安装后的延迟验证，请参阅 RT 验证和已知限制。

​选择正确的 RT 配方

​构建 RT 内核镜像

​1. 同步工作区

​2. 打开 RT 内核的 kas shell

​3. 构建镜像

​4. 烧写到设备

​自定义 RT 内核

​添加补丁

​添加 Kconfig 配置片段

​修改内核命令行

​验证 RT 内核已安装