一、简介AP6256是正基科技推出的一款低成本低功耗的双模模块。是一款SDIO接口单通道802.11ac双频支持BT5.0 蓝牙WiFi二合一模块。ModelAP6256SDIO WIFI UART BTChipBCM43456WiFi 2.4G5GBT5.0WIFI Throughputup:196 Mbits/sec down: 187 Mbits/sec二、环境介绍硬件环境ArmSoM-W3 RK3588开发板、AP6256软件版本OSArmSoM-W3 Debian11三、DTS配置3.1 配置SDIO/* SDIO接口Wi-Fi专用配置SDIO接口节点 */sdio{max-frequency150000000;/* sdio接口的最大频率,可调整 */ supports-sdio;bus-width4;/*4线模式可调整1线模式 */ disable-wp;cap-sd-highspeed;cap-sdio-irq;keep-power-in-suspend;mmc-pwrseqsdio_pwrseq;non-removable;num-slots1;pinctrl-namesdefault;pinctrl-0sdiom0_pins;sd-uhs-sdr104;/* 支持SDIO3.0 */ statusokay;};3.2 WIFI的配置WIFI_REG_ON: Wi-Fi的电源使能PIN脚配置 ( 控制WIFI模块电源的GPIO )WL_REG_ON由sdio_pwrseq节点进行管理控制不需要在wireless-wlan节点下面重复添加WIFI,poweren_gpio配置;/* SDIO接口Wi-Fi专用配置 WIFI_REG_ON: Wi-Fi的电源使能PIN脚 */ sdio_pwrseq: sdio-pwrseq{compatiblemmc-pwrseq-simple;clockshym8563;clock-namesext_clock;pinctrl-namesdefault;pinctrl-0wifi_enable_h;reset-gpiosgpio0 RK_PC4 GPIO_ACTIVE_LOW;/*跟电源使能状态恰好相反高有效为LOW低有效则为HIGH。切记这个配置跟下面的WIFI,poweren_gpio是互斥的不能同时配置*/ /*特别注意reset-gpios的GPIO_ACTIVE 配置跟poweren_gpio配置的电源使能状态恰好是相反的*/};/* SDIO接口Wi-Fi专用配置WIFI_REG_ON脚的pinctrl的配置 */pinctrl{sdio-pwrseq{wifi_enable_h: wifi-enable-h{rockchip,pins0RK_PC4 RK_FUNC_GPIOpcfg_pull_none;/* 对应上面的WIFI_REG_ON关掉上下拉防止不能拉高或拉低 */};};}WIFI节点配置/* Wi-Fi节点 */ wireless_wlan: wireless-wlan{compatiblewlan-platdata;wifi_chip_typeap6256;//模块名称 pinctrl-namesdefault;pinctrl-0wifi_host_wake_irq;WIFI,host_wake_irqgpio0 RK_PB2 GPIO_ACTIVE_HIGH;//WIFI模块唤醒CPU的 //WIFI,poweren_gpiogpio0 RK_PC4 GPIO_ACTIVE_HIGH;//控制WIFI模块电源的GPIO,配置了sdio_pwrseq就不需要再配置poweren_gpio statusokay;};WIFI,host_wake_irq的配置说明WIFI,host_wake_irqgpio0 RK_PB2 GPIO_ACTIVE_HIGH;/* WIFI_WAKE_HOST: Wi-Fi中断通知主控的PIN脚。 * 特别注意确认下这个Wi-Fi pin脚跟主控的pin的硬件连接关系直连的话就是GPIO_ACTIVE_HIGH;* 如果中间加了一个反向管就要改成低电平GPIO_ACTIVE_LOW触发 */WIFI_WAKE_HOST脚的pinctrl的配置:pinctrl{wireless-wlan{wifi_host_wake_irq: wifi-host-wake-irq{rockchip,pins0RK_PB2 RK_FUNC_GPIOpcfg_pull_down;};};}/* 注意一般Wi-Fi的wakehostpin都是高电平触发 * 所以默认这里要配置为下拉;如果客户的硬件设计 * 是反向的则要改为上拉总之要初始化为与触发电平 * 相反的状态 */3.3 蓝牙的配置以下UART相关的都要配置为实际使用的UART口的所对应PIN注意RTS/CTS pin一定要按照SDK设计接(具体接法参考7.3章节的UART描述)很多客户反馈的异常都是因为这两个PIN脚没有接导致初始化异常下面假设蓝牙使用UART4bt_uart6: wireless_bluetooth: wireless-bluetooth{compatiblebluetooth-platdata;clockshym8563;//外部时钟 clock-namesext_clock;uart_rts_gpiosgpio1 RK_PA2 GPIO_ACTIVE_LOW;//uart的rts脚 pinctrl-namesdefault,rts_gpio;pinctrl-0uart6m1_rtsn;pinctrl-1uart6_gpios;BT,reset_gpiogpio3 RK_PA6 GPIO_ACTIVE_HIGH;//蓝牙的复位脚 BT,wake_host_irqgpio0 RK_PC5 GPIO_ACTIVE_HIGH;//蓝牙模块唤醒CPU的GPIO statusokay;};pinctrl{wireless-bluetooth{uart6_gpios: uart6-gpios{rockchip,pins1RK_PA2 RK_FUNC_GPIOpcfg_pull_none;};};}蓝牙对应的uart6配置/* 打开对应的UART配置 */uart6{pinctrl-namesdefault;/* 这里配置对应主控UART的TX/RX/CTS PIN 不要配置RTS PIN*/ pinctrl-0uart6m1_xferuart6m1_ctsn;statusokay;};四 、内核配置4.1 WIFI配置kernel配置defconfigrockchip_linux_defconfig 配置CONFIG_WL_ROCKCHIPyCONFIG_WIFI_BUILD_MODULEy# CONFIG_WIFI_LOAD_DRIVER_WHEN_KERNEL_BOOTUP is not setCONFIG_BCMDHDyCONFIG_AP6XXXm# CONFIG_BCMDHD_PCIE is not set #PCIE接口与SDIO互斥不是PCIE可不配CONFIG_BCMDHD_SDIOy#SDIO接口与PCIE互斥MK文件中定义的Kernel defconfigkernel的defconfig对应到这个文件 “kernel\arch\arm64\configs\rockchip_linux_defconfig”# Kernel defconfigexportRK_KERNEL_DEFCONFIGrockchip_linux_defconfigcdkernelmakeARCHarm64 menuconfigmakesavedefconfig选择Device Drivers — Network device support — Wireless LAN — Rockchip Wireless LAN supportWi-Fi驱动可编译到内核或者ko方式切记下面两个配置必须二选一否则Wi-Fi无法加载KO 配置[* ] build wifi ko modulesCONFIG_WIFI_BUILD_MODULEy# CONFIG_WIFI_LOAD_DRIVER_WHEN_KERNEL_BOOTUP is not setbuildin 配置[* ] Wifi load driver when kernel bootupCONFIG_WIFI_LOAD_DRIVER_WHEN_KERNEL_BOOTUPy# CONFIG_WIFI_BUILD_MODULE is not setbuildin 只能选择一个型号realtek 模组和 ap6xxx 模组不能同时选择为y且realtek的也只能选择其中一个ap6xxx 和 cypress 也是互斥的只能选择一个且如果选择ap6xxxcypress的配置自动消失去掉ap配置cypress自动出现ko方式则可以选择多个Wi-Fi4.2 蓝牙配置kernel配置defconfig正基和海华的模块使用内核的默认CONFIG_BT_HCIUART 驱动cdkernelmakeARCHarm64 menuconfigmakesavedefconfig选择 Networking support — Bluetooth subsystem support — Bluetooth device drivers注意配置完成后要保存到对应的defconfig五、Wi-Fi/BT的文件及更新及编译说明5.1 查看板上生成的ko文件和firmware / nvram文件正基/海华模组以AP6256为例对应的Wi-Fi/BT的firmware在SDK中的位置external/rkwifibt/firmware/broadcom/AP6256/ ├── bt │ └── BCM4345C5.hcd └── wifi ├── fw_bcm43456c5_ag.bin ├── fw_bcm43456c5_ag_mfg.bin └── nvram_ap6256.txt经过编译规则编译后对应的文件被拷贝到工程的output目录(kernel4.19内核由system变更为vendor目录)buildroot/output/rockchip_rk3xxxx/target/ /system(vendor)/lib/modules/bcmdhd.ko#驱动ko如果是ko编译的话/system(vendor)/etc/firmware/fw_bcm43456c5_ag.bin#驱动firmware文件存放位置/system(vendor)/etc/firmware/fw_bcm43456c5_ag_mfg.bin#驱动firmware文件存放位置/system(vendor)/etc/firmware/nvram_ap6256.txt#驱动nvram文件存放位置/system(vendor)/etc/firmware/BCM4345C5.hcd#蓝牙firmware文件如果有蓝牙功能最终烧录到机器中后Wi-Fi运行时所需的文件及存放位置/system(vendor)/lib/modules/bcmdhd.ko#驱动ko如果是ko编译的话/system(vendor)/etc/firmware/fw_bcm43456c5_ag.bin#驱动firmware文件存放位置/system(vendor)/etc/firmware/fw_bcm43456c5_ag_mfg.bin#驱动firmware文件存放位置/system(vendor)/etc/firmware/nvram_ap6256.txt#驱动nvram文件存放位置/system(vendor)/etc/firmware/BCM4345C5.hcd#蓝牙firmware文件如果有蓝牙功能5.2 编译配置说明mk文件配置路径3588_linux5.10_v1.0.5/device/rockchip/rk3588/BoardConfig-rk3588-pi5.mk兼容正基和RealtekRK_WIFIBT_TTY这个参数根据蓝牙对应的串口来配置此处蓝牙对应的是uart6# Define WiFi BT chip# Compatible with Realtek and AP6XXX WiFi : RK_WIFIBT_CHIPALL_AP# Compatible with Realtek and CYWXXX WiFi : RK_WIFIBT_CHIPALL_CY# Single WiFi configuration: AP6256 or CYW43455: RK_WIFIBT_CHIPAP6256exportRK_WIFIBT_CHIPALL_AP# Define BT ttySXexportRK_WIFIBT_TTYttyS6