Oryginalny przewodnik rozwiązywania problemów jest wartościowy, ponieważ zaczyna się poniżej interfejsu CasaOS. Gdy dysk, karta sieciowa, karta PCIe lub urządzenie USB zachowuje się dziwnie, pierwszym pytaniem jest, czy bazowy system Linux w ogóle widzi ten sprzęt.
Kluczową granicą w 2026 roku jest architektura systemu operacyjnego. Przewodnik z 2023 roku zakłada CasaOS działający na standardowej instalacji Linuksa w stylu Debiana/Ubuntu. Obecny ZimaOS to odrębny system operacyjny typu appliance, oparty na Buildroot, z w dużej mierze tylko do odczytu systemem. Polecenia diagnostyczne tylko do odczytu pozostają przydatne, ale instrukcji instalowania pakietów i modyfikowania systemu z typowych przewodników dla Debiana nie należy przenosić do ZimaOS.
Użyj dmidecode do wyświetlania informacji o BIOS-ie i płycie głównej
dmidecode odczytuje dane SMBIOS/DMI, takie jak:
- producent i wersja BIOS-u;
- data wydania;
- identyfikatory systemu/płyty głównej;
- informacje o pamięci;
- funkcje oprogramowania układowego, takie jak UEFI.
Jest to przydatne przy porównywaniu problemu specyficznego dla sprzętu z aktualizacją BIOS-u lub potwierdzaniu, która dokładnie rewizja płyty jest używana.
Użyj lspci, aby potwierdzić wykrycie sprzętu PCIe
lspci wyświetla urządzenia wykrywane przez podsystem PCI: układy GPU, kontrolery SATA, adaptery NVMe, karty sieciowe, karty przechwytujące oraz inny sprzęt rozszerzeń.
Jeśli nowa karta sieciowa PCIe nigdy nie pojawia się w lspci, problem leży poniżej warstwy Dockera/CasaOS. Przed zainstalowaniem oprogramowania aplikacyjnego sprawdź osadzenie, zasilanie, ustawienia oprogramowania układowego, współdzielenie linii oraz zgodność sprzętową.
Użyj lsusb do identyfikacji urządzeń USB
lsusb raportuje identyfikatory producenta i produktu USB. Identyfikatory te są szczególnie przydatne podczas diagnozowania adapterów Wi‑Fi, urządzeń Coral TPU, mostków pamięci USB, koordynatorów Zigbee oraz innych urządzeń peryferyjnych, które mogą występować w kilku wersjach sprzętowych pod jedną nazwą handlową.
Użyj dmesg do wyświetlania komunikatów sterowników i sprzętu z czasem rozruchu
dmesg może wyświetlać:
- powiązanie z wewnętrznym sterownikiem jądra;
- niepowodzenia ładowania oprogramowania układowego;
- zdarzenia odłączania/podłączania urządzeń USB;
- błędy wejścia/wyjścia pamięci masowej;
- zmiany stanu połączenia karty sieciowej;
- błędy PCIe/AER.
Filtruj lub przechwytuj tylko odpowiednie sekcje zamiast publikować tysiące niezwiązanych z tematem wierszy rozruchu.
Użyj lsblk, aby odróżnić „dysk niewykryty” od „dysku niezamontowanego”
lsblk wyświetla dyski, partycje, zależności między systemami plików oraz punkty montowania. Dysk obecny w lsblk ale brak urządzenia w interfejsie plików CasaOS to inny problem niż całkowity brak dysku w Linuksie.
Najpierw używaj poleceń tylko do odczytu w celu rozpoznania, a dopiero potem poleceń naprawczych
Oryginalna część 1 jest najlepsza, gdy uczy obserwacji. Polecenia takie jak dmidecode, lspci, lsusb, dmesg, oraz lsblk można ustalić warstwę problemu bez modyfikowania pamięci masowej ani pakietów.
Zrób to przed ponownym formatowaniem dysków, ponowną instalacją sterowników, rekurencyjną zmianą właściciela lub ponownym utworzeniem Dockera.
CasaOS i ZimaOS wymagają innych zasad modyfikowania hosta
CasaOS zwykle działa na ogólnym hoście systemu Linux, na którym apt może być dostępne. System ZimaOS jest oparty na Buildroot, a aktualne wytyczne IceWhale dotyczące interfejsu CLI wskazują, że większość folderów systemowych pozostaje tylko do odczytu nawet dla użytkownika root.
Jeśli ten sam sprzęt działa z systemem ZimaOS, użyj aktualnych ograniczeń interfejsu CLI systemu ZimaOS.
Diagnozuj od sprzętu w górę
Przydatna kolejność jest następująca:
- BIOS/oprogramowanie układowe wykrywa sprzęt;
- wyliczanie urządzeń przez magistralę systemu Linux wykrywa je;
- sterownik jądra zostaje powiązany;
- system operacyjny tworzy użyteczny interfejs/urządzenie blokowe;
- CasaOS/ZimaOS udostępnia je w interfejsie;
- Docker/aplikacje otrzymują urządzenie/ścieżkę.
Przejście od razu do warstwy szóstej sprawia, że wiele problemów sprzętowych wygląda jak błędy aplikacji.
Użyj blkid, aby zidentyfikować typ systemu plików i UUID
Źródłowa część 1 również używa blkid po lsblk. To odpowiada na inne pytanie: jaki system plików lub sygnatura członka LVM faktycznie znajduje się na partycji oraz który UUID/PARTUUID ją identyfikuje?
Jest to przydatne, gdy dysk jest widoczny w systemie Linux, ale narzędzie do montowania lub zarządzania pamięcią masową nie rozpoznaje oczekiwanego systemu plików. Zapisz wynik przed sformatowaniem czegokolwiek.
Zapisz informacje o sprzęcie przed zmianą sterowników lub pamięci masowej
Aby przygotować powtarzalne zgłoszenie do pomocy technicznej, zapisz odpowiednie wyniki poleceń wraz z:
- model płyty głównej i wersja BIOS-u;
- wersja systemu operacyjnego;
- model urządzenia oraz identyfikator PCI/USB;
- co zmieniło się bezpośrednio przed wystąpieniem problemu;
- czy sprzęt jest widoczny w BIOS-ie, systemie Linux oraz interfejsie CasaOS/ZimaOS.
Dzięki temu można odróżnić brak sterownika od uszkodzonego kabla, nieobsługiwanego systemu plików lub problemu z mapowaniem w kontenerze.
Często zadawane pytania dotyczące rozwiązywania problemów ze sprzętem w systemie Linux
Co powinienem uruchomić najpierw w przypadku nieznanej karty PCIe?
lspci to najszybsze sprawdzenie tylko do odczytu, czy podsystem PCI je wykrywa.
Co jest najbardziej przydatne do sprawdzania identyfikatorów producenta i produktu USB?
lsusb.
Czy mogę zastosować założenia przewodnika dotyczące pakietów Debiana w systemie ZimaOS?
Zachowaj pojęcia diagnostyczne, ale stosuj zasady dotyczące rozszerzeń i sterowników właściwe dla ZimaOS.
