Tina Linux 设备树深度解析：以RTL8733bs WIFI驱动移植为例

1. Tina Linux设备树基础与RTL8733bs硬件分析

第一次接触Tina Linux设备树配置时，我也曾被那些复杂的节点和属性搞得晕头转向。直到后来在RTL8733bs WIFI模块的移植过程中，才真正理解了设备树如何成为硬件与驱动之间的"翻译官"。设备树本质上就是用文本文件描述硬件连接关系，就像给操作系统画一张硬件接线图。

RTL8733bs是一款常见的WiFi+蓝牙二合一模块，采用SDIO接口与主控通信。拿到模块后，首先要研究原理图，重点关注三个部分：

• 电源管理：模块需要3.3V工作电压，通常通过PMIC（如AXP2101）的DCDC1通道供电
• 控制引脚：包括WIFI使能引脚（regon）和唤醒引脚（hostwake）
• 通信接口：SDIO用于数据传输，UART用于蓝牙通信

以全志V853平台为例，PH11引脚通常用作WIFI使能，PG7作为主机唤醒中断引脚。这些硬件信息必须准确映射到board.dts文件中，驱动才能正确控制硬件。我曾遇到过因引脚配置错误导致模块无法启动的情况，后来用万用表测量才发现原理图标注与实际PCB走线不一致。

2. 设备树关键节点配置详解

2.1 WIFI核心节点配置

在board.dts中配置WIFI节点就像填写一份硬件说明书。以下是RTL8733bs的典型配置：

wlan: wlan@0 { compatible = "allwinner,sunxi-wlan"; pinctrl-0 = <&wlan_pins_a>; pinctrl-names = "default"; clock-names = "32k-fanout0"; clocks = <&clk_fanout0>; wlan_busnum = <0x1>; wlan_power_num = <1>; wlan_power1 = "axp2101-dcdc1"; wlan_io_regulator = "axp2101-dcdc1"; wlan_power_voltage = <3300000>; wlan_io_voltage = <3300000>; wlan_regon = <&pio PH 11 1 0x1 0x2 0>; // 使能引脚配置 wlan_hostwake = <&pio PG 7 14 0x1 0x2 0>; // 唤醒引脚配置 chip_en; power_en; status = "okay"; wakeup-source; };

这里有几个容易踩坑的点：

1. 电压单位：微伏(μV)而不是毫伏(mV)，3300000表示3.3V
2. 引脚配置格式：<&pio PH 11 1 0x1 0x2 0>中：
   • PH11表示端口组PH的第11脚
   • 第一个1表示GPIO输出模式
   • 0x1表示初始高电平
   • 0x2表示驱动能力等级

2.2 SDIO接口配置

WIFI模块通过SDIO接口通信，必须确保SDIO控制器配置正确：

&sdc1 { bus-width = <4>; no-mmc; no-sd; cap-sd-highspeed; sunxi-dis-signal-vol-sw; cap-sdio-irq; keep-power-in-suspend; ignore-pm-notify; max-frequency = <50000000>; ctl-spec-caps = <0x8>; status = "okay"; };

特别注意max-frequency要根据模块规格设置，RTL8733bs最高支持50MHz。我曾将频率设得过高导致数据传输错误，表现为WIFI时断时续。

2.3 蓝牙相关配置

虽然本文聚焦WIFI驱动，但RTL8733bs是组合模块，蓝牙部分也需要配置：

&uart3 { pinctrl-names = "default", "sleep"; pinctrl-0 = <&uart3_pins_active>; pinctrl-1 = <&uart3_pins_sleep>; uart-supply = <®_dcdc1>; status = "okay"; };

蓝牙使用UART3通信，注意检查原理图确认使用的是哪个UART端口。pinctrl配置确保了睡眠状态下引脚状态正确，避免漏电。

3. 驱动移植与内核配置

3.1 驱动源码准备

将rtl8733bs驱动放到指定目录：

cp -r rtl8733bs/ lichee/linux-4.9/drivers/net/wireless/

驱动目录结构通常包含：

• Kconfig：驱动配置选项
• Makefile：编译规则
• os_dep：操作系统相关代码
• hal：硬件抽象层代码

3.2 修改编译系统

在drivers/net/wireless/Makefile中添加：

obj-$(CONFIG_RTL8733BS) += rtl8733bs/

在drivers/net/wireless/Kconfig中添加：

source "drivers/net/wireless/rtl8733bs/Kconfig"

执行make kernel_menuconfig时，需要勾选：

• Device Drivers → Network device support → Wireless LAN → Realtek 8733B SDIO WiFi

3.3 常见编译问题解决

遇到过最头疼的问题是驱动依赖的内核配置项未启用。建议检查：

1. CONFIG_CFG80211：无线配置子系统
2. CONFIG_MMC：SDIO控制器支持
3. CONFIG_PM：电源管理支持

如果编译报错提示某些函数未定义，通常是内核版本差异导致。RTL8733bs驱动最初是为Android内核编写，可能需要调整才能适配Tina Linux的内核版本。

4. 固件与文件系统集成

4.1 固件部署

将固件文件（如rtl8733bs_fw.bin）放到：

package/firmware/linux-firmware/rtl8733bs/

在make menuconfig中勾选：

• Firmware → linux-firmware → rtl8733bs-firmware

4.2 自动加载配置

在target/allwinner/v853-perf1/modules.mk中添加：

define KernelPackage/net-rtl8733bs SUBMENU:=$(WIRELESS_MENU) TITLE:=RTL8733BS support (staging) DEPENDS:= +rtl8733bs-firmware +@IPV6 +@USES_REALTEK FILES:=$(LINUX_DIR)/drivers/net/wireless/rtl8733bs/8733bs.ko AUTOLOAD:=$(call AutoProbe,rtl8733bs) endef

4.3 启动脚本配置

在target/allwinner/v853-perf1/busybox-init-base-files/etc/init.d/rc.modules中添加：

insmod /lib/modules/4.9.191/8733bs.ko wpa_supplicant -B -i wlan0 -c /etc/wifi/wpa_supplicant/wpa_supplicant.conf &

我曾遇到过驱动加载顺序问题，必须在SDIO控制器初始化后才能加载WIFI驱动，否则会报"SDIO host not ready"错误。

5. 网络连接测试与调试

5.1 WIFI连接配置

编辑package/allwinner/wireless/wifimanager2.0/files/wpa_supplicant.conf：

ap_scan=1 network={ ssid="Your_WiFi_SSID" psk="Your_WiFi_Password" }

5.2 IP地址获取

启动后执行：

udhcpc -i wlan0

测试网络连通性：

ping www.baidu.com

5.3 常见问题排查

1. 模块未启动：测量供电电压，检查使能引脚电平
2. 无法扫描AP：确认SDIO通信正常，检查dmesg | grep sdio
3. 连接不稳定：调整max-frequency或尝试降低传输功率
4. 固件加载失败：检查/lib/firmware/rtl8733bs/下是否有正确固件

记得使用iwconfig查看信号强度，ifconfig查看IP分配情况。调试阶段建议保持串口调试终端开启，实时观察内核日志。