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 软件结构
• 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 模组移植
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建议从RTL原厂获取最新版本的完整资料,包括驱动,文档,工具。(也可以从其他内核已适配版本获取驱动) -
内核适配
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
-
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; }; ... }
- 整体编译烧写
- 验证排查
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 变量
- 现象:
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)
-
原因:
wowlan成员变量受CONFIG_PM控制,没有打开导致的.休眠唤醒的依赖。 -
解决方案:
在内核配置
-Power management options --->
Device power management core functionality
6.1.2 找不到xxx.ko
-
现象:
sunxi_wlan_get_bus_index...xradio_core.ko undefined!
-
原因:
缺少配置misc。 -
解决方案:
在内核配置m kernel_menuconfig--> Device drivers--> Misc devices--> Allwinner rfkill driver
6.1.3 mmc_xxx undefined
- 现象:
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'
-
原因:
没有配置mmc。 -
解决方案
Device Drivers --->
<*> MMC/SD/SDIO card support --->
<*> Allwinner sunxi SD/MMC Host Controller support
6.1.4 缺少依赖库
-
现象:
Package kmod-net-xr829 is missing dependencies for the following libraries: cfg80211.ko mmc_core.ko sunxi-wlan.ko
-
原因:
依赖库需要编译进内核,不能以模块方式编译进去。 -
解决方案。
在内核配置如下模块时,配置成y CONFIG_RFKILL =y CONFIG_CFG80211=y CONFIG_MMC=y CONFIG_MAC80211=y
6.2 驱动加载问题
6.2.1 R16 博通模组联网时提示:No such device.
- 现象:
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
- 原因:
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
- 解决方案
tina配置正确的firmware
firmware --->
└─> <*> ap6212a-firmware............................... Broadcom AP6212A firmware
6.2.2 R329_XR829 模组ifconfig 显示:No such device
-
现象:
ifconfig: SIOCGIFFLAGS: No such device
-
原因:
firmware选择不匹配。 - lsmod查看驱动已经正常加载。 - dmesg 查看加载log发现: [ 195.966066] [XRADIO_ERR] xradio_load_firmware: Wait for wakeup:device is not responding. XR829换了40M晶振。
-
解决方案
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.解决方案
尝试连接另外的路由器测试。