Skip to content

README.de.md

Latest commit

 

History

History
217 lines (154 loc) · 12 KB

README.de.md

File metadata and controls

217 lines (154 loc) · 12 KB
Raw

BC250 Toolkit — DeckyLoader Plugin

Neu in v0.6.3: Benachrichtigungen zur automatischen Spielkonfiguration öffnen beim Auswählen die Steam-Bibliotheksseite des Spiels; bei Updatefehlern öffnen sie Details und den Release-Link.

🌐 EN · FR · DE · ES · IT · PT · NL · PL · RU

Ein DeckyLoader-Plugin für den ASRock BC-250 (AMD Ryzen Embedded V2000 / Cyan Skillfish) unter Bazzite, SteamOS Linux oder CachyOS.

Community-Datenbank mit optimierten Startoptionen für den BC-250 — direkt aus dem Steam Quick Access Menu anwendbar.

📸 Screenshots

Games tab CU/UMA tab

UMA frame buffer System tab

Funktionen

Spiele-Tab

  • Erkennt automatisch das ausgewählte Spiel in der Steam-Bibliothek
  • Zeigt empfohlene Einstellungen für den BC-250 (Proton-Version, Startoptionen, Hinweise, Hardware-Voraussetzungen)
  • Konfigurationsvarianten — wenn ein Spiel mehrere optimierte Profile bietet (z. B. Stable vs Performance), wählt man eines über einen Selektor; die Auswahl wird gespeichert
  • Übernehmen-Schaltfläche — schreibt in einer Aktion die Startoptionen, wählt den Proton/GE-Proton-Build und wendet etwaige spielbezogene GPU-Overrides an (RADV-Optionen in ~/.drirc)
  • Auto-Apply (opt-in) — wendet die vollständige Konfiguration automatisch an, wenn ein bekanntes Spiel gestartet wird; beim Aktivieren werden zudem alle installierten Spiele aus der Datenbank vorkonfiguriert

CU/UMA-Tab (Compute Units & VRAM)

  • Live-Anzeige der aktiven CU-Anzahl über GPU-SPI-Register
  • 4 Profile:
    • 24 CU (BC-250 Standard)
    • 32 CU
    • 36 CU
    • 40 CU (voll — alle WGPs aktiv)
  • Live-Anwendung ohne Neustart
  • Beim Start speichern-Schalter — installiert einen systemd-Dienst, der das Profil bei jedem Start wiederherstellt
  • Benötigt umr — automatische Installation per Schaltfläche (rpm-ostree unter Bazzite/SteamOS, pacman unter CachyOS/Arch)
  • Integrierter Hinweis und Stabilitätsempfehlungen
  • VRAM-Verwaltung (UMA) — stellt die UMA Frame Buffer Size des BIOS (Auto / 2G / 4G / 8G) direkt aus dem Panel ein, indem die EFI-NVRAM-Variable (AmdSetup) gepatcht wird — kein Umweg mehr über den BIOS-Bildschirm. Wirkt beim nächsten Neustart; das Panel zeigt die aktuelle VRAM und den im BIOS vorgemerkten Wert
    • Schutzmechanismen: BIOS-Versions-Whitelist (P3.00), NVRAM-Layout-Prüfung, automatisches Backup vor jedem Schreiben (Buttons bei unbekanntem BIOS deaktiviert)
    • Das Schreiben ins BIOS erfordert ein aktuelles bc250-tweaks (liefert den Root-Helper bc250-uma-helper — keine sudo-Passwortabfrage)
    • Auto (≈8 GB) ist der empfohlene sichere Wert — bei Grafikartefakten (z. B. grünen Störungen) nach einer Änderung zurück auf Auto stellen

Tuning-Tab (mit BC250 Control Center)

Ist BC250 Control Center installiert (RPM per rpm-ostree install auf Bazzite, danach einmal Prepare dependencies in der App), wird dieser Tab seine Oberfläche im Spielmodus:

  • GPU — Governor-Profile und geprüfte Stufen
  • Compute Units — Live-Raster 4×5, gespeicherte Starttabelle und Startdienst
  • CPU — Übertaktung über den Detektor des Control Centers, manuelle Skala und Startdienst
  • Lüfter — manuelle Drehzahl pro Kanal oder zurück auf automatisch

Der Toolkit speichert hier nichts selbst: Er steuert denselben geschützten Helper wie das Control Center, Änderungen am Desktop erscheinen also im Spielmodus und umgekehrt. Auch der CU-Tab läuft darüber. Ohne Control Center funktioniert der Rest des Plugins wie bisher; unter Bazzite bietet der Tab eine Schaltfläche BC250 Control Center installieren (offizielles RPM v1.19.0, SHA-256 geprüft, rpm-ostree install, dann Neustart), sonst verlinkt er die Projektseite. Die Schaltfläche verschwindet, sobald das Control Center erkannt wird.

System-Tab

  • CPU/GPU-Temperaturen in Echtzeit, Lüfterdrehzahl und GPU/CPU-Takt
  • Ressourcen — aktivierter System-RAM (was dem OS nach dem UMA-Carve-out bleibt), belegter RAM mit Prozentanzeige und Anzahl aktiver CUs
  • scx_lavd-Status, Tuned-Profil, Gamemode-Daemon-Status
  • Hardware-Integrationen — schreibgeschützt: WLAN-Adapter mit NetworkManager-Status und Treiber, ob hid_playstation geladen ist und wie viele Controller verbunden sind, aktive Bildschirmanschlüsse, die aktuelle PipeWire-Ausgabe und der HDMI-CEC-Bus, sofern vorhanden. Es wird nichts aktiviert oder geändert: Die Anzeige hält nur fest, was wirklich vorhanden ist, damit keine TV- oder Controller-Funktion angeboten wird, die die Hardware nicht kann.
  • Manuelle Aktualisierungsschaltfläche für bc250-tweaks

Einstellungen-Tab

  • Auto-Apply-Schalter
  • DB-Aktualisierung von GitHub
  • Über — Plugin-Version, Autor und GitHub-Link

Sprache

Das Plugin erkennt automatisch die Steam-Sprache:

English · Français · Deutsch · Español · Italiano · Português · Nederlands · Polski · Русский

Installation

Über DeckyLoader (empfohlen)

  1. Entwicklermodus in Deckys allgemeinen Einstellungen aktivieren
  2. Decky-Einstellungen → Entwickler → Plugin von URL installieren: https://github.com/Necrosiak/bc250-toolkit-decky/releases/latest/download/BC250-Toolkit.zip

Direkter Vertrieb über GitHub: die URL oben zeigt immer auf das neueste Release, danach hält sich das Plugin per eingebautem Auto-Update selbst aktuell.

Manuelle Installation in der Zwischenzeit:

git clone https://github.com/Necrosiak/bc250-toolkit-decky.git \
  ~/homebrew/plugins/BC250-Toolkit
sudo systemctl restart plugin_loader

Voraussetzungen

  • DeckyLoader installiert
  • Bazzite, SteamOS oder CachyOS auf BC-250

Spieldatenbank

Die DB befindet sich in games_db.json und aktualisiert sich automatisch von GitHub.

Unterstützte Spiele

Spiel Proton Hinweise
Crimson Desert Proton Experimental (bleeding-edge) GPU-Spoof 731F erforderlich
Cyberpunk 2077 GE-Proton RT deaktiviert empfohlen
Elden Ring GE-Proton ~60 FPS spielbar
Red Dead Redemption 2 GE-Proton Vulkan-Modus erforderlich
Control GE-Proton RT funktioniert (RDNA 1.5)
Counter-Strike 2 Proton Experimental 100+ FPS
Rocket League Proton Experimental 120+ FPS
Devil May Cry 5 GE-Proton ~100 FPS Hoch
Company of Heroes 3 GE-Proton VRAM-Split mind. 4 GB erforderlich
Detroit: Become Human Proton Experimental Stabile 60 FPS
The Last of Us Part I GE-Proton 60 FPS Medium-Hoch
Black Myth: Wukong GE-Proton Unveränderte Spieldateien erforderlich
Code Vein 2 GE-Proton UE5 DX12 — benötigt UMA Frame Buffer = Auto (~8G) + spielbezogenen Unified-Heap-Fix (automatisch, siehe Preset unten)
Stardew Valley Proton Experimental Perfekt

Bekannte inkompatible Spiele

  • Fortnite / Valorant — Kernel-EAC, Linux inkompatibel
  • FF VII Rebirth — Prüft GPU-ID, Cyan Skillfish nicht erkannt, kein Fix verfügbar

Beitragen

🐛 Bugs & Ideen: eröffnet Issues! Jede Meldung bestimmt direkt die nächste Release mit. Ein paar Zeilen genügen — idealerweise mit eurem OS (Bazzite, CachyOS…), der Plugin-Version, dem betroffenen QAM-Tab und wenn möglich den Logs (~/homebrew/logs/BC250-Toolkit/, journalctl -u plugin_loader). Feature-Wünsche und „läuft auf X“-Meldungen sind genauso willkommen.

Einfache Methode — Webformular

Nutze das Einreichungsformular — fülle die Angaben aus, klicke auf Einreichen, und ein GitHub-Issue wird automatisch erstellt. Nach Genehmigung wird das Spiel per PR hinzugefügt.

Entwickler-Methode — Direkter PR

  1. Forke dieses Repository
  2. Bearbeite games_db.json entsprechend dem vorhandenen Format
  3. Öffne einen Pull Request

Eintragsformat

"STEAM_APP_ID": {
  "name": "Spielname",
  "proton": "GE-Proton10-34",
  "launch_options": "MANGOHUD=1 MANGOHUD_CONFIG=no_display gamemoderun %command%",
  "notes": "BC-250-spezifische Hinweise",
  "tested_on": "BC-250"
}

Optionale erweiterte Felder (das Plugin wendet sie beim Klick auf Übernehmen automatisch an):

  • compat_tool — Proton/GE-Proton-Build, der über das Steam-Kompatibilitäts-Mapping ausgewählt wird
  • radv — spielbezogene Mesa-RADV-Overrides, die in ~/.drirc geschrieben werden, Match über den Namen der ausführbaren Datei, z. B. {"match": "Game-Win64-Shipping.exe", "options": {"radv_enable_unified_heap_on_apu": false}}
  • requires — Hardware-Voraussetzungen, die dem Benutzer angezeigt werden (uma_min_mb, gttsize)
  • configs — Array alternativer Varianten, jede mit eigenem label, stability, compat_tool, launch_options, radv, requires; der Benutzer wählt eine im Spiele-Tab

Die Steam-AppID befindet sich in der URL der Spielseite im Steam Store.

Wiederverwendbares Preset — UE5 DX12 „out of video memory"

Manche Unreal-Engine-5-Spiele in DX12 stürzen bei der Render-Initialisierung ab (D3D12Util.cpp:926 — Out of video memory), obwohl reichlich VRAM frei ist, weil der Unified Heap von RADV auf APU den dedizierten VRAM vor VKD3D verbirgt (DedicatedVideoMemory ≈ 0). games_db.json enthält ein wiederverwendbares ue5_dx12_oom-Profil unter _meta.presets: Unified Heap für die ausführbare Datei deaktivieren + BIOS-UMA Frame Buffer auf Auto setzen (liefert auf einem 16-GB-BC-250 bereits ~8 GB — 4G muss nicht erzwungen werden) + GE-Proton für die Video-Codecs. Um ein neues betroffenes Spiel zu fixen, das Preset in dessen Eintrag kopieren und radv.match auf dessen ausführbare Datei setzen. Zuerst auf Code Vein 2 validiert.

Build (Entwickler)

pnpm install
pnpm run build

# Lokal bereitstellen
sudo cp dist/index.js ~/homebrew/plugins/BC250-Toolkit/dist/
sudo cp main.py updater.py bios_uma.py games_db.json package.json ~/homebrew/plugins/BC250-Toolkit/
sudo systemctl restart plugin_loader

Siehe auch

Community-Mitwirkende

  • @AyeZeeBB — CachyOS/Arch-Unterstützung für die umr-Installation + GPU-Instanz-Fallback (aus seinem Fork übernommen)

🐧 Kompatibilität

Wir arbeiten aktiv daran, dass dieses Plugin auf jedem für den BC-250 dokumentierten Betriebssystem (Community-Doku) läuft — Bazzite, SteamOS, CachyOS/Arch, Fedora… — mit automatischer OS-Erkennung (Paketmanager, GPU-Instanz), damit auf deiner Distribution die richtige Methode verwendet wird.

KI-Hinweis

Bei der Entwicklung dieses Projekts wurde KI (Claude von Anthropic und Codex von OpenAI) eingesetzt — für Reverse Engineering, Entwicklung und Dokumentation. Nicht für Grafik oder kreatives Schreiben. Alles Veröffentlichte wird von einem Menschen geprüft, und ich stehe für das Ergebnis gerade. Wer damit nicht einverstanden ist, weiß nun Bescheid.

Entwicklung unterstützen

Wenn dir dieses Projekt hilft, kannst du seine weitere Entwicklung auf Ko-fi unterstützen.

Unterstütze mich auf Ko-fi