跳到主要内容

扩展板 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
SDIORV1126 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/aic8800aic8800_bsp / aic8800_fdrv / aic8800_btlpm
D80 固件SDIO/driver_fw/fw/aic8800D80fmacfw_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 failedWIFI_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 内核,驱动结论以本平台实测为准。