Ubuntu 18.04 系统使用 Linux 5.4 内核时，Intel I226-V (Device ID 0x125C) 2.5G 网卡无法被 igc 驱动识别，报错 probe failed with error -2/-5。解决方案是修改 igc 驱动源码，在 hw.h 中添加设备 ID 定义，在 main.c 中注册 PCI 设备表，并在 base.c 中适配初始化流程及绕过 PHY 检查。通过 DKMS 或手动编译安装修改后的驱动，可成功加载网卡并启用网络功能。建议高版本内核优先升级，此方法适用于无法升级内核的嵌入式场景。
在 Ubuntu 18.04 (Kernel 5.4.0) 平台上使用 Intel NUC13 或某些定制主板时，遇到了板载的 Intel I226-V 2.5G 网卡无法识别的问题。
lspci 可以看到设备，但驱动加载失败，dmesg 报错 probe failed with error -5 或 error -2。
本文记录了通过修改 Intel IGC 源码驱动来适配该未知设备 ID (0x125C) 的完整过程。
架构： x86_64 CPU 运行模式： 32-bit, 64-bit 字节序： Little Endian CPU: 16 在线 CPU 列表： 0-15 每个核的线程数： 1 每个座的核数： 10 座： 1 NUMA 节点： 1 厂商 ID： GenuineIntel CPU 系列： 6 型号： 186 型号名称： 13th Gen Intel(R) Core(TM) i7-13620H 步进： 2 CPU MHz： 553.048 CPU 最大 MHz： 6300.0000 CPU 最小 MHz： 400.0000 BogoMIPS： 5836.80 虚拟化： VT-x L1d 缓存： 48K L1i 缓存： 32K L2 缓存： 1280K L3 缓存： 24576K NUMA 节点 0 CPU： 0-15 标记： fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clflush dts acpi mmx fxsr sse sse2 ss ht tm pbe syscall nx pdpe1gb rdtscp lm constant_tsc art arch_perfmon pebs bts rep_good nopl xtopology nonstop_tsc cpuid aperfmperf tsc_known_freq pni pclmulqdq dtes64 monitor ds_cpl vmx smx est tm2 ssse3 sdbg fma cx16 xtpr pdcm pcid sse4_1 sse4_2 x2apic movbe popcnt tsc_deadline_timer aes xsave avx f16c rdrand lahf_lm abm 3dnowprefetch cpuid_fault epb invpcid_single ssbd ibrs ibpb stibp ibrs_enhanced tpr_shadow vnmi flexpriority ept vpid ept_ad fsgsbase tsc_adjust bmi1 avx2 smep bmi2 erms invpcid rdseed adx smap clflushopt clwb intel_pt sha_ni xsaveopt xsavec xgetbv1 xsaves dtherm ida arat pln pts hwp hwp_notify hwp_act_window hwp_epp hwp_pkg_req umip pku ospke waitpkg gfni vaes vpclmulqdq rdpid movdiri movdir64b md_clear flush_l1d arch_capabilities
通过 lspci -nnk 查询到的网卡信息如下：
55:00.0 Ethernet controller [0200]: Intel Corporation Device [8086:125c](rev 04) Subsystem: Intel Corporation Device [8086:3037]
56:00.0 Ethernet controller [0200]: Intel Corporation Device [8086:125c](rev 04) Subsystem: Intel Corporation Device [8086:0000]
关键点在于 Device ID 为 125c，这是一个在 Linux 5.4 内核自带驱动中未被定义的 ID。
lspci 显示没有 Kernel driver in use。igc: probe of 0000:55:00.0 failed with error -5 (MAC 初始化错误)igc: probe of 0000:55:00.0 failed with error -2 (PHY ID 检查或 NVM 校验错误)我们需要下载 Intel IGC 独立驱动源码（基于 5.4.0-7642.46 或类似版本），并修改源码以添加对 0x125C 的支持。
安装编译环境和内核头文件：
sudo apt-get update
sudo apt-get install dkms build-essential linux-headers-$(uname -r)
假设你已经有了 intel-igc 的驱动源码（可以从 GitHub 或 Intel 官网获取旧版源码）。
需要修改三个文件来适配此硬件。
文件：src/igc_hw.h
在设备 ID 列表处添加 0x125C 的定义：
#define IGC_DEV_ID_I225_LM 0x15F2
// ... 其他 ID ...
#define IGC_DEV_ID_I225_BLANK_NVM 0x15FD
#define IGC_DEV_ID_I226_V 0x125C /* 添加这一行 */
文件：src/igc_main.c
在 igc_pci_tbl 数组中添加新的 ID，使其能被 probe 探测到：
static const struct pci_device_id igc_pci_tbl[] = {
{PCI_VDEVICE(INTEL, IGC_DEV_ID_I225_LM), board_base},
// ...
{PCI_VDEVICE(INTEL, IGC_DEV_ID_I226_V), board_base}, /* 添加这一行 */
{0,}
};
文件：src/igc_base.c
步骤 A：在 igc_get_invariants_base 中添加初始化分支
防止返回 error -5 (MAC Init Error)：
static s32 igc_get_invariants_base(struct igc_hw *hw) {
// ...
switch(hw->device_id) {
case IGC_DEV_ID_I225_LM:
// ...
case IGC_DEV_ID_I226_V: /* 添加这一行 */
mac->type = igc_i225;
break;
default:
return -IGC_ERR_MAC_INIT;
}
// ...
}
步骤 B：在 igc_init_phy_params_base 中放宽 PHY ID 检查
防止返回 error -2 (PHY Error/ENOENT)。由于这是定制版或新版 PHY，ID 可能不在白名单中，我们将其默认视为 I225 PHY 处理：
static s32 igc_init_phy_params_base(struct igc_hw *hw) {
// ... (获取 PHY ID 后)
/* Verify phy id and set remaining function pointers */
switch(phy->id) {
case I225_I_PHY_ID:
phy->type = igc_phy_i225;
break;
default:
/* 修改：不再直接返回错误，而是兼容处理 */
// ret_val = -IGC_ERR_PHY;
// goto out;
phy->type = igc_phy_i225; /* 强制指定为 I225 */
break;
}
// ...
}
这样内核升级后驱动会自动重编。
# 1. 确保在源码根目录
cd ~/intel-igc
# 2. 清理旧版本（如果有）
sudo dkms remove igc/5.4.0-7642.46 --all
# 3. 添加到 DKMS
sudo dkms add .
# 4. 安装
sudo dkms install igc/5.4.0-7642.46
# 5. 加载驱动
sudo rmmod igc
sudo modprobe igc
cd src
make -C /lib/modules/$(uname -r)/build M=$(pwd) modules
sudo insmod igc.ko
执行以下命令查看状态：
# 1. 查看内核日志，确认 probe 成功
dmesg | tail
# 应显示：Intel(R) 2.5G Ethernet Linux Driver... 且无报错
# 2. 查看 PCI 驱动绑定
lspci -nnk | grep -A3 125c
# 应显示：Kernel driver in use: igc
# 3. 查看网口并启用
ip addr
sudo ip link set enp85s0 up
sudo dhclient enp85s0
至此，Intel 0x125C 网卡在 Ubuntu 18.04 下成功驱动。
注意：本文基于 Linux 5.4 内核环境。更高版本的内核（如 5.15+）可能已经原生支持该设备，建议优先考虑升级内核。但在无法升级内核的嵌入式/工控场景下，此 patch 方法非常有效。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online