Tina_Linux_Wi-Fi_开发指南

时间:2023-02-26 18:56:18

Tina Linux Wi-Fi 开发指南

1 前言

1.1 文档简介

介绍Allwinner 平台上Wi-Fi 驱动移植,介绍Tina Wi-Fi 管理框架,包括Station,Ap 以及Wi-Fi 常见问题。

1.2 目标读者

适用Tina 平台的广大客户和对Tina Wi-Fi 感兴趣的同事。

1.3 适用范围

Allwinner 软件平台Tina v3.0 版本及以上。
Allwinner 硬件平台R 系列(R6,R11,R16,R18,R30,R40,R328,R331, R329,R818,R528…)。
Allwinner 硬件平台MR 系列(MR133, MR813…)。
Allwinner 硬件平台H 系列(H133…)。
Allwinner 硬件平台V 系列(V853…)。

2 Wi-Fi 简介

2.1 Wi-Fi 工作的几种模式

目前Tina 平台上的Wi-Fi 一般可处于3 种工作模式,分别是STATION,AP,MONITOR。
• STATION:连接无线网络的终端,大部分无线网卡默认都处于该模式,也是常用的一种模式。
• AP:无线接入点,常称热点,比如路由器功能。
• MONITOR:也称为混杂设备监听模式,所有数据包无过滤传输到主机。

2.2 Tina Wi-Fi 软件结构

Tina_Linux_Wi-Fi_开发指南

图2-1: Tina 软件结构图

• wifimanager-v2.0:包含了wifimanager-v1.0 的功能(用于STATION 模式,提供Wi-Fi连接扫描等功能)外,还集成了softap(启动AP 功能)和smartlink(多种配网模式)的功能,做到了一个应用集成了多种wifi 功能,方便客户使用和管理。
• wpa_supplicant: 开源的无线网络配置工具,主要用来支持WEP,WPA/WPA2 和WAPI 无线协议和加密认证的,实际上的工作内容是通过socket 与驱动交互上报数据给用户。
• hostapd: 是一个用户态用于AP 和认证服务器的守护进程。
• monitor: Wi-Fi 处于混杂设备监听模式的处理应用。

2.3 Wi-Fi 常用命令介绍

2.3.1 station 模式

详情请看Tina_linux_wifimanger2.0_ 开发指南。

执行下面的命令前请确保wifi_deamon后台进程已启动,若没有启动请先启动wifi_deamon后台进程。

wifi -o sta 以sta模式打开wifimanager
wifi -s 扫描周围网络
wifi -c ssid [passwd] 以加密或非加密的方式连接指定网络
wifi -d 断开已经连接的网络
wifi -l [all] 列出保存的网络
wifi -a [enable/disable] 重连断开的网络
wifi -r [ssid/all] 移除保存的指定网络
注:
ssid 网络名
passwd 秘钥

2.3.2 ap 模式

执行下面的命令前请确保wifi_deamon后台进程已启动,若没有启动请先启动wifi_deamon后台进程。

wifi -o ap [ssid] [passwd] 以ap模式打开wifimanager
wifi -l 列出连接到ap热点的sta信息
注:
ssid 网络名
passwd 秘钥
ap模式和station模式在不同模组上不一定能共存,详情看第5节介绍。

2.3.3 monitor 模式

执行下面的命令前请确保wifi_deamon后台进程已启动,若没有启动请先启动wifi_deamon后台进程。

wifi -o monitor 以monitor模式打开wifimanager
注:
没有

2.3.4 额外功能

执行下面的命令前请确保wifi_deamon后台进程已启动,若没有启动请先启动wifi_deamon后台进程。

wifi -f 关闭wifimanager
wifi -p [softap/ble/xconfig/soundwave] 使用softap/ble/xconfig/soundwave进行配网
wifi -D [error/warn/info/debug/dump/exce] 设置打印等级
wifi -g 获取mac地址信息
wifi -m [macaddr] 设置mac地址
wifi -h 打印wifimanager使用说明
注:
配网模式并不是所有模组都支持,要看具体的模组。
mac地址设置只能进行临时性设置。

3 Wi-Fi 模组移植

Tina_Linux_Wi-Fi_开发指南

图3-1: 主控与Wi-Fi 硬件连接简图

Wi-Fi 模组工作的条件,如上图,需要满足以下几个条件:
• 供电:一般有两路供电,其中VCC-Wi-Fi 为主电源,VCCIO-Wi-Fi 为IO 上拉电源。
• 使能:要能正常工作,需要WL-REG-ON 给高电平。
• SDIO:与SOC 的通信有通过USB,SDIO 等,这里以SDIO 为例,其中SDIO 0~3 为SDIO 的4 条数据线。
• 唤醒主控:当系统休眠时,Wi-Fi 模组可通过WL-WAKE-AP 通过中断的方式唤醒主控,有些模组也通过该引脚来作为主控接收数据的中断。
• 24/26MHz 时钟信号.
• 32.768KHz 信号:根据模组而定,有些模组内部通过(5)中的输入的clk 进行分频得到,有些需要外部单独输入该信号。

对于Wi-Fi 模组移植,重点围绕以上的几个条件进行开展,对于以上几个工作条件allwinner已经提供了对应的driver,根据总线设备驱动模型,只需要根据各个平

台配置device 即可,allwinner device 除了可以可以通过dts 外(linux-3.4 内核无dts),还可通过sys_config.fex的方式,sys_config.fex 的优先级高于dts,一般情

况下,直接配置sys_config.fex 即可。

说明:

- Tina3.5.0及之前sys_config.fex的路径:tina/target/allwinner/xxx(cowbell_perf1)/configs/
- Tina3.5.1及之后sys_config.fex的路径:tina/device/config/chips/xxx(r328)/configs/xxx(perf1)/
- Tina3.5.0及之前dts的路径:tina/lichee/linux-xxx/arch/arm/boot/dts/
- Tina3.5.1及之后dts的路径:tina/device/config/chips/xxx(r328)/configs/xxx(perf1)/board.dts

linux 3.4 device(sys_config.fex 配置)

[rf_para]
module_num = 10 /*用于区分模组型号:默认8~10*/
module_power1 = "axp22_dldo1" /*power1使用的电源树:dld01*/
module_power1_vol = 3300000 /*power1使用的电源树电压设置为3.3v*/
module_power2 = "axp22_dldo2" /*power2使用的电源树:dld02*/
module_power2_vol = 3300000 /*power2使用的电源树电压设置为3.3v*/
module_power3 = "axp22_aldo3" /*power3使用的电源树:dld03*/
module_power3_vol = 3300000 /*power3使用的电源树电压设置为3.3v*/
/*以上,是使用pmu供电的配置,如果直接供电,可省略*/
power_switch =
chip_en = /*电源使能,备用于使用gpio高低点平打开电源*/
lpo_use_apclk = "losc_out" /*32khz的时钟使能*/
[wifi_para]
wifi_used = 1 /*是否使用Wi-Fi*/
wifi_sdc_id = 1 /*Wi-Fi所使用的sdio 卡号*/
wl_reg_on = port:PL06<1><default><default><0> /*使能脚所使用的gpio*/
wl_host_wake = port:PL07<4><default><default><0> /*唤醒主控所使用的gpio*/
[mmc1_para]
sdc_used = 1
sdc_detmode = 4
sdc_buswidth = 4
sdc_clk = port:PG00<2><1><1><default> /*sdio所使用的gpio号*/
sdc_cmd = port:PG01<2><1><1><default>
sdc_d0 = port:PG02<2><1><1><default>
sdc_d1 = port:PG03<2><1><1><default>
sdc_d2 = port:PG04<2><1><1><default>
sdc_d3 = port:PG05<2><1><1><default>
sdc_det =
sdc_use_wp = 0
sdc_wp =
sdc_isio = 1
sdc_regulator = "none"

linux 3.4 driver 路径,详情请参考以下代码路径

tina/lichee/linux-3.4/drivers/misc/rf_pm

linux3.4 以上,device(sys_config.fex 配置)

[sdc1]
sdc1_used = 1
bus-width = 4
sdc1_clk = port:PG00<2><1><3><default>
sdc1_cmd = port:PG01<2><1><3><default>
sdc1_d0 = port:PG02<2><1><3><default>
sdc1_d1 = port:PG03<2><1><3><default>
sdc1_d2 = port:PG04<2><1><3><default>
sdc1_d3 = port:PG05<2><1><3><default>
sd-uhs-sdr50 =
sd-uhs-ddr50 =
sd-uhs-sdr104 =
cap-sdio-irq =
keep-power-in-suspend =
ignore-pm-notify =
max-frequency = 150000000 /*sdio所使用的最大扫卡频率*/
mix-frequency = 150000000
[wlan]
wlan_used = 1
compatible = "allwinner,sunxi-wlan"
clocks = "losc_out"
wlan_power_num = 2 /*使用pmu供电,所使用的电源数量*/
wlan_power1 = "vcc-wifi1" /*使用pmu供电,使用的power1标示*/
wlan_power2 = "vcc-wifi2" /*使用pmu供电,使用的power2标示*/
wlan_io_regulator = "vcc-io-wifi" /*使用pmu供电,使用的io标示*/
/*上面4行表示使用pmu供电的配置项,对应后面的regulator选项。如果不使用pmu供电,可忽略。*/
wlan_busnum = 1
wlan_regon = port:PE06<1><1><1><0>
wlan_hostwake = port:PE05<6><default><default><default>
[regulator0]
compatible = "axp221s-regulator"
regulator_count = 20
......
regulator2 = "axp221s_dcdc2 none vdd-cpua"
regulator3 = "axp221s_dcdc3 none vdd-sys vdd-gpu"
regulator4 = "axp221s_dcdc4 none"
regulator5 = "axp221s_dcdc5 none vcc-dram"
regulator6 = "axp221s_rtc none vcc-rtc"
regulator7 = "axp221s_aldo1 none vcc-25 csi-avdd"
regulator8 = "axp221s_aldo2 none vcc-ephy0"
regulator9 = "axp221s_aldo3 none avcc vcc-pll"
regulator10 = "axp221s_dldo1 none vcc-io-wifi vcc-pg " /*io power 挂在dld01上*/
regulator11 = "axp221s_dldo2 none vcc-wifi1" /*power1 挂在dld02上*/
regulator12 = "axp221s_dldo3 none vcc-wifi2" /*power2 挂在dld03上*/
regulator13 = "axp221s_dldo4 none vdd-sata-25 vcc-pf"
regulator14 = "axp221s_eldo1 none vcc-pe csi-iovcc"

linux 3.4 以上driver,详情请参考以下代码路径

tina/lichee/linux-XXX/drivers/misc/sunxi-rf

3.1 模组移植的步骤

下面总结一款新模组移植到Tina 平台的步骤。

3.1.1 修改模组厂提供的Wi-Fi driver

模组厂提供过来的driver,适配到Tina 平台,主要修改的地方是调用Tina 平台提供的有上下电,扫卡函数,修改firmware 的download 路径,配置Kconfig 和

Makefile 等。

下面先说明Tina 平台提供给driver 的函数,其中linux 3.4 跟其他内核稍微有些区别。

linux 3.4

#include <mach/sys_config.h>
#include <linux/gpio.h>
/*
*函数功能: sdio扫卡
*参数id: 卡号,(sdio 0 or 1 ...)
*参数insert: 0,卡插入,进行扫卡; 1,卡拔出。
*返回值:无
*/
extern void sunxi_mci_rescan_card(unsigned id, unsigned insert);
/*
*函数功能: Wi-Fi模组上电,使能。
*参数on: 0,上电;1,掉电。
*返回值: 无
*/
extern void wifi_pm_power(int on);

linux 3.4 以上

#include <linux/mmc/host.h>
#include <linux/sunxi-gpio.h>
#include <linux/power/aw_pm.h>
/*
*函数功能: 获取所使用的sdio卡号,对应sysconfig.fex中的wlan_busnum
*返回值: sdio 卡号
*/
extern int sunxi_wlan_get_bus_index(void);
/*
*函数功能: sdio 扫卡
*参数id: 卡号,(sdio 0 or 1 ...)
*返回值: 无
*/
extern void sunxi_mmc_rescan_card(unsigned ids);
/*
*函数功能: Wi-Fi模组上电,使能。
*参数on: 0,上电;1,掉电。
*返回值: 无
*/
extern void sunxi_wlan_set_power(bool on);
/*
*函数功能:获取gpio wlan hostwake pin的申请的中断号
*参数: void
*返回值:irq number
*说明: 部分模组,主控接收数据通过hostwake pin产生中断来触发,
* 所以需要主控这边提供获取到中断号。
*/
extern int sunxi_wlan_get_oob_irq(void);
/*
*函数功能:获取host wake pin设置中断的标志位
*参数: void
*返回值: irq flag
*/
extern int sunxi_wlan_get_oob_irq_flags(void);

首先是将Wi-Fi driver 放到linux-4.9/drivers/net/wireless,填充对应的上电,扫卡等函数。

linux 3.4 的驱动请参考:

esp8089模组:

tina/lichee/linux-3.4/drivers/net/wireless/esp8089/sdio_stub.c

xr819模组:

tina/lichee/linux-3.4/drivers/net/wireless/xradio/wlan/platform.c

linux 3.4 以上的驱动请参考:

tina/lichee/linux-4.9/drivers/net/wireless/rtl8723ds/platform/platform_ARM_SUNnI_sdio.c

其次是增加内核的menuconfig 配置以及编译,只需要修改以下地方即可。

tina/lichee/linux-4.9/drivers/net/wireless/Kconfig
example:
+source "drivers/net/wireless/xr829/Kconfig"
tina/lichee/linux-4.9/drivers/net/wireless/Makefile
example:
+obj-$(CONFIG_XR829_WLAN) += xr829/

配置完成后,可执行make kernel_menuconfig 中选上,编译的时候,就会把指定的driver 编译。

Device Drivers --->
    [*] Network device support --->
        [*] Network device support --->
            [*] Wireless LAN --->
            	[] xxx模块

3.1.2 添加make munconfig 的配置

该步骤主要将kernel 中编译的ko 文件以及firmware 拷贝到跟文件系统中。
首先是配置firmware。firmware 文件一般以模组文件名存放在如下,并需要新增一个mk 文件,使其在make munconfig 中可见。

tina/package/firmware/linux-firmware/XXX模组
tina/package/firmware/linux-firmware/XXX模组/XXX.mk
example:
tina/package/firmware/linux-firmware/xr829
make munuconfig
Firmware --->
< > xr829-firmware..................................... Xradio xr829 firmware

其次是配置ko。

tina/target/allwinner/xxx方案/modules.mk
example:
Tina-3.5.0及以前:
tina/target/allwinner/cowbell-perf1/modules.mk
Tina-3.5.1及以后:
tina/target/allwinner/r328s2-perf1/modules.mk
make munuconfig
    Kernel modules --->
        Wireless Drivers --->
        	XXX 模块

3.1.3 配置sys_config.fex

前面已经阐述,见第3 章节开头描述。

3.1.4 验证

按照前面的配置好,make kernel_menuconfig 选上对应模块,make menuconfig 选项对应
firmware 和模块,同时,make munconfig 新增选上如下,即可进行验证了。

make menuconfig
    Allwinner --->
        wireless --->
            <*> wifimanager-v2.0................................... Tina wifimanager-v2.0
            <*> wifimanager-v2.0-demo..................... Tina wifimanager-v2.0 app demo

验证命令

查看模块是否加载:lsmod
模块卸载: rmmod
ps查看wifi_deamon后台进程是否已起来,若没有起来先启动wifi_deamon后台进程
连接路由命令:wifi -c ssid passwd
扫描周围热点:wifi -s

3.1.5 模组移植示例

以RTL8723DS 为例:

  1. 获取资料
    1.1建议从RTL原厂获取最新版本的完整资料,包括驱动,文档,工具。(也可以从其他内核已适配版本获取驱动)

  2. 内核适配

2.1将整个驱动SDK拷贝到tina/lichee/linux-xxx/drivers/net/wireless/
2.2驱动重命名为rtl8723ds
2.3在tina/lichee/linux-xxx/drivers/net/wireless/目录修改Kconfig和Makefile
Kconfig:
+source "drivers/net/wireless/rtl8723ds/Kconfig"
Makefile:
+obj-$(CONFIG_RTL8723DS) += rtl8723ds/ (注意:这里命名一定要匹配)
2.4修改驱动原生代码
2.4.1驱动的Makefile(tina/lichee/linux-xxx/drivers/net/wireless/rtl8723ds/Makefile)
+CONFIG_RTW_ANDROID = 0 (# CONFIG_RTW_ANDROID - 0: no Android, 4/5/6/7/8/9/10 : Android
version)
+CONFIG_PLATFORM_I386_PC = n
+CONFIG_PLATFORM_ARM_SUNxI = y
2.4.2替换适配sunxi的平台文件(tina/lichee/linux-xxx/drivers/net/wireless/rtl8723ds/platform)
可以从已经适配过的其他模组获取:platform_ARM_SUNxI_sdio.c
  1. Tina module 适配

    3.1.从其他任意已经支持的IC方案中拷贝module的配置
    define KernelPackage/net-rtl8723ds
    SUBMENU:=$(WIRELESS_MENU) //make menuconfig的菜单位置,一般不更改。
    TITLE:=RTL8723DS support (staging) //make menuconfig的提示
    DEPENDS:= +r8723ds-firmware +@IPV6 +@USES_REALTEK +@PACKAGE_realtek-rftest +
    @PACKAGE_rtk_hciattach //添加tina依赖,可以理解为select
    FILES:=$(LINUX_DIR)/drivers/net/wireless/rtl8723ds/8723ds.ko
    KCONFIG:=\ //添加内核依赖可以理解位select
    ...
    AUTOLOAD:=$(call AutoProbe,8723ds)
    endef
    define KernelPackage/net-rtl8723ds/description //make menuconfig的描述
    Kernel modules for RealTek RTL8723DS support
    endef
    $(eval $(call KernelPackage,net-rtl8723ds))
    一个完整的module
    注:建议直接添加在平台的通用配置中:tina/target/allwinner/xxx-common/modules.mk
    3.2.firmware的配置
    /package/firmware/linux-firmware/rtl8723ds/ //更新驱动时更新firmware文件(如果有最新的)
    3.3.sys_config.fex/board.dts的配置
    rfkill: rfkill@0 {
    compatible = "allwinner,sunxi-rfkill";
    chip_en;
    power_en;
    status = "okay";
    wlan: wlan@0 {
    compatible = "allwinner,sunxi-wlan";
    pinctrl-0 = <&wlan_pins_a>;
    pinctrl-names = "default";
    clock-names = "32k-fanout1";
    clocks = <&ccu CLK_FANOUT1_OUT>;
    wlan_busnum = <0x1>;
    wlan_regon = <&pio PE 17 GPIO_ACTIVE_HIGH>;
    wlan_hostwake = <&pio PG 10 GPIO_ACTIVE_HIGH>;
    /*wlan_power = "VCC-3V3";*/
    /*wlan_power_vol = <3300000>;*/
    /*interrupt-parent = <&pio>;
    interrupts = < PG 10 IRQ_TYPE_LEVEL_HIGH>;*/
    wakeup-source;
    };
    ...
    }
    
    1. 整体编译烧写
    2. 验证排查

3.1.6 模组移植总结

主要就是以下几点:
• 修改模组厂提供的driver,填充相应的上电,扫卡等函数。
• 增加make kernel_menuconfig 和make menuconfig 选项, 涉及到firmware,makefile,ko。
• 配置sys_config.fex。
• 验证。

目前Tina 平台的linux 内核版本有linux_3.4,linux_3.10,linux_4.4,linux_4.9,linux_5.4,由于历史原因,很有可能内核版本之间的配置有些不一样,主要体现在device:sys_config.fex 以及driver:sunxi-rf。用户在模组移植时,可参考对应各个内核版本进行参考。

Tina-3.5.0 及以前:

产品名称 内核版本 sys_config.fex
R16 Linux-3.4 tina/target/allwinner/astarparrot/configs/sysconfig.fex
R18 Linux-4.4 tina/target/allwinner/tulip_d1/configs/sysconfig.fex
R328 Linux-4.9 tina/target/allwinner/cowbell_demo/configs/sysconfig.fex

Tina-3.5.1 及以后:

产品名称 内核版本 配置文件
R16 Linux-3.4 tina/device/config/chips/r16/configs/parrot/sys_config.fex
R18 Linux-4.4 tina/device/configs/chips/r18/configs/d1/sys_config.fex
R328 Linux4.9 tina/device/config/chips/r328s2/configs/perf1/sys_config.fex(board.dts)
R528 Linux-5.4 tina/device/config/chips/r528/configs/evb1/sys_config.fex(board.dts)

3.2 Tina 平台已经移植的模组

Tina 平台上已经移植过多款Wi-Fi 模组,支持列表如下:

BCM : AP6212,AP6212A,AP6255,AP6256,AP6335等。
Realtek: RTL8723DS(linux 3.4/4.9/5.4),RTL8821cs(linux 4.9/5.4),RTL8822cs(linux 4.9),RTL8189FTV(linux4.9)
Xradio : XR819(linux 3.4/4.4/4.9),xr829(linux 3.4/4.4/4.9/5.4)
Esp : esp8089(linux 3.4)
.....

对于以上已经移植的模组,用户大多情况只需要在kernel_menuconfig 和menuconfig 选上对应的配置即可。如果按照在对应的menuconfig 中选上,还是不

能工作,就按照3.1 小节的步骤依次排查原因。同时,如果有些方案可能在make menuconfig 中无法显示相应的Kernel modules,这是因为在方案下的

modules.mk 文件中没有添加,可按照3.1.2 小节的方式进行添加。

以下列出各个模组kernel_menuconfig 以及menuconfig 的选项。

3.2.1 BCM 系列的模组

make kernel_menuconfig 配置

Device Drivers --->
	Network device support --->
		Wireless LAN --->
			<M> Broadcom FullMAC wireless cards support
                (/lib/firmware/fw_bcmdhd.bin) Firmware path
                (/lib/firmware/nvram.txt) NVRAM path
PS: BCM系列的模组,如AP6212,AP6255,AP6256..都是用的同一份driver

make menuconfig 配置

Kernel modules--->
	Wireless Drivers--->
	<*> kmod-net-broadcom
Firmware--->
	<*> ap6212-firmware. ---根据模组型号选择

3.2.2 XR 系列的模组

(1)XR819
make kernel_menuconfig 配置

Device Drivers --->
	Network device support --->
		Wireless LAN --->
			<M> XR819 WLAN support --->
		/*or*/<M> XRadio WLAN support --->

make menuconfig 配置

Kernel modules--->
	Wireless Drivers--->
		<*> kmod-net-broadcom
Firmware--->
	<*> xr819-firmware..................................... Xradio xr819 firmware

(2)XR829
make kernel_menuconfig 配置

Device Drivers --->
	Network device support --->
	Wireless LAN --->
	<M> XR829 WLAN support --->

make menuconfig 配置

Kernel modules--->
Wireless Drivers--->
<*> kmod-net-xr829................................... xr829 support (staging)
Firmware--->
<*> xr829-firmware..................................... Xradio xr829 firmware

3.2.3 REALTEK 系列的模组

(1)RTK8723DS
make kernel_menuconfig 配置

Device Drivers --->
	Network device support --->
	Wireless LAN --->
	<M> Realtek 8723D SDIO or SPI WiFi

make menuconfig 配置

Kernel modules--->
    Wireless Drivers--->
    	<*> kmod-net-rtl8723ds........................... RTL8723DS support (staging)
Firmware--->
	<*> r8723ds-firmware.............................. RealTek RTL8723DS firmware

(2)RTK8822CS
make kernel_menuconfig 配置

Device Drivers --->
    Network device support --->
    	Wireless LAN --->
    		<M> Realtek 8822C SDIO WiFi

make menuconfig 配置

Kernel modules--->
	Wireless Drivers--->
		<*> kmod-net-rtl8822cs........................... RTL8723CS support (staging)
Firmware--->
		<*> rtl8821cs-firmware............................ RealTek RTL8821CS firmware

(3)RTK8189FTV
make kernel_menuconfig 配置

Device Drivers --->
	Network device support --->
		Wireless LAN --->
			<M> Realtek 8189F SDIO WiFi

make menuconfig 配置

Kernel modules--->
	Wireless Drivers--->
		<*> kmod-net-rtl8189fs........................... RTL8189FS support (staging)
注:RTL8189FTV 在tina配置中不需要firmware配置.

3.2.4 ESP 系列的模组

(1)ESP8089
make kernel_menuconfig 配置

Device Drivers --->
	Network device support --->
		Wireless LAN --->
			<*> Eagle WLAN driver

make menuconfig 配置

Kernel modules--->
	Wireless Drivers--->
		<*> kmod-esp8089................................... esp8089 support (staging)
Firmware--->
		<*> esp8089-firmware........................................ esp8089 firmware

3.3 Tina 主要平台模组支持列表

硬件平台 支持模组 内核版本
R6 XR819 linux3.10
R7/R11 XR819 linux3.4
R16 AP6210/AP6212/AP6181/8723BS linux3.4
R18 AP6212/AP6236/AP6255 linux4.4
R30 AP6181/AP6212/AP6234/AP6330/8723BS linux4.4
R40 AP6212 linux3.10
R58 AP6212/AP6181/8723BS linux3.4
R311 AP6212/AP6181/8723BS linux4.9
R328 XR829/8723DS(单天线) linux4.9
R329 XR829/8723DS(单双天线) linux4.9
R331/R332/R333 8723DS(单天线) linux4.9
R818 XR829/8723DS(单双天线)/8189FTV/8821CS(单双天线) linux4.9
MR133 AP6212/AP6181/8723BS linux4.9
MR813 XR829/8723DS(单双天线)/8189FTV linux4.9
T7 AP6210/AP6212/AP6234 linux4.9
R528 RTL8723ds(单)/RTL8821cs/xr829 linux5.4
V853 XR829/XR819s/RTL8189FS linux4.9

4 Wi-Fi manager 介绍

wifimanager 已升级为wifimanager2.0,wifimanager2.0 已独立出一个单独文档,wifimanager2.0的具体介绍请参考

Tina_linux_wifimanger2.0_ 开发指南

5 Softap 介绍

softap 功能已集成到wifimanager2.0,wifimanager2.0 已独立出一个单独文档,wifimanager2.0的具体介绍请参考

Tina_linux_wifimanger2.0_ 开发指南

6 常见问题

6.1 编译问题

6.1.1 找不到wowlan 变量

  1. 现象:
drivers/net/wireless/xr829/umac/main.c:870:17: error: 'struct wiphy' has no member named 'wowlan'
if ((hw->wiphy->wowlan->flags || hw->wiphy->wowlan->n_patterns)
  1. 原因:
    wowlan成员变量受CONFIG_PM控制,没有打开导致的.休眠唤醒的依赖。

  2. 解决方案:

在内核配置
-Power management options --->
Device power management core functionality

6.1.2 找不到xxx.ko

  1. 现象:

    sunxi_wlan_get_bus_index...xradio_core.ko undefined!
    
  2. 原因:
    缺少配置misc。

  3. 解决方案:
    在内核配置

    m kernel_menuconfig-->
       Device drivers-->
       	Misc devices-->
       		Allwinner rfkill driver
    

6.1.3 mmc_xxx undefined

  1. 现象:
drivers/built-in.o: In function scan_device_store':
lichee/linux-4.9/drivers/misc/sunxi-rf/sunxi-wlan.c:309: undefined reference
tosunxi_mmc_rescan_card'
lichee/linux-4.9/drivers/misc/sunxi-rf/sunxi-wlan.c:309:(.text+0x5fc40): relocation
truncated to fit:
R_AARCH64_CALL26 against undefined symbol `sunxi_mmc_rescan_card'
  1. 原因:
    没有配置mmc。

  2. 解决方案

Device Drivers --->
	<*> MMC/SD/SDIO card support --->
	<*> Allwinner sunxi SD/MMC Host Controller support

6.1.4 缺少依赖库

  1. 现象:

    Package kmod-net-xr829 is missing dependencies for the following libraries:
    cfg80211.ko
    mmc_core.ko
    sunxi-wlan.ko
    
  2. 原因:
    依赖库需要编译进内核,不能以模块方式编译进去。

  3. 解决方案。

    在内核配置如下模块时,配置成y
    CONFIG_RFKILL =y
    CONFIG_CFG80211=y
    CONFIG_MMC=y
    CONFIG_MAC80211=y
    

6.2 驱动加载问题

6.2.1 R16 博通模组联网时提示:No such device.

  1. 现象:
root@TinaLinux:/# wifi_add_network_test ssid passwd 1

*********************************

***Start wifi connect ap test!***

*********************************

wpa_suppplicant not running!
Cannot create "/data/misc/wifi/entropy.bin": No such file or directory
Wi-Fi entropy file was not created
ifconfig: SIOCGIFFLAGS: No such device
event_label 0x0
wifi on failed!
wifi on failed event 0xf001
  1. 原因:
firmware选择不匹配,导致驱动加载时下载失败.

- lsmod查看驱动已经正常加载
- dmesg 查看加载log发现:
  [ 22.336336] dhdsdio_download_code_file: Open firmware file failed /lib/firmware/
  fw_bcm43438a1.bin
  [ 22.346331] _dhdsdio_download_firmware: dongle image file download failed
  表示firmware固件缺失(这里表示缺失fw_bcm43438a1.bin)
  最后发现是在配置firmware时选择了ap6212,正常应该用ap6212a
  1. 解决方案
tina配置正确的firmware
firmware --->
└─> <*> ap6212a-firmware............................... Broadcom AP6212A firmware

6.2.2 R329_XR829 模组ifconfig 显示:No such device

  1. 现象:

    ifconfig: SIOCGIFFLAGS: No such device
    
  2. 原因:

    firmware选择不匹配。
    
    - lsmod查看驱动已经正常加载。
    - dmesg 查看加载log发现:
      [ 195.966066] [XRADIO_ERR] xradio_load_firmware: Wait for wakeup:device is not responding.
      XR829换了40M晶振。
    
  3. 解决方案

    tina配置选择40M晶振的firmware
    firmware --->
    	[*] xr829 with 40M sdd
    

6.2.3 MR133_XR829 can’t open /etc/wifi/xr_wifi.conf, failed

1.现象:

lsmod驱动没有正常加载。

原因:

dmesg查看log:
[ 6.802331] [XRADIO_ERR] can't open /etc/wifi/xr_wifi.conf, failed(-30)
[ 6.802338] [XRADIO_ERR] Access_file failed, path:/etc/wifi/xr_wifi.conf!
[ 6.914044] sunxi-mmc sdc1: no vqmmc,Check if there is regulator
[ 7.028376] [XRADIO_ERR] xradio_load_firmware: Wait_for_wakeup: can't read control
register.
busnum配置错误,原理图上使用的是sdc0.

2.解决方案

board.dts中配置wlan时
busnum = 0;

6.2.4 驱动加载问题总结

6.2.4.1 配置问题
1.内核驱动,Tina modules, Tina firmware三者必须正确对应同一个模组。
2.注意common下的modules.mk的编写。
3.Sdio的配置一定要根据原理图选择对应busnum。
可能导致:
1.扫卡失败。
2.下载firmware失败。
最终导致驱动加载失败。
6.2.4.2 供电问题
检查VCC_WIFI和VCC_IO_WIFI两路电。
不同模组对供电时序有一定要求,比如RTL8723ds需要两路电同时供电,针对有AXP的方案,一定要注意供电的配置,特别是enable的时间。
1.硬件方面:主要排查两路电的供电方案,是否是同一路供电,若是分开供电,要考虑两路供电的时序,
例如DCDC1--->VCC_WIFI,LDOA--->VCC_IO_WIFI,那么DCDC1和LDOA的时序就得考虑。
2.软件方面主要是sysconfig.fex或者boart.dts的配置,分开供电的是否需要单独配置。
如:R818硬件设计是两路电分开供电。
可能导致:
1.扫卡失败。
2.下载firmware失败。
3.sdio_clk没有时钟。
4.32k竞争不起振。
最终导致驱动加载失败。
6.2.4.3 sdio 问题
1.sdio busnum配置错误.
2.驱动WL-REG-ON的方式不对.例如:
XR819模块出现
[SBUS_ERR] sdio probe timeout!
[XRADIO_ERR] sbus_sdio_init_failed
这个问题主要是sdio扫卡失败,跟sdio上电时序有关,可在drivers/net/wireless/xradio/wlan/platform.c中
xradio_wlan_power函数sunxi_wlan_set_power(on)后面加上一段延时。
RLT8723ds需要先高-低-高的方式.
可能导致:
1.扫卡失败。
2.下载firmware失败。
3.sdio_clk没有时钟。
4.32k晶振不起振。
5.WL-REG-ON无法正常被拉高。
最终导致驱动加载失败。

6.3 起wlan0 网卡问题

6.3.1 R818_RTL8723ds ifconfig wlan0 up: No such device

1.现象:

ifconfig: SIOCGIFFLAGS: No such device

2.原因:

- lsmod查看驱动已经正常加载。
- dmesg查看log未发现异常。
- 排查sdio_clk, regon_on,32k,都正常。
- 两路供电都正常配置。
- 对比其他平台硬件发现,供电方式不一样,两路电采用了分开供电,咨询RTL需要同时上电。

3.解决方案
硬件更改,VCC_WIFI/VCC_IO_WIFI用同一路电供电。

6.3.2 R328_RTL8723ds 无法自启动wlan0

1.现象:

启动脚本/etc/init.d/wpa_supplicant中会自启动wlan0
但是每次启动启动都自启动失败,然后手动ifconfig wlan0 up正常。

2.原因:

AP-WAKE_BT引脚被接了上拉电阻,进入测试模式了。

3.解决方案
硬件摘除上拉电阻。

6.3.3 起wlan0 网卡问题总结

wlan0启动失败问题目前遇到的都是与硬件相关的,如果不能自加载一般采用ifconfig wlan0 up先手动加载看看打印提
示。
同时让硬件帮忙check一下供电和一些io的上下拉电阻。

6.4 supplicant 服务问题

6.4.1 找不到wpa_suplicant.conf 文件

1.现象:
起supplicant失败

- ps发现没有supplicant进程.
- 于是手动执行wpa_supplicant -D nl80211 -i wlan0 -c /etc/wpa_supplicant.conf -B
  提示:
  Failed to open config file '/etc/wpa_supplicant.conf', error: No such file or directory
  Failed to read or parse configuration '/etc/wpa_supplicant.conf'.

2.原因:
路径错误。

3.解决方案

tina正常的路径一般在/etc/wifi/wpa_supplicant.conf
在wifimanage包下面配置正确的路径,保持和启动脚本一致.

6.5 wifimanager 使用问题

6.5.1 联网时出现:network not exist!

1.现象:

wifi_connect_ap_test ssid passwd
network not exist!

2.原因:

- lsmod查看驱动已经正常加载。
- ifconfig查看wlan0已经正常up。
- ps查看supplicant服务已经正常启动。
- 使用wifi_scan_results_test扫描网络
root@TinaLinux:/# wifi_scan_results_test
*********************************
***Start scan!***
*********************************
bssid / frequency / signal level / flags / ssid
******************************
Wifi get_scan_results: Success!
******************************
没有任何网络扫描到。

3.解决方案
一般是信号太多,没有板载天线,尝试外加一根天线。

6.6 上层网络应用服务问题

6.6.1 MR133_XR829 ping 压力测试: poll time out

1.现象:

ping 压力测试,一段时间后出现poll time out。

2.原因:

ping的网络性能不好.连接的公司内网可能存在一些未知的限制。

3.解决方案

尝试连接另外的路由器测试。

wpa_supplicant.conf -B
提示:
Failed to open config file ‘/etc/wpa_supplicant.conf’, error: No such file or directory
Failed to read or parse configuration ‘/etc/wpa_supplicant.conf’.


2.原因:
路径错误。

3.解决方案

tina正常的路径一般在/etc/wifi/wpa_supplicant.conf
在wifimanage包下面配置正确的路径,保持和启动脚本一致.




### 6.5 wifimanager 使用问题

#### 6.5.1 联网时出现:network not exist!

1.现象:

wifi_connect_ap_test ssid passwd
network not exist!


2.原因:

  • lsmod查看驱动已经正常加载。
  • ifconfig查看wlan0已经正常up。
  • ps查看supplicant服务已经正常启动。
  • 使用wifi_scan_results_test扫描网络
    root@TinaLinux:/# wifi_scan_results_test

Start scan!


bssid / frequency / signal level / flags / ssid


Wifi get_scan_results: Success!


没有任何网络扫描到。


3.解决方案
一般是信号太多,没有板载天线,尝试外加一根天线。

### 6.6 上层网络应用服务问题

#### 6.6.1 MR133_XR829 ping 压力测试: poll time out

1.现象:

ping 压力测试,一段时间后出现poll time out。


2.原因:

ping的网络性能不好.连接的公司内网可能存在一些未知的限制。


3.解决方案

尝试连接另外的路由器测试。