25 Commits

Author SHA1 Message Date
Martin
e81b54a0e1 fix: correct VRAM thermal pad thickness across pages
All the GDDR6 sits on the underside of the board, opposite the APU, so
the "1.5mm on front of board" recommendation was wrong. There are no VRAM
chips on the APU side, that side takes paste on the die. prerequisites.md
also listed 1mm/1.5mm while cooling.md and performance.md said 2mm.

Standardise on 2mm for the underside memory pads, add a "verify the gap on
your board" caveat, drop the phantom front-side pads, and link
prerequisites to the cooling procedure so the value lives in one place.

Closes #34.
2026-07-01 18:21:15 +02:00
Martin
aa4ac3a335 docs: standardize sysfs paths on card0 for BC-250
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).
2026-05-31 16:09:58 +02:00
Martin
6ece5643a1 fix: replace oberon-governor with cyan-skillfish-governor-smu, add swap/zram guide
- Replace deprecated oberon-governor refs with cyan-skillfish-governor-smu across all docs
- Keep oberon only in migration/uninstall sections
- Add swap/zram optimization section for 8GB RAM constraint (zswap + lz4 + swapfile)
- Update GPU OC limits: 2230 MHz air / 2300 good air / 2400 liquid (NexGen3D tested)
- Update NexGen3D SteamMachine reference
- COPR repo: filippor/bazzite for all distros
- Config path: /etc/cyan-skillfish-governor-smu/config.toml
2026-03-22 00:26:40 +01:00
Martin
c99e298337 Revert "fix: replace deprecated oberon-governor refs with cyan-skillfish-governor-smu"
This reverts commit 2925c62316.
2026-03-21 23:34:00 +01:00
Martin
2925c62316 fix: replace deprecated oberon-governor refs with cyan-skillfish-governor-smu 2026-03-21 23:32:56 +01:00
Martin
3f4d9d7d85 fix: hardware-verified corrections from live BC-250 audit
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
2026-03-21 21:12:40 +01:00
Martin
a4b8abdffa fix: remove hallucinated claims from docs
- Remove fabricated '6.19.x PCIe issues' warning (no Discord evidence,
  host runs 6.19.7 without issues). Add 6.19.x as recommended kernel.
- Remove unsourced 'Fedora 44 Beta' and 'GNOME 50' references
- Remove unsourced zswap/AoE2:DE 'community reports' claim
- Remove unsourced P5.00 BIOS bricking from memory timings claim
  (keep sourced facts: P3.00 watchdog, tREF, bottom-binned Micron)
- Fix unverified '6.16.5 (Fedora 43)' to '6.16.x (Fedora 43)'

Verified against Discord exports: 5-10% 6.18 vs 6.17 (confirmed),
mitigations=off +18 FPS CP2077 (confirmed), 6.15.0-6.15.6 broken
(confirmed), 6.17.8-6.17.10 broken (confirmed), Balance > FSR 3.1.5
Quality (confirmed).
2026-03-21 21:12:40 +01:00
Martin
6ecde49315 fix: update version numbers to March 2026 reality
- Kernel: 6.18.18 LTS (recommended), 6.19.8 stable (PCIe issues),
  7.0-rc4 mainline added. Updated kernel compatibility table.
- Fedora: 42 marked as EOL everywhere, 43 is current, 44 Beta mentioned
- Mesa: 25.x in Fedora 43, 26.0 on Debian sid. Removed Fedora 42
  mesa-git COPR instructions.
- Updated kernel install examples to use 6.18.18 instead of 6.14/6.16
- Added 6.19.x PCIe warning across all relevant pages
2026-03-18 23:52:51 +01:00
Martin
45eaf62280 fix: third pass — purge stale oberon refs, add governor crash bug, remove AI filler
- 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
2026-03-18 23:52:51 +01:00
Martin
574cb182e4 fix: clean up quick-start and bazzite pages
- 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
2026-03-18 23:52:51 +01:00
Martin
180aa9e367 fix: remove AI slop from overclocking, tone down alarmism in cooling/power/vram
Second pass cleanup:
- overclocking: remove fabricated FPS numbers, restructure to lead with
  governor install, remove bloated cooling/PSU tables, add community refs
- vram: 512MB is not universally best — some games need 4-8GB static
- cooling: tone down VRAM backplate alarmism (recommended, not critical)
- power: 6-pin works fine for most setups, not just 8-pin
- quick-start: match toned-down backplate cooling language
2026-03-18 23:52:51 +01:00
Martin
e755dcb28b fix(intro): add VCN firmware blocked by Sony, Smokeless_UMAF warning
- Add explicit note that HW video encode/decode doesn't work (VCN firmware blocked by Sony)
- Add danger warning about Smokeless_UMAF causing permanent damage
2026-03-18 23:52:51 +01:00
Martin
f99e3b7322 wip: leftover changes from first pass 2026-03-18 23:52:51 +01:00
Martin
60dc106297 fix: add WiFi driver warning for performance mode rebase (closes #10)
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.
2026-03-18 23:52:51 +01:00
Martin
c992742e88 fix(quick-start): correct governor service name and add ACPI fix warning
- Fix service name: oberon-governor.service → cyan-skillfish-governor-tt.service
  (matches the package actually being installed)
- Promote SMU governor from "emerging" to recommended alternative
- Add essential ACPI fix warning
- Update verification commands to match installed governor
2026-03-18 23:52:51 +01:00
Martin
233bec6f9e fix: correct kernel version references from 6.17.8+ to 6.17.8-6.17.10 across all docs
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.
2026-03-18 23:52:51 +01:00
Martin
56ade65e7e docs: comprehensive update — kernel, cooling, pinouts, mesa, governors, distros 2026-03-11 13:01:51 +01:00
Martin
1c5547ee06 Fix documentation inconsistencies and errors
Corrections made:
- Fix CMOS clear time to 60 seconds (was inconsistently 30s in some places)
- Fix BIOS filename capitalization: Robin5.00 (capital R)
- Correct power button info: no header exists (soldering required)
- Fix VRAM allocation descriptions to emphasize 512MB is dynamic
- Standardize BIOS name to BC250_3.00_CHIPSETMENU
- Remove amdgpu.sg_display=0 from Fedora defaults (only needed for kernel <6.10)
- Fix GNOME description: now recommended for stability (was incorrectly saying issues)
- Fix Bazzite PSU requirement: 300W minimum (was incorrectly 90W)
- Fix SteamOS status: now works after Mesa updates
- Clarify DisplayPort audio: passive adapters usually work
2025-11-24 21:40:22 +01:00
Martin
ec6f65a7a2 Fix community-reported documentation errors
- Remove unverified 980 MHz instability claim (no source found)
- Correct M.2 slot specification: PCIe Gen 2 x2 (not Gen 3)
- Add critical warning: 350 MHz governor config requires kernel patch
- Document governor crash with std::__ios_failure on stock kernels
- Instruct users to use min: 1000 MHz without kernel patch

Based on Discord feedback from community members questioning
documentation accuracy.
2025-11-23 19:22:53 +01:00
Martin
42c36c0d88 Remove outdated fedora-setup.sh script and update repository links
- Replace deprecated fedora-setup.sh with modern manual installation steps
  * Mesa 25.1+ now included in Fedora 43 repos (no COPR needed)
  * Governor installation via @exotic-soc/oberon-governor COPR
  * Updated in quick-start.md and troubleshooting/display.md

- Fix idle power specifications in prerequisites.md
  * Corrected minimum idle power: 70-85W (was incorrectly 50-80W)
  * Added note about GPU freq patch increasing max power to 250W+

- Update footer GitHub link to elektricM/amd-bc250-docs
  * Changed from mothenjoyer69/bc250-documentation
  * Updated in mkdocs.yml and introduction.md

All changes verified with mkdocs build --strict (no warnings).
2025-11-22 16:54:24 +01:00
Martin
fb2cda86c7 Major documentation updates based on community feedback (Nov 2025)
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
2025-11-22 16:12:30 +01:00
Martin
6a396a70ed Apply community corrections from Discord feedback
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.
2025-11-22 00:47:46 +01:00
Martin
d64947030d Fix critical kernel version misinformation
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.
2025-11-22 00:40:47 +01:00
Martin
87edbbfa2b Fix strict build: remove non-existent pages from nav and fix broken links 2025-11-21 22:20:25 +01:00
Martin
b3bf9eb724 Initial commit: AMD BC250 Documentation
- MkDocs site with Material theme (teal/cyan, system theme matching)
- 20 comprehensive documentation pages
- Content from 9,716 Discord messages + GitHub sources
- GitHub Actions workflow for automated deployment
- Custom compact styling optimized for wide displays

Coverage:
- Getting Started (3 pages)
- Hardware (4 pages)
- BIOS & Firmware (4 pages)
- Linux Setup (4 pages)
- System Configuration (1 page)
- Gaming & Performance (1 page)
- Troubleshooting (1 page)
- Reference (1 page)
2025-11-21 21:59:00 +01:00