编译Linux网卡驱动

uname -a

本文将阐述Linux环境下安装WIFI驱动的常规思路。网络上绝大多数教程对新手极其不友好，现在咱们就用简单一点的方式来搞定无线网卡驱动安装。本文的安装思路在Ubuntu、Debian、Deepin、CentOS、Kali等不同Linux发行版通用。无论使用Raspberry Pi、Nano Pi、Orange Pi等ARM开发板还是x86架构的设备，安装思路大体一致。

分清网卡是什么接口 主流的接口有两种：

1. 直接插在主板上的是PCI接口（包括MINI-PCI或PCIE）。
2. 插在USB接口上的USB无线网卡。

如果还没有购买，购买前到网卡官网搜一下，看官方提供的驱动是否兼容你的设备。MacOS（包括黑苹果）的驱动和Linux驱动不通用。需要特别注意Linux驱动对Linux内核版本或发行版、设备架构的要求，一般在驱动下载界面会有明确说明。

部分无线网卡只兼容x86架构的设备，因此对于ARM开发板，可以到对应官方提供的文档手册，查看官方系统已经兼容的无线网卡型号，官方测试过的型号通常更加稳定和易用。需要注意的是，文档中列明的型号未必和销售标识的型号一致，此情况后文有说明。

查看内核信息：

ifconfig -a

yum install net-tools -y

判断网卡是否在Linux下免驱 查看是否有wlan开头的网卡信息。例如：wlan0。当然，部分网卡也会显示为eth1或wlx803f5d150c4c、usb0之类。可以在插入网卡前执行一次ifconfig -a，插入网卡后再执行一次命令，对比前后差异。

ifconfig: command not found 部分发行版，例如CentOS 7默认已不再安装此命令，可以用ip addr替代或安装相应的net-tools软件包。

例如，CentOS下，安装net-tools：

iwconfig

net-tools包括了ifconfig、route、arp和netstat命令。

其它判断方法 也可以用iwconfig命令，查看当前无线网卡信息。

同样的，如果出现iwconfig: command not found，需要安装wireless-tools这个包。

apt-get install linux-firmware

请将apt替换为对应发行版的包管理工具。

如果上述方式已经可以获取到相应的无线网卡信息，则说明已经驱动了网卡。

到网卡官网下载驱动 根据所购买的网卡型号，到对应的网卡官网，下载驱动并按说明进行安装。只有运气非常好，才有可能遇到所购买的无线网卡兼容Linux平台的情况。否则我们可能需要先获取网卡芯片型号，然后再搜搜对应芯片的Linux驱动程序或驱动源文件。

到对应Linux发行版Wiki中查找固件 如果你的PCI无线网卡或USB WIFI无法正常工作，大概率是因为系统中缺少了对应的网卡固件。

Debian 对于Debian系统, 可以在Debian-Wiki里找到并安装USB无线网卡芯片的固件。

Ubuntu 对于Ubuntu系统, 可以通过下列命令安装所有的USB无线网卡固件：

apt install pciutils

通常情况下, 各类WiFi芯片的固件都存放在/lib/firmware目录下。

查看网卡芯片型号 无线网卡型号和芯片型号通常不一致。例如电商平台显示的型号TL-WN725N型号可能对应芯片型号rtl8188eu或rtl8188eus。不同版本的无线网卡对应的芯片型号可能不同，例如水星MW150US对应rtl8188eu，而MW150US(免驱版) V2.0对应芯片rtl8188gu。不同生产批次对应的芯片型号也有可能不同，例如2019的批次可能对应一个型号，而2020可能对应另外的型号。这是因为本身网卡芯片也在不断迭代升级，提供更多的功能，而厂商为了销售的方便，会统一制定一个网卡型号。不同品牌相似功能的产品可能用的是同一个芯片，为了准确定位当前硬件的芯片，可以通过lspci或lsusb查看。

PCI无线网卡

lspci -v

apt install usbutils

lsusb

查看网卡信息：

lspci -v|grep network

如果信息太多，可以使用lspci -v|grep network过滤一些信息，方便查找。

通常PCI无线网卡的芯片型号信息会直接显示在设备名称中。

USB无线网卡 查看网卡信息：

root@raspberrypi:~# lsusb
Bus 003 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 002 Device 002: ID 0846:9053 NetGear, Inc.

root@NanoPi-NEO2:~# lsusb
Bus 008 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 005 Device 004: ID 0bda:8812 Realtek Semiconductor Corp. RTL8812AU 802.11a/b/g/n/ac WLAN Adapter

Bus 005 Device 012: ID 0bda:b711 Realtek Semiconductor Corp.

通常usb无线网卡显示的芯片信号信息不一定在名称中。例如：

部分已经安装了驱动程序的网卡，显示信息可能如下：

这种情况，芯片信号一目了然，就是RTL8812AU。但其实第一种情况也可以查找芯片信号，根据ID 0846:9053到相应的网卡厂商官网进行查找。

例如水星MW150US2.0：

dmesg | grep brcm

根据ID 0bda:b711，到下述网站查找型号，可以找到对应的网卡芯片型号为RTL8188GU。

USB ID查询站点：

除了水星MW150US 2.0免驱版的网卡芯片为RTL8188GU，普联TL-WN726N(免驱版)、 TL-WN725N、CF-WU815N V2也可能使用的是这款芯片。

BCM无线网卡 目前很多笔记本电脑的用的是BCM的无线网卡和蓝牙模块集成模块，上述两个命令是无法找到网卡信息的。

sudo apt install git bc bison flex libssl-dev make raspberrypi-kernel-headers

可以看到类似上图所示内容，则型号为BCM4343A0，蓝牙和WIFI共用一个模块。

根据网卡芯片型号查找驱动 知道了网卡芯片型号后，可以搜索到的资料就很多了。只要芯片型号匹配的驱动理论上都可以用。

查找驱动除了百度、Google，还有俩常规方案:

1. 到对应的芯片厂商官网搜索。
2. 到万能的github搜索。

通常芯片厂商会提供部分Linux网卡驱动的源代码，需要自行编译安装，也可能只提供对应发行版的安装文件（一定要确认一下内核版本和驱动要求的版本是否匹配、架构是否匹配。x86的驱动程序是不能用于arm64架构的，反之亦然）。

这里给出部分Linux驱动地址。

rtl8188guLinux驱动： https://github.com/kelebek333/rtl8188gu

rtl8188euLinux驱动： https://github.com/lwfinger/rtl8188eu

rtl8821cuLinux驱动（ID 0bda:1a2b）： https://github.com/whitebatman2/rtl8821CU

编译Linux网卡驱动 驱动编译命令一般在README.md中都已经有介绍，在此不再赘述。但是在执行编译命令前，需要先确保对应内核的linux-headers包已经安装。

安装编译工具和内核头文件 通常编译驱动也需要git、gcc、make、autoconf、build-essential等依赖，请根据需要自行研究。

如果执行make编译时提示/lib/modules/……/build does not exist，通常由于对应的内核头文件（kernel header）没有安装。

树莓派 由于Raspberry Pi具有超大的用户群，在Raspbian中安装常见驱动比其他Linux系统方便得多。

git clone https://github.com/friendlyarm/linux.git -b sunxi-4.14.y --depth 1

如果您的Raspberry Pi内核非常新，则您需要等待几个周的时间才能通过apt安装到对应的kernel-headers。或者通过获取内核源文件。

关于树莓派内核编译：

Nano Pi 内核源码：

yum install kernel-devel

apt-get install linux-headers-$(uname -r)

cd /lib/modules/`uname -r`
ln -s build ../相近版本

其中4.14应替换为uname -r对应的版本。

参考文档：%2B/zh

编译内核或模组的方法，请参考对应平台的说明文档。

ORange Pi 内核源码：

CentOS 其它发行版 编译无线网卡技巧相近内核头文件用于编译

通常下载内核的方式获取linux-headers非常耗时耗力，而某些情况无法通过包管理工具直接安装现行版本的内核linux-headers。这种情况下，可以安装与当前内核版本号非常接近的kernel headers版本，然后进入对应当前版本的modules文件夹下，通过软连接ln -s将build文件连接到相近版本，然后再编译。

[ 4496.876553] 8188gu: version magic '4.15.0-99-generic SMP mod_unload aarch64' should be '4.14.111 SMP mod_unload aarch64'

cd /usr/src/linux-headers-当前内核
vim include/linux/vermagic.h

内核模块版本和内核版本不一致的处理方法 如果在dmesg中看到类似下面的信息（version magic）：

...
#define VERMAGIC_STRING                         \
    UTS_RELEASE "    "                        \
    MODULE_VERMAGIC_SMP MODULE_VERMAGIC_PREEMPT             \
    MODULE_VERMAGIC_MODULE_UNLOAD MODULE_VERMAGIC_MODVERSIONS    \
...

...
#define VERMAGIC_STRING                         \
    "4.14.111 "                            \
    MODULE_VERMAGIC_SMP MODULE_VERMAGIC_PREEMPT             \
    MODULE_VERMAGIC_MODULE_UNLOAD MODULE_VERMAGIC_MODVERSIONS    \
...

dmesg

将UTS_RELEASE修改为uname -r对应的版本号。注意后面的空格。

例如，修改前：

修改后：

修改完成后，重新编译无线网卡驱动即可。

查看驱动加载报错信息 如果编译安装了无线网卡驱动并重启后仍然无法正常使用网卡。可以通过