Cubieboard2（五） 安装无线网卡驱动
1 前情提要
1.1 硬件情况
- 1）Cubieboard2：http://cubieboard.org/model/cb2/
Cubieboard2 是一个由珠海的 Cubietech 团队推出，采用全志 A20 处理器的开发板。
手头上的是生产于 2012.9.9 的是 MMC + SDCard 而非 dual_card 款，也是饱经风霜了。
- 2）无线网卡：
Tenda 生产的型号为 U2 v5.0 AX300 Wi-Fi6 高增益 USB 无线网卡。
- 3）CB2 与无线网卡组装图：
不相干的话：
（1）买无线网卡前以为房间没有可用网线接口，买完才发现有网口，那买都买了不折腾一下不是亏大了吗？
（2）开始折腾了发现网卡的 USB 公头短而延长部分太宽，无法插入到带盒子的 Cubieboard2 的 USB 母口上，那这不再整个 USB 转接头那我网卡不白买了吗？
（3）再买一个 USB 的直角转接头（本来想买 U 型的，脑海中 3D 建模一下发现 U 型的插上后，网卡天线要么水平，要么朝下），买回来后发现转接头的 USB 公头部分也短，没有什么是一把指甲刀解决不了的，打磨一下终于可以插上了。
（4）去官网下载 Linux 下的网卡驱动包，安装，报错，啊！ —— 来自土拨鼠的嘶吼！
回过头去研究某宝的详情页，发现该网卡支持 Linux 内核版本为 V3.10-V6.2，而 CB2 的内核为 linux-3.4，那这不折腾一下那我网卡和 USB 转换头不白买了吗？
1.2 软件环境
-
1）OS 选择基于微软的 WSL（Windows Subsystem for Linux）的 Ubuntu 22.04
-
2）交叉编译工具链：arm-linux-gnueabihf-gcc 7.5.0 版本
-
3）Linux 源码：选择 v6.1-rc8（这里是我的一个误区，原以为这些 rc 版本是 v6.1 的升级版本，实际上 v6.1 才是包含 patch 的稳定版本，即应该直接选择 v6.1 版本）
-
4）U-Boot 源码：直接 master 分支
2 编译
具体的编译过程详见前置文章，这里记录一下其中的问题。
- 1）升级完内核后再安装无线网卡驱动包 ax300-wifi-adapter-linux-driver.deb，报错：
# 内核版本如下
uname -r
6.1.0-rc8-dirty
情况1：编译时出现以下错误
/lib/modules/6.1.0-rc8-dirty/build 目录不存在
情况2：安装头文件
apt-get install linux-headers-$(uname -r)
E: Unable to locate package linux-headers-6.1.0-rc8-dirty
情况3：尝试安装 linux-headers-5.13.0-generic，并通过 ln 将软连接定位过来
编译成功，但使用 insmod 安装时出现 Invalid format module 问题
情况4：通过 make install_headers 将内核头文件安装上
依然报错：/lib/modules/6.1.0-rc8-dirty/build 目录不存在
- 2）山重水复间，观察驱动包安装时的日志，发现它会将驱动源码解压到 /usr/src/tenda/aic8800 目录，有源码就好办了。直接把驱动源码复制到 Linux 源码中编译即可，遇到的问题：
情况1：Kconfig:3: unknown statement "---help---"
应该是新版本 Kconfig 不兼容其中的 “--help--”，修改成 help 指令即可。
- 3）编译成功，且生成了无线网卡驱动，内核烧录见前置文章。
/usr/lib/modules/6.1.0-rc8-dirty/kernel/drivers/net/wireless/aic8800/aic_load_fw/aic_load_fw.ko
/usr/lib/modules/6.1.0-rc8-dirty/kernel/drivers/net/wireless/aic8800/aic8800_fdrv/aic8800_fdrv.ko
3 安装驱动
- 1）重启系统后发现，两个驱动文件没有安装，配置开机自动进行驱动加载：
# 建立驱动 map 文件
depmod -a
# 添加自动加载的驱动名（aic_load_fw 应该在 aic8800_fdrv 之前）
echo "aic_load_fw" >> /etc/modprobe.d/aic8800.conf
echo "aic8800_fdrv" >> /etc/modprobe.d/aic8800.conf
-
参考：https://blog.csdn.net/huiyuanliyan/article/details/120882037
-
2）重启后驱动正常加载，但是通过 ifconfig/iwconfig 命令依然看不到无线网卡，查看 /var/log/messages 日志，报错：
AICWFDBG(LOGINFO) ###Upload fmacfw patch 8800dc u02 bin firmware,180000
AICWFDBG(LOGINFO) ###Load file fmacfw patch 8800dc u02 bin
AICWFDBG(LOGINFO) rwnx load firmware firmware path /lib/firmware/aic8800DC/fmacfw patch 8800dc u02 bin
AICWFDBG(LOGERROR) rwnx load firmware:fmacfw patch 8800dc u02bin file failed to open
AICWFDBG(LOGERROR) No such file or directory
AICWFDBG(LOGINFO) load patch bin fail:-1
猜测这些 bin 文件应该是驱动的依赖库，去驱动的源码目录 find 一下，果然 /fw/aic8800DC/ 目录下由包含这个 bin 文件的一堆依赖文件，通过 scp 拷贝到 Cubieboard2 的对应目录。
- 3）在 /etc/network/interfaces.d/wlan0.conf 文件中配置自动获取 IP、WIFI 账户密码后，再次重启，通过 ifconfig/iwconfig 命令依然看不到无线网卡。依稀记得官方《安装驱动方法》文档中提到会出现系统识别是 U 盘的情况：
# 配置 /etc/network/interfaces.d/wlan0.conf
auto wlan0
allow-hotplug wlan0
iface wlan0 inet dhcp
wpa-ssid "WIFI name"
wpa-psk "WIFI password"
# 查看所有挂载点
mount
# 查看块设备
lsblk
mount 命令没有找到被挂载的网卡，块设备中倒是发现了它，3.7M 的那个就是
- 4）根据官方《安装驱动方法》文档提示，使用 eject /dev/sda1 弹出 U 盘，发现没有该命令，尝试安装：
apt-get install eject
奇怪，明明提示无法弹出，但结果确实弹出了。
- 5）再次通过 iwconfig 终于出现了无线网卡，不过名称有点奇怪，先修改下网络配置文件：
# 配置 /etc/network/interfaces.d/wlan0.conf
auto wlxc83a35120088
allow-hotplug wlxc83a35120088
iface wlxc83a35120088 inet dhcp
wpa-ssid "WIFI name"
wpa-psk "WIFI password"
网卡名称为 wlxc83a35120088，根据该名称修改 /etc/network/interfaces.d/wlan0.conf 文件。
- 5）通过以下命令重启网络，结果：
systemctl restart networking
通过 ssh 测试，可以使用该网卡正常登录。
- 6）还剩最后一个问题：每次重启后，无线都被识别为 U 盘，需要通过 eject 指令弹出，再重启网络才能正常使用。
