1. 开发环境搭建与SDK准备
在开始RK3588S Android13适配EW-7611UXB无线网卡驱动之前,我们需要先搭建一个稳定可靠的开发环境。这里我推荐使用Ubuntu 22.04 LTS版本,这个版本在长期支持性和软件兼容性方面都表现得很不错。记得硬盘空间至少要预留100GB以上,因为Android13的源码加上编译中间文件会占用大量空间。
我第一次搭建环境时就踩过坑,当时用的Ubuntu 18.04,结果在编译过程中遇到各种奇怪的依赖问题。后来换了22.04版本,问题就少多了。所以强烈建议直接用22.04,能省去很多不必要的麻烦。
安装必要的编译工具和库文件时,可以用下面这个命令一次性搞定:
sudo apt-get update && sudo apt-get install git ssh make gcc libssl-dev liblz4-tool expect expect-dev g++ patchelf chrpath gawk texinfo chrpath diffstat binfmt-support qemu-user-static live-build bison flex fakeroot cmake gcc-multilib g++-multilib unzip device-tree-compiler ncurses-dev libgucharmap-2-90-dev bzip2 expat gpgv2 cpp-aarch64-linux-gnu libgmp-dev libmpc-dev bc python-is-python3 python2
有时候新SDK编译会报错,可能需要额外安装一些库。我就遇到过缺少libncurses5的情况,用这个命令解决:
sudo apt update
sudo apt install libncurses5 libncurses5-dev libncurses5:i386
1.1 环境检查与升级
编译Android系统对主机环境有比较严格的要求,特别是python、make和lz4的版本。我建议先检查一下当前系统的版本是否符合要求。
用python3 --version查看python版本,需要3.6或以上。如果版本太低,可以用以下方式升级:
PYTHON3_VER=3.6.15
wget https://www.python.org/ftp/python/${PYTHON3_VER}/Python-${PYTHON3_VER}.tgz
tar xf Python-${PYTHON3_VER}.tgz
cd Python-${PYTHON3_VER}
sudo apt-get install libsqlite3-dev
./configure --enable-optimizations
sudo make install -j8
make版本需要4.0以上,用make -v检查。升级make稍微复杂一些:
sudo apt update && sudo apt install -y autoconf autopoint
git clone https://gitee.com/mirrors/make.git
cd make
git checkout 4.2
autoreconf -f -i
./configure
make -j8
sudo install -m 0755 make /usr/bin/make
lz4版本要求1.7.3以上,用lz4 -v检查。升级命令如下:
git clone https://gitee.com/mirrors/LZ4_old1.git
cd LZ4_old1
make
sudo make install
sudo install -m 0755 lz4 /usr/bin/lz4
如果手头没有多余的电脑搭建Ubuntu环境,用VMware虚拟机也是个不错的选择。不过要注意给虚拟机分配足够的内存和CPU资源,否则编译过程会非常缓慢。
1.2 SDK下载与解压
Android13 SDK可以通过提供的百度云链接下载。下载完成后,建议在主目录下新建一个专门的文件夹来存放SDK,比如/home/username/EDIMAX。这样便于后续管理,也不会搞乱系统其他文件。
解压SDK是个需要耐心的过程,30多GB的文件需要一些时间:
cd /home/username/EDIMAX
cat android13_rk35xx_20250106_sdk.tar.gza* > android13_rk35xx_20250106_sdk.tar.gz
tar xvf android13_rk35xx_20250106_sdk.tar.gz
解压完成后会生成android13-dev目录,这就是我们后续工作的根目录。在开始驱动移植前,我强烈建议先直接编译一次原始SDK,确保基础环境没有问题。这样如果后续出现错误,就能确定是驱动移植步骤的问题,而不是环境配置的问题。
2. WiFi驱动移植详解
EW-7611UXB是一款支持WiFi6和蓝牙5.3的二合一无线网卡,性能相当不错。但在RK3588S平台上适配需要一些功夫。我自己在移植过程中遇到了不少问题,这里把经验和解决方案都分享出来。
2.1 驱动文件准备与添加
首先需要从提供的驱动包中获取WiFi驱动文件。驱动包结构大致如下:
EW-7611UXB_WiFi_linux_v1.19.10-78-gfbe3fba11.20240422/
├── android_ref_codes_13.x
├── driver
│ ├── core
│ ├── include
│ ├── os_dep
│ ├── runwpa
│ └── wlan0dhcp
我们需要将driver目录改名为rtl8851bu,然后放置到SDK的external/wifi_driver目录下。这个步骤很关键,名字一定要改对,否则后续编译会找不到驱动文件。
接下来修改external/wifi_driver/Makefile文件,添加以下内容:
CONFIG_RTL8851BU = m
export CONFIG_RTL8851BU
obj-$(CONFIG_RTL8851BU) += rtl8851bu/
这样编译系统就知道要编译我们新添加的驱动模块了。
2.2 驱动代码适配修改
Realtek的驱动原本是针对x86平台编写的,需要修改才能用在ARM平台的RK3588S上。这个过程中我踩过几个坑,都是平台相关的问题。
首先修改external/wifi_driver/rtl8851bu/Makefile中的平台配置:
CONFIG_PLATFORM_I386_PC = y 改为 n
CONFIG_PLATFORM_ARM_ROCKCHIP = n 改为 y
同时需要启用WIFI_HAL支持,这是Android8.0以上版本必需的:
CONFIG_RTW_WIFI_HAL = n 改为 y
最关键的修改是添加RK3588S平台的支持代码。在Makefile中找到PLATFORM OPS部分,注释掉原有的平台包含语句,替换为以下内容:
ifeq ($(CONFIG_PLATFORM_ARM_RK3188), y)
EXTRA_CFLAGS += -DCONFIG_LITTLE_ENDIAN -DCONFIG_PLATFORM_ANDROID -DCONFIG_PLATFORM_ROCKCHIPS
EXTRA_CFLAGS += -DCONFIG_IOCTL_CFG80211 -DRTW_USE_CFG80211_STA_EVENT
EXTRA_CFLAGS += -DCONFIG_CONCURRENT_MODE
EXTRA_CFLAGS += -DRTW_SUPPORT_PLATFORM_SHUTDOWN
ARCH := arm
CROSS_COMPILE :=
KSRC := /home/username/EDIMAX/android13-dev/kernel
MODULE_NAME := 8851bu
endif
这里需要注意KSRC的路径要改成你自己SDK内核的实际路径。我第一次编译时就因为路径不对,导致内核头文件找不到。
2.3 驱动入口函数重写
这是最复杂但也最关键的一步。Realtek原厂的驱动入口函数需要重写,以适配Rockchip的驱动框架。
修改external/wifi_driver/rtl8851bu/os_dep/linux/usb_intf.c文件:
首先修改函数声明:
static int __init rtw_drv_entry(void) 改为 static int rtw_drv_entry(void)
static void __exit rtw_drv_halt(void) 改为 static void rtw_drv_halt(void)
然后添加Rockchip特定的驱动入口函数:
#include <linux/rfkill-wlan.h>
extern int get_wifi_chip_type(void);
extern int rockchip_wifi_power(int on);
extern int rockchip_wifi_set_carddetect(int val);
int rockchip_wifi_init_module_rtkwifi(void)
{
// 初始化代码
return rtw_drv_entry();
}
void rockchip_wifi_exit_module_rtkwifi(void)
{
// 清理代码
rtw_drv_halt();
}
最后注释掉原来的module_init和module_exit调用,改用我们新写的函数。这个修改确保了驱动能够正确地集成到Rockchip的电源管理和设备检测框架中。
2.4 其他必要修改
还有一些零散但必要的修改,比如在external/wifi_driver/rtl8851bu/core/rtw_ieee80211.c文件末尾添加:
void platform_wifi_mac_addr(u8 *mac_addr)
{
}
这个函数是平台获取MAC地址的接口,虽然我们暂时用不到,但如果不实现编译时会报错。
另外还需要修改external/wifi_driver/rtl8851bu/phl/phl_regulation_def.h中的一行代码:
u8 size = sizeof(_chdef_tbl_) / sizeof(struct regulatory_domain_mapping_6g);
改为
u8 size = sizeof(_chdef_tbl_) / sizeof(struct chdef_6ghz);
这个修改解决了编译器对结构体大小计算的问题。我在第一次编译时就卡在这里很久,最后通过仔细分析错误信息才找到这个需要修改的地方。
3. 蓝牙驱动移植实战
EW-7611UXB的蓝牙部分移植相对复杂一些,需要同时修改内核层和硬件抽象层。我自己在做这部分的时候反复折腾了好几次,才把所有环节都打通。
3.1 内核层驱动替换
RK3588S的蓝牙驱动路径在kernel-5.10/drivers/bluetooth。首先需要修改内核配置文件,编辑kernel-5.10/arch/arm64/configs/rockchip_defconfig:
添加以下配置:
CONFIG_BT_HCIBTUSB=n
CONFIG_BT_RTKBTUSB=y
同时禁用其他可能冲突的Realtek驱动:
CONFIG_RTL8188EU=n
CONFIG_RTL8188FU=n
CONFIG_RTL8189ES=n
...(其他RTL驱动都设为n)
CONFIG_RTL8851BU=m
从驱动包中获取蓝牙内核驱动文件:
BT_Android_Linux_Driver/ANDROID_BT_DRIVER/20230911_BT_ANDROID_13.0_RTL8851B_COEX_v0707/linux/drivers/bluetooth/
将里面的rtk_btusb.c和rtk_btusb.h复制到SDK的kernel-5.10/drivers/bluetooth目录下,覆盖原有文件。记得先备份原文件,这样如果出现问题可以随时恢复。
3.2 硬件抽象层调整
硬件层的修改更为复杂,需要替换多个文件。从驱动包中找到rtkbt目录:
BT_Android_Linux_Driver/ANDROID_BT_DRIVER/20230911_BT_ANDROID_13.0_RTL8851B_COEX_v0707/rtkbt/
将整个目录内容复制到SDK的hardware/realtek/rtkbt目录下。这里建议先删除原来的文件,再拷贝新的,避免文件残留导致问题。
接下来需要修改几个关键的配置文件。首先在build/make/core/product.mk中添加对Realtek蓝牙芯片的支持:
_product_stash_var_list += \
BOARD_HAVE_BLUETOOTH_RTK
然后修改hardware/realtek/rtkbt/rtkbt.mk文件,主要做以下几处调整:
- 添加CUR_PATH := hardware/realtek/rtkbt 定义路径
- 设置BOARD_HAVE_BLUETOOTH_RTK_TV为false
- 将模块名从libbt-vendor改为libbt-vendor-realtek
- 将所有LOCAL_PATH替换为CUR_PATH
这个重命名很关键,因为SDK中可能已经有同名的模块,不重命名会导致冲突。我第一次编译时就因为这个问题折腾了好久。
3.3 设备节点与固件配置
修改hardware/realtek/rtkbt/vendor/etc/bluetooth/rtkbt.conf配置文件:
# 注释掉原来的设备节点
# BtDeviceNode=?/dev/ttyS1:H5
# 添加新的设备节点
BtDeviceNode=/dev/rtkbt_dev
这个修改确保了系统能够找到正确的蓝牙设备节点。
还需要在几个源文件中添加设备支持。在hardware/realtek/rtkbt/code/libbt-vendor/src/hardware_usb.c中添加:
{ 0x7392, 0xE611, 0x8851, 0, 0, "mp_rtl8851bu_fw", "rtl8851bu_fw", "rtl8851bu_config", NULL, 0, CONFIG_MAC_OFFSET_GEN_4PLUS, MAX_PATCH_SIZE_65_2K},
在hardware/realtek/rtkbt/code/libbt-vendor/src/bt_vendor_rtk.c中修改供应商ID检查:
if (!Check_Key_Value(newpath, "idVendor", 0x0bda) &&
!Check_Key_Value(newpath, "idVendor", 0x7392))
最后修改Android.mk文件,添加编译选项和模块重命名:
LOCAL_CFLAGS += -Wno-format
LOCAL_MODULE := libbt-vendor-realtek
这些修改确保了编译系统能够正确识别和构建蓝牙驱动模块。
4. 系统框架与权限配置
驱动移植完成后,还需要在系统框架层进行一些适配工作,否则驱动即使编译成功也无法正常工作。这部分内容比较琐碎,但每一个步骤都很重要。
4.1 Framework层适配
首先需要在WIFI HAL层添加对新型号的支持。修改frameworks/opt/net/wifi/libwifi_hal/rk_wifi_ctrl.cpp文件,添加以下定义:
#define RTL8851BU_DRIVER_MODULE_PATH WIFI_MODULE_PATH"8851bu.ko"
#define RTL8851BU_DRIVER_MODULE_NAME "8851bu"
然后在相应的设备列表中添加:
{"RTL8851BU", "7392:e611"},
{"RTL8851BU", RTL8851BU_DRIVER_MODULE_NAME, RTL8851BU_DRIVER_MODULE_PATH, UNKOWN_DRIVER_MODULE_ARG, REALTEK_WIFI_HAL},
这些修改让系统能够识别并加载我们的新网卡驱动。我记得第一次测试时忘了做这一步,结果驱动编译成功了,但系统就是识别不到网卡,排查了好久才找到这个原因。
4.2 设备权限与初始化配置
在device/rockchip/rk3588/rk3588s_lubancat_4_v1_hdmi/目录下创建init.rk3588s.rc文件,内容主要包括设备节点权限设置和服务启动配置。这个文件定义了系统启动时如何初始化和配置我们的无线网卡。
接着修改rk3588s_lubancat_4_v1_hdmi.mk文件,添加:
PRODUCT_COPY_FILES += \
$(LOCAL_PATH)/init.rk3588s.rc:$(TARGET_COPY_OUT_VENDOR)/etc/init/hw/init.rk3588s.rc
这样确保init脚本会被打包到系统镜像中。然后修改device/rockchip/common/rootdir/init.rockchip.rc文件,添加对新增init脚本的引用:
import /vendor/etc/init/hw/init.rk3588s.rc
权限配置也很重要,修改device/rockchip/common/rootdir/ueventd.rockchip.rc:
#for BT中添加
/dev/rtkbt_dev 0666 bluetooth net_bt_admin
#for radio中添加
/dev/ttyUSB* 0666 radio radio
4.3 SELinux策略调整
Android系统越来越重视安全性,SELinux策略的配置也变得很重要。需要修改多个sepolicy文件来确保我们的驱动有足够的权限运行。
在device/rockchip/common/sepolicy/vendor/目录下的多个文件中添加相应策略:
Bluetooth.te中添加:
allow bluetooth tmpfs:dir { write };
allow bluetooth rtkbt_device:chr_file rw_file_perms;
device.te中添加:
type rtk_bt_device, dev_type;
file.te中添加:
type bluetooth_vendor_data_file, file_type, data_file_type;
还需要修改hal_bluetooth_default.te等多个文件,添加相应的权限允许规则。这些策略确保了蓝牙服务能够正常访问设备节点和系统资源。
最后还需要修改system/sepolicy下的多个版本对应的策略文件,包括domain.te和hal_neverallows.te,放宽一些限制性策略。这些修改需要仔细测试,确保既不会过于宽松导致安全风险,又不会过于严格影响功能正常使用。
5. 系统编译与烧写测试
所有修改完成后,就可以开始编译整个系统了。这个过程比较耗时,建议使用性能较好的机器并行编译。
5.1 完整系统编译
进入SDK根目录,执行以下命令设置编译环境:
cd android13-dev
source build/envsetup.sh
lunch rk3588s_lubancat_4_v1_hdmi-userdebug
选择正确的lunch选项很关键,我第一次编译时选错了版本,结果编译出来的镜像无法正常启动。rk3588s_lubancat_4_v1_hdmi-userdebug是针对鲁班猫4开发板的配置。
开始编译使用命令:
./build.sh -UACKu -J16
参数说明:
- U: 编译uboot
- A: 编译Android
- C: 使用Clang编译内核
- K: 编译内核
- u: 生成update.img
- J: 并行编译任务数(根据CPU核心数调整)
编译过程可能需要几个小时,取决于机器性能。建议保存编译日志以便排查问题:
./build.sh -CK -J16 > build_edimax.log
如果编译成功,会在rockdev/Image-rk3588s_lubancat_4_v1_hdmi/目录下生成update.img文件,这就是可以烧写到开发板的完整系统镜像。
5.2 烧写与功能测试
烧写需要先安装Rockchip的USB驱动DriverAssitant_v5.1.1。这个驱动支持多种Windows系统,包括Win7、Win10的32位和64位版本。安装完成后,使用RKDevTool_v3.13工具进行烧写。
烧写步骤:
- 用USB Type-C线连接开发板和电脑
- 开发板进入Loader或Maskrom模式
- 打开RKDevTool,选择Upgrade Firmware页面
- 点击Firmware选择编译好的update.img
- 点击Upgrade开始烧写
烧写完成后开发板会自动重启。首次启动时间会比较长,因为系统需要初始化各种服务和配置。
启动完成后,可以通过以下命令检查驱动是否正常加载:
dmesg | grep -i wifi
dmesg | grep -i bluetooth
lsmod | grep 8851
如果驱动加载成功,可以在系统设置中看到WiFi和蓝牙功能。建议进行实际连接测试,确保不仅驱动能加载,功能也能正常使用。
我在测试过程中遇到过驱动能加载但WiFi无法扫描网络的问题,最后发现是电源管理配置有问题。通过调整电源管理参数解决了这个问题,所以实际功能测试很重要,不能只看驱动是否加载成功。
如果遇到问题,可以通过logcat和dmesg查看详细日志。Realtek驱动通常会输出比较详细的调试信息,有助于定位问题。常见问题包括电源管理配置错误、固件加载失败、设备权限不足等,需要根据具体日志信息进行分析和解决。
289



被折叠的 条评论
为什么被折叠?



