La guida originale alla risoluzione dei problemi è preziosa perché parte da un livello sottostante l'interfaccia di CasaOS. Quando un'unità, una scheda di rete, una scheda PCIe o un dispositivo USB si comporta in modo anomalo, la prima domanda è se il sistema Linux sottostante riesca a rilevare l'hardware.
Il confine importante del 2026 riguarda l'architettura del sistema operativo. La guida del 2023 presuppone CasaOS in esecuzione su una normale installazione Linux in stile Debian/Ubuntu. Gli strumenti diagnostici in sola lettura restano utili, ma le istruzioni per installare pacchetti e modificare il sistema host delle normali guide Debian non devono essere copiate in ZimaOS.
Usa dmidecode per le informazioni sul BIOS e sulla scheda
dmidecode legge i dati SMBIOS/DMI, come:
- produttore e versione del BIOS;
- data di rilascio;
- identificativi del sistema/della scheda;
- informazioni sulla memoria;
- funzionalità del firmware come UEFI.
È utile per confrontare un problema specifico dell'hardware con un aggiornamento del BIOS o per confermare esattamente quale revisione della scheda è in uso.
Usa lspci per verificare che l'hardware PCIe sia enumerato
lspci elenca i dispositivi rilevati dal sottosistema PCI: GPU, controller SATA, adattatori NVMe, schede di rete, schede di acquisizione e altro hardware di espansione.
Se una nuova scheda di rete PCIe non compare mai in lspci, il problema è a un livello inferiore rispetto a Docker/CasaOS. Controlla il collegamento, l'alimentazione, le impostazioni del firmware, la condivisione delle linee e la compatibilità hardware prima di installare il software applicativo.
Usa lsusb per identificare i dispositivi USB
lsusb riporta gli ID di produttore/prodotto USB. Questi ID sono particolarmente utili per diagnosticare adattatori Wi-Fi, dispositivi Coral TPU, bridge per l'archiviazione USB, coordinatori Zigbee e altre periferiche che possono avere diverse revisioni hardware con lo stesso nome commerciale.
Usa dmesg per i messaggi dei driver e dell'hardware durante l'avvio
dmesg può mostrare:
- associazione dei driver del kernel;
- errori di caricamento del firmware;
- eventi di disconnessione/riconnessione USB;
- errori di I/O dell'archiviazione;
- variazioni del collegamento della scheda di rete;
- errori PCIe/AER.
Filtra o acquisisci solo le sezioni pertinenti invece di pubblicare migliaia di righe di avvio non correlate.
Usa lsblk per distinguere tra «disco non rilevato» e «disco non montato»
lsblk mostra dischi, partizioni, relazioni tra file system e punti di montaggio. Un'unità presente in lsblk ma l'assenza dall'interfaccia File di CasaOS è un problema diverso da un'unità completamente assente da Linux.
Preferisci la rilevazione in sola lettura prima dei comandi di riparazione
La Parte 1 originale è più efficace quando insegna a osservare. Comandi come dmidecode, lspci, lsusb, dmesg, e lsblk può stabilire il livello del problema senza modificare lo storage o i pacchetti.
Esegui questa operazione prima di riformattare i dischi, reinstallare i driver, modificare ricorsivamente i proprietari o ricostruire Docker.
CasaOS e ZimaOS richiedono regole diverse per la modifica dell'host
CasaOS normalmente viene eseguito su un host Linux generico in cui apt potrebbe essere disponibile. ZimaOS è basato su Buildroot e le indicazioni attuali della CLI di IceWhale specificano che la maggior parte delle cartelle di sistema rimane in sola lettura anche per l'utente root.
Usa l'attuale perimetro della CLI di ZimaOS quando lo stesso hardware esegue ZimaOS.
Diagnostica dal livello hardware verso l'alto
Un ordine utile è:
- il BIOS/firmware rileva l'hardware;
- l'enumerazione del bus Linux lo rileva;
- un driver del kernel si associa;
- il sistema operativo crea un'interfaccia/un dispositivo a blocchi utilizzabile;
- CasaOS/ZimaOS lo espone nell'interfaccia utente;
- Docker/le applicazioni ricevono il dispositivo/percorso.
Passare direttamente al sesto livello fa sembrare molti problemi hardware dei bug delle app.
Usa blkid per identificare il tipo di filesystem e l'UUID
La Parte 1 della fonte utilizza anche blkid dopo lsblk. Questo risponde a una domanda diversa: quale firma di filesystem o membro LVM contiene effettivamente la partizione e quale UUID/PARTUUID la identifica?
È utile quando un disco viene visualizzato in Linux, ma un gestore dei mount o dello storage non riconosce il filesystem previsto. Registra l'output prima di riformattare qualsiasi cosa.
Salva le informazioni sull'hardware prima di modificare i driver o lo storage
Per una segnalazione di supporto riproducibile, acquisisci l'output dei comandi pertinenti insieme a:
- modello della scheda e versione del BIOS;
- versione del sistema operativo;
- modello del dispositivo e ID PCI/USB;
- che cosa è cambiato subito prima che si verificasse il problema;
- se l'hardware viene visualizzato nel BIOS, in Linux e nell'interfaccia utente di CasaOS/ZimaOS.
Questo consente di distinguere tra un driver mancante, un cavo guasto, un filesystem non supportato o un problema di mappatura del container.
FAQ sulla risoluzione dei problemi hardware Linux
Cosa devo eseguire per primo per una scheda PCIe sconosciuta?
lspci è il controllo in sola lettura più rapido per verificare che il sottosistema PCI lo rilevi.
Qual è il comando più utile per ottenere gli ID del produttore e del prodotto USB?
lsusb.
Posso applicare a ZimaOS le ipotesi della guida sui pacchetti Debian?
No. Mantieni i concetti diagnostici, ma segui le regole specifiche di ZimaOS per estensioni e driver.
