当前位置：首页 > news >正文

【RV1103】SDIO接口RTL8723bs WiFi模块驱动移植与实战

news 2026/5/16 23:31:37

1. RV1103与RTL8723bs WiFi模块概述

RV1103是瑞芯微推出的一款高性能嵌入式处理器，广泛应用于智能硬件和物联网设备。而RTL8723bs则是Realtek推出的一款低功耗WiFi+蓝牙二合一模块，采用SDIO接口通信，外形设计成SD卡样式，便于嵌入式系统集成。

在实际项目中，我们经常需要在RV1103平台上接入RTL8723bs模块来实现无线网络功能。这种组合的优势在于：

硬件兼容性好：SDIO接口与SD卡接口硬件兼容
驱动成熟：Realtek提供了完善的Linux驱动支持
功耗低：适合电池供电的便携设备
成本优势：相比独立WiFi模组更具性价比

我曾在多个项目中使用这种组合方案，实测下来连接稳定，传输速率能满足大多数物联网应用需求。下面将详细介绍从硬件连接到驱动移植的完整流程。

2. 硬件连接与原理图分析

2.1 硬件准备

要实现RV1103与RTL8723bs的连接，需要以下硬件：

开发板：LuckFox Pico（基于RV1103）
WiFi模块：Licheepi WiFi+BT模块（RTL8723bs芯片，TF卡形状）
其他：SPI NAND Flash（如W25N01GVZEIG）

2.2 接口原理

LuckFox Pico开发板上的SD卡槽引脚定义与标准SDIO接口完全兼容。RTL8723bs模块通过以下关键信号与RV1103连接：

SDIO_D0 - 数据线0 SDIO_D1 - 数据线1 SDIO_D2 - 数据线2 SDIO_D3 - 数据线3 SDIO_CMD - 命令线 SDIO_CLK - 时钟线

特别注意模块上的两个控制信号：

WL_REG（12号引脚）：模块使能控制
HOST_WAKE（13号引脚）：主机唤醒信号

2.3 硬件修改要点

在LuckFox Pico上使用WiFi模块需要特别注意：

开发板默认21-27引脚用于SPI Flash，需要改为SD卡槽功能
需要为WiFi模块提供稳定的3.3V电源
建议在WL_REG线上添加上拉电阻确保稳定启动

3. Linux内核驱动移植

3.1 内核配置修改

首先需要确保内核支持以下配置：

# 配置WiFi驱动为模块方式编译 CONFIG_CFG80211=m CONFIG_MAC80211=m CONFIG_RTL8723BS=m # 启用SDIO接口支持 CONFIG_MMC=y CONFIG_MMC_DW=y CONFIG_MMC_DW_ROCKCHIP=y

可以通过menuconfig进行配置：

make ARCH=arm menuconfig

找到以下路径进行配置：

Device Drivers → Network device support → Wireless LAN → Realtek RTL8723BS SDIO WiFi

3.2 设备树配置

设备树需要添加SDIO控制器和WiFi电源序列节点：

sdio_pwrseq: sdio-pwrseq { compatible = "mmc-pwrseq-simple"; pinctrl-names = "default"; post-power-on-delay-ms = <200>; reset-gpios = <&gpio3 RK_PC5 GPIO_ACTIVE_HIGH>; }; &sdmmc { max-frequency = <200000000>; bus-width = <4>; cap-sd-highspeed; cap-sdio-irq; keep-power-in-suspend; non-removable; mmc-pwrseq = <&sdio_pwrseq>; status = "okay"; };

关键参数说明：

post-power-on-delay-ms：电源稳定后的延迟时间
reset-gpios：WiFi模块复位引脚
non-removable：标识设备不可热插拔

3.3 固件加载

RTL8723bs需要加载固件才能正常工作，需将固件rtl8723bs_nic.bin放入文件系统：

# 创建固件目录 mkdir -p /lib/firmware/rtlwifi # 下载固件 wget https://raw.githubusercontent.com/wkennington/linux-firmware/master/rtlwifi/rtl8723bs_nic.bin -O /lib/firmware/rtlwifi/rtl8723bs_nic.bin

4. 驱动加载与网络配置

4.1 手动加载驱动

首次测试时可手动加载驱动模块：

insmod /lib/modules/$(uname -r)/kernel/net/wireless/cfg80211.ko insmod /lib/modules/$(uname -r)/kernel/net/mac80211/mac80211.ko insmod /lib/modules/$(uname -r)/kernel/drivers/net/wireless/realtek/rtl8723bs/r8723bs.ko

加载成功后可通过ifconfig -a查看到wlan0接口。

4.2 自动加载配置

正式产品中应配置为自动加载，创建/etc/modules-load.d/rtl8723bs.conf：

cfg80211 mac80211 r8723bs

4.3 WiFi网络连接

使用wpa_supplicant连接WiFi网络：

# 创建配置文件 cat > /etc/wpa_supplicant.conf <<EOF ctrl_interface=/var/run/wpa_supplicant ap_scan=1 network={ ssid="Your_SSID" psk="Your_Password" key_mgmt=WPA-PSK } EOF # 启动wpa_supplicant mkdir -p /var/run/wpa_supplicant wpa_supplicant -B -i wlan0 -c /etc/wpa_supplicant.conf # 获取IP地址 udhcpc -i wlan0

4.4 带宽测试

使用iperf工具测试实际传输带宽：

# 服务端（在PC端运行） iperf -s # 客户端（在RV1103运行） iperf -c <server_ip> -i 1 -t 30

实测RTL8723bs在RV1103平台上的传输速率约为15-21Mbps，能满足大多数物联网应用需求。

5. 常见问题与解决方法

5.1 驱动加载失败

现象：insmod时提示"Unknown symbol in module"解决：确保依赖模块(cfg80211, mac80211)已先加载，且版本匹配

5.2 WiFi无法连接

现象：wpa_supplicant报认证失败解决：

检查SSID和密码是否正确
确认路由器加密方式(WPA2-PSK最兼容)
检查固件是否正常加载

5.3 传输速率低

优化建议：

确保使用SDIO 4-bit模式
调整SDIO时钟频率（最高支持50MHz）
避免2.4GHz频段干扰

5.4 电源管理问题

现象：休眠后WiFi无法恢复解决：在设备树中配置正确的电源序列：

sdio_pwrseq: sdio-pwrseq { compatible = "mmc-pwrseq-simple"; reset-gpios = <&gpio3 RK_PC5 GPIO_ACTIVE_LOW>; post-power-on-delay-ms = <100>; };

6. 进阶优化与调试

6.1 驱动参数调优

可通过模块参数优化性能：

# 设置调试级别 echo 8 > /sys/module/r8723bs/parameters/debug # 启用节能模式 echo 1 > /sys/module/r8723bs/parameters/power_saving

6.2 信号强度监测

使用iw工具监测无线信号：

iw dev wlan0 station dump iw dev wlan0 link

6.3 功耗测试

测量不同状态下的电流消耗：

空闲状态：约20mA
传输状态：约120mA
休眠状态：<5mA

可通过iwconfig wlan0 power on/off控制节能模式。

7. 项目实战经验分享

在实际项目中移植RTL8723bs驱动时，我遇到过几个典型的坑：

电源时序问题：最初没有正确配置post-power-on-delay，导致模块无法正常初始化。通过示波器测量电源波形后，发现需要至少200ms的延迟。
SDIO时钟干扰：当SDIO时钟超过25MHz时，发现数据传输不稳定。最终通过以下措施解决：
- 缩短SDIO走线长度
- 在时钟线添加33Ω串联电阻
- 降低时钟频率到20MHz
中断共享问题：当系统中同时使用SD卡和WiFi时，出现中断冲突。解决方案是在设备树中正确配置中断优先级。

对于产品化部署，我建议：