Gemenskapslösning

Drivrutinsguide för Realtek RTL8821CE eller RTL8852BE på ZimaOS

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

Om ett Realtek Wi-Fi-kort visas i lspci men ZimaOS säger ”Wi-Fi Hardware: Missing” upptäcks PCIe-enheten, men den användbara sökvägen för trådlös drivrutin och firmware är inte komplett. I källtråden står RTL8821CE i rubriken, men den faktiska lspci-utmatningen identifierar en RTL8852BE 802.11ax-kontroller.

Den skillnaden är viktig eftersom RTL8821CE och RTL8852BE använder olika drivrutiner i Linux. Aktuell kompatibilitetsdokumentation för ZimaOS listar fortfarande inte något av PCIe-korten som ett verifierat Wi-Fi-alternativ, så anta inte att en Linux Mint-drivrutin bara kan installeras i ZimaOS som ett vanligt Debian-paket.

Identifiera det exakta chippet först

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

Använd PCI-ID:t och drivrutinsraden, inte bara produktmärkningen på kortet. Källanvändarens maskinvara identifierades som RTL8852BE, även om tråden hänvisade till RTL8821CE.

RTL8852BE har en Linux-drivrutin uppströms

Den aktuella Linux-referensen för RTL8852BE-drivrutinen visar att RTL8852BE använder modulen rtw89_8852be i moderna Linux-kärnor.

RTL8821CE använder en annan drivrutinsfamilj

RTL8821CE hanteras av rtw88-familjen i stället för rtw89. Om instruktioner för de två chipseten blandas ihop kan det leda till fel modul och fel felsökningsväg för firmware.

Den aktuella kompatibilitetslistan för ZimaOS verifierar inte dessa kort

Den aktuella listan över kompatibla nätverksadaptrar för ZimaOS innehåller Intel AX210 och flera Ethernet-adaptrar, men inte PCIe-Wi-Fi-korten RTL8821CE eller RTL8852BE.

Installera inte slumpmässiga DKMS-paket på värdsystemet

ZimaOS är ett system av appliance-typ. Ett drivrutinspaket som fungerar i Ubuntu eller Linux Mint kan vara beroende av headers, DKMS, pakethanterarens tillstånd eller skrivbara systemsökvägar som ZimaOS inte exponerar på samma sätt.

Kontrollera om modulen finns

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

Om den exakta modulen saknas bör du rapportera PCI-ID:t och drivrutinsnamnet till IceWhale i stället för att tvinga fram en orelaterad extern kompilering.

Använd en verifierad adapter för en produktionsserver

Om Wi-Fi behövs nu bör du använda en aktuell verifierad adapter, till exempel Intel AX210, i stället för att förlita dig på ett overifierat Realtek PCIe-kort.

Guiden för felsökning av maskinvara hjälper dig att strukturera en kompatibilitetsrapport.

Kontrollera firmwarefel separat från drivrutinsmodulen

En modul kan finnas men ändå misslyckas eftersom den nödvändiga Realtek-firmwarefilen saknas. I dmesg ska du skilja mellan ”module not found” och ”failed to load firmware”, eftersom de kräver olika åtgärder från IceWhale.

Använd PCI-ID:t i en drivrutinsförfrågan

För det publicerade RTL8852BE 1T1R-kortet är PCI-ID:t viktigare än HP:s reservdelsmärkning. Drivrutinsförfrågningar bör innehålla leverantörs- och enhets-ID:n så att IceWhale kan aktivera rätt kärnalternativ och firmwarepaket.

Föredra Ethernet för en NAS som alltid är på

Även när Wi-Fi fungerar är trådbundet Ethernet vanligtvis mer förutsägbart för en lagringsserver, eftersom det undviker roaming, RF-störningar och beteenden kopplade till trådlös energihantering. Använd Wi-Fi när kabeldragning är opraktisk, snarare än som standard för tung NAS-trafik.

Vanliga frågor

Är källkortet verkligen RTL8821CE?

Forumrubriken säger RTL8821CE, men den publicerade lspci-utmatningen identifierar RTL8852BE.

Varför fungerar Linux Mint?

Mint kan innehålla den nödvändiga kärnmodulen och firmware, medan ZimaOS-versionen kanske inte innehåller eller aktiverar samma kombination.

Kan jag installera Wi-Fi-drivrutinen med apt?

Behandla inte ZimaOS som ett vanligt Ubuntu-värdsystem. Föredra en verifierad adapter eller be om drivrutinsintegration.

Vad ska jag skicka till IceWhale?

Exakt PCI-ID, lspci -nnk, relevant dmesg-utmatning, ZimaOS-version och information om huruvida en annan Linux-distribution fungerar.