实战：RK3568 Android14 集成 AP6212A WiFi/BT 二合一模块
前言
在 AIoT 设备中，无线连接是标配。AP6212A 是一款性价比极高的 WiFi (802.11 b/g/n) + 蓝牙 (BT 4.2/5.x) 二合一模块。
本文将结合硬件原理图，详细记录如何在 RK3568 Android 14 平台上驱动这颗模块。
WiFi 接口：SDIO 3.0 (4-bit)
蓝牙接口：UART (带流控) + PCM (音频)
一、硬件原理图深度解析
在写代码前，我们要先把原理图的引脚功能过一遍，原理图截图：
1.1 WiFi 部分 (SDIO)
SDMMC2_D0~D3 / CMD / CLK:连接到 RK3568 的 SDMMC2 控制器。这是 WiFi 数据传输的主通道。
WIFI_REG_ON_H (Pin 12):WiFi 的使能引脚（高电平有效）。对应原理图左侧的 R6232 上拉和控制网络，这需要映射到一个 GPIO（例如 GPIO0_PC0，请查阅底板原理图确认具体 GPIO）。
WIFI_WAKE_HOST_H (Pin 13):WiFi 唤醒主控的 GPIO（用于休眠唤醒），对应 OOB 中断。
1.2 蓝牙部分 (UART + PCM)
UART8_TX/RX/CTS/RTS:蓝牙指令与数据通道。原理图右侧 Option4 显示连接到了 UART8。注意：必须开启 CTS/RTS 硬件流控。
BT_REG_ON (Pin 34):蓝牙使能引脚（复位脚），需要分配一个 GPIO。
:蓝牙唤醒主控。
:主控唤醒蓝牙（通常用于省电模式，可悬空或配置）。
PCM_CLK/SYNC/IN/OUT:用于蓝牙通话音频（SCO），连接到 RK3568 的 I2S 接口（图中通过 U6201 电平转换连接到了 I2S3）。
1.3 关键时钟 (32KHz)
CLK32K_OUT0_WIFI:原理图左下角显示 R6229 (22R) 连接到了 SoC 的时钟输出。
重点：AP6212A 在休眠和蓝牙工作时严重依赖这个 32.768KHz 时钟。如果这个时钟没有波形，WiFi 扫不到热点或者蓝牙无法打开。
二. 内核配置 (Kernel Config)
AP6212A 属于 Broadcom 系列，需要开启 brcmfmac 驱动。
CONFIG_WL_ROCKCHIP=y CONFIG_WIFI_BUILD_MODULE=y CONFIG_AP6XXX=m三、设备树配置 (DTS)
打开 kernel-6.1/arch/arm64/boot/dts/rockchip/rk3568-evb1-ddr4-v10.dtsi，主要涉及三个节点的配置。
3.1 配置 WiFi (SDMMC2)
RK3568 通常使用 sdmmc2 作为 WiFi 接口。
&sdmmc2{max-frequency=<150000000>;no-sd;no-mmc;bus-width=<4>;disable-wp;cap-sd-highspeed;cap-sdio-irq;keep-power-in-suspend;mmc-pwrseq=<&sdio_pwrseq>;non-removable;pinctrl-names="default";pinctrl-0=<&sdmmc2m0_bus4&sdmmc2m0_cmd&sdmmc2m0_clk>;sd-uhs-sdr104;status="okay";};3.2 配置 RFKill 与 GPIO (Wireless Node)
Rockchip 的 SDK 使用 wireless-wlan 和 wireless-bluetooth 节点来管理 GPIO 和外部时钟
kernel-6.1/arch/arm64/boot/dts/rockchip/rk3568-evb.dtsi/{/* WiFi 电源序列 */sdio_pwrseq:sdio-pwrseq{compatible="mmc-pwrseq-simple";clocks=<&rk8091>;clock-names="ext_clock";pinctrl-names="default";pinctrl-0=<&wifi_enable_h>;/* * On the module itself this is one of these (depending * on the actual card populated): * - SDIO_RESET_L_WL_REG_ON * - PDN (power down when low) */post-power-on-delay-ms=<200>;reset-gpios=<&gpio3 RK_PD5 GPIO_ACTIVE_LOW>;};}kernel-6.1/arch/arm64/boot/dts/rockchip/rk3568-evb1-ddr4-v10.dtsi&uart8{status="okay";pinctrl-names="default";/* 必须包含 CTS/RTS，AP6212 必须流控 */pinctrl-0=<&uart8m0_xfer&uart8m0_ctsn>;};/* 无线网络总控节点 */&wireless_wlan{pinctrl-names="default";pinctrl-0=<&wifi_host_wake_irq>;wifi_chip_type="ap6212a";/* 标识芯片类型 *//* WiFi 唤醒脚: WIFI_WAKE_HOST */WIFI,host_wake_irq=<&gpio3 RK_PD4 GPIO_ACTIVE_HIGH>;};/* 蓝牙控制节点 */&wireless_bluetooth{compatible="bluetooth-platdata";clocks=<&rk8091>;clock-names="ext_clock";//wifi-bt-power-toggle;/* 蓝牙串口: 对应 UART8 */uart_rts_gpios=<&gpio2 RK_PB1 GPIO_ACTIVE_LOW>;pinctrl-names="default","rts_gpio";pinctrl-0=<&uart8m0_rtsn>;pinctrl-1=<&uart8_gpios>;BT,reset_gpio=<&gpio3 RK_PA0 GPIO_ACTIVE_HIGH>;BT,wake_gpio=<&gpio3 RK_PA2 GPIO_ACTIVE_HIGH>;/* 蓝牙唤醒脚: BT_WAKE_HOST */BT,wake_host_irq=<&gpio3 RK_PA1 GPIO_ACTIVE_HIGH>;status="okay";};&pinctrl{sdio-pwrseq{wifi_enable_h:wifi-enable-h{rockchip,pins=<3RK_PD5 RK_FUNC_GPIO&pcfg_pull_none>;};};wireless-wlan{wifi_host_wake_irq:wifi-host-wake-irq{rockchip,pins=<3RK_PD4 RK_FUNC_GPIO&pcfg_pull_down>;};};wireless-bluetooth{uart8_gpios:uart8-gpios{rockchip,pins=<2RK_PB1 RK_FUNC_GPIO&pcfg_pull_none>;};};};四、固件集成 (Firmware)
驱动只是躯壳，固件才是灵魂。你需要将 AP6212A 的固件推送到 Android 系统。
4.1 确认文件
厂商会提供以下文件：
WiFi: fw_bcmxxx.bin (固件), nvram_xxx.txt (配置文件，非常重要，包含 MAC 地址配置和射频参数).
BT: BCMxxx.hcd (蓝牙 Patch 文件)。
通常在vendor/rockchip/common/wifi/firmware目录下，将厂商提供的模组固件放置到该目录下即可。
4.2 系统配置 (Android 14)
BOARD_CONNECTIVITY_VENDOR:=Broadcom BOARD_CONNECTIVITY_MODULE:=ap6xxx五、调试与排坑 (Troubleshooting)
烧录镜像后，如果 WiFi 打不开，按以下步骤排查：
5.1 检查 SDIO 枚举
在串口输入：
ls/sys/bus/sdio/devices/如果为空，说明 CPU 根本没认到卡。
查电压：测量 WiFi 模组的 VBAT (3.3V) 和 VCC_IO (1.8V)。
查时钟：用示波器测量 CLK32K 脚，必须有 32.768KHz 方波。原理图中的 R6229 如果没贴或阻值不对，WiFi 必死。
查复位：测量 WIFI_REG_ON 是否为高电平 (1.8V/3.3V)。
5.2 检查内核日志
dmesg|grep brcm dmesg|grep mmc2报错 -110 (Timeout):通常是数据线 D0-D3 接错，或者没有 32K 时钟。
报错 Firmware not found:检查 4.2 步骤中的文件路径是否正确。
5.3 蓝牙无法打开
检查 UART8 是否通。
重点检查 CTS/RTS：AP6212A 必须连接 CTS/RTS。如果原理图上的 Option4 电阻没贴对，蓝牙无法初始化。
检查 .hcd 文件是否加载成功：logcat | grep -i bt。
总结
AP6212A 的集成在 RK3568 上非常成熟。只要电源、32K 时钟、SDIO 线序、UART 流控这四点硬件没问题，软件上主要是 DTS 对应的 GPIO 别填错即可。
希望这篇博文能帮你一次点亮 WiFi 和蓝牙！