在Yocto中创建自定义Realtek-8192cu驱动配方的方法

Got it, let's walk through creating a Yocto recipe for that custom Realtek 8192cu driver step by step. I’ve done this a bunch of times for out-of-tree wireless drivers, so here’s a reliable, step-by-step process that should work for you:

First off, you’ll want to use a custom Yocto layer (never modify core layers if you can avoid it—keeps your setup clean and easy to update). If you don’t have a custom layer yet, create one first, then add this directory structure inside it:

meta-yourcustomlayer/
└── recipes-kernel/
    └── realtek-8192cu/
        ├── realtek-8192cu/
        │   └── files/ (use this for patches or extra config files if needed)
        └── realtek-8192cu_git.bb

This is the heart of the setup. Here’s a template you can adapt, with explanations for each key part:

SUMMARY = "Custom Realtek 8192cu driver with concurrent softAP support"
LICENSE = "GPL-2.0-only"
LIC_FILES_CHKSUM = "file://COPYING;md5=eb723b61539feef013de476e68b5c50a"

# Pull the driver source from the git repo
SRC_URI = "git://github.com/desflynn/realtek-8192cu-concurrent-softAP.git;branch=master"
# Replace this with the latest commit hash from the repo (get it via git log or GitHub's interface)
SRCREV = "your-latest-commit-hash-here"

S = "${WORKDIR}/git"

# Inherit Yocto classes for kernel module building
inherit module-base kernel-module-split

# Depend on kernel headers to build the module
DEPENDS += "linux-headers"

# Auto-load the module on system boot (skip this if you don't want auto-loading)
KERNEL_MODULE_AUTOLOAD += "8192cu"

# Optional: Add any extra Makefile flags if the driver needs them
# EXTRA_OEMAKE = "CONFIG_RTL8192CU=m"

# Optional: Add patches here if you need to fix kernel compatibility
# SRC_URI += "file://0001-fix-kernel-5.15-compatibility.patch"

A quick breakdown of critical bits:

• SRCREV: You’ll need to grab the latest commit hash from the driver repo—this ensures you’re building the exact version you want.
• inherit lines: These Yocto classes handle all the heavy lifting for kernel module building, including packaging the module correctly.
• KERNEL_MODULE_AUTOLOAD: Tells Yocto to add the module to the auto-load list so it loads on boot.

Out-of-tree drivers often need small patches to work with newer kernel versions. If you hit build errors related to kernel APIs:

1. Create a patch file (e.g., 0001-fix-kernel-6.1-compat.patch) in the files/ directory of your recipe.
2. Add the patch to the SRC_URI line in your recipe (like the commented example above).

Make sure your custom layer is included in bblayers.conf:

BBLAYERS += "${TOPDIR}/meta-yourcustomlayer"

To build just the driver package:
bitbake realtek-8192cu

To include it in your final image, add this line to your image recipe (e.g., core-image-minimal.bbappend):

IMAGE_INSTALL += "realtek-8192cu"

• Kernel header errors: Double-check that linux-headers matches your target kernel (verify PREFERRED_PROVIDER_virtual/kernel in local.conf).
• Module won’t load: Check dmesg for errors—common issues are mismatched kernel versions or missing firmware (some Realtek drivers need extra firmware packages).
• SoftAP not working: Confirm your hardware supports concurrent station/AP mode, and make sure you’ve configured hostapd correctly for your setup.

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