Skip to content

42.4 Radxa X4 x86 开发板 ​

除树莓派等 ARM 架构单板计算机外,市场上亦存在基于 x86 架构的开发板产品。

42.4.1 概述 ​

Radxa X4 是一款基于 x86 架构的单板计算机,其核心处理器为英特尔(Intel)N100。本节内容基于 16 GB 内存与 128 GB eMMC 存储的硬件配置展开。

42.4.1.1 BIOS 配置说明 ​

如需解锁 PL1、PL2 等功耗限制相关的 BIOS 设置,请参考本书引导管理器与 UEFI 固件相关内容。

42.4.1.2 FreeBSD 版本兼容性 ​

建议安装 FreeBSD 15.1-RELEASE(2026 年 6 月发布)或更新版本。

FreeBSD 14.3-RELEASE 存在潜在问题:若使用 eMMC 存储版本并将系统安装于 eMMC,则固态硬盘的分区数量不得超过 5 个,否则 ZFS 文件系统将无法正常启动。

42.4.1.3 硬件配置信息 ​

Radxa X4 配备的无线网卡型号为 RTL8852BE(即瑞莎 A8 无线模块 V2.0),其中无线局域网功能通过 PCIe 通道实现,而蓝牙功能则通过 USB 通道提供。

Radxa X4 的有线以太网控制器型号为英特尔 i226-V。

42.4.2 显卡驱动安装与配置 ​

42.4.2.1 驱动程序安装 ​

使用 pkg 二进制包管理器安装:

sh
# pkg install drm-61-kmod

或使用 Port 从源代码构建安装:

sh
# cd /usr/ports/graphics/drm-61-kmod/
# make install clean

42.4.2.2 驱动加载配置 ​

安装驱动后,需配置驱动模块开机自动加载。在 /etc/rc.conf 中添加 i915kms:

sh
# sysrc -f /etc/rc.conf kld_list+=i915kms

42.4.3 无线网卡驱动安装与配置 ​

42.4.3.1 驱动程序安装 ​

使用 pkg 二进制包管理器安装:

sh
# pkg install wifi-firmware-rtw89-kmod

或使用 Ports 从源代码构建安装:

sh
# cd /usr/ports/net/wifi-firmware-rtw89-kmod/
# make install clean

42.4.3.2 无线网络性能配置 ​

完成无线网卡驱动安装后,需进一步配置以优化无线连接的稳定性与性能。当前驱动尚不支持 Wi-Fi 5/6 标准。

在 2.4 GHz 频段,传输速率仅可达到 802.11g 标准;在 5 GHz 频段,传输速率仅可达到 802.11a 标准。rtw89 驱动虽然硬件支持 802.11a/b/g/n/ac/ax 模式,但当前兼容层代码仅支持 802.11a/b/g 模式,802.11n/ac/ax 支持尚待实现。

使用 rtw89 模块时,需编辑 /boot/loader.conf 配置文件,添加以下参数:

ini
compat.linuxkpi.skb.mem_limit=1

该参数将 Linux KPI 网络缓冲区内存限制设置为 1,此配置可解决系统长时间运行后 Wi-Fi 无法自动重连的问题。

42.4.4 系统实时状态监控 ​

42.4.4.1 资源使用监控 ​

以下命令每秒刷新一次虚拟存储器及系统状态综合信息:

sh
# systat -vmstat 1
    2 users    Load  2.01  3.28  3.42                  Mar  9 12:26:41
   Mem usage:  91%Phy 52%Kmem                           VN PAGER   SWAP PAGER
Mem:      REAL           VIRTUAL                        in   out     in   out
       Tot   Share     Tot    Share     Free   count
Act   432M  10400K   4610G   15868K    1373M   pages
All   434M  12244K   4610G   87652K                       ioflt  Interrupts
Proc:                                                     cow    3273 total
  r   p   d    s   w   Csw  Trp  Sys  Int  Sof  Flt   663 zfod        sdhci_pci0
  1           41        4K  684  138   2K       663       ozfod  1030 cpu0:timer
                                                         %ozfod   204 cpu1:timer
 0.2%Sys   0.2%Intr 25.3%User  0.0%Nice 74.3%Idle         daefr     3 cpu2:timer
|    |    |    |    |    |    |    |    |    |    |       prcfr     9 cpu3:timer
>>>>>>>>>>>>>                                             totfr  2022 xhci1 129
                                           dtbuf          react       igc0:rxq0
Namei     Name-cache   Dir-cache    345474 maxvn          pdwak     3 igc0:rxq1
   Calls    hits   %    hits   %    252374 numvn      249 pdpgs       igc0:rxq2
       3       3 100                176597 frevn          intrn     2 igc0:rxq3
                                                    8298M wire        igc0:aq
Disks mmcsd mmcsd mmcsd  nda0 pass0                  581M act         nvme0:admi
KB/t   0.00  0.00  0.00  0.00  0.00                 5380M inact       nvme0:io0
tps       0     0     0     0     0                  548K laund       nvme0:io1
MB/s   0.00  0.00  0.00  0.00  0.00                 1373M free        nvme0:io2
%busy     0     0     0     0     0                   57K buf         nvme0:io3
                                                                      hdac0 140

42.4.5 CPU 温度监控 ​

过高的工作温度可导致系统不稳定、降频甚至硬件永久性损坏。

42.4.5.1 CPU 温度读取方法 ​

首先动态加载 coretemp 内核模块,该模块用于英特尔处理器的温度监控:

sh
# kldload coretemp # 英特尔处理器加载 coretemp 模块,AMD 处理器请使用 amdtemp
# kldstat -v | grep coretemp # 确认模块已成功加载
# sysctl -a | grep temperature
hw.acpi.thermal.tz0.temperature: 27.9C # 此值不代表 CPU 核心温度,通常为主板环境温度
dev.cpu.3.temperature: 41.0C
dev.cpu.2.temperature: 40.0C
dev.cpu.1.temperature: 40.0C
dev.cpu.0.temperature: 40.0C

如果需要单独查看各 CPU 核心的温度信息,可执行以下命令:

sh
# sysctl dev.cpu | grep temperature
dev.cpu.3.temperature: 30.0C
dev.cpu.2.temperature: 30.0C
dev.cpu.1.temperature: 29.0C
dev.cpu.0.temperature: 30.0C

42.4.5.2 温度监控配置持久化 ​

为确保每次系统启动后均可正常监控 CPU 温度,需将温度监控模块的加载配置持久化。为便于 htop 等系统监控软件读取 CPU 温度信息,编辑 /boot/loader.conf 配置文件,添加以下内容:

ini
coretemp_load="YES"

该配置可使系统在开机时自动加载 coretemp 内核模块。

42.4.5.3 参考文献 ​

42.4.6 附录:Server 2025 如何安装英特尔 i226-V 网卡驱动 ​

除了 FreeBSD 系统外,部分用户需在 Windows Server 系统上使用 Radxa X4 开发板。

本附录介绍在 Windows Server 2025 上安装英特尔 i226-V 网卡驱动的方法。i226-V 在 Windows Server 下可使用 I226-LM 驱动,无需修改任何文件或系统配置。I226-LM 与 I226-V 在基础以太网功能上兼容,但 I226-LM 额外支持 Intel vPro/AMT 等企业级管理功能。

操作步骤如下:

  1. 下载并解压 适用于 Windows Server 2025* 的英特尔 ® 网络适配器驱动程序
  2. 在设备管理器中定位以太网控制器
  3. 在其属性页面选择“更新驱动程序”
  4. 点击“浏览我的计算机以查找驱动程序软件”
  5. 选择“让我从计算机上的可用驱动程序列表中选取”
  6. 在“从以下列表选择设备的类型”中选择“网络适配器”
  7. 在“选择要为此硬件安装的设备驱动程序”界面中,点击右下方的“从磁盘安装”按钮
  8. 点击“浏览”,找到驱动文件中的 e2f.inf,点击“确定”
  9. 选择条目“Intel(R) Ethernet Controller I226-LM”即可

42.4.6.1 参考文献 ​