Realtek 2.5GbE NIC unsupported (error -ENODEV: unknown chip XID 689) on Beelink SER5 MAX
Environment:
- Device: Beelink SER5 MAX Mini PC (AMD Ryzen 7 6800U)
- Model: SER5 MAX-L-24500EJ0W64PRO-DP/XA
- OS Version: umbrelOS 2.0 beta 1
- NIC: Realtek Semiconductor RTL8125 2.5GbE Controller (newer revision)
Issue Description: When booting umbrelOS 2.0 with an Ethernet cable connected, no Ethernet network interface is detected or initialized. Wi-Fi works, but wired networking is completely non-functional out of the box.
Kernel Diagnostic:
The kernel log reveals that the in-tree r8169 driver fails during PCIe probe:
r8169 0000:02:00.0: error -ENODEV: unknown chip XID 689
Root Cause & Upstream Fix:
Newer production revisions of the Beelink SER5 MAX use the Realtek RTL8125 revision with hardware identifier XID 689. The stock kernel currently used by umbrelOS lacks this identifier in its hardware tables. Upstream Linux kernels (6.8 and newer) already include the patch recognizing XID 689.
Requested Action:
Please update the umbrelOS base kernel or backport the Realtek XID 689 patch so users with newer mini PC batches have out-of-the-box wired Ethernet connectivity.
Source: getumbrel/umbrel