Community-Lösung

Realtek RTL8821CE oder RTL8852BE unter ZimaOS: Treiberanleitung

A user labeled the card RTL8821CE, but lspci showed RTL8852BE; ZimaOS detected PCIe hardware while nmtui reported Wi-Fi Hardware: Missing.

Wenn eine Realtek-WLAN-Karte in lspci angezeigt wird, ZimaOS jedoch „Wi-Fi Hardware: Missing“ meldet, wird das PCIe-Gerät zwar erkannt, aber der nutzbare WLAN-Treiber- bzw. Firmware-Pfad ist nicht vollständig. Im Ausgangsthread lautet der Titel RTL8821CE, die tatsächliche Ausgabe von lspci weist jedoch auf einen RTL8852BE-802.11ax-Controller hin.

Dieser Unterschied ist wichtig, da RTL8821CE und RTL8852BE unterschiedliche Upstream-Linux-Treiber verwenden. Die aktuellen ZimaOS-Kompatibilitätsdokumente führen weiterhin keine der beiden PCIe-Karten als verifizierte WLAN-Option auf. Gehen Sie daher nicht davon aus, dass sich ein Linux-Mint-Treiber wie ein normales Debian-Paket in ZimaOS installieren lässt.

Zuerst den exakten Chip identifizieren

lspci -nnk | grep -A3 -Ei 'network|wireless'
dmesg | grep -Ei 'rtw|firmware|wifi|wlan' | tail -100

Verwenden Sie die PCI-ID und die Treiberzeile, nicht nur die Produktbezeichnung auf der Karte. Die Hardware des Nutzers aus der Quelle wurde als RTL8852BE erkannt, obwohl im Thread von RTL8821CE die Rede war.

RTL8852BE verfügt über einen Upstream-Linux-Treiber

Die aktuelle Linux-Referenz zum RTL8852BE-Treiber zeigt, dass RTL8852BE in modernen Linux-Kerneln das Modul rtw89_8852be verwendet.

RTL8821CE verwendet eine andere Treiberfamilie

RTL8821CE wird von der rtw88-Familie und nicht von rtw89 unterstützt. Eine Vermischung der Anweisungen für die beiden Chipsätze kann zum falschen Modul und zu einem falschen Firmware-Fehlerbehebungsweg führen.

Die aktuelle ZimaOS-Kompatibilitätsliste verifiziert diese Karten nicht

Die aktuelle Liste kompatibler Netzwerkadapter für ZimaOS führt Intel AX210 und mehrere Ethernet-Adapter auf, jedoch keine PCIe-WLAN-Karten vom Typ RTL8821CE oder RTL8852BE.

Keine zufälligen DKMS-Pakete auf dem Host installieren

ZimaOS ist ein systemähnliches Appliance-Betriebssystem. Ein Treiberpaket, das unter Ubuntu oder Linux Mint funktioniert, kann von Headern, DKMS, dem Zustand des Paketmanagers oder beschreibbaren Systempfaden abhängen, die ZimaOS nicht auf dieselbe Weise bereitstellt.

Prüfen, ob das Modul vorhanden ist

modinfo rtw89_8852be 2>/dev/null
modinfo rtw88_8821ce 2>/dev/null

Falls das genaue Modul fehlt, melden Sie IceWhale die PCI-ID und den Treibernamen, anstatt einen nicht verwandten Out-of-Tree-Build zu erzwingen.

Für einen Produktionsserver einen verifizierten Adapter verwenden

Wenn WLAN sofort benötigt wird, verwenden Sie einen aktuell verifizierten Adapter wie Intel AX210, anstatt von einer nicht verifizierten Realtek-PCIe-Karte abhängig zu sein.

Der Leitfaden zur Hardware-Fehlerbehebung hilft dabei, einen Kompatibilitätsbericht zu erstellen.

Firmwarefehler getrennt vom Treibermodul prüfen

Ein Modul kann vorhanden sein und trotzdem fehlschlagen, weil das erforderliche Realtek-Firmware-Blob fehlt. Unterscheiden Sie in dmesg zwischen „module not found“ und „failed to load firmware“, da dafür unterschiedliche Maßnahmen von IceWhale erforderlich sind.

Die PCI-ID in einer Treiberanfrage verwenden

Bei der veröffentlichten RTL8852BE-1T1R-Karte ist die PCI-ID wichtiger als die Ersatzteilbezeichnung von HP. Treiberanfragen sollten Hersteller- und Geräte-IDs enthalten, damit IceWhale die richtige Kernel-Option und das passende Firmware-Paket aktivieren kann.

Für ein dauerhaft betriebenes NAS Ethernet bevorzugen

Selbst wenn WLAN funktioniert, ist kabelgebundenes Ethernet für einen Speicher-Server in der Regel zuverlässiger, da Roaming, Funkstörungen und das Energieverwaltungsverhalten von WLAN vermieden werden. Verwenden Sie WLAN, wenn eine Verkabelung nicht praktikabel ist, und nicht als Standardweg für intensive NAS-Datenübertragungen.

FAQ

Ist die Karte aus der Quelle wirklich eine RTL8821CE?

Der Forumstitel nennt RTL8821CE, aber die veröffentlichte lspci-Ausgabe weist RTL8852BE aus.

Warum funktioniert Linux Mint?

Mint enthält möglicherweise das erforderliche Kernelmodul und die Firmware, während der ZimaOS-Build dieselbe Kombination möglicherweise nicht enthält oder aktiviert.

Kann ich den WLAN-Treiber per apt installieren?

Behandeln Sie ZimaOS nicht wie einen normalen Ubuntu-Host. Bevorzugen Sie einen verifizierten Adapter oder bitten Sie um eine Integration des Treibers.

Was sollte ich an IceWhale senden?

Die genaue PCI-ID, die Ausgabe von lspci -nnk, die relevante dmesg-Ausgabe, die ZimaOS-Version und die Information, ob eine andere Linux-Distribution funktioniert.