Skip to content

Commit 19dadf0

Browse files
MTSistemiMTSistemi
committed
Documentation: glossary and command reference in four languages
16 of 19. Three left: GPU overclock, performance and sources.
1 parent c8963a7 commit 19dadf0

8 files changed

Lines changed: 968 additions & 0 deletions

File tree

‎website/src/content/docs/de/comandi-utili.md‎

Lines changed: 139 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,139 @@
1+
---
2+
title: Nützliche Befehle
3+
description: Ein Spickzettel fürs Terminal, um SkillFishOS zu untersuchen und einzustellen.
4+
group: Nachschlagen
5+
order: 4
6+
---
7+
8+
SkillFishOS ist so gebaut, dass das Terminal **nicht** nötig ist: für den gewöhnlichen Gebrauch reichen der [Tuner](/de/docs/app-native) und die grafischen Anwendungen. Diese Seite ist für alle, die **basteln** oder auf Fehlersuche gehen wollen. Befehle mit erhöhten Rechten laufen über `sudo`.
9+
10+
> Denk vor riskanten Versuchen an das Sicherheitsnetz: Btrfs-Schnappschüsse und die Rückkehr aus dem GRUB-Menü (siehe [Speicher und Schnappschüsse](/de/docs/storage-snapshot)).
11+
12+
## System und Kernel
13+
14+
```bash
15+
uname -r # laufender Kernel (sollte auf -skillfishos enden)
16+
cat /proc/cmdline # geltende Startparameter
17+
journalctl -b -p err # Fehler des aktuellen Starts
18+
inxi -Fxxxz # vollständige Übersicht der Hardware
19+
```
20+
21+
## GPU, Takte und Temperaturen
22+
23+
```bash
24+
# GPU-Temperatur aus dem sysfs von amdgpu
25+
cat /sys/class/drm/card*/device/hwmon/hwmon*/temp1_input # °C ×1000
26+
# Zustand des SMU-Governors
27+
systemctl status cyan-skillfish-governor
28+
cat /etc/cyan-skillfish-governor/config.toml # sichere Punkte aus Takt und Spannung
29+
# GPU in Echtzeit beobachten
30+
nvtop # oder: radeontop
31+
```
32+
33+
> Auf der BC-250 läuft die Taktsteuerung **nicht** über das übliche sysfs von amdgpu, sondern über den **SMU-Governor**. Ändere die Werte im [Tuner](/de/docs/app-native), nicht von Hand.
34+
35+
## CPU — Übertaktung und Undervolting
36+
37+
```bash
38+
systemctl status bc250-smu-oc.service # dass er nach dem Anwenden „inactive“ ist, gehört so (er läuft einmalig)
39+
cat /etc/bc250-smu-oc.conf # angewandter Takt und angewandte Spannung
40+
lscpu | grep MHz # aktuelle Kerntakte
41+
sensors # Temperaturen und Spannungen (nct6686, k10temp)
42+
```
43+
44+
## Recheneinheiten im Betrieb (skillfish-cu)
45+
46+
```bash
47+
skillfish-cu get # Zustand als JSON: aktive CU und Maske je Reihe (SE/SH)
48+
sudo skillfish-cu max # alle CU in Betrieb nehmen (40)
49+
sudo skillfish-cu stock # zurück auf 24 (Grundwert des Treibers)
50+
sudo skillfish-cu set 0x1f # WGP-Maske für alle Reihen (0x07=24 … 0x1f=40)
51+
cat /run/skillfish/cu_active # „40/40“ (das liest auch das HUD)
52+
vulkaninfo | grep -i "deviceName\|driverName" # die GPU, wie Vulkan sie sieht (RADV)
53+
```
54+
55+
Die CU verwaltet man am besten über das **Raster** im [Tuner](/de/docs/app-native) (Klick und Vorgaben, mit der „CU-Prüfung“). Die ersten 24 sind vom Treiber festgelegt und immer an.
56+
57+
Schnelle Messungen (dieselben, die der Tuner benutzt):
58+
59+
```bash
60+
vkpeak # FP32-Leistung (GFLOPS)
61+
clpeak # Speicherbandbreite (GB/s)
62+
sysbench cpu run # Last und Messung für die CPU
63+
```
64+
65+
## Einheitlicher Speicher (Grafikspeicher und GTT)
66+
67+
```bash
68+
cat /proc/cmdline | tr ' ' '\n' | grep -E 'ttm\.' # Parameter zu GTT/TTM
69+
glxinfo | grep -i "memory" # Speicher, wie der Treiber ihn sieht
70+
free -h # gemeinsamer RAM/GDDR6
71+
```
72+
73+
## Spiele
74+
75+
```bash
76+
flatpak list # Flatpak-Anwendungen (Steam, Emulatoren von EmuDeck …)
77+
flatpak update # die Flatpak-Anwendungen aktualisieren
78+
gamescope -- %command% # (in den Startoptionen von Steam eintragen)
79+
# Controller über Bluetooth
80+
bluetoothctl # scan on / pair / connect / trust
81+
```
82+
83+
## Lokale KI
84+
85+
```bash
86+
# ein einziger nativer Dienst, keine Container: Docker ist nicht installiert
87+
systemctl status skillfish-unsloth # Zustand des KI-Motors
88+
sudo systemctl start skillfish-unsloth # starten
89+
sudo systemctl stop skillfish-unsloth # anhalten und GPU sowie Speicher freigeben
90+
curl -s localhost:8888/ # die Oberfläche von Unsloth Studio (nur Loopback)
91+
```
92+
93+
## Schnappschüsse und Rückkehr (Btrfs)
94+
95+
```bash
96+
sudo snapper list # Schnappschüsse auflisten
97+
sudo snapper create -d "vor X" # Schnappschuss von Hand
98+
sudo btrfs subvolume list / # Unterbände (@, @home, @log, @cache)
99+
100+
# wirklich zu einem Schnappschuss zurück (gilt ab dem nächsten Start)
101+
sudo skillfish-rollback --list # welche Schnappschüsse es gibt
102+
sudo skillfish-rollback 12 # Schnappschuss 12 zum laufenden System machen
103+
sudo skillfish-rollback --undo # anders überlegt: den alten zurückholen
104+
sudo skillfish-rollback --clean # die von früheren Rückkehren beiseitegelegten Systeme entfernen
105+
106+
# über das GRUB-Menü → „SkillFishOS snapshots“ bekommst du denselben Schnappschuss
107+
# NUR LESBAR: gut zum Umsehen und Retten von Dateien, danach den Befehl oben ausführen
108+
```
109+
110+
## Aktualisierungen und Paketquelle
111+
112+
```bash
113+
sudo apt update && sudo apt full-upgrade # das System aktualisieren
114+
apt-mark showhold # festgehaltene Pakete (samt Kernel)
115+
sudo apt install skillfishos-kernel # den Kernel aus der Paketquelle installieren oder aktualisieren
116+
apt policy <Paket> # aus welcher Paketquelle und in welcher Fassung ein Paket kommt
117+
```
118+
119+
## Netzwerk und Fernzugriff
120+
121+
```bash
122+
nmcli device status # Zustand der Netzwerkgeräte
123+
ip a # IP-Adressen
124+
systemctl status x11vnc # VNC-Server für den entfernten Schreibtisch
125+
hostname -I # IP für den VNC-Client
126+
```
127+
128+
## Bildschirm (HPD des DisplayPort)
129+
130+
```bash
131+
systemctl status skillfish-dp-hotswap # Dienst, der das defekte HPD umgeht
132+
xrandr # Ausgänge und Auflösungen (X11-Sitzung)
133+
```
134+
135+
## Quellen
136+
137+
- [Btrfs-Wiki](https://btrfs.readthedocs.io/) · [Snapper](http://snapper.io/)
138+
- [Mesa / RADV](https://docs.mesa3d.org/drivers/radv.html) · [vulkaninfo](https://github.com/KhronosGroup/Vulkan-Tools)
139+
- [Arch Wiki](https://wiki.archlinux.org/) — Nachschlagewerk für viele Linux-Befehle

‎website/src/content/docs/de/glossario.md‎

Lines changed: 103 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,103 @@
1+
---
2+
title: Glossar
3+
description: Die Fachbegriffe rund um SkillFishOS und die BC-250, kurz erklärt.
4+
group: Nachschlagen
5+
order: 5
6+
---
7+
8+
Die Begriffe, die sich durch die ganze Dokumentation ziehen, jeder in einer Zeile erklärt. In alphabetischer Folge.
9+
10+
## Hardware und APU
11+
12+
**APU** — *Accelerated Processing Unit*: ein Chip, der CPU und GPU auf demselben Plättchen vereint. Die BC-250 trägt eine teilweise maßgefertigte von AMD.
13+
14+
**BC-250** — die Platine, auf der SkillFishOS läuft: APU Zen 2 + RDNA 2, 16 GB GDDR6, ursprünglich fürs Mining gebaut.
15+
16+
**Cyan Skillfish** — der Kennname des **Grafikteils** (GPU) der APU der BC-250. Daher der Name „SkillFish“.
17+
18+
**Oberon** — der Kennname des **CPU-Teils** (Zen 2) derselben APU.
19+
20+
**Recheneinheit (CU)** — die Rechenblöcke der GPU. Die BC-250 hat 40, zeigt aber ab Werk weniger: SkillFishOS **schaltet alle frei** (siehe [Kernel](/de/docs/kernel)).
21+
22+
**gfx1013** — die Kennung der Grafikarchitektur der BC-250 (Familie RDNA 2). Sie ist wichtig, weil **ROCm sie nicht unterstützt** → stattdessen kommt Vulkan zum Einsatz.
23+
24+
**RDNA 2** — die Grafikarchitektur von AMD in dieser GPU (dieselbe Familie wie die aktuellen Konsolen).
25+
26+
**Zen 2** — die CPU-Architektur von AMD in dieser APU (**8 Kerne / 16 Threads**: die Platine zeigt 6, SkillFishOS schaltet die anderen beiden über die SMU frei).
27+
28+
**GDDR6** — der Speichertyp der Platine: schnell und hier von CPU und GPU **gemeinsam genutzt**.
29+
30+
**UMA** — *Unified Memory Architecture*: CPU und GPU benutzen **denselben** Speichervorrat (die rund 16 GB GDDR6).
31+
32+
**GTT** — *Graphics Translation Table*: der Mechanismus, mit dem die GPU über den eigenen Grafikspeicher hinaus Systemspeicher nutzen kann. SkillFishOS erweitert ihn, sodass Vulkan rund 13 GiB sieht (nützlich für die KI).
33+
34+
## Takte, Spannungen, Wärme
35+
36+
**SMU** — *System Management Unit*: der Mikrocontroller in der APU, der Takte und Spannungen regelt. Auf der BC-250 läuft die Steuerung **nur** über ihn, nicht über die gewöhnlichen amdgpu-Dateien in sysfs.
37+
38+
**SMU-Governor** — der Dienst (`cyan-skillfish-governor`), der die *sicheren Punkte* aus Takt und Spannung für die GPU festlegt.
39+
40+
**sclk / mclk** — Takt des **Grafikkerns** (sclk) und des **Speichers** (mclk). Auf der BC-250 lässt sich der mclk **nicht** verstellen.
41+
42+
**Undervolting** — die Spannung bei gleichem Takt senken: dieselbe Arbeit, **weniger Wärme und weniger Verbrauch**. Siehe [GPU und Übertaktung](/de/docs/gpu-overclock).
43+
44+
**Übertaktung (OC)** — die Takte über die Werkseinstellung heben, um mehr Leistung zu bekommen.
45+
46+
**Vid** — die Spannung, die der Chip bei einem bestimmten Takt anfordert. Auf der BC-250 liegt die harte Grenze bei **1,325 V**.
47+
48+
**Temperaturschutz** — der Wächter des Systems, der die Takte senkt, sobald 85 °C überschritten werden.
49+
50+
**Wärmestau (heat-soak)** — die angesammelte Wärme, die unmittelbar hintereinander gefahrene Messungen verfälscht: lass die Platine zwischen den Durchläufen abkühlen.
51+
52+
**Silizium-Lotterie** — die Tatsache, dass jeder Chip eine andere Übertaktung und ein anderes Undervolting verträgt; deshalb prüft SkillFishOS die Profile **auf deiner** Platine.
53+
54+
## Systemsoftware
55+
56+
**Debian sid** — der Zweig *unstable* von Debian, immer aktuell, aber anfällig für Rückschritte: die Grundlage von SkillFishOS (siehe [Aktualisierungen](/de/docs/aggiornamenti)).
57+
58+
**KDE Plasma 6** — die verwendete Arbeitsumgebung, in Steampunk-Gestaltung gekleidet.
59+
60+
**linux-tkg** — das Baurezept für den Kernel (Frogging-Family), auf dem der maßgeschneiderte Kernel von SkillFishOS beruht.
61+
62+
**Mesa / RADV** — die quelloffenen Grafiktreiber; **RADV** ist der **Vulkan**-Treiber, den die GPU der BC-250 benutzt.
63+
64+
**ROCm** — der „offizielle“ Rechenunterbau von AMD: er unterstützt gfx1013 **nicht** und wird daher nicht verwendet.
65+
66+
**Vulkan** — die Schnittstelle für Grafik und Rechenarbeit, die auf der BC-250 sowohl zum Spielen als auch für die **KI** (Unsloth Studio) dient.
67+
68+
**Btrfs** — das Copy-on-Write-Dateisystem mit Schnappschüssen, das das „Sicherheitsnetz“ liefert (siehe [Speicher und Schnappschüsse](/de/docs/storage-snapshot)).
69+
70+
**Snapper** — das Werkzeug, das vor und nach Aktualisierungen automatisch Btrfs-Schnappschüsse anlegt.
71+
72+
**grub-btrfs** — lässt die Schnappschüsse im GRUB-Menü erscheinen, um schon beim Start zurückzukehren.
73+
74+
**APT-Pinning** — ein Paket auf einer geprüften Fassung festhalten, für die Bestandteile, die auf dieser Hardware heikel sind.
75+
76+
**reprepro** — das Werkzeug, mit dem die signierte APT-Paketquelle von SkillFishOS verwaltet wird.
77+
78+
**HPD** — *Hot-Plug Detect*: die Erkennung des angeschlossenen Bildschirms. Auf der BC-250 ist sie **defekt** → daher der Dienst `skillfish-dp-hotswap`.
79+
80+
**s2idle / Ruhezustand** — die Schlafzustände von ACPI: auf der BC-250 **kaputt** und deshalb abgeschaltet.
81+
82+
**IOMMU** — die Speicherverwaltungseinheit für die Virtualisierung von Ein- und Ausgabe: auf der BC-250 unruhig, wird **nie** eingeschaltet.
83+
84+
## Spiele und KI
85+
86+
**Proton** — die Kompatibilitätsschicht von Valve, die Windows-Spiele über Steam unter Linux laufen lässt.
87+
88+
**gamescope** — der Mikro-Compositor von Valve fürs Spielen („Konsolen“-Sitzung, Hochskalieren mit FSR1/NIS).
89+
90+
**EmuDeck / ES-DE** — der Einrichter für Emulatoren und die Oberfläche für die Emulation.
91+
92+
**FSR / OptiScaler** — Verfahren zum **Hochskalieren**. FSR 4 gibt es hier nicht (es verlangt RDNA 4); verwendet werden FSR1/NIS oder OptiScaler.
93+
94+
**Unsloth Studio** — Motor und Oberfläche der lokalen KI: führt GGUF-Modelle auf der GPU aus und bietet eine zu OpenAI kompatible Schnittstelle.
95+
96+
**qwen3:14b** — das Referenzmodell der KI, das vollständig auf der GPU läuft.
97+
98+
**Tuner** — die eigene Anwendung von SkillFishOS, um die Hardware mit Prüfen und Zurücknehmen einzustellen (siehe [Eigene Anwendungen](/de/docs/app-native)).
99+
100+
## Quellen
101+
102+
- [bc250.info](https://bc250.info) · [elektricm.github.io/amd-bc250-docs](https://elektricm.github.io/amd-bc250-docs)
103+
- [amdgpu-Dokumentation](https://docs.kernel.org/gpu/amdgpu/) · [Mesa / RADV](https://docs.mesa3d.org/drivers/radv.html)

‎website/src/content/docs/es/comandi-utili.md‎

Lines changed: 139 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,139 @@
1+
---
2+
title: Órdenes útiles
3+
description: Una chuleta de terminal para diagnosticar y ajustar SkillFishOS.
4+
group: Referencia
5+
order: 4
6+
---
7+
8+
SkillFishOS está pensado para **no** necesitar la terminal: para el uso normal bastan el [Tuner](/es/docs/app-native) y las aplicaciones gráficas. Esta página es para quien quiere **trastear** o diagnosticar. Las órdenes con privilegios usan `sudo`.
9+
10+
> Antes de experimentos arriesgados, recuerda la red de seguridad: instantáneas Btrfs y vuelta atrás desde el menú de GRUB (ver [Almacenamiento e instantáneas](/es/docs/storage-snapshot)).
11+
12+
## Sistema y núcleo
13+
14+
```bash
15+
uname -r # núcleo en marcha (debe acabar en -skillfishos)
16+
cat /proc/cmdline # parámetros de arranque activos
17+
journalctl -b -p err # errores del arranque actual
18+
inxi -Fxxxz # resumen completo del hardware
19+
```
20+
21+
## GPU, frecuencias y temperaturas
22+
23+
```bash
24+
# temperatura de la GPU desde el sysfs de amdgpu
25+
cat /sys/class/drm/card*/device/hwmon/hwmon*/temp1_input # °C ×1000
26+
# estado del gobernador SMU
27+
systemctl status cyan-skillfish-governor
28+
cat /etc/cyan-skillfish-governor/config.toml # puntos seguros de frecuencia y voltaje
29+
# vigilancia de la GPU en tiempo real
30+
nvtop # o: radeontop
31+
```
32+
33+
> En la BC-250 el control de la frecuencia **no** pasa por el sysfs estándar de amdgpu, sino por el **gobernador SMU**. Cambia los valores desde el [Tuner](/es/docs/app-native), no a mano.
34+
35+
## CPU — overclock y undervolt
36+
37+
```bash
38+
systemctl status bc250-smu-oc.service # que quede «inactive» tras aplicar es normal (es de una sola pasada)
39+
cat /etc/bc250-smu-oc.conf # frecuencia y voltaje aplicados
40+
lscpu | grep MHz # frecuencias actuales de los núcleos
41+
sensors # temperaturas y voltajes (nct6686, k10temp)
42+
```
43+
44+
## Unidades de cómputo en caliente (skillfish-cu)
45+
46+
```bash
47+
skillfish-cu get # estado en JSON: CU activas y máscara por fila (SE/SH)
48+
sudo skillfish-cu max # poner en marcha todas las CU (40)
49+
sudo skillfish-cu stock # volver a 24 (mínimo del controlador)
50+
sudo skillfish-cu set 0x1f # máscara WGP para todas las filas (0x07=24 … 0x1f=40)
51+
cat /run/skillfish/cu_active # «40/40» (también lo lee el HUD)
52+
vulkaninfo | grep -i "deviceName\|driverName" # la GPU tal como la ve Vulkan (RADV)
53+
```
54+
55+
Las CU se manejan mejor desde la **rejilla** del [Tuner](/es/docs/app-native) (clic y perfiles, con «Prueba de CU»). Las primeras 24 están fijadas por el controlador y siempre encendidas.
56+
57+
Mediciones rápidas (las mismas que usa el Tuner):
58+
59+
```bash
60+
vkpeak # rendimiento FP32 (GFLOPS)
61+
clpeak # ancho de banda de memoria (GB/s)
62+
sysbench cpu run # carga y medición de la CPU
63+
```
64+
65+
## Memoria unificada (VRAM y GTT)
66+
67+
```bash
68+
cat /proc/cmdline | tr ' ' '\n' | grep -E 'ttm\.' # parámetros de GTT/TTM
69+
glxinfo | grep -i "memory" # memoria vista por el controlador
70+
free -h # RAM/GDDR6 compartida
71+
```
72+
73+
## Juegos
74+
75+
```bash
76+
flatpak list # aplicaciones Flatpak (Steam, emuladores de EmuDeck…)
77+
flatpak update # actualizar las aplicaciones Flatpak
78+
gamescope -- %command% # (ponerlo en las opciones de lanzamiento de Steam)
79+
# mandos por Bluetooth
80+
bluetoothctl # scan on / pair / connect / trust
81+
```
82+
83+
## IA local
84+
85+
```bash
86+
# un solo servicio propio, sin contenedores: Docker no está instalado
87+
systemctl status skillfish-unsloth # estado del motor de IA
88+
sudo systemctl start skillfish-unsloth # arrancarlo
89+
sudo systemctl stop skillfish-unsloth # pararlo y liberar GPU y memoria
90+
curl -s localhost:8888/ # la interfaz de Unsloth Studio (solo loopback)
91+
```
92+
93+
## Instantáneas y vuelta atrás (Btrfs)
94+
95+
```bash
96+
sudo snapper list # listar instantáneas
97+
sudo snapper create -d "antes de X" # instantánea a mano
98+
sudo btrfs subvolume list / # subvolúmenes (@, @home, @log, @cache)
99+
100+
# volver a una instantánea de verdad (surte efecto en el siguiente arranque)
101+
sudo skillfish-rollback --list # qué instantáneas hay
102+
sudo skillfish-rollback 12 # hacer que la instantánea 12 sea el sistema
103+
sudo skillfish-rollback --undo # te has arrepentido: devolver el anterior
104+
sudo skillfish-rollback --clean # quitar los sistemas apartados por vueltas atrás previas
105+
106+
# desde el menú de GRUB → «SkillFishOS snapshots» obtienes la misma instantánea
107+
# EN SOLO LECTURA: sirve para mirar y rescatar archivos; luego ejecuta la orden de arriba
108+
```
109+
110+
## Actualizaciones y repositorio
111+
112+
```bash
113+
sudo apt update && sudo apt full-upgrade # actualizar el sistema
114+
apt-mark showhold # paquetes retenidos (incluido el núcleo)
115+
sudo apt install skillfishos-kernel # instalar o actualizar el núcleo desde el repositorio
116+
apt policy <paquete> # de qué repositorio y versión viene un paquete
117+
```
118+
119+
## Red y acceso remoto
120+
121+
```bash
122+
nmcli device status # estado de las interfaces de red
123+
ip a # direcciones IP
124+
systemctl status x11vnc # servidor VNC para el escritorio remoto
125+
hostname -I # IP para usar con el cliente VNC
126+
```
127+
128+
## Pantalla (HPD del DisplayPort)
129+
130+
```bash
131+
systemctl status skillfish-dp-hotswap # servicio que sortea el HPD averiado
132+
xrandr # salidas y resoluciones (sesión X11)
133+
```
134+
135+
## Fuentes
136+
137+
- [Wiki de Btrfs](https://btrfs.readthedocs.io/) · [Snapper](http://snapper.io/)
138+
- [Mesa / RADV](https://docs.mesa3d.org/drivers/radv.html) · [vulkaninfo](https://github.com/KhronosGroup/Vulkan-Tools)
139+
- [Arch Wiki](https://wiki.archlinux.org/) — referencia de muchas órdenes de Linux

0 commit comments

Comments
 (0)