[PATCH v10 0/2] Bluetooth: btrtl: Add firmware format v3 support and RTL8922D
From: Hilda Wu
Date: Fri Nov 20 2026 - 03:27:06 EST
This series adds support for the new Realtek firmware format v3 and for
the first controller that uses it, the RTL8922D.
Format v3 replaces the flat epatch container with a section/subsection
layout that can carry several independently configurable images, selected
by key id and IC cut, each with its own register fixups and optional
per-image config file. Patch 1 adds the parser and the downloader. The
new code lives in btrtl_enh.c, which is linked into the same module as
btrtl.c, so the lifetime of the parsed image list follows the existing
btrtl_device_info and no extra module or symbol_get() dependency is
introduced. Support for the existing v1 and v2 firmware is unchanged.
Patch 2 adds the RTL8922D id table entry, the matching quirks and the
MODULE_FIRMWARE() entries. The firmware binary will be submitted to the
linux-firmware project separately.
Both patches are needed for a working RTL8922D. Patch 2 depends only on
patch 1 and the series should be applied as a whole.
Note that building btrtl.c and btrtl_enh.c as one composite object
renames the module from btrtl.ko to btrtl_core.ko. The CONFIG_BT_RTL
option and the exported symbols are unchanged.
Testing was done on RTL8922D over USB (0bda:a82d, chip id 55) with
rtl8922du_fw.bin; the boot log is included in patch 1.
Alex Lu (1):
Bluetooth: btrtl: Add firmware format v3 support
Hilda Wu (1):
Bluetooth: btrtl: Add the support for RTL8922D
drivers/bluetooth/Makefile | 4 +-
drivers/bluetooth/btrtl.c | 226 +++++++---
drivers/bluetooth/btrtl.h | 87 +++-
drivers/bluetooth/btrtl_enh.c | 795 +++++++++++++++++++++++++++++++++
drivers/bluetooth/btusb_main.c | 25 +-
5 files changed, 1056 insertions(+), 81 deletions(-)
create mode 100644 drivers/bluetooth/btrtl_enh.c
--
2.34.1