Commit Graph

16 Commits

Author SHA1 Message Date
Martin
86cffe0198 Add note about GPU card number in CachyOS verification step
Some systems enumerate the BC-250 as card1 instead of card0.
Added a note to check /sys/class/drm/ if card0 doesn't work.

Fixes GitHub issue feedback.
2026-01-24 23:15:57 +01:00
Martin
5087f0100a add cmos reset validation 2026-01-13 09:07:10 -05:00
Martin
293ee59f1a Update kernel compatibility and fix documentation links
- 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
2025-12-19 18:51:20 +01:00
Martin
8f766bf64d Add CPU mitigations disable instructions for all distros
- Added distro-specific commands for disabling mitigations:
  - GRUB-based (Fedora, Arch, Debian): edit GRUB config
  - Bazzite/Fedora Atomic: rpm-ostree kargs command
- Documented performance impact (+18 FPS in Cyberpunk 2077)
- Added security warning for dedicated gaming systems only
- Bazzite section now references kernel docs to avoid duplication
2025-11-30 23:30:07 +01:00
Martin
83c9348a9a Fix oberon-governor COPR and cleanup documentation
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).
2025-11-30 23:26:22 +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
b72b0c8748 Fix logo sizing and revert non-existent icons
- 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)
2025-11-22 19:43:25 +01:00
Martin
2a26465e5b Update distribution logos to consistent Simple Icons CDN
Replace varying logo sources with uniform Simple Icons CDN for all distros:
- Arch Linux: archlinux.org PNG → simpleicons.org SVG
- Fedora: fedoraproject.org PNG → simpleicons.org SVG
- Debian: debian.org PNG → simpleicons.org SVG
- CachyOS: GitHub raw PNG → simpleicons.org SVG
- Bazzite: GitHub tagline SVG → simpleicons.org SVG

All logos now have consistent monochrome styling and format.
2025-11-22 19:38:03 +01:00
Martin
3973ff52dd Add distribution logos to Linux setup guides
- 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.
2025-11-22 17:24:58 +01:00
Martin
59aab4010c Fix broken links in CachyOS guide
- Fixed broken anchor link to Arch Migration section
- Fixed reference to non-existent gpu-frequency-patch.md (now points to overclocking.md)
- Resolves mkdocs build --strict warnings
2025-11-22 16:15:53 +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
67eaf346a6 Critical safety corrections from community feedback
SAFETY-CRITICAL PSU FIXES:
- Removed Dell D220P-01/D250AD-00 recommendations (220W/250W too low, reported failures)
- Removed LED PSU recommendations (unreliable ripple current)
- Updated minimum power draw: 70W (not 50W, never observed that low)
- Updated minimum PSU requirement: 300W on 12V rail (was 250W)
- Updated cable gauge: 16 AWG minimum (18 AWG has caused melted cables)

Hardware corrections:
- Removed power button header references (board has NO header, solder only)
- Fixed Arctic P12 Pro/Max static pressure: 6.9 mm H2O (was incorrect)
- Added separate specs for P12 Max vs Pro

Documentation cleanup:
- Removed energy cost calculations (as requested)
- Removed multi-board setup sections
- Updated Arch install: direct to Arch Wiki, removed archinstall recommendations

Thanks to DeathStalker and Astrocast for critical safety feedback.
2025-11-22 00:57:52 +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
8c4de755d7 Add comprehensive distribution setup guides
- 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
2025-11-21 22:57:24 +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