Een geïntegreerde GPU controleren na een kernelupdate

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Een geïntegreerde GPU blijft alleen beschikbaar als de nieuwe kernel deze detecteert, het juiste stuurprogramma koppelt, rendernodes aanmaakt en deze beschikbaar stelt aan de workload.

Na een kernelupdate op een homeserver kan een media-app terugvallen op software, ook al staat hardwareversnelling nog steeds ingeschakeld. De fout kan optreden bij PCI-detectie, het koppelen van de kernelmodule, het laden van firmware, het aanmaken van een DRM-apparaat, VA-API-initialisatie, apparaatmachtigingen, Docker-koppeling of het FFmpeg-pad van de mediaserver. Controleer deze lagen in volgorde en vergelijk ze met de vorige opstartbeurt voordat je de applicatie-instellingen wijzigt.

Noteer de nieuwe kernel en controleer of de iGPU op de PCI-bus staat

Noteer de versie van de actieve kernel, de eerder geïnstalleerde kernels, de opstartparameters en het tijdstip van de update. Geef vervolgens PCI-apparaten van de beeldschermklasse weer met numerieke ID's en het kernelstuurprogramma dat momenteel aan de geïntegreerde GPU is gekoppeld.

Als de iGPU ontbreekt in de PCI-inventarisatie, controleer dan de firmware- of BIOS-instellingen voordat je VA-API gaat debuggen. Een server kan alleen een afzonderlijke GPU beschikbaar stellen als de iGPU- of multi-monitoroptie is uitgeschakeld, zoals blijkt uit een geval waarin de iGPU verborgen was voor Linux.

Vergelijk de apparaat-ID en het gekoppelde stuurprogramma met de laatst bekende goede opstartbeurt. Voor Intel-systemen is dit meestal i915 of, op ondersteunde nieuwere systemen, xe. Gebruik het stuurprogramma dat bedoeld is voor de hardware en distributie, in plaats van een module van een ander platform te forceren.

Kernel-logboeken voor de initialisatie van stuurprogramma's en firmware bekijken

Zoek in het huidige opstartlogboek naar het GPU-stuurprogramma, DRM, GuC- of HuC-firmware, beeldscherminitialisatie, probeerfouten, time-outs en moduleblacklists. Vergelijk dezelfde meldingen met die van de vorige kernel als er persistente logboeken beschikbaar zijn.

Een probleem met het mediastuurprogramma kan optreden, zelfs als de hardware wordt vermeld. In een Intel-issue wordt beschreven hoe de VA-API-initialisatie mislukte op een geïntegreerde Xe-LPG-GPU nadat de omliggende softwarestack was gewijzigd. Dit laat zien dat gedetecteerde hardware niet voldoende is.

Controleer of de vereiste firmwarepakketten nog aanwezig zijn en of de module niet wordt geblokkeerd door een nieuwe kernelparameter, blacklist of Secure Boot-beleid. Installeer de mediaserver pas opnieuw als het hoststuurprogramma zonder problemen initialiseert.

Controleer of het DRM-renderknooppunt nog bestaat

Controleer /dev/dri en noteer de hoofd- en subnummers, eigenaren, groepen en symbolische koppelingen voor elke kaart en elk renderknooppunt. Ga er niet van uit dat de iGPU altijd renderD128 blijft wanneer er een andere GPU aanwezig is.

Hardwareversnelling werkt niet als FFmpeg een knooppunt gebruikt dat wel bestaat, maar geen geldige VA-weergave meer biedt. Een Jellyfin-rapport toont de doorslaggevende fout: geen VA-weergave voor het renderapparaat.

Koppel het renderknooppunt via sysfs aan het PCI-apparaat en werk de container- of applicatieconfiguratie alleen bij als de identiteit van het knooppunt daadwerkelijk is veranderd. Vermijd ruime rechten, zoals modus 777; behoud het model met de rendergroep en controleer of het serviceaccount lid is van die groep.

Single board computer zimaboard2

Test VA-API of Quick Sync op de host voordat je Docker gebruikt

Voer de VA-API-diagnostiek van de distributie uit op het geverifieerde renderknooppunt en leg de drivernaam, VA-API-versie, ondersteunde decodeerprofielen, encodeerfuncties en videobewerkingsmogelijkheden vast.

De mediad driver in de gebruikersruimte moet passen bij de hardwaregeneratie en de kernelinterface. Een opgeloste Linux-casus benadrukt dat DRM-kernelmodules en DRI- of VA-drivers in de gebruikersruimte afzonderlijke lagen zijn; als je die door elkaar haalt, kan de verkeerde driver in de gebruikersruimte actief blijven.

Als VA-API op de host niet werkt, vergelijk dan de huidige pakketten voor de media-driver en firmware met de versies van vóór de update. Als VA-API op de host wel werkt, laat de kernel en driver dan ongemoeid en onderzoek de containergrens.

Controleer hetzelfde apparaat en dezelfde groepen in de container

Controleer de apparaten, groeps-ID's en toegang tot het gekozen renderknooppunt in de actieve container. Voer de meegeleverde VA-API-diagnostiek of FFmpeg-build van de mediaserver uit in de container, want een geslaagde test op de host bewijst niet dat het in de container ook werkt.

Een container kan /dev/dri/renderD128 ontvangen en toch mislukken omdat het proces geen toestemming heeft via de bijbehorende rendergroep. Een rapport van een Jellyfin-container laat zien dat zowel de apparaatkoppeling als de groepstoegang moeten worden gecontroleerd.

Vergelijk de numerieke groeps-ID's op de host en in de container en maak de service zo nodig opnieuw aan met expliciete apparaat- en groepsconfiguratie. De ZimaSpace-handleiding voor het controleren van hardwaretranscodering biedt de volgende controle op applicatieniveau.

Forceer een kleine codec-test en controleer de daadwerkelijke GPU-engines

Gebruik één bekend goed H.264- of HEVC-sample en forceer een videotranscodering zonder ondertitels of HDR-tonemapping. Noteer de dashboardstatus, de FFmpeg-opdracht, de transcoderingssnelheid, het CPU-gebruik en de activiteit van de GPU-decodeer- of codeerengine.

Een mediaserver kan melden dat hardware wordt ondersteund, maar automatisch het verkeerde VA-API-apparaat selecteren. Een Jellyfin-probleem beschrijft een geval waarin expliciete apparaatselectie veranderde of FFmpeg het versnellingspad detecteerde.

Test decoderen en coderen indien mogelijk afzonderlijk. Als één codec faalt terwijl een eenvoudige codec wel werkt, is de iGPU beschikbaar, maar wordt dat profiel, die firmwarefunctie, dat stuurprogrammapad of dat filter niet ondersteund. Verklaar niet dat de hele GPU ontbreekt op basis van één fout bij geavanceerde tonemapping.

Gebruik de vorige kernel voor een gecontroleerde vergelijking

Als PCI-detectie, renderknooppunten of VA-API op de host alleen met de nieuwe kernel niet werken, start dan op met de vorige geïnstalleerde kernel zonder de containerimage, versie van de mediaserver of gebruikersruimteconfiguratie te wijzigen.

In een Jellyfin-geval rond probleemoplossing wordt teruggaan naar een vorige kernel aanbevolen als de eenvoudigste manier om te bepalen of de fout samenhangt met een kernelwijziging. De waarde zit in een gecontroleerde kernelvergelijking, niet in het beschouwen van terugdraaien als de permanente oplossing.

De verificatie is voltooid wanneer de huidige kernel de iGPU op PCI detecteert, het juiste stuurprogramma koppelt, het juiste renderknooppunt aanmaakt, VA-API initialiseert, het apparaat beschikbaar maakt in de container en een echte codeectest met hardwareversnelling uitvoert. Als alleen de vorige kernel slaagt, houd die dan als tijdelijke opstartoptie totdat de regressie in de kernel, firmware of het mediastuurprogramma is geïsoleerd.

Ondersteuning en tips

Meer om te lezen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.