如何在Yocto构建的NXP fsl-image-auto系统中开机自动加载apex.ko

Got it, let's break down why your previous attempts didn't work first, then walk through the correct approach for your pre-built apex.ko module.

为什么之前的方法失效？ #

• KERNEL_MODULE_AUTOLOAD += apex不生效：这个变量只对Yocto从源码编译的内核模块生效（比如通过kernel-module-* recipes或者内核源码树里的模块）。你的apex.ko是预编译的第三方模块，不属于Yocto内核构建流程的一部分，所以这个变量识别不到它。
• module_do_install()报错：这个函数是Yocto内核模块编译框架的一部分，它需要源码和Makefile来编译模块。你直接用它但没提供模块源码，自然会报"no makefile found"的错误。

正确的实现步骤（针对预编译模块） #

我们需要创建一个专门的Yocto recipe来安装这个预编译模块，并配置开机自动加载。

1. 准备自定义Layer（如果还没有）

如果你还没有自己的自定义layer，先创建一个（比如叫meta-custom），结构大概是：

meta-custom/
├── conf/
│   └── layer.conf
└── recipes-kernel/
    └── apex/
        ├── files/
        │   └── apex.ko
        └── apex.bb

2. 编写apex.bb Recipe

把下面的内容放到meta-custom/recipes-kernel/apex/apex.bb：

SUMMARY = "Pre-built APEX kernel module for NXP platform"
LICENSE = "CLOSED"  # 如果有开源许可证，替换成对应的（比如MIT/GPLv2）
LIC_FILES_CHKSUM = "file://${COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302"

# 指定预编译模块的来源
SRC_URI = "file://apex.ko"

S = "${WORKDIR}"  # 工作目录就是下载/复制文件的目录

do_install() {
    # 创建内核模块安装目录（Yocto标准路径）
    install -d ${D}/lib/modules/${KERNEL_VERSION}/extra/
    # 安装模块到正确位置，权限设为644
    install -m 0644 ${S}/apex.ko ${D}/lib/modules/${KERNEL_VERSION}/extra/
}

# 目标系统上执行depmod更新模块依赖（确保系统能找到模块）
pkg_postinst_ontarget_${PN}() {
    depmod -a ${KERNEL_VERSION}
}

# 配置开机自动加载模块
MODULES_LOAD += "apex"

# 可选：如果模块需要参数，添加下面的配置
# do_install_append() {
#     install -d ${D}/etc/modprobe.d/
#     echo "options apex param1=your_value param2=another_value" > ${D}/etc/modprobe.d/apex.conf
# }

3. 放置预编译模块

把你的apex.ko放到meta-custom/recipes-kernel/apex/files/目录下。

4. 启用Recipe并构建镜像

• 在build/conf/local.conf里添加：

  IMAGE_INSTALL:append = " apex"
  

• 确保你的自定义layer被添加到build/conf/bblayers.conf中：

  BBLAYERS += "${TOPDIR}/../meta-custom"
  

• 重新构建镜像：

  bitbake fsl-image-auto
  

关键说明 #

• 内核版本匹配：必须确保你的apex.ko是针对Yocto构建的内核版本、配置编译的，否则会出现version magic mismatch的加载错误。可以用modinfo apex.ko查看模块的内核版本，和目标系统的uname -r对比。
• 加载机制：MODULES_LOAD变量会让Yocto自动生成对应的加载配置——如果用systemd，会创建/etc/modules-load.d/apex.conf；如果是sysvinit，会处理启动脚本，不需要手动修改rcS.d。
• 权限与路径：把模块放到/lib/modules/${KERNEL_VERSION}/extra/是Yocto的标准做法，depmod会自动扫描这个路径更新模块依赖。

内容的提问来源于stack exchange，提问作者Eric Fan