扩展板 24PIN - Wi-Fi / 蓝牙调试(RV1126)

本文记录 CAM126(RV1126)+ CAM126B-P-24 扩展板(AIC8800D80,SDIO Wi-Fi + UART 蓝牙)的驱动匹配、配置与验证。
与 CAM126B-P 不同,RV1126 SDK(rv1126-repo-v20230717-dev,Linux 4.19.111)没有集成 AIC8800 驱动,内核 drivers/net/wireless/rockchip_wlan 下也没有 aic8800 目录,开机不会出现 wlan0 / hci0。
需要自行匹配。AIC 官方 SDIO 驱动包 aic8800d_linux_sdk_V5.0_2026_0509_2195ae36 已包含 D80 驱动与固件,按本文第 2 节集成即可。下载地址见 资料下载(RV1126 与 RV1126B-P 使用同一文件)。
1. 硬件与引脚
| 项目 | 说明 |
|---|---|
| 无线模块 | AIC8800D80,SDIO 接 Wi-Fi、UART 接 BT |
| SDIO | RV1126 sdio@ffc70000(mmc1),4-bit,1.8V |
| BT 串口 | RV1126 uart0 → /dev/ttyS0,1500000 波特率,硬件流控 |
| Wi-Fi 电源使能 | GPIO1_D0(24PIN-14) |
| Wi-Fi 唤醒主机 | GPIO1_D1(24PIN-10) |
| BT 复位 / 唤醒 / 唤醒主机 | GPIO3_A5 / GPIO3_A6 / GPIO3_A4(24PIN-11/12/13) |
| 拨码 S01 | 使用 Wi-Fi / BT 时置于 1 / 3,TTL 调试置于 2 / 4 |
完整 24PIN 定义见 扩展板 24PIN,dts 配置见 RV1126 24PIN 配置。
SDIO 为 1.8V。确认 RV1126 侧 GPIO1 所在 IO 域(VCCIO)为 1.8V,否则不要直接连接。
2. 驱动匹配(需自行集成)
2.1 驱动包内容
| 项目 | 路径(解压后) | 说明 |
|---|---|---|
| SDIO 驱动源码 | SDIO/driver_fw/driver/aic8800 | aic8800_bsp / aic8800_fdrv / aic8800_btlpm |
| D80 固件 | SDIO/driver_fw/fw/aic8800D80 | fmacfw_8800d80_u02.bin、fw_patch_8800d80_u02_ext0.bin、aic_userconfig_8800d80.txt 等 |
| 移植说明 | AIC_Docs/AIC8800_SDIO_porting_guide_v1_1_20220526.pdf | 官方 SDIO 移植手册 |
匹配点:驱动支持的 SDIO ID 为 vendor 0xc8a1 / device 0x0082(function2 0x0182),与 AIC8800D80 一致,固件目录也包含 D80 全套固件。
需要自行处理的部分:
| 项 | 现状 | 需要做的事 |
|---|---|---|
| 编译平台 | 顶层 Makefile 默认 CONFIG_PLATFORM_UBUNTU=y,Rockchip 模板是 arm64 + 固定 KDIR | 改为 ARCH=arm,KDIR 指向 RV1126 SDK 的 kernel,CROSS_COMPILE 用 gcc-linaro 6.3.1 |
| 内核版本 | 驱动内有 4.19 分支,但官方未提供 RV1126 平台补丁 | 首次编译若报 4.19 API 差异,按 LINUX_VERSION_CODE 兼容宏补齐 |
| 固件路径 | 默认 /vendor/etc/firmware | 改为 /lib/firmware,或把固件放到 /vendor/etc/firmware |
| 设备树 | 无 | 按 RV1126 24PIN 配置 增加 sdio_pwrseq / &sdio / wireless-wlan / wireless-bluetooth / &uart0 |
| 自动加载 | 无 | 自建 S36wifibt-init.sh,依次加载三个 ko 并拉起 hciattach |
AIC 包内
SDIO/patch/for_Rockchip只有 3566 / 3128 / 3326 的 Android framework 补丁,不涉及 4.19 内核,Buildroot/Linux 侧用不到。
2.2 内核配置
RV1126 的 rv1126_defconfig 已包含 MMC / RFKILL,需确认以下选项:
CONFIG_CFG80211=y
CONFIG_CFG80211_WEXT=y
CONFIG_MAC80211=m
CONFIG_RFKILL=y
CONFIG_MMC=y
CONFIG_MMC_DW=y
CONFIG_MMC_DW_ROCKCHIP=y
CONFIG_MODULES=y
板级 config 片段(rv1126-emmc-drivers-modules.config 等)里已有 CONFIG_CFG80211=m、CONFIG_MAC80211=m,可直接沿用。
2.3 编译驱动
cd aic8800d_linux_sdk_V5.0_2026_0509_2195ae36/SDIO/driver_fw/driver/aic8800
将顶层 Makefile 的平台选择改为全部关闭(或只保留一个自定义块),然后显式传入 KDIR / ARCH / CROSS_COMPILE:
export CONFIG_PLATFORM_ROCKCHIP = n
export CONFIG_PLATFORM_ROCKCHIP2 = n
export CONFIG_PLATFORM_ALLWINNER = n
export CONFIG_PLATFORM_AMLOGIC = n
export CONFIG_PLATFORM_UBUNTU = n
make -C <驱动目录> modules \
KDIR=<SDK>/kernel \
ARCH=arm \
CROSS_COMPILE=<SDK>/prebuilts/gcc/linux-x86/arm/gcc-linaro-6.3.1-2017.05-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-
生成:
aic8800_bsp/aic8800_bsp.ko
aic8800_fdrv/aic8800_fdrv.ko
aic8800_btlpm/aic8800_btlpm.ko
也可以用
make -C <SDK>/kernel M=<驱动目录> ARCH=arm CROSS_COMPILE=... modules编译,效果相同。
2.4 安装固件与模块
# 固件
cp SDIO/driver_fw/fw/aic8800D80/* <rootfs>/lib/firmware/
# 模块
cp aic8800_bsp/aic8800_bsp.ko <rootfs>/lib/modules/4.19.111/
cp aic8800_fdrv/aic8800_fdrv.ko <rootfs>/lib/modules/4.19.111/
cp aic8800_btlpm/aic8800_btlpm.ko <rootfs>/lib/modules/4.19.111/
驱动内固件路径需要统一,在顶层 Makefile 增加并导出(子目录的 aic8800_bsp、aic8800_fdrv 会继承):
CONFIG_AIC_FW_PATH = "/lib/firmware"
export CONFIG_AIC_FW_PATH
同时把 aic8800_bsp/Makefile 里的 CONFIG_AIC_FW_PATH 改成相同值。若不是 /lib/firmware,也可以把固件同时放到 /vendor/etc/firmware(驱动默认值)。
2.5 开机脚本
#!/bin/sh
insmod /lib/modules/4.19.111/aic8800_bsp.ko
insmod /lib/modules/4.19.111/aic8800_fdrv.ko
insmod /lib/modules/4.19.111/aic8800_btlpm.ko
# BT:AIC8800D80 走 uart0
hciattach -s 1500000 /dev/ttyS0 any 1500000 flow
顺序必须是 bsp → fdrv → btlpm;fdrv 注册 wlan0,btlpm 负责 BT 低功耗。
3. 验证
3.1 Wi-Fi
ifconfig -a # 应看到 wlan0
lsmod | grep aic8800 # 三个模块都在
dmesg | grep -iE 'aic|wlan0|sdio' | tail -50
wpa_cli -i wlan0 scan
wpa_cli -i wlan0 scan_results
连接:
vi /etc/wpa_supplicant.conf
ctrl_interface=/var/run/wpa_supplicant
ap_scan=1
update_config=1
network={
ssid="ORBI60"
psk="fanconn123"
key_mgmt=WPA-PSK
}
wpa_cli -i wlan0 reconfigure
sleep 8
wpa_cli -i wlan0 status # wpa_state=COMPLETED
udhcpc -i wlan0 -q
ping -c 4 www.baidu.com
3.2 蓝牙
ps | grep hciattach
hciconfig -a # hci0: Bus: UART, UP RUNNING
bluetoothctl
[bluetooth]# power on
[bluetooth]# scan on
手动 attach:
killall hciattach
hciattach -s 1500000 /dev/ttyS0 any 1500000 flow
上电状态:
for r in /sys/class/rfkill/rfkill*; do echo "$r $(cat $r/name) state=$(cat $r/state)"; done
cat /sys/kernel/debug/gpio | grep -iE 'bt|wifi'
4. 常见问题
| 现象 | 原因 / 处理 |
|---|---|
ifconfig -a 无 wlan0 | 驱动未加载 / dts 未启用 &sdio;先看 lsmod、dmesg | grep aic |
mmc1: new SDIO card 有日志但没有 wlan0 | 只识别到卡,aic8800_fdrv 未加载或固件路径不对 |
aic8800_bsp: probe failed | WIFI_REG_ON(GPIO1_D0)时序或 SDIO 1.8V 供电问题 |
| 扫描不到 AP | 天线未接、S01 不在 1 / 3、wlan0 未 up |
连接卡在 4WAY_HANDSHAKE | 密码错误或路由器 WPA3,先用 scan_results 核对加密方式 |
| 连上无 IP | 手动 udhcpc -i wlan0 -q |
hciconfig -a 无输出 | hciattach 未运行;确认 /dev/ttyS0、S01 1 / 3、BT_RST 已释放 |
hci0: Opcode 0x0c03 failed: -110 | 芯片未上电或 UART 未通到模块,查 rfkill 与 BT,power_gpio |
| 蓝牙能扫但速率低 | 确认 24PIN-21/24 的 RTS/CTS 已接,hciattach ... flow 带流控 |
5. 实测参考
CAM126B-P 同款模块在 RV1126B(内核 6.1)上的实测结果可作为对照:wlan0 正常、扫描可见 2.4G / 5G、连接 5200MHz / 40MHz、RSSI=-40、BT HCI 5.4。RV1126 为 4.19 内核,驱动结论以本平台实测为准。