IT EN
Riferimenti

Comandi utili

Cheat-sheet dei comandi da terminale per diagnosticare e regolare SkillFishOS.

SkillFishOS è pensato per non richiedere il terminale: il Tuner e le app grafiche bastano per l’uso normale. Questa pagina è per chi vuole smanettare o diagnosticare. Comandi privilegiati = con sudo.

🛟 Prima di esperimenti rischiosi, ricorda la rete di sicurezza: snapshot Btrfs e rollback dal menu GRUB (vedi Storage e snapshot).

Sistema e kernel

uname -r                      # versione kernel in uso (deve finire con -skillfishos)
cat /proc/cmdline             # parametri di avvio attivi
journalctl -b -p err          # errori dell'avvio corrente
inxi -Fxxxz                   # riepilogo hardware completo

GPU, frequenze e temperature

# frequenza/temperatura GPU dal sysfs amdgpu
cat /sys/class/drm/card*/device/hwmon/hwmon*/temp1_input   # °C ×1000
# stato del governor SMU della GPU
systemctl status cyan-skillfish-governor
cat /etc/cyan-skillfish-governor/config.toml               # safe-point freq/volt
# monitoraggio GPU in tempo reale
nvtop        # oppure: radeontop

Sulla BC-250 il controllo frequenze non passa dal sysfs amdgpu standard ma dal governor SMU. Modifica i valori dal Tuner, non a mano.

CPU — overclock/undervolt

systemctl status bc250-smu-oc.service   # "inactive" dopo l'applicazione è normale (one-shot)
cat /etc/bc250-smu-oc.conf              # frequenza/tensione applicate
lscpu | grep MHz                        # frequenze correnti dei core
sensors                                 # temperature/tensioni (nct6686, k10temp)

Compute Unit a caldo (skillfish-cu)

skillfish-cu get          # stato JSON: CU attive + mask per fila (SE/SH)
sudo skillfish-cu max     # instrada tutte le CU (40)
sudo skillfish-cu stock   # torna a 24 (baseline driver)
sudo skillfish-cu set 0x1f   # mask WGP per tutte le file (0x07=24 .. 0x1f=40)
cat /run/skillfish/cu_active # "40/40" (lo legge anche l'HUD)
vulkaninfo | grep -i "deviceName\|driverName"   # GPU vista da Vulkan (RADV)

Le CU si gestiscono comodamente dalla griglia del Tuner (clic + preset, con «Test CU»). Le prime 24 sono bloccate dal driver e sempre attive.

Benchmark rapido (gli stessi usati dal Tuner):

vkpeak                # throughput FP32 (GFLOPS)
clpeak                # banda memoria (GB/s)
sysbench cpu run      # stress/benchmark CPU

Memoria unificata (VRAM/GTT)

cat /proc/cmdline | tr ' ' '\n' | grep -E 'gttsize|ttm'   # parametri GTT/TTM
glxinfo | grep -i "memory"                                 # memoria vista dal driver
free -h                                                     # RAM/GDDR6 condivisa

Gaming

flatpak list                         # app Flatpak (Steam, emulatori EmuDeck…)
flatpak update                        # aggiorna le app Flatpak
gamescope -- %command%               # (da impostare nelle opzioni di avvio di Steam)
# Bluetooth controller
bluetoothctl                         # scan on / pair / connect / trust

AI locale

# lo stack gira in container Docker (vedi pannello AI)
docker ps                            # container attivi (ollama, openwebui, dockge)
docker compose -f <stack> up -d      # avvia lo stack
docker compose -f <stack> down       # ferma e libera GPU/RAM
ollama list                          # modelli installati (es. qwen3:14b)

Snapshot e rollback (Btrfs)

sudo snapper list                    # elenco snapshot
sudo snapper create -d "prima di X"  # snapshot manuale
sudo btrfs subvolume list /          # sottovolumi (@rootfs, @home)
# il rollback più semplice è dal menu GRUB → "SkillFishOS snapshots"

Aggiornamenti e repository

sudo apt update && sudo apt full-upgrade   # aggiorna il sistema
apt-mark showhold                          # pacchetti bloccati (incl. il kernel)
sudo apt install skillfishos-kernel        # installa/aggiorna il kernel dal repo
apt policy <pacchetto>                      # da quale repo/versione viene un pacchetto

Rete e accesso remoto

nmcli device status                  # stato interfacce di rete
ip a                                 # indirizzi IP
systemctl status x11vnc              # server VNC per il desktop remoto
hostname -I                          # IP da usare col client VNC

Display (HPD DisplayPort)

systemctl status skillfish-dp-hotswap   # demone che aggira l'HPD rotto
xrandr                                   # uscite e risoluzioni (sessione X11)

Fonti