RTL8188CUS驱动程序编译步骤

说明

出于学习的目的，需要在hi3518ev200平台上接入RTL8188无线网卡传输数据。本文记录自己对编译操作的步骤，以期望帮助到其它的初学者。

RTL8188介绍

嵌入式应用中可供选择的WIFI网络芯片非常多，RTL系列只是众水中的一支，其它的例如XR819、AP6256.有些还将Wifi和蓝牙做在了一起。RTL系列中常见的型号有RTL8188、RTL8723、RTL8189、RTL8192等等。其中，RTL8188是150Mbps的USB2.0接口芯片，而RTL8189是150Mbps的SDIO接口芯片，以上是初学者应该了解的。
我使用的RTL8188又分成很多版本，例如RTL8188ETV/EUS/CUS等等，淘宝上占得比较多的是ETV和EUS，商用网卡成品中，EUS/CUS版本占得较多，这些具体的细节和背后的故事网络上也多有说明。粗略了解可阅读【参考】部分的第1项。
本文使用的芯片具体型号是RTL8188CUS，购买链接可作为学习之用，并非广告，淘宝上也有很多同型号产品。
——注意！经验证，EUS版本的驱动不能支持CUS网卡，如果使用EUS版本驱动CUS硬件，将无法显示wlan0。

驱动程序编译

0.准备操作

在开始之前，你需要做出以下准备：
(1)已经建立了hi3518的交叉编译环境。这一步骤可以参考我做的记录博文，详见【参考】部分第2项。
(2)已经准备好了一份linux内核源码，或者linux下编译需要使用的资源文件。linux源码的获取可以在其官方网站上得到，下载地址详见【参考】部分的第3项。
(3)已经准备好了官方的RTL8188CUS驱动程序源码，我们需要交叉编译得到在嵌入式Linux上运行的ko模块文件，驱动程序源码可从本文末的【原始驱动程序下载】部分得到。 RTL8188CUS和RTL8192CUS的驱动是通用的，所以后文中不必在意这两个名字的混用，官方给的驱动原本也是针对RTL8192CUS的，但在我的开发板上也能正常驱动RTL8188CUS。

1.Makefile文件的修改

在编译之前请确保已经安装make工具，众所周知对Makefile文件的配置是编译顺利的前提。
打开解压后文件夹根目录下的顶层Makefile文件，首先配置平台，因为我们要在hi3518的平台上运行驱动，所以需要新增一个平台配置做适配。将新增的配置项 CONFIG_PLATFORM_ARM_HI3518E 设置为 y，而原程序初始的 CONFIG_PLATFORM_I386_PC设置为 n。

而后查找上一项 CONFIG_PLATFORM_MIPS_JZ4760 的配置实例，在其后增加一份新的配置实例如下：

ifeq ($(CONFIG_PLATFORM_ARM_HI3518), y)
#EXTRA_CFLAGS += -DCONFIG_LITTLE_ENDIAN #选择小端模式
ARCH := arm
CROSS_COMPILE := arm-hisiv300-linux-
KVER := 3.4.35
KSRC := /home/wind/Downloads/linux-3.4.y
MODULE_NAME := RTL8188CUS
endif

其中,
ARCH为架构选择；
CROSS_COMPILE为交叉编译器前缀；
KSRC目录为目标linux内核的地址；
KVER是目标内核的版本；
MODULE_NAME是结果文件名，这些需要根据实际需要更改。
——注意！ 根据文末【参考】部分第4项中所写的内容，为防万一，Makefile文件起始部分的 CONFIG_POWER_SAVING 项设置为 n。

2.源码的修改（重要）

网上查找的很多移植失败的帖子都是死在了这里，所以编译之前，需要耐心将下面文件做出修改。
(1)——将下列文件头的 #include <linux/smp_lock.h> 语句改为 #include <linux/hardirq.h> 。这是因为适配的Linux系统内核不同导致的更改需要，涉及到此项修改的文件有：

./core/rtw_io.c
./core/rtw_cmd.c
./core/rtw_security.c
./core/rtw_mlme.c
./hal/rtl8192c/usb/rtl8192c_cmd.c
./include/rtw_io.h
./os_dep/linux/mlme_linux.c

此处修改方法出处详见【参考】部分第5项。
(2)——在下列文件头增加 #include <linux/interrupt.h> 语句。这是因为 tasklet_struct 结构定义在此文件中，涉及到此项修改的文件有：

./include/rtw_xmit.h
./include/rtw_recv.h

此处修改方法出处详见【参考】部分第6项。
(3)——如果你没有在Makefile设置EXTRA_CFLAGS，那么可以打开 ./include/rtw_byteorder.h 文件，在开头处新增一个 CONFIG_LITTLE_ENDIAN宏定义，在该文件中需要指定使用大端模式还是小端模式，在hi3518中使用的是小端模式。

3.开始编译

使用Terminal进入驱动程序目录，输入 make编译，稍等几十秒，编译完成后将在当前目录下生成ko模块文件。
使用file命令查看目标文件是否适配平台。

*注意事项

如果需要在Windows和虚拟机之间传输文件（夹），可以使用SCP工具，可以参考我做的记录博文，详见【参考】部分第7项。

编译过程输出

wind@WKC:~/Downloads/rtl8192CU_linux_v2.0.1502.20110402$ make
make ARCH=arm CROSS_COMPILE=arm-hisiv300-linux- -C /home/wind/Downloads/linux-3.4.y M=/home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402  modules
make[1]: Entering directory '/home/wind/Downloads/linux-3.4.y'
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/core/rtw_cmd.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/core/rtw_security.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/core/rtw_debug.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/core/rtw_io.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/core/rtw_ioctl_query.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/core/rtw_ioctl_set.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/core/ieee80211.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/core/rtw_mlme.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/core/rtw_mlme_ext.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/core/rtw_wlan_util.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/core/rtw_pwrctrl.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/core/rtw_rf.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/core/rtw_recv.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/core/rtw_sta_mgt.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/core/rtw_xmit.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/core/efuse/rtl8712_efuse.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/core/led/rtl8192c_led.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/hal/rtl8192c/rtl8192c_phycfg.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/hal/rtl8192c/rtl8192c_rf6052.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/hal/rtl8192c/rtl8192c_dm.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/hal/rtl8192c/rtl8192c_rxdesc.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/hal/rtl8192c/usb/usb_ops_linux.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/hal/rtl8192c/usb/usb_halinit.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/hal/rtl8192c/usb/Hal8192CUHWImg.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/hal/rtl8192c/usb/rtl8192cu_xmit.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/hal/rtl8192c/usb/rtl8192cu_recv.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/hal/rtl8192c/usb/rtl8192c_cmd.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/os_dep/osdep_service.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/os_dep/linux/os_intfs.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/os_dep/linux/usb_intf.o
/home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/os_dep/linux/usb_intf.c:204:1: warning: data definition has no type or storage class [enabled by default]
 MODULE_DEVICE_TABLE(usb, rtw_usb_id_tbl);
 ^
/home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/os_dep/linux/usb_intf.c:204:1: warning: type defaults to ‘int’ in declaration of ‘MODULE_DEVICE_TABLE’ [-Wimplicit-int]
/home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/os_dep/linux/usb_intf.c:204:1: warning: parameter names (without types) in function declaration [enabled by default]
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/os_dep/linux/ioctl_linux.o
/home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/os_dep/linux/ioctl_linux.c: In function ‘rtw_wx_get_scan’:
/home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/os_dep/linux/ioctl_linux.c:1931:1: warning: the frame size of 1032 bytes is larger than 1024 bytes [-Wframe-larger-than=]
 }
 ^
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/os_dep/linux/xmit_linux.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/os_dep/linux/mlme_linux.o
  CC [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/os_dep/linux/recv_linux.o
  LD [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/8192cu.o
  Building modules, stage 2.
  MODPOST 1 modules
  CC      /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/8192cu.mod.o
  LD [M]  /home/wind/Downloads/rtl8192CU_linux_v2.0.1502.20110402/8192cu.ko
make[1]: Leaving directory '/home/wind/Downloads/linux-3.4.y'
wind@WKC:~/Downloads/rtl8192CU_linux_v2.0.1502.20110402$ 

原始驱动程序下载

百度网盘链接：https://pan.baidu.com/s/1oZrFqBGukPK5PlJVJ7UTsA
提取码：jje1

参考

1.浅析几款USB接口RTL8188/8723/8192EU/8821CU小尺寸经典WiFi模块选型参考
2.【燕卫博】从零开始进行Hi3518_SDK安装、环境搭建和Linux内核编译，并生成可供烧写的uImage
3.Linux内核源码下载地址
4.关于在2440上移植rtl8192和rtl8188cus linux驱动遇到的问题及解决方法！！！
5.Linux下编译驱动代码时smp_lock.h文件找不到的解决方案
6.Linux tasklet 分析笔记（转载）
7.【燕卫博】使用SCP工具和SSH实现主机与Hyper-V虚拟机之间的文件传输
————2019-11-22 @燕卫博————