- Add new hardware pinouts page with detailed connector information
- Add J2000/J2001 power connector pinouts to power requirements
- Update VCN section to explain Sony is blocking firmware release
- Update kernel version info on index page (6.17.11+ now works)
Source: https://github.com/mothenjoyer69/bc250-documentation
Credits: mothenjoyer69, Segfault/TuxThePenguin0, neggles, yeyus
- 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).
Major corrections based on community member feedback:
USB Flashing Method:
- Replace incorrect Windows utility instructions with actual EFI Shell method
- Add detailed blk0: and Flash.nsh command sequence
- Correct file naming: Robin5.00 (no extension)
- Add proper download link to kenavru's GitHub for flashing tools
- Remove made-up Windows utility references
Hardware Programmer Safety:
- Add critical 5V warning for CH341A programmers (can fry 3.3V chips)
- Add SuperIO chip warning (SIO1_R vs BIOS_A1)
- Correct chip model: W25Q128JVSQ (not "25Q168" typo)
- Add J4004 header pinout with orientation guide
- Add Raspberry Pi Pico as 3.3V alternative
BIOS Version Clarifications:
- Remove incorrect claims about fan control differences
- Clarify stock BIOS versions are functionally identical
- Note fan control works on both stock and modded BIOS
- Emphasize P3.00 modded as community standard
Download Links:
- Add direct link to 4U12G BIOS Update.zip
- Link to TuxThePenguin0 GitLab for modded BIOS
- Document stock BIOS sources (P5.00 in ZIP, P3.00 from Segfault)
Flashing Process:
- Remove ambiguous "command line method"
- Document actual EFI Shell boot process (unplug drives)
- Add 15-minute wait warning for hung flashes
- Emphasize CMOS clear criticality
Credits to Segfault for hardware documentation.
- 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.
- 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.
- 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).
Applied final corrections based on rigorous verification of Discord feedback:
DISPLAY ADAPTERS (CRITICAL FIX):
- Fixed backwards recommendation: Passive adapters NOW recommended (not active)
- Passive: Reliable audio, $5-10, works for most users
- Active: Audio often broken, only for 4K @120Hz+
- Community: "Not sure why you wouldn't reccomend a passive adapter"
BIOS FLASHING (CRITICAL FIX):
- Removed fake "ZIP file" references (GitLab only has .ROM files)
- Added separate flashing utility download info (Discord forum thread)
- Community: "this only gives you the .rom file, there is no .zip"
- Clarified: ROM from GitLab, utility from Discord (two separate downloads)
COOLING GUIDE:
- Removed detailed Dremel/hacksaw fin cutting instructions
- Replaced with minimal warning about manual pull/tear method only
- Removed "screw fan into heatsink" references
- Community: "this cutting guide is not accurate, I wouldnt recommend any of those"
BIOS FLASHING:
- Removed AMIBCP/Smokeless section (not used by community)
- Community: "Lets not reccomend smokeless" / "AMIBCP is a bit of a meme"
GOVERNOR:
- Updated COPR instructions with correct repos
- Added warning about filippor oberon-governor core dumps
- Clarified: @exotic-soc for Oberon, filippor for cyan-skillfish
All issues from community review now addressed.
Build passes with --strict flag.
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 CONTRIBUTING.md with detailed contribution guide
- Add docs/contribute.md page in documentation site
- Update README.md to emphasize community collaboration
- Remove internal project files from repository (DEV.md, PROJECT_STATUS.md, etc.)
- Update .gitignore to exclude internal working files
- 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
