一、简介

专栏总目录AP6256是正基科技推出的一款低成本，低功耗的双模模块。是一款SDIO接口单通道802.11ac双频支持BT5.0 蓝牙WiFi二合一模【mó】块【kuài】。Model：AP6256：SDIO WIFI + UARTBTChip：BCM43456WiFi：2.4G&5GBT：5.0WIFI Throughput：up:196 Mbits/sec down: 187 Mbits/sec

二、DTS配置

2.1 配置SDIO

/* SDIO接口Wi-Fi专用配置：SDIO接口节【jiē】点 */&sdio {max-frequency = < 150000000 >;  /* sdio接口的【de】最大频【pín】率,可调【diào】整 */supports-sdio;bus-width = < 4 >;    /* 4线【xiàn】模式【shì】，可调整1线模式 */disable-wp;cap-sd-highspeed;cap-sdio-irq;keep-power-in-suspend;mmc-pwrseq = < &sdio_pwrseq >;non-removable;num-slots = < 1 >;pinctrl-names = "default";pinctrl-0 = < &sdiom0_pins >;sd-uhs-sdr104;     /* 支持SDIO3.0 */status = "okay";};

2.2 WIFI的配置

WIFI_REG_ON: Wi-Fi的电源使能PIN脚配置 ( 控【kòng】制WIFI模块电源的GPIO )WL_REG_ON由sdio_pwrseq节点进行管理控制，不需【xū】要在【zài】wireless-wlan节点下面【miàn】重【chóng】复添【tiān】加【jiā】WIFI,poweren_gpio配【pèi】置;

/* SDIO接口Wi-Fi专用配【pèi】置： WIFI_REG_ON: Wi-Fi的电源使能PIN脚【jiǎo】 */sdio_pwrseq: sdio-pwrseq {compatible = "mmc-pwrseq-simple";clocks = < &hym8563 >;clock-names = "ext_clock";pinctrl-names = "default";pinctrl-0 = < &wifi_enable_h >;reset-gpios = < &gpio0 RK_PC4 GPIO_ACTIVE_LOW >;  /*跟电源使【shǐ】能状态恰好相反【fǎn】：高有【yǒu】效为LOW，低【dī】有【yǒu】效则【zé】为HIGH。切记：这个配置跟【gēn】下面的WIFI,poweren_gpio是互斥的，不能同时【shí】配置【zhì】！！！*/ /*特别注【zhù】意：reset-gpios的GPIO_ACTIVE 配置跟【gēn】poweren_gpio配置的【de】电源使能【néng】状态恰好是相反的【de】*/};/* SDIO接口Wi-Fi专用【yòng】配置：WIFI_REG_ON脚的pinctrl的配置 */&pinctrl {sdio-pwrseq {wifi_enable_h: wifi-enable-h {rockchip,pins = < 0 RK_PC4 RK_FUNC_GPIO &pcfg_pull_none >;  /* 对应上面的WIFI_REG_ON，关掉上下拉，防【fáng】止不能拉【lā】高或【huò】拉低【dī】 */};};}

WIFI节点配置

/* Wi-Fi节点 */wireless_wlan: wireless-wlan {compatible = "wlan-platdata";wifi_chip_type = "ap6256";        //模块名【míng】称pinctrl-names = "default";pinctrl-0 = < &wifi_host_wake_irq >;WIFI,host_wake_irq = < &gpio0 RK_PB2 GPIO_ACTIVE_HIGH >;     //WIFI模块唤醒CPU的//WIFI,poweren_gpio = < &gpio0 RK_PC4 GPIO_ACTIVE_HIGH >;    //控制WIFI模块电【diàn】源的GPIO,配置了sdio_pwrseq就不【bú】需要再【zài】配置poweren_gpio status = "okay";};

WIFI,host_wake_irq的配置说明：

WIFI,host_wake_irq = < &gpio0 RK_PB2 GPIO_ACTIVE_HIGH >; /* WIFI_WAKE_HOST: Wi-Fi中断【duàn】通知主控的PIN脚。* 特别注意：确认下这【zhè】个Wi-Fi pin脚跟【gēn】主【zhǔ】控【kòng】的pin的硬件连接关系【xì】，直连的话就是【shì】GPIO_ACTIVE_HIGH;* 如【rú】果中间加了一个【gè】反向【xiàng】管就要改成低电【diàn】平GPIO_ACTIVE_LOW触发*/

WIFI_WAKE_HOST脚的pinctrl的配置:

&pinctrl {wireless-wlan {wifi_host_wake_irq: wifi-host-wake-irq {rockchip,pins = < 0 RK_PB2 RK_FUNC_GPIO &pcfg_pull_down >;};};}/* 注意【yì】一【yī】般【bān】Wi-Fi的wake host pin都是高【gāo】电平触发，* 所以默认这里要【yào】配置为下拉; 如果客户的硬件设计* 是反向【xiàng】的【de】则要改为上拉，总之要初始【shǐ】化【huà】为与【yǔ】触发电平* 相反的状态*/

2.3 蓝牙的配置

以下【xià】UART相关【guān】的都要配【pèi】置【zhì】为实际使用的UART口的所【suǒ】对应PIN，注意RTS/CTS pin一定【dìng】要【yào】按照SDK设计

【资料图】

接【jiē】(具体【tǐ】接法【fǎ】参考7.3章节的【de】UART描【miáo】述)，很多客户反馈【kuì】的异常都是【shì】因为这两个PIN脚没【méi】有接导致初始化

异常，下面假设蓝牙使用UART4：

bt_uart6: wireless_bluetooth: wireless-bluetooth {compatible = "bluetooth-platdata";clocks = < &hym8563 >;                                     //外部时钟clock-names = "ext_clock"; uart_rts_gpios = < &gpio1 RK_PA2 GPIO_ACTIVE_LOW >;        //uart的rts脚pinctrl-names = "default", "rts_gpio";pinctrl-0 = < &uart6m1_rtsn >;pinctrl-1 = < &uart6_gpios >;BT,reset_gpio    = < &gpio3 RK_PA6 GPIO_ACTIVE_HIGH >;     //蓝牙的复【fù】位脚【jiǎo】BT,wake_host_irq = < &gpio0 RK_PC5 GPIO_ACTIVE_HIGH >;     //蓝牙模【mó】块【kuài】唤醒CPU的GPIOstatus = "okay";};&pinctrl {wireless-bluetooth {uart6_gpios: uart6-gpios {rockchip,pins = < 1 RK_PA2 RK_FUNC_GPIO &pcfg_pull_none >;};};}

蓝牙对应的uart6配置

/* 打开对应的UART配【pèi】置【zhì】 */&uart6 {pinctrl-names = "default";/* 这里配置对应主【zhǔ】控UART的TX/RX/CTS PIN ，不要【yào】配置RTS PIN*/pinctrl-0 = < &uart6m1_xfer &uart6m1_ctsn >;status = "okay";};

三 、内核配置

3.1 WIFI配置：kernel配置defconfig

MK文件【jiàn】中定义的Kernel defconfig：kernel的defconfig对应到这【zhè】个文【wén】件【jiàn】： "kernel\\arch\\arm64\\configs\\rockchip_linux_defconfig"

# Kernel defconfigexport RK_KERNEL_DEFCONFIG=rockchip_linux_defconfig

cd kernelmake ARCH=arm64 menuconfigmake savedefconfig

选择：Device Drivers ---> Network device support ---> Wireless LAN ---> Rockchip Wireless LAN support

Wi-Fi驱动可【kě】编【biān】译到内核或者【zhě】ko方【fāng】式， 切记下【xià】面【miàn】两个配【pèi】置必须二选一，否则Wi-Fi无法加载！

KO 配置：[* ] build wifi ko modules

CONFIG_WIFI_BUILD_MODULE=y# CONFIG_WIFI_LOAD_DRIVER_WHEN_KERNEL_BOOTUP is not set

buildin 配置：[* ] Wifi load driver when kernel bootup

CONFIG_WIFI_LOAD_DRIVER_WHEN_KERNEL_BOOTUP=y# CONFIG_WIFI_BUILD_MODULE is not set

buildin 只能【néng】选择一个型【xíng】号，realtek 模【mó】组和 ap6xxx 模【mó】组不能同时选择为y，且realtek的也只能选【xuǎn】择其

中一个；

ap6xxx 和 cypress也是【shì】互斥的，只【zhī】能选择一【yī】个且如果选择ap6xxx，cypress的【de】配置自动消【xiāo】失，去掉ap

配置，cypress自动出现；

ko方式则可以选择多个Wi-Fi

3.2 蓝牙配置：kernel配置defconfig

正基和【hé】海华的【de】模块使【shǐ】用内核的默认CONFIG_BT_HCIUART 驱动【dòng】：

cd kernelmake ARCH=arm64 menuconfigmake savedefconfig

选择： Networking support ---> Bluetooth subsystem support ---> Bluetooth device drivers

注意：配置完成后要保存到对应的defconfig

四、Wi-Fi/BT的文件及更新及编译说明

4.1 查看板上生成的ko文件和firmware / nvram文件

正基/海华模【mó】组以AP6256为例：对【duì】应【yīng】的Wi-Fi/BT的firmware在【zài】SDK中的位置：

external/rkwifibt/firmware/broadcom/AP6256/├── bt│ └── BCM4345C5.hcd└── wifi├── fw_bcm43456c5_ag.bin├── fw_bcm43456c5_ag_mfg.bin└── nvram_ap6256.txt

经过编译规则编译后，对应的文件【jiàn】被拷贝【bèi】到工程的output目录【lù】：(kernel4.19内【nèi】核由system变更【gèng】为vendor目录【lù】)

buildroot/output/rockchip_rk3xxxx/target//system(vendor)/lib/modules/bcmdhd.ko #驱动ko（如【rú】果是ko编译的话【huà】）/system(vendor)/etc/firmware/fw_bcm43456c5_ag.bin #驱动firmware文件【jiàn】存放位置/system(vendor)/etc/firmware/fw_bcm43456c5_ag_mfg.bin #驱【qū】动firmware文件存放位【wèi】置【zhì】/system(vendor)/etc/firmware/nvram_ap6256.txt #驱动nvram文件存【cún】放位置/system(vendor)/etc/firmware/BCM4345C5.hcd #蓝牙firmware文件【jiàn】（如果有蓝牙功能）

最终烧录到机器中后，Wi-Fi运行时所需的文件及存放位置：

/system(vendor)/lib/modules/bcmdhd.ko #驱动ko（如果是ko编译的话）/system(vendor)/etc/firmware/fw_bcm43456c5_ag.bin #驱动firmware文【wén】件【jiàn】存放位置【zhì】/system(vendor)/etc/firmware/fw_bcm43456c5_ag_mfg.bin #驱【qū】动firmware文件存放位置【zhì】/system(vendor)/etc/firmware/nvram_ap6256.txt #驱【qū】动nvram文件存【cún】放位置/system(vendor)/etc/firmware/BCM4345C5.hcd #蓝牙firmware文件（如【rú】果有蓝【lán】牙功能）

4.2 编译配置说明

mk文【wén】件【jiàn】配置路径：3588_linux5.10_v1.0.5/device/rockchip/rk3588/BoardConfig-rk3588-pi5.mk兼容正基【jī】和RealtekRK_WIFIBT_TTY这【zhè】个参数根【gēn】据蓝牙对应的串口来配置，此处【chù】蓝牙对应的【de】是uart6

# Define WiFi BT chip# Compatible with Realtek and AP6XXX WiFi : RK_WIFIBT_CHIP=ALL_AP# Compatible with Realtek and CYWXXX WiFi : RK_WIFIBT_CHIP=ALL_CY# Single WiFi configuration: AP6256 or CYW43455: RK_WIFIBT_CHIP=AP6256export RK_WIFIBT_CHIP=ALL_AP# Define BT ttySXexport RK_WIFIBT_TTY=ttyS6

审核编辑：汤梓红