.. _gentoo_mba_wifi: ==================================== Gentoo Linux在MacBook Air配置Wifi ==================================== .. note:: 所有淘宝上售卖的不同品牌 ``AX300`` 免驱动WiFi6无线网卡 ，实际上都是 RealTek 开发芯片 ``aic8800`` , BrostTrend 代工的 ``AX5L`` WiFi6 USB无线网卡。 该 ``aic8800`` 可能是 Realtek ``RTL8188EU`` 芯片的改进型号，但是驱动没有进入Linux主线内核，需要独立编译安装 支持WiFi标准: - WiFi 4: 802.11n - WiFi 6: 802.11ax .. note:: Tenda(腾达)公司 `AX300 Wi-Fi 6 高增益USB无线网卡(U2 v5.0) `_ 产品介绍，以及 `U2v5.0 Linux系统驱动- X86架构 （Ubuntu/UOS/kylin OS） 内核3.10~6.2 `_ 提供了源代码安装包。我在 :ref:`ubuntu_aic8800` 实践中完成Ubuntu平台的编译安装。 我的 :ref:`mba13_early_2014` 和 :ref:`mbp15_late_2013` 配置的是完全一样的 ``Boradcom BCM4360`` 蓝牙无线网卡，这款网卡对开源非常不兼容，导致 :ref:`gentoo_mbp_wifi` 实践遇到很多波折。 虽然最终能够通过hack方式使用 ``Boradcom BCM4360`` ，但是性能损失和kernel的特性损失导致得不偿失。所以我分别采用了不同的方法来解决这两台MacBook的无线网络问题: - :ref:`mbp15_late_2013` 购买了 :ref:`bcm943602cs` 硬件来实现 :ref:`gentoo_brcmfmac_wifi` - :ref:`mba13_early_2014` 没有升级硬件，则采用外接USB无线网卡(本文) 硬件 ========= - 选了一款 WiFi6 的USB网卡 - ``COMFAST CF-940AX 免驱动WiFi6无线网卡`` - 主要考虑露出USB接口部分比较小，比较便携 - WiFi6现在逐渐普及，这样在 2.4GHz 频率下能够速率翻倍(比原先WiFi4)，达到300Mbps - :strike:`比较担心Linux兼容性` **真没想到非常巧，原来AX300是Realtek开发BrosTrend代工的Linux的无线网卡** ，广告宣传是免驱动，实际上只有Win10/11是内置驱动，其他是通过插入USB无线网卡后默认内置一个小容量U盘提供驱动安装 .. figure:: ../../_static/linux/gentoo_linux/cf-940ax.png - 插入 ``CF-940AX`` USB无线网卡后，执行 ``lsusb`` 可以看到这款网卡设备显示: .. literalinclude:: gentoo_mba_wifi/aicsemi :caption: ``COMFAST CF-940AX`` 显示设备名 好奇怪的设备名字，居然没有型号 - google一下，找到了以下两篇厂商文档: - `腾达（Tenda） U2 V5 AX300无线网卡Linux系统安装方法 `_ - `[deb] 爱科微 AIC8800 芯片的无线网卡驱动(Debian 11.8, linux-image-6.1.0-0.deb11.11-amd64) `_ 看起来，这款USB无线网卡是 `爱科微 `_ 公司的WiFi6无线芯片 ``aic8800`` 这款 aic8800 驱动没有进入Linux内核，所以要通过 out-of-tree 方式编译安装: 根据 `BrosTrend官方Linux文档 `_ ，从 Kernel 6.2 开始，已经包含 ``AC1L, AC3L, AC5L`` : - ``AC1L,AC3L`` 使用 Realtek ``rtl88x2bu`` 驱动 - ``AC5L`` 使用 Realtek ``rtl8821cu`` 驱动 - ``AX5L`` 是最新Realtek为BrosTrend 开发的 ``aic8800`` 芯片，尚未进入Linux内核 在 Gentoo 中也提供了这个驱动的ebulid `net-wireless/aic8800 `_ ，源代码是从 `brostrend公司Linux源代码网站 `_ 获取。在官方Linux源代码网站说明: - brostrend公司的WiFi芯片是由Realtek公司开开发: 参考 `[deb] 爱科微 AIC8800 芯片的无线网卡驱动(Debian 11.8, linux-image-6.1.0-0.deb11.11-amd64) `_ 网友补充信息，看起来是 Realtek ``r8188eu`` - ``aic8800`` (芯片型号)也就是 AX5L(USB无线网卡成品型号) ，应该是比较新型号 安装包实际上提供了源代码以及将源代码注册到 :ref:`dkms` 系统，这样在新内核安装时会自动重新编译。 - 兼容众多Linux发行版(当然也包括 :ref:`windows` 和 :ref:`macos` ) - 提供X86_64 和 :ref:`arm` 架构支持，实际上只要使用Kernel 6.2发行版都支持，较低版本内核则主要支持 Debian/ :ref:`ubuntu_linux` 系列(具体参考 `BrosTrend Linux Supported distributions `_ ) - 支持 :ref:`raspberry_pi` .. figure:: ../../_static/linux/gentoo_linux/AX300-Linux-WiFi-6-USB-Adapter-Supports.webp ``AX300`` ( **BrosTrend AX5L** )支持众多Linux发行版以及Windows和macOS 根据腾达公司 和 爱科微公司(似乎是BrosTrend的国内公司名) 提供的编译安装文档，看起来这款设备的文档都是2023年10月发布的，应该都是 ``brostrend`` 代工产品(Realtek公司开发)。BrosTrend官方文档 `BrosTrend AX300 WiFi 6 Linux Compatible WiFi Adapter, 2.4GHz Only, Nano Linux WiFi Adapter for PC, Raspberry Pi 2+, for Ubuntu, Mint, Debian, Kubuntu, Mate, Zorin, PureOS etc, USB WiFi Dongle 286Mbps `_ 介绍这款AX300 Linux WiFi 6 USB Adapter对Linux兼容和支持较好: .. youtube:: sq-vrLFZYos 安装 ======= - 安装 ``net-wireless/aic8800`` : .. literalinclude:: gentoo_mba_wifi/install_aic8800 :caption: 安装 ``aic8800`` 驱动 - **识别设备** 编译很顺利，安装完成后，在 ``/lib/modules/$(uname -r)`` 目录下可以通过 ``tree`` 命令找到安装的内核模块和firmware，通过 ``ls`` 检查: .. literalinclude:: gentoo_mba_wifi/ls_aic8800 :caption: ``tree`` 找到对应驱动，通过 ``ls`` 检查 输出可以看到以下两个文件: .. literalinclude:: gentoo_mba_wifi/ls_aic8800_output :caption: ``aic8800`` 内核模块和firmware 但是，很奇怪，为何没有像网上所说的那样能够自动加载内核模块呢？而且再次使用 ``lsusb`` 看到的USB口插入的无线网卡依然没有显示出详细的品牌和型号信息，依然是: .. literalinclude:: gentoo_mba_wifi/aicsemi :caption: 安装了 ``aic8800`` 内核模块和firmware，却没有看到设备输出信息有任何变化 根据 `BrosTrend Source code: install.sh `_ 提供了 ``install.sh`` 脚本中段落: .. literalinclude:: gentoo_mba_wifi/brostrend_install.sh :caption: `BrosTrend Source code `_ 安装脚本 ``install.sh`` 有关 ``aic8800`` ``原来如此`` 这个无线网卡默认是存储模式，需要通过一个工具 :ref:`usb_modeswitch` 工具来转换工作模式 - 安装 :ref:`usb_modeswitch` : .. literalinclude:: usb_modeswitch/gentoo_install :caption: 在Gentoo上安装 ``usb_modeswitch`` - 参考官方提供的 ``install.sh`` 脚本片段的实际命令，执行: .. literalinclude:: gentoo_mba_wifi/usb_modeswitch_wifi :caption: 执行 ``usb_modeswitch`` 命令将 ``AX5L`` 从存储模式切换到WLAN模式 注意: 在转换前设备ID是 ``a69c:5721`` ，这个参数就是 ``usb_modeswitch`` 需要的参数 - 执行完成后，再次执行 ``lsusb`` 就会看到设备显示信息，可以看到该USB设备的ID和名称都发生了变化: .. literalinclude:: gentoo_mba_wifi/aicsemi_usb_modeswitch :caption: ``a69c:5721`` ( **aicsemi Aic MSC** ) 在切换模式之后，改变成 ``a69c:88dc`` ( **AICSemi AIC8800DC** ) 此时检查 ``ifconfig`` 会看到系统中增加了一个 ``wlan0`` 设备 并且系统日志中会记录模式切换的数据信息: .. literalinclude:: gentoo_mba_wifi/aicsemi_usb_modeswitch_messagest :caption: ``aicsemi`` USB设备切换模式时系统日志 :emphasize-lines: 5,6,8,11 :ref:`udev` 配置自动切换WLAN模式 ================================== 上述 ``aic8800`` 配置完成后，如果重启操作系统或者重新插入 ``AX5L`` USB WiFi设备，初始状态都是USB存储模式。每次手工输入 ``usb_modeswitch`` 命令切换显然太笨拙了。这就需要结合 :ref:`openrc_udev` 来完成自动切换: .. literalinclude:: gentoo_mba_wifi/10-aic8800.rules :caption: 配置 ``aic8800`` (AX5L)无线网卡插入时自动将存储模式切换为WLAN模式 完成配置后，触发 :ref:`udev` 重新加载规则: .. literalinclude:: ../redhat_linux/udev/udev_startup/udev_reload-rules :caption: ``udevadm`` 控制重新加载 ``udev`` 规则 :ref:`wpa_supplicant` ======================= 接下来就是常规操作，通过 :ref:`wpa_supplicant` 配置无线认证和接入WiFi 参考 ======= - `腾达（Tenda） U2 V5 AX300无线网卡Linux系统安装方法 `_ - `[deb] 爱科微 AIC8800 芯片的无线网卡驱动(Debian 11.8, linux-image-6.1.0-0.deb11.11-amd64) `_