Den ursprungliga felsökningsguiden är värdefull eftersom den börjar under CasaOS-gränssnittet. När en enhet, ett nätverkskort, ett PCIe-kort eller en USB-enhet beter sig märkligt är den första frågan om det underliggande Linux-systemet över huvud taget kan se maskinvaran.
Den viktiga gränsen för 2026 är operativsystemets arkitektur. Guiden från 2023 förutsätter att CasaOS körs på en vanlig Debian-/Ubuntu-liknande Linux-installation. Aktuella ZimaOS är ett separat, Buildroot-baserat appliance-operativsystem med ett i stor utsträckning skrivskyddat system. Skrivskyddade diagnostikkommandon är fortfarande användbara, men instruktioner om paketinstallation och ändringar av värdsystemet från vanliga Debian-guider bör inte kopieras till ZimaOS.
Använd dmidecode för information om BIOS och moderkort
dmidecode läser SMBIOS-/DMI-data som:
- BIOS-leverantör och -version;
- utgivningsdatum;
- system-/kortidentifierare;
- minnesinformation;
- funktioner i fast programvara som UEFI.
Detta är användbart när du jämför ett maskinvaruspecifikt problem med en BIOS-uppdatering eller bekräftar exakt vilken kortrevision som används.
Använd lspci för att bekräfta att PCIe-maskinvara har identifierats
lspci visar enheter som PCI-undersystemet upptäcker: grafikprocessorer, SATA-styrenheter, NVMe-adaptrar, nätverkskort, inspelningskort och annan expansionsmaskinvara.
Om ett nytt PCIe-nätverkskort aldrig visas i lspciär problemet under Docker/CasaOS. Kontrollera anslutning, strömförsörjning, inställningar för fast programvara, delning av PCIe-banor och maskinvarukompatibilitet innan du installerar programvara.
Använd lsusb för att identifiera USB-enheter
lsusb rapporterar USB-leverantörs- och produkt-ID:n. Dessa ID:n är särskilt användbara vid felsökning av Wi-Fi-adaptrar, Coral TPU-enheter, USB-lagringsbryggor, Zigbee-koordinatorer och annan kringutrustning som kan ha flera maskinvaruversioner under samma försäljningsnamn.
Använd dmesg för drivrutins- och maskinvarumeddelanden vid start
dmesg kan visa:
- bindning av kärndrivrutiner;
- misslyckade inläsningar av fast programvara;
- händelser när USB-enheter kopplas från eller ansluts igen;
- lagringsrelaterade I/O-fel;
- ändringar av nätverkskortets länkstatus;
- PCIe/AER-fel.
Filtrera eller samla bara in relevanta avsnitt i stället för att publicera tusentals orelaterade startrader.
Använd lsblk för att skilja ”disken upptäcks inte” från ”disken är inte monterad”
lsblk visar diskar, partitioner, filsystemens relationer och monteringspunkter. En enhet som finns i lsblk men att den saknas i CasaOS filgränssnitt är ett annat fel än att en enhet saknas helt i Linux.
Föredra skrivskyddad identifiering framför reparationskommandon
Den ursprungliga del 1 är som bäst när den lär ut observation. Kommandon som dmidecode, lspci, lsusb, dmesg, och lsblk kan fastställa problemets lager utan att ändra lagring eller paket.
Gör detta innan du formaterar om diskar, installerar om drivrutiner, ändrar ägarskap rekursivt eller bygger om Docker.
CasaOS och ZimaOS kräver olika regler för ändringar på värdsystemet
CasaOS körs normalt på en generell Linux-värd där apt kan vara tillgängligt. ZimaOS är Buildroot-baserat, och aktuell CLI-vägledning från IceWhale anger att de flesta systemmappar förblir skrivskyddade även som root.
Använd den aktuella CLI-gränsen i ZimaOS när samma maskinvara kör ZimaOS.
Felsök uppifrån och ned från maskinvaran
En användbar ordning är:
- BIOS/fast programvara upptäcker maskinvaran;
- Linux-bussenumerering hittar den;
- en kärndrivrutin binds;
- operativsystemet skapar ett användbart gränssnitt/enhet för blocklagring;
- CasaOS/ZimaOS visar den i gränssnittet;
- Docker/applikationer får enheten/sökvägen.
Om du hoppar direkt till lager sex kan många maskinvaruproblem se ut som appfel.
Använd blkid för att identifiera filsystemstyp och UUID
Källdel 1 använder också blkid efter lsblk. Detta besvarar en annan fråga: vilken filsystem- eller LVM-medlemssignatur innehåller partitionen faktiskt, och vilket UUID/PARTUUID identifierar den?
Det är användbart när en disk visas i Linux men ett monterings- eller lagringshanteringsverktyg inte känner igen det förväntade filsystemet. Spara utdatan innan du formaterar om något.
Spara maskinvaruunderlaget innan du ändrar drivrutiner eller lagring
För en reproducerbar supportanmälan ska du samla in relevant kommandoutdata tillsammans med:
- kortmodell och BIOS-version;
- operativsystemets version;
- enhetsmodell samt PCI-/USB-ID;
- vad som ändrades omedelbart innan problemet uppstod;
- om maskinvaran visas i BIOS, Linux och CasaOS/ZimaOS-gränssnittet.
Detta gör det möjligt att skilja en saknad drivrutin från en trasig kabel, ett filsystem som inte stöds eller ett problem med containermappning.
Vanliga frågor om felsökning av Linux-maskinvara
Vad bör jag köra först för ett okänt PCIe-kort?
lspci är den snabbaste skrivskyddade kontrollen av om PCI-undersystemet ser det.
Vad är mest användbart för USB-leverantörs-/produkt-ID:n?
lsusb.
Kan jag använda guidens antaganden om Debian-paket på ZimaOS?
Behåll de diagnostiska begreppen, men följ ZimaOS-specifika regler för tillägg och drivrutiner.
