De oorspronkelijke gids voor probleemoplossing is waardevol omdat deze onder de CasaOS-interface begint. Wanneer een schijf, NIC, PCIe-kaart of USB-apparaat zich vreemd gedraagt, is de eerste vraag of het onderliggende Linux-systeem de hardware überhaupt kan zien.
De belangrijke grens voor 2026 is de architectuur van het besturingssysteem. De gids uit 2023 gaat ervan uit dat CasaOS draait op een normale Debian-/Ubuntu-achtige Linux-installatie. Alleen-lezen diagnoseopdrachten blijven nuttig, maar instructies voor pakketinstallatie en wijzigingen aan de host uit gewone Debian-gidsen mogen niet zonder meer worden overgenomen voor ZimaOS.
Gebruik dmidecode voor BIOS- en bordinformatie
dmidecode leest SMBIOS-/DMI-gegevens zoals:
- BIOS-leverancier en -versie;
- releasedatum;
- systeem-/bord-ID’s;
- geheugeninformatie;
- firmwaremogelijkheden zoals UEFI.
Dit is nuttig bij het vergelijken van een hardwarespecifiek probleem met een BIOS-update of bij het bevestigen van de exacte bordrevisie die wordt gebruikt.
Gebruik lspci om te bevestigen dat PCIe-hardware wordt opgesomd
lspci toont apparaten die het PCI-subsysteem detecteert: GPU’s, SATA-controllers, NVMe-adapters, NIC’s, capturekaarten en andere uitbreidingshardware.
Als een nieuwe PCIe-NIC nooit verschijnt in lspci, dan ligt het probleem onder Docker/CasaOS. Controleer de plaatsing, voeding, firmware-instellingen, lane-deling en hardwarecompatibiliteit voordat je applicatiesoftware installeert.
Gebruik lsusb voor de identiteit van USB-apparaten
lsusb rapporteert USB-leveranciers- en product-ID’s. Die ID’s zijn vooral nuttig bij het diagnosticeren van wifi-adapters, Coral TPU-apparaten, USB-opslagbruggen, Zigbee-coördinatoren en andere randapparaten die onder één winkelnaam meerdere hardwareversies kunnen hebben.
Gebruik dmesg voor stuurprogramma- en hardwaremeldingen tijdens het opstarten
dmesg kan het volgende tonen:
- koppeling van kernelstuurprogramma’s;
- mislukte firmwareladingen;
- USB-verbindingsverbrekingen en -herverbindingen;
- I/O-fouten van opslag;
- wijzigingen in de NIC-link;
- PCIe/AER-fouten.
Filter of leg alleen de relevante gedeelten vast in plaats van duizenden irrelevante opstartregels te plaatsen.
Gebruik lsblk om onderscheid te maken tussen ‘Schijf niet gedetecteerd’ en ‘Schijf niet aangekoppeld’
lsblk toont schijven, partities, relaties tussen bestandssystemen en aankoppelpunten. Een schijf die aanwezig is in lsblk maar een schijf die ontbreekt in de CasaOS-bestandsinterface is een ander probleem dan een schijf die volledig ontbreekt in Linux.
Geef de voorkeur aan alleen-lezen detectie vóór herstelopdrachten
Het oorspronkelijke deel 1 is het sterkst wanneer het observatie aanleert. Opdrachten zoals dmidecode, lspci, lsusb, dmesg, en lsblk kan de probleempuntlaag vaststellen zonder opslag of pakketten te wijzigen.
Doe dit voordat je schijven opnieuw formatteert, stuurprogramma's opnieuw installeert, eigenaarschap recursief wijzigt of Docker opnieuw opbouwt.
Voor CasaOS en ZimaOS gelden verschillende regels voor hostwijzigingen
CasaOS draait normaal gesproken op een algemene Linux-host waarop apt is mogelijk beschikbaar. ZimaOS is gebaseerd op Buildroot en volgens de huidige CLI-richtlijnen van IceWhale blijven de meeste systeemmappen alleen-lezen, zelfs als root.
Gebruik de huidige CLI-grenzen van ZimaOS wanneer dezelfde hardware ZimaOS gebruikt.
Diagnoseer van hardware naar bovenliggende lagen
Een bruikbare volgorde is:
- het BIOS/de firmware detecteert de hardware;
- Linux-busenumeratie detecteert het;
- een kernelstuurprogramma wordt gekoppeld;
- het besturingssysteem maakt een bruikbare interface of blokapparaat aan;
- CasaOS/ZimaOS stelt het beschikbaar in de gebruikersinterface;
- Docker/applicaties ontvangen het apparaat of pad.
Als je rechtstreeks naar laag zes springt, lijken veel hardwareproblemen op fouten in apps.
Gebruik blkid om het bestandssysteemtype en de UUID te identificeren
In deel 1 van de bron wordt ook blkid na lsblk. Dit beantwoordt een andere vraag: welke handtekening van een bestandssysteem of LVM-lid bevat de partitie daadwerkelijk, en welke UUID/PARTUUID identificeert deze?
Dat is nuttig wanneer een schijf wel zichtbaar is in Linux, maar een koppelpunt of opslagbeheerder het verwachte bestandssysteem niet herkent. Leg de uitvoer vast voordat je iets opnieuw formatteert.
Sla hardwaregegevens op voordat je stuurprogramma's of opslag wijzigt
Leg voor een reproduceerbaar supportticket de relevante uitvoer vast, samen met:
- kaartmodel en BIOS-versie;
- versie van het besturingssysteem;
- apparaatmodel plus PCI/USB-ID;
- wat er direct vóór het probleem is veranderd;
- of de hardware zichtbaar is in het BIOS, Linux en de CasaOS/ZimaOS-gebruikersinterface.
Hierdoor kun je onderscheid maken tussen een ontbrekend stuurprogramma, een defecte kabel, een niet-ondersteund bestandssysteem of een probleem met de containerkoppeling.
Veelgestelde vragen over het oplossen van Linux-hardwareproblemen
Wat moet ik als eerste uitvoeren voor een onbekende PCIe-kaart?
lspci is de snelste alleen-lezencontrole om te zien of het PCI-subsysteem het apparaat detecteert.
Wat is het handigst voor USB-leverancier- en product-ID's?
lsusb.
Kan ik de aannames over Debian-pakketten uit de handleiding gebruiken op ZimaOS?
Nee. Behoud de diagnostische concepten, maar volg de specifieke regels van ZimaOS voor extensies en stuurprogramma's.
