Communityoplossing

Driverhandleiding voor Realtek RTL8821CE of RTL8852BE op ZimaOS

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

Als er een Realtek-wifi-kaart in lspci verschijnt, maar ZimaOS “Wi-Fi Hardware: Missing” meldt, wordt het PCIe-apparaat wel gedetecteerd, maar is het pad naar een bruikbare draadloze driver of firmware niet compleet. In de brondiscussie vermeldt de titel RTL8821CE, maar de daadwerkelijke uitvoer van lspci identificeert een RTL8852BE 802.11ax-controller.

Dat onderscheid is belangrijk, omdat RTL8821CE en RTL8852BE verschillende upstream-Linuxdrivers gebruiken. De huidige compatibiliteitsdocumentatie van ZimaOS vermeldt geen van beide PCIe-kaarten als geverifieerde wifi-optie. Ga er dus niet van uit dat je een Linux Mint-driver zomaar als een normaal Debian-pakket in ZimaOS kunt installeren.

Identificeer eerst de exacte chip

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

Gebruik de PCI-ID en de driverregel, niet alleen het productlabel op de kaart. De hardware van de gebruiker in de bron werd als RTL8852BE opgesomd, hoewel de discussie naar RTL8821CE verwees.

RTL8852BE heeft een upstream-Linuxdriver

De actuele Linux-referentie voor de RTL8852BE-driver laat zien dat RTL8852BE de module rtw89_8852be gebruikt in moderne Linux-kernels.

RTL8821CE gebruikt een andere driverfamilie

RTL8821CE wordt afgehandeld door de rtw88-familie, niet door rtw89. Het combineren van instructies voor de twee chipsets kan leiden tot de verkeerde module en een verkeerd firmwaretraject voor probleemoplossing.

De huidige compatibiliteitslijst van ZimaOS verifieert deze kaarten niet

De huidige lijst met compatibele netwerkadapters voor ZimaOS vermeldt Intel AX210 en verschillende Ethernetadapters, maar geen PCIe-wifikaarten met RTL8821CE of RTL8852BE.

Installeer geen willekeurige DKMS-pakketten op de host

ZimaOS is een systeem in appliance-stijl. Een driverpakket dat op Ubuntu of Linux Mint werkt, kan afhankelijk zijn van headers, DKMS, de status van de pakketbeheerder of beschrijfbare systeempaden die ZimaOS niet op dezelfde manier beschikbaar stelt.

Controleer of de module bestaat

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

Als de exacte module ontbreekt, meld dan de PCI-ID en drivernaam aan IceWhale in plaats van een niet-gerelateerde build buiten de kernel om te forceren.

Gebruik een geverifieerde adapter voor een productieserver

Als je nu wifi nodig hebt, gebruik dan een momenteel geverifieerde adapter, zoals Intel AX210, in plaats van afhankelijk te zijn van een niet-geverifieerde Realtek PCIe-kaart.

De handleiding voor het oplossen van hardwareproblemen helpt bij het structureren van een compatibiliteitsrapport.

Controleer firmwarefouten afzonderlijk van de drivermodule

Een module kan bestaan, maar toch niet werken omdat de vereiste Realtek-firmwareblob ontbreekt. Maak in dmesg onderscheid tussen “module not found” en “failed to load firmware”, omdat daarvoor verschillende oplossingen van IceWhale nodig zijn.

Gebruik de PCI-ID in een driververzoek

Voor de geplaatste RTL8852BE 1T1R-kaart is de PCI-ID belangrijker dan het HP-reserveonderdeelnummer. Driververzoeken moeten vendor- en device-ID's bevatten, zodat IceWhale de juiste kerneloptie en het juiste firmwarepakket kan inschakelen.

Geef de voorkeur aan Ethernet voor een NAS die altijd aanstaat

Zelfs wanneer wifi werkt, is bekabeld Ethernet meestal voorspelbaarder voor een opslagserver, omdat het roaming, radio-interferentie en gedrag van draadloos energiebeheer voorkomt. Gebruik wifi wanneer bekabeling niet praktisch is, en niet als standaardverbinding voor zwaar NAS-verkeer.

Veelgestelde vragen

Is de kaart uit de bron echt een RTL8821CE?

De forumtitel vermeldt RTL8821CE, maar de geplaatste uitvoer van lspci identificeert RTL8852BE.

Waarom werkt Linux Mint wel?

Mint bevat mogelijk de vereiste kernelmodule en firmware, terwijl de ZimaOS-build dezelfde combinatie mogelijk niet bevat of inschakelt.

Kan ik de wifidriver installeren met apt?

Behandel ZimaOS niet als een normale Ubuntu-host. Geef de voorkeur aan een geverifieerde adapter of vraag om integratie van de driver.

Wat moet ik naar IceWhale sturen?

De exacte PCI-ID, lspci -nnk, relevante uitvoer van dmesg, de ZimaOS-versie en of een andere Linux-distributie wel werkt.