Add a Community Setup Toolkits section to the distribution guide and a
short pointer from the Bazzite and CachyOS pages. The community has
converged on one-command and menu-driven setup projects (NexGen
SteamMachine, bc250-buddy, NeOdYmS toolkit on Bazzite, redbeard toolkit
on CachyOS, the two arch scripts) and the docs didn't surface them in
one place.
These are third-party and move fast, so the section says to read them
before running and keeps the per-distro guides as the reference for what
each step does.
The BC-250 enumerates as /sys/class/drm/card0 on a typical install (no
secondary GPU). Verified live on Fedora 43, kernel 7.0.9, PCI 1002:13fe.
Many doc snippets hardcoded card1, so copy-paste failed on a stock single-
GPU board.
Replaced /sys/class/drm/card1/ with /sys/class/drm/card0/ across:
bios/overclocking.md, bios/vram.md, drivers/radv.md,
getting-started/quick-start.md, linux/{arch,bazzite,cachyos,debian,fedora}.md,
reference/quick-reference.md, system/{governor,sensors}.md,
troubleshooting/{boot,display,performance,stability}.md.
Existing card0-vs-card1 disclaimers preserved at governor.md L166/L503,
quick-start.md L78, bazzite.md L104, kernel.md L222 (and quick-reference.md
intro rewritten to lead with card0 + note the iGPU edge case).
In my testing while using Bazzite, I always had consistent micro-stutters (every couple of seconds) while playing the least demanding of 2D games.
Disabling the governor had no impact, stuttering continued. Later in my testing, I identified Bazzite's Handheld Daemon as the root cause of this stuttering. The journalctl revealed that the process kept failing and restarting. Disabling it fixed the micro-stuttering completely. This proposed solution informs users to disable this software to fix the micro-stutters.
Key fixes:
- nct6687 for fan control (not nct6683 which is read-only)
- GPU is card1 not card0 in all sysfs paths
- Fan on pwm2/fan2 (Pump Fan header), not pwm1
- Vulkan 1.4.328 (not 1.3), Mesa 25.3.6 (not 25.2.4)
- cpupower doesn't work on BC-250 (removed recommendations)
- pp_dmu_clock -> pp_dpm_mclk
- ACPI fix marked as optional/experimental (not essential)
- amdgpu.sg_display=0 only needed for kernels < 6.10
- GPU voltage range 700-1129 mV (from OD_RANGE)
- Added CoolerControl installation instructions
- Expanded sensors.md with proper nct6687 setup guide
- Replace oberon-governor with cyan-skillfish-governor-tt as default across
bazzite, debian, arch, cachyos, fedora, power, quick-reference, display,
performance, radv, and stability pages (oberon remains documented as legacy)
- Add "Black Screen on GPU Reset (Governor Running)" section to
troubleshooting/stability.md (source: Discord user nohanmv, Feb 26)
- Remove AI filler: "comprehensive" from index/sensors, unverifiable stats
(3500+ members, 100+ solutions, 30+ games, 9716/7000+ messages analyzed,
90%/95% success rates)
- Remove unverifiable 8K @60Hz display claim
- Update governor config examples from oberon YAML format to
cyan-skillfish-governor-tt TOML format
- Normalize community links to point to filippor/cyan-skillfish-governor
- Remove old oberon-setup.sh script from quick-start (conflicts with
cyan-skillfish-governor-tt install instructions above it)
- Remove unverifiable performance target numbers from quick-start
- Update troubleshooting to reference cyan-skillfish-governor-tt
- Tone down backplate VRAM cooling from DANGER/required to info/recommended
(community: "ram cooling nonsense" — akxfile, Dec 2025)
- Remove oberon automated setup as primary install method on bazzite page
- arch.md, debian.md: correct sensor module from nct6687 to nct6683 with
force=true (consistent with other guides)
- bazzite.md: clarify that standard Bazzite kernel already includes GPU
frequency patch as of early 2026, custom images only needed for extra
optimizations
- cooling.md: correct to nct6683 with force=true for sensor readings
- bazzite.md: document both nct6687 (PWM control) and nct6683 (read-only
sensors) as valid options depending on use case
- Add warning that performance mode rebase can kill WiFi drivers (issue #10)
- Update SMU governor from "emerging" to established alternative
- Add nct6683 alternative for sensor module (per mothenjoyer69's docs)
- Note both nct6687 (PWM control) and nct6683 (read-only) options
- cyan-skillfish-governor → cyan-skillfish-governor-tt (service names and
config paths throughout overclocking, power, and troubleshooting docs)
- Update TTM page pool parameters to 3959290 for correct 14.75GB VRAM
- Add SMU governor variant to AUR install instructions
- Clarify 700mV minimum voltage behavior (locks GPU to 1500MHz)
- Update SMU governor description from "emerging" to established
Rebasing to patched Bazzite images can remove USB WiFi drivers since the
BC-250 has no built-in wireless. Added prominent warnings to bazzite.md
performance section and prerequisites.md with recovery steps.
- Reduce logo size from height=60 to width=48 (more appropriate)
- Revert CachyOS to working GitHub logo (simpleicons doesn't have it)
- Revert Bazzite to working GitHub logo (simpleicons doesn't have it)
- Keep Arch, Fedora, Debian on simpleicons (verified working)
- Fedora: Official Fedora Workstation logo
- Bazzite: Official Bazzite tagline logo from GitHub
- CachyOS: Official CachyOS logo from GitHub
- Arch Linux: Official Arch Linux logo
- Debian: Official Debian open use logo
All logos linked externally (no downloads), properly licensed for documentation use.
Adds visual polish and helps users quickly identify distributions.
Applied comprehensive corrections from Discord community (DeathStalker, Astrocast,
and others) to fix inaccuracies, remove outdated procedures, and improve readability.
CRITICAL SAFETY FIXES:
- IOMMU: Changed from "optional" to "MUST disable" across all docs
- Removed dangerous `amd_iommu=on` kernel parameter (causes crashes)
- Added danger warnings that IOMMU is broken on BC-250
BIOS & VRAM FIXES:
- Fixed BIOS flashing guide: removed fake "ZIP file" references
- Added link to actual flasher utility (separate from ROM download)
- Removed made-up Windows utility steps, added real ASRock method
- Removed AMIBCP/Smokeless section (not used, P5.00_clv has all unlocked)
- VRAM docs: reduced verbosity by 40%, emphasized 512MB is DYNAMIC
- Added ZRAM conflict warning (crashes in RDR2 with dynamic VRAM)
COOLING & HARDWARE:
- Removed impractical fin cutting/screwing instructions
- Removed J4003 header references (not for normal users)
- Added tower cooler downside (must cool VRAMs separately)
- Static pressure already correct at 6.9 mm H2O
LINUX DISTRIBUTION UPDATES:
- Fedora: Removed outdated setup script, Mesa 25.1 now in repos
- Fedora: nomodeset no longer needed on 42/43 with working kernels
- Bazzite: Removed "on steroids" section (patch included by default)
- CachyOS: Simplified from custom ISO to standard installation
- Updated KDE vs GNOME: GNOME recommended for stability (6 changes)
- SteamOS/Ubuntu: Already added in previous commit (verified)
GOVERNOR & DRIVERS:
- Prioritized COPR installation over building from source
- Added @exotic-soc/oberon-governor and filippor/bazzite repos
- Display adapters: Now recommend PASSIVE (audio works) over active
IMPOSSIBLE FEATURES REMOVED:
- Fortnite: Clarified it cannot run (Easy Anti-Cheat)
- ROCm training: Corrected to "experimental/limited" (doesn't work)
Desktop Environment: GNOME now recommended over KDE for stability
(KDE had Qt RDSEED bug, now fixed but GNOME more tested)
Files modified: 14
Community credits: DeathStalker, Astrocast, legodude
- Add Bazzite setup guide with standard and performance configurations
- Add CachyOS installation guide with custom ISO build methods
- Add Arch Linux and Manjaro setup with community scripts
- Add Debian and PikaOS setup guide
- Update navigation to include all distribution guides
- All content extracted from bc250-resources forum threads
- Cross-referenced with parsed Discord content for accuracy
