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.
New container-focused setup guide for Fedora CoreOS on the BC-250.
Covers ignition prerequisites, ACPI fix via dracut, Cyan Skillfish
governor via COPR, hardware monitor (nct6683), 40 CU unlock via UMR
systemd service, 14.75GB VRAM allocation with initramfs sync, and
Spectre mitigations toggle. Notes Zincati auto-upgrade persistence
and Podman GPU passthrough. Adds nav entry under Linux Setup.
Closes#25.
New Alpine guide covering kernel selection, AMDGPU/Vulkan stack,
extlinux/GRUB kargs, and a manual SMU governor build with an
OpenRC service + D-Bus policy. Adds nav entry, README/index
mentions, and an Alpine row in the distribution comparison.
Note: the "D-Bus AccessDenied Error" troubleshooting entry is
missing its solution paragraph will follow up in a small fix
commit after merge.
Closes#20.
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).
The active upstream of cyan-skillfish-governor is filippor/cyan-skillfish-governor
(v0.4.6, May 2026, 27 stars), not Magnap/cyan-skillfish-governor (v0.1.3,
Aug 2025, 12 stars). Several install paths in the docs were pointing readers
at Magnap releases and telling them to wget a .deb that no longer exists in
the upstream release pipeline.
- system/governor.md: TT section repo link, SMU feature list (drop .deb/Nix
claims, mention tarball + COPR + AUR), Option 2 rewritten as tarball
install with scripts/install.sh, Option 3 build-from-source link updated.
- linux/cachyos.md: build-from-source link updated.
- linux/debian.md: Option 1 rewritten as tarball install.
- troubleshooting/performance.md: Debian quick-install line rewritten.
Magnap is preserved as historical credit in two developer-attribution lines
(SMU was originally Magnap, filippor maintains the active fork).
- flashing: soften "essential" wording, point at fanoush/bc250_memcfg for VRAM-only use case (#21)
- vram: add "From Linux" section documenting bc250_memcfg as an alternative to BIOS flashing (#21)
- debian: drop unsourced prebuilt-image claim (#22)
- kernel: document the 40 CU unlock patch (CachyOS PR #159) as experimental (#23)
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
- display.md: DisplayLink unreliable (latency, no game mode), DP MST max 2 screens
- cooling.md: 3 heatsink variants (QR code = 9-row), thermal pads 1.5mm front/2.0mm back
- distributions.md: Ubuntu 26.04 daily server ISO works out of box
- radv.md: LLM headless mode tip (~14.2GB available VRAM, headless saves ~800MB)
- stability.md: P5.00 BIOS more susceptible to bricking from memory timing;
tREF most rewarding timing, GDDR6 ICs are bottom-binned Micron
- 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
- Replace oberon-governor with cyan-skillfish-governor-smu as recommended
option (no kernel patch needed on CachyOS)
- Add TT governor as alternative requiring kernel patch
- Mark oberon-governor build-from-source as legacy option
- Fix sensor module from nct6687 to nct6683 with force=true
- 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
- Fix ttm.pages_limit and ttm.page_pool_size: 3776000 → 3959290
(per mothenjoyer69's docs for >8GB shared memory)
- Add note that Bazzite already includes the frequency range patch
- Add note that SMU governor bypasses kernel patching entirely
- Clarify manual patching only needed for TT governor on non-Bazzite distros
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.
The broken kernel range is 6.17.8-6.17.10, not 6.17.8+ — kernel 6.17.11+
has the fix applied. Updated 11 files to use the precise range and added
6.17.11+/6.18.x as recommended alternatives. Also added a warning about
6.19.x PCIe issues reported in March 2026.
Update README to mention community cases catalogue (145 designs) and
clarify governor naming (cyan-skillfish-governor-tt as default,
oberon-governor as alternative).
Current stable is 6.19.6, 6.18.x LTS confirmed working.
Reorganize recommended kernels to reflect current state.
- 6.18.x and 6.19.x are now the recommended range
- Keep 6.17.11+ and 6.15.7-6.17.7 as also working
- Add confirmed working versions for 6.18.3 and 6.19.6
- Mark kernel 6.17.11+ as working (kernel fix applied)
- Update broken kernel range to 6.17.8-6.17.10 (was 6.17.8+)
- Update BIOS flashing guide Next Steps link to recovery.md
Governor fixes:
- filippor/bazzite oberon-governor crashes on kernel 6.17+ with
std::__ios_failure error when writing to pp_od_clk_voltage
- Updated to recommend @exotic-soc/oberon-governor which works correctly
- Added detailed troubleshooting section for iostream crash error
- Added fix instructions: remove broken package, install working one
- Note about GPU card number (card0 vs card1) in sysfs paths
Documentation cleanup:
- Removed non-existent #bios-help channel reference
- Removed r/BC250 subreddit reference (doesn't exist)
- Removed claim about pre-programmed BIOS chips being available
Tested on Fedora 43 with kernel 6.17.1 - governor now runs properly
and GPU scales from 1000MHz (idle) to 2000MHz (load).
- 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
Fixed multiple issues identified by DeathStalker and Astrocast:
Hardware corrections:
- FSP500 model: FSP500-30AS (not FSP500-50FGBBI)
- Board length: 340mm/310mm (not ~200mm)
- Added Arctic P12 Pro to cooling (more available than Max)
- Power draw: Can exceed 235W with GPU frequency patch
GPU comparisons:
- Standardized to GTX 1660 Ti (removed inconsistent 3060 Ti refs)
VRAM allocation:
- Clarified 512MB setting is DYNAMIC (not a limit)
- Can allocate nearly full 16GB to GPU (~14GB+)
Software updates:
- Fedora 42/43: nomodeset no longer needed with working kernels
- COPR repos available for governors (Fedora/Bazzite)
- Added SteamOS to distro list (Mesa now updated)
- Added Ubuntu to supported distros
Thanks to DeathStalker and Astrocast for detailed feedback.
Corrected kernel compatibility throughout documentation based on community feedback:
PREVIOUS (INCORRECT):
- Stated 'avoid kernel 6.15+' entirely
- Recommended only 6.12-6.14 LTS
CORRECTED:
- 6.15.0-6.15.6: Broken (GPU init fails)
- 6.15.7-6.17.7: Works (recommended, kernel support fixed)
- 6.17.8+: Broken again (GPU driver issues)
- 6.12-6.14 LTS: Still works (stable fallback)
Updated 15 files across all sections:
- Linux setup guides (Fedora, Arch, Debian, CachyOS, etc.)
- Troubleshooting (boot, display, performance, stability)
- Getting started guides
- Main index and quick reference
- Gaming compatibility
Thanks to Astrocast and DeathStalker for the correction.
- 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
