RK3562/RK3568平台AIC8800 WiFi蓝牙驱动集成指南

1. RK3562/RK3568平台WiFi&蓝牙模块开发概述

在RK3562和RK3568平台上集成AIC8800（FCS960K-N）WiFi蓝牙二合一模块时，Rockchip官方提供了两种主要的驱动集成方式。这两种方式在实际项目开发中各有特点，需要根据具体平台和SDK版本进行选择。

方法一（传统内核集成方式）：

• 驱动代码直接放在内核目录（kernel/drivers/net/wireless/aic8800）
• 通过内核配置系统（Kconfig/Makefile）管理编译选项
• 需要手动处理固件部署和启动脚本
• 主要适用于早期SDK版本和RK3568平台

方法二（外部模块化方式）：

• 驱动代码移至external/rkwifibt目录
• 采用模块化编译管理
• 提供更灵活的固件部署机制
• 推荐用于新项目，特别是RK3562平台

重要提示：方法二实际上是方法一的迭代升级版本，Rockchip已明确建议新项目采用方法二。方法一主要保留用于兼容已有项目。

2. 设备树关键配置解析

设备树配置是WiFi蓝牙模块正常工作的基础，需要特别注意以下几个关键部分：

2.1 WiFi电源序列配置

dts复制sdio_pwrseq: sdio-pwrseq {
    compatible = "mmc-pwrseq-simple";
    clocks = <&rk809 1>;
    clock-names = "ext_clock";
    pinctrl-names = "default";
    pinctrl-0 = <&wifi_enable_h>;
    post-power-on-delay-ms = <200>;
    reset-gpios = <&gpio0 RK_PB0 GPIO_ACTIVE_LOW>;
};

关键参数说明：

• post-power-on-delay-ms：电源稳定延时，200ms是AIC8800的典型值
• reset-gpios：WiFi模块复位引脚，注意电平极性
• pinctrl-0：对应的GPIO引脚配置

2.2 WiFi平台数据配置

dts复制wireless-wlan {
    compatible = "wlan-platdata";
    rockchip,grf = <&sys_grf>;
    wifi_chip_type = "aic8800";
    pinctrl-names = "default";
    pinctrl-0 = <&wifi_host_wake_irq>;
    WIFI,host_wake_irq = <&gpio0 RK_PC4 GPIO_ACTIVE_HIGH>;
    status = "okay";
};

特别注意：

• wifi_chip_type必须准确设置为"aic8800"
• host_wake_irq是WiFi唤醒主机的中断引脚
• 确保status为"okay"

2.3 蓝牙配置

dts复制wireless-bluetooth {
    compatible = "bluetooth-platdata";
    clocks = <&rk809 1>;
    clock-names = "ext_clock";
    uart_rts_gpios = <&gpio1 RK_PD3 GPIO_ACTIVE_LOW>;
    pinctrl-names = "default", "rts_gpio";
    pinctrl-0 = <&uart1m0_rtsn>;
    pinctrl-1 = <&uart1_gpios>;
    BT,wake_gpio = <&gpio0 RK_PC6 GPIO_ACTIVE_HIGH>;
    BT,wake_host_irq = <&gpio0 RK_PC5 GPIO_ACTIVE_HIGH>;
    status = "okay";
};

关键点：

• 确保使用的UART端口与硬件设计一致（示例中使用ttyS1）
• 注意GPIO电平极性配置
• 唤醒引脚配置必须准确

3. 方法一：内核集成方式详细实现

3.1 内核驱动集成

1. 将驱动代码放置到内核目录：

   bash复制kernel/drivers/net/wireless/aic8800/
   

2. 修改Kconfig配置：

   makefile复制# kernel/drivers/net/wireless/Kconfig
   source "drivers/net/wireless/aic8800/Kconfig"
   

3. 修改Makefile：

   makefile复制# kernel/drivers/net/wireless/Makefile
   obj-$(CONFIG_AIC_WLAN_SUPPORT) += aic8800/
   

4. 配置内核选项：

   config复制# kernel/arch/arm64/configs/rockchip_linux_defconfig
   CONFIG_AIC_WLAN_SUPPORT=y
   CONFIG_AIC8800_WLAN_SUPPORT=m
   

3.2 Buildroot配置

1. 基础配置：

   config复制# buildroot/configs/rockchip_rk3568_defconfig
   BR2_PACKAGE_RKWIFIBT_AIC8800=y
   BR2_PACKAGE_RKWIFIBT_BTUART="ttyS1"
   

2. 蓝牙补丁应用：

   • 将0002-add-support-for-aic.patch应用到bluez5_utils包
   • 该补丁为hciattach添加aic参数支持

3. 文件系统部署：

   makefile复制# buildroot/package/rockchip/rkwifibt/rkwifibt.mk
   define RKWIFIBT_TB_INSTALL
       mkdir -p $(TARGET_DIR)/vendor/etc/firmware
       mkdir -p $(TARGET_DIR)/data/local/tmp
       mkdir -p $(TARGET_DIR)/usr/lib/modules
       cp -rf $(TOPDIR)/../external/rkwifibt/firmware/FCS960K/* \
           $(TARGET_DIR)/vendor/etc/firmware/
       cp -f $(TOPDIR)/../kernel/drivers/net/wireless/aic8800/aic8800_bsp/aic8800_bsp.ko \
           $(TARGET_DIR)/usr/lib/modules/
       cp -f $(TOPDIR)/../kernel/drivers/net/wireless/aic8800/aic8800_btlpm/aic8800_btlpm.ko \
           $(TARGET_DIR)/usr/lib/modules/
       cp -f $(TOPDIR)/../kernel/drivers/net/wireless/aic8800/aic8800_fdrv/aic8800_fdrv.ko \
           $(TARGET_DIR)/usr/lib/modules/
       cp -f $(TOPDIR)/../external/rkwifibt/conf/wpa_supplicant.conf $(TARGET_DIR)/etc/
       cp -f $(TOPDIR)/../external/rkwifibt/drivers/bluetooth_uart_driver/hci_uart.ko $(TARGET_DIR)/usr/lib/modules/
   endef
   

3.3 启动脚本配置

1. 蓝牙启动服务：

   bash复制# buildroot/package/bluez5_utils/S40bluetoothd
   #!/bin/sh
   
   case "$1" in
   start)
       killall rtk_hciattach
   
       echo 0 >/sys/class/rfkill/rfkill0/state
       echo 0 >/proc/bluetooth/sleep/btwrite
       sleep 0.5
   
       echo 1 >/sys/class/rfkill/rfkill0/state
       echo 1 >/proc/bluetooth/sleep/btwrite
       sleep 0.5
   
       wpa_supplicant -i wlan0 -c /etc/wpa_supplicant.conf -B
   
       insmod ./usr/lib/modules/hci_uart.ko
       hciattach -s 1500000 /dev/ttyS1 aic 1500000 flow 
   
       hciconfig hci0 up &
       /usr/libexec/bluetooth/bluetoothd -C -E -n &
       sleep 2
       gatt-service &
       ;;
   *)
       echo "usage: $0 {start}"
       ;;
   esac
   

2. WiFi/BT初始化脚本：

   bash复制# external/rkwifibt/S36wifibt-init.sh
   case "$1" in
       start|stop|restart)
           /usr/bin/wifibt-init.sh $1
           insmod ./usr/lib/modules/aic8800_bsp.ko
           insmod ./usr/lib/modules/aic8800_fdrv.ko
           insmod ./usr/lib/modules/aic8800_btlpm.ko
           ;;
       *)
           echo "Usage: [start|stop|restart]" >&2
           exit 3
           ;;
   esac
   

4. 方法二：外部模块化方式实现

4.1 驱动编译配置

1. 驱动代码位置：

   code复制external/rkwifibt/drivers/aic8800_sdio
   

2. 固件文件位置：

   code复制external/rkwifibt/firmware/aic/sdio/aic8800
   

3. 编译脚本：

   bash复制# device/rockchip/common/scripts/post-wifibt.sh
   if [[ "$RK_WIFIBT_MODULES" = "AIC8800_SDIO" ]];then
       echo "building AIC8800 SDIO"
       $KMAKE M=$RKWIFIBT_DIR/drivers/aic8800_sdio
   fi
   

4.2 文件系统部署

bash复制if [[ "$RK_WIFIBT_MODULES" =~ "AIC8800_SDIO" ]];then
    echo "Install AIC file to rootfs"
    cp $RKWIFIBT_DIR/firmware/aic/sdio/*/* \
        $TARGET_DIR/lib/firmware/
    cp $RKWIFIBT_DIR/drivers/aic8800_sdio/aic8800_btlpm/*.ko \
        $TARGET_DIR/lib/modules/
    cp $RKWIFIBT_DIR/drivers/aic8800_sdio/aic8800_fdrv/*.ko \
        $TARGET_DIR/lib/modules/
    cp $RKWIFIBT_DIR/drivers/aic8800_sdio/aic8800_bsp/*.ko \
        $TARGET_DIR/lib/modules/
fi

4.3 板级配置

config复制# device/rockchip/.chips/rk3562/rockchip_rk3562_evb2_ddr4_v10_defconfig
RK_WIFIBT_CHIP="AIC8800_SDIO"

5. Debian系统特殊配置

5.1 工具更新

bash复制# debian/mk-rootfs-bullseye.sh
#wireless driver    
sudo mkdir -p $TARGET_ROOTFS_DIR/usr/lib/modules
if [ -e "$TARGET_ROOTFS_DIR/usr/bin/hciattach" ];
then sudo rm $TARGET_ROOTFS_DIR/usr/bin/hciattach
fi
sudo cp  ../buildroot/output/rockchip_rk3562/target/usr/bin/hciattach $TARGET_ROOTFS_DIR/usr/bin/hciattach

5.2 服务配置

1. WiFi/BT启动服务：

   bash复制# debian/overlay/etc/init.d/open_wifibt.sh
   # Wi-Fi
   insmod /usr/lib/modules/aic8800_bsp.ko 2>/dev/null
   insmod /usr/lib/modules/aic8800_fdrv.ko 2>/dev/null
   insmod /usr/lib/modules/aic8800_btlpm.ko 2>/dev/null
   sleep 1
   
   # Bluetooth 
   echo 0 >/sys/class/rfkill/rfkill0/state
   echo 0 >/proc/bluetooth/sleep/btwrite
   sleep 0.5
   
   echo 1 >/sys/class/rfkill/rfkill0/state
   echo 1 >/proc/bluetooth/sleep/btwrite
   sleep 0.5
   
   insmod /usr/lib/modules/hci_uart.ko 2>/dev/null
   btattach -B /dev/ttyS1 -S 1500000 -P h4
   
   sleep 2
   

2. 蓝牙配置服务：

   bash复制# debian/overlay/etc/init.d/open_bt.sh
   #!/bin/bash
   
   hciconfig hci0 up 
   sleep 5
   rfkill unblock bluetooth
   

3. systemd服务文件：

   ini复制# debian/overlay/etc/systemd/system/open_wifibt.service
   [Unit]
   Description=My Startup Script
   
   [Service]
   ExecStart=/etc/init.d/open_wifibt.sh
   
   [Install]
   WantedBy=multi-user.target
   

6. 常见问题排查指南

6.1 WiFi功能异常排查流程

1. 检查设备节点：

   bash复制ip addr show wlan0
   

   • 有设备节点：检查网络连接和IP配置
   • 无设备节点：继续排查

2. 检查内核日志：

   bash复制dmesg | grep aic
   

   • 确认驱动加载情况
   • 查看可能的错误信息

3. 检查后台进程：

   bash复制ps aux | grep wpa_supplicant
   

   • 确保认证进程正常运行

4. 检查驱动文件：

   bash复制ls /usr/lib/modules/aic8800_*.ko
   

   • 确认所有必要驱动文件存在

5. 手动加载测试：

   bash复制insmod /usr/lib/modules/aic8800_bsp.ko
   insmod /usr/lib/modules/aic8800_fdrv.ko
   

   • 观察加载过程中的错误信息

6.2 蓝牙功能异常排查流程

1. 检查设备节点：

   bash复制hciconfig -a
   

   • 确认hci设备是否存在

2. 检查内核日志：

   bash复制dmesg | grep -i bluetooth
   

   • 查看蓝牙驱动加载情况

3. 检查hciattach进程：

   bash复制ps aux | grep hciattach
   

   • 确保蓝牙协议栈已正确初始化

4. 手动测试：

   bash复制hciattach -s 1500000 /dev/ttyS1 aic 1500000 flow
   hciconfig hci0 up
   

   • 逐步执行命令定位问题环节

7. 关键注意事项

1. 固件版本匹配：

   • 确保使用的固件文件与硬件版本严格匹配
   • AIC8800不同子型号需要不同的固件

2. 电源时序控制：

   • 严格按照200ms的电源稳定延时
   • 不正确的电源时序会导致模块工作不稳定

3. 中断配置：

   • WiFi和蓝牙的中断引脚配置必须准确
   • 错误的中断配置会导致性能下降或功能异常

4. UART波特率：

   • 蓝牙UART必须配置为1500000波特率
   • 不匹配的波特率会导致通信失败

5. 驱动加载顺序：

   • 必须先加载bsp驱动，再加载功能驱动
   • 错误的加载顺序会导致模块初始化失败

在实际项目开发中，我遇到过因GPIO极性配置错误导致模块无法启动的情况。通过逻辑分析仪抓取电源序列波形，最终发现是复位信号极性设置反了。这个经验告诉我，对于嵌入式外设集成，硬件信号的验证与软件配置同等重要。建议在初期调试时，使用示波器或逻辑分析仪验证所有关键信号的时序和电平是否符合预期。