From 6ecde4931556e2a19ec53f2f4bea3ab30dbe2ebf Mon Sep 17 00:00:00 2001 From: Martin Date: Wed, 18 Mar 2026 23:46:15 +0100 Subject: [PATCH] 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 --- docs/drivers/radv.md | 13 +++-------- docs/gaming/compatibility.md | 2 +- docs/getting-started/prerequisites.md | 2 +- docs/getting-started/quick-start.md | 10 ++++---- docs/index.md | 4 ++-- docs/linux/arch.md | 12 +++++----- docs/linux/cachyos.md | 14 +++++++----- docs/linux/debian.md | 8 +++---- docs/linux/distributions.md | 23 +++++++++++-------- docs/linux/fedora.md | 18 +++++++++------ docs/linux/kernel.md | 33 ++++++++++++++++----------- docs/linux/mesa.md | 17 ++++---------- docs/reference/quick-reference.md | 12 +++++----- docs/troubleshooting/boot.md | 18 +++++++-------- docs/troubleshooting/display.md | 17 +++++++------- docs/troubleshooting/performance.md | 18 ++++++--------- docs/troubleshooting/stability.md | 16 ++++++------- 17 files changed, 115 insertions(+), 122 deletions(-) diff --git a/docs/drivers/radv.md b/docs/drivers/radv.md index e63e8d9..9c8c970 100644 --- a/docs/drivers/radv.md +++ b/docs/drivers/radv.md @@ -62,7 +62,7 @@ Mesa 25.1 includes critical fixes for BC-250: ## Installation by Distribution -### Fedora 42/43 +### Fedora 43 Mesa 25.1 is now in mainline Fedora repositories (as of Fedora 43): @@ -75,15 +75,8 @@ glxinfo | grep "OpenGL version" # Should show: Mesa 25.1.X or newer ``` -**Fedora 42** may need a manual update if on an older installation: - -```bash -# Check current version -dnf list installed | grep mesa - -# If < 25.1, update system -sudo dnf upgrade --refresh -``` +!!!warning "Fedora 42 is End of Life" + Fedora 42 reached EOL. Upgrade to Fedora 43 for current Mesa packages. ### Bazzite diff --git a/docs/gaming/compatibility.md b/docs/gaming/compatibility.md index 1691cce..7523183 100644 --- a/docs/gaming/compatibility.md +++ b/docs/gaming/compatibility.md @@ -380,7 +380,7 @@ Check anti-cheat compatibility: [areweanticheatyet.com](https://areweanticheatye 5. **Monitor Temps:** Keep GPU < 85°C for stability 6. **Adequate VRAM:** Use 4GB split for AAA games 7. **Disable Mitigations:** `mitigations=off` for +10-15% FPS -8. **Optimize Kernel:** Use 6.17.11+, 6.18.x, 6.15.7-6.17.7, or 6.12-6.14 LTS, avoid 6.15.0-6.15.6 and 6.17.8-6.17.10 +8. **Optimize Kernel:** Use 6.18.18 LTS (recommended) or 6.17.11+, avoid 6.15.0-6.15.6, 6.17.8-6.17.10, and 6.19.x ## See Also diff --git a/docs/getting-started/prerequisites.md b/docs/getting-started/prerequisites.md index de71823..0f17328 100644 --- a/docs/getting-started/prerequisites.md +++ b/docs/getting-started/prerequisites.md @@ -99,7 +99,7 @@ The BC-250 requires Linux for GPU support. Windows has NO drivers. **Recommended (easiest setup):** -- **Fedora 42 or 43 Workstation** - Most tested, good documentation +- **Fedora 43 Workstation** - Most tested, good documentation (Fedora 42 is EOL) - **Bazzite** - Gaming-focused, works out-of-box **Also work well:** diff --git a/docs/getting-started/quick-start.md b/docs/getting-started/quick-start.md index 70ccea8..fc9092b 100644 --- a/docs/getting-started/quick-start.md +++ b/docs/getting-started/quick-start.md @@ -40,11 +40,11 @@ Boot into BIOS (Del key during startup) and configure: ### Step 3: Install Linux !!!tip "Recommended: Fedora or Bazzite" - Fedora 42/43 and Bazzite have the best out-of-box support. Other distros work but need more manual setup. + Fedora 43 and Bazzite have the best out-of-box support. Other distros work but need more manual setup. **Fedora Installation:** -1. Download Fedora 42 or 43 Workstation +1. Download Fedora 43 Workstation (or Fedora 44 Beta) 2. Boot installer in "Basic Graphics Mode" (enables nomodeset automatically) 3. Complete installation normally 4. Reboot @@ -58,8 +58,8 @@ Boot into BIOS (Del key during startup) and configure: Run the automated setup script: ```bash -# For Fedora 42/43 -# Mesa 25.1+ is included in Fedora 43 repos - no additional setup needed +# For Fedora 43 (Fedora 42 is EOL — upgrade if still on it) +# Mesa 25.x is included in Fedora 43 repos - no additional setup needed sudo dnf update # Install governor from COPR (updated Dec 2025) @@ -180,7 +180,7 @@ This fixes graphical glitches in some games. **Solution:** 1. Verify Mesa 25.1+ installed: `dnf list mesa-*` -2. Check kernel version: `uname -r` (should be 6.17.11+, 6.18.x, 6.15.7-6.17.7, or 6.12-6.14 LTS, NOT 6.15.0-6.15.6 or 6.17.8-6.17.10) +2. Check kernel version: `uname -r` (should be 6.18.18 LTS, 6.17.11+, or 6.12-6.14 LTS — NOT 6.15.0-6.15.6 or 6.17.8-6.17.10) 3. Verify nomodeset was removed from GRUB ### Poor Performance / Low FPS diff --git a/docs/index.md b/docs/index.md index b5ae12b..a34c8d0 100644 --- a/docs/index.md +++ b/docs/index.md @@ -76,7 +76,7 @@ The AMD BC250 is a compact motherboard built around AMD's "Cyan Skillfish" APU, Before you begin, be aware of these essential requirements: !!! danger "Kernel Version" - **AVOID Linux kernel 6.15.0-6.15.6 and 6.17.8-6.17.10** - Known to cause GPU driver failures. Use **6.15.7-6.17.7** or **6.17.11+** for best performance, or **6.12.x-6.14.x LTS** for stability. + **AVOID Linux kernel 6.15.0-6.15.6 and 6.17.8-6.17.10** - Known to cause GPU driver failures. Use **6.18.18 LTS** (recommended) or **6.17.11+** for best performance. Kernel 6.19.x has PCIe issues on BC-250. !!! warning "Mesa Version" **Mesa 25.1.3+ minimum**, 25.1.5+ recommended for proper RADV driver support. @@ -91,7 +91,7 @@ Before you begin, be aware of these essential requirements: Based on extensive community testing: -1. **Fedora 42/43** - Most tested, beginner-friendly, Mesa 25.1+ in repos +1. **Fedora 43** - Most tested, beginner-friendly, Mesa 25.x in repos (Fedora 42 is EOL) 2. **Bazzite** - Gaming-focused, works out-of-box 3. **CachyOS** - Best performance for advanced users 4. **Arch Linux** - Maximum control and flexibility diff --git a/docs/linux/arch.md b/docs/linux/arch.md index 2699471..31f3040 100644 --- a/docs/linux/arch.md +++ b/docs/linux/arch.md @@ -7,7 +7,7 @@ Both Arch Linux and Manjaro work excellently on the BC-250. Arch provides maximu **Status:** Both fully working **Difficulty:** Arch (Advanced), Manjaro (Intermediate) **Mesa:** 25.1+ in official repos with upstream BC-250 support. Mesa 26 (development/git) available and confirmed working on Debian sid and Ubuntu 26.04 daily as of Jan 2026. -**Kernel:** Kernels 6.18.x and 6.17.11+ are confirmed stable. Avoid 6.17.8–6.17.10 and 6.15.0–6.15.6 (known broken). LTS kernels (6.12–6.14) remain supported for stability. +**Kernel:** Kernel 6.18.18 LTS (current LTS, recommended) and 6.17.11+ are confirmed stable. Avoid 6.17.8–6.17.10 and 6.15.0–6.15.6 (known broken). Kernel 6.19.x has PCIe issues on BC-250. --- @@ -69,9 +69,9 @@ See [BIOS Flashing Guide](../bios/flashing.md). **Key BC-250 Specific Requirements:** 1. **Kernel Selection** - - Install `linux-lts` package (6.12.x - 6.14.x) for stability - - **Recommended:** Kernels 6.18.x and 6.17.11+ are confirmed stable - - **AVOID:** Kernel 6.15.0-6.15.6 and 6.17.8–6.17.10 (GPU initialization failures) + - **Recommended:** Kernel 6.18.18 LTS (current LTS) or `linux-lts` package + - **Also works:** 6.17.11+ confirmed stable + - **AVOID:** Kernel 6.15.0-6.15.6, 6.17.8–6.17.10 (GPU initialization failures), and 6.19.x (PCIe issues) - LTS kernels (6.12-6.14) remain supported for stability 2. **Boot Parameters** @@ -383,7 +383,7 @@ sudo pacman -S protonup-qt **Solution 2: Check kernel** ```bash uname -r -# If 6.15.0-6.15.6 or 6.17.8–6.17.10, install working kernel (6.17.11+, 6.18.x, or 6.12-6.14 LTS) +# If 6.15.0-6.15.6 or 6.17.8–6.17.10, install working kernel (6.18.18 LTS or 6.17.11+) ``` ### GPU Not Detected / llvmpipe @@ -418,7 +418,7 @@ dmesg | grep amdgpu **Solution:** ```bash -# Option 1: Install confirmed stable kernel (6.17.11+, 6.18.x) +# Option 1: Install confirmed stable kernel (6.18.18 LTS or 6.17.11+) sudo pacman -S linux # Check version is 6.17.11+ or 6.18.x # Or # Option 2: Install LTS for guaranteed stability diff --git a/docs/linux/cachyos.md b/docs/linux/cachyos.md index 89eab88..2d2b5d1 100644 --- a/docs/linux/cachyos.md +++ b/docs/linux/cachyos.md @@ -76,7 +76,7 @@ CachyOS can now be installed directly on the BC-250 using the standard ISO. ```bash # After installation completes uname -r - # Should show compatible version (6.12-6.14 LTS or 6.15.7-6.17.7) + # Should show compatible version (6.18.x LTS recommended, or 6.17.11+) ``` 6. **Reboot and enjoy** @@ -97,7 +97,7 @@ Install Arch Linux first, then migrate to CachyOS repositories for optimized pac Follow the [Arch Installation Guide](https://wiki.archlinux.org/title/Installation_guide) **Key selections:** - - Kernel: `linux-lts` (6.12.x - 6.14.x) or `linux` (verify version is 6.15.7-6.17.7) + - Kernel: `linux-lts` (6.18.18 LTS recommended) or `linux` (verify version is 6.17.11+) - Desktop: KDE Plasma or GNOME - Bootloader: GRUB @@ -333,7 +333,7 @@ coolercontrol ```bash # 1. Check kernel -uname -r # Expected: 6.12.x-lts or 6.15.7-6.17.7 +uname -r # Expected: 6.18.x-lts (recommended) or 6.17.11+ # 2. Check Mesa glxinfo | grep "OpenGL version" # Expected: Mesa 25.1.x+ @@ -368,12 +368,14 @@ sensors # Expected: nct6686-isa-0a20, GPU temp, fan speeds ### Kernel Compatibility **Compatible kernels:** -- **6.12.x - 6.14.x LTS** - Most stable, recommended -- **6.15.7 - 6.17.7** - Works well, newer features +- **6.18.18 LTS** - Current LTS, RECOMMENDED +- **6.17.11+** - Confirmed stable +- **6.12.x - 6.14.x LTS** - Older but stable **Broken kernels (avoid):** - **6.15.0 - 6.15.6** - GPU initialization failures, kernel panics - **6.17.8-6.17.10** - GPU driver issues (fixed in 6.17.11+) +- **6.19.x** - PCIe issues reported on BC-250 (Mar 2026) If you accidentally install a broken kernel: ```bash @@ -416,7 +418,7 @@ CachyOS now works well on BC-250 with standard installation. The complex custom **Quick Start:** 1. Download CachyOS ISO from [cachyos.org](https://cachyos.org/) 2. Install normally (follow installer wizard) -3. Verify compatible kernel is installed (6.12-6.14 LTS or 6.15.7-6.17.7) +3. Verify compatible kernel is installed (6.18.18 LTS recommended, or 6.17.11+) 4. Install GPU governor (`cyan-skillfish-governor-smu` from AUR recommended) 5. Configure sensors, install gaming tools, enjoy diff --git a/docs/linux/debian.md b/docs/linux/debian.md index 3cfb233..13a5909 100644 --- a/docs/linux/debian.md +++ b/docs/linux/debian.md @@ -180,9 +180,9 @@ sudo apt update sudo apt install linux-xanmod-lts-x64v3 ``` -**Confirmed working:** 6.18.3 tested Jan 2026 +**Confirmed working:** 6.18.3+ tested Jan 2026. Current LTS: 6.18.18. -**Important:** Avoid kernel 6.15.0-6.15.6 and 6.17.8–6.17.10 (broken). Use 6.17.11+ or 6.18.x for best performance, or stick to 6.12-6.14 LTS for stability. +**Important:** Avoid kernel 6.15.0-6.15.6 and 6.17.8–6.17.10 (broken). Use 6.18.18 LTS (recommended) or 6.17.11+. Kernel 6.19.x has PCIe issues on BC-250. --- @@ -358,7 +358,7 @@ vulkaninfo | grep deviceName # Kernel version uname -r -# Expected: 6.17.11+, 6.18.x (best) or 6.12.x-6.14.x LTS (stable) +# Expected: 6.18.18 LTS (recommended) or 6.17.11+ ``` ### Check Governor @@ -401,7 +401,7 @@ sensors **Symptom:** GPU initialization failures, black screens on 6.15.0-6.15.6 or 6.17.8–6.17.10 **Solution:** -- Use 6.17.11+, 6.18.x for best performance +- Use 6.18.18 LTS (recommended) or 6.17.11+ - Or use 6.12-6.14 LTS kernels for guaranteed stability - Avoid 6.15.0-6.15.6 and 6.17.8–6.17.10 (known broken) diff --git a/docs/linux/distributions.md b/docs/linux/distributions.md index a9f5407..406dd48 100644 --- a/docs/linux/distributions.md +++ b/docs/linux/distributions.md @@ -6,20 +6,23 @@ Choosing the right Linux distribution for your BC-250 is important for a smooth | User Type | Recommended Distro | Reason | |-----------|-------------------|--------| -| **Beginners** | Fedora 42/43 or Bazzite | Easy setup, works out-of-box, good documentation | +| **Beginners** | Fedora 43 or Bazzite | Easy setup, works out-of-box, good documentation | | **Gaming Focus** | Bazzite | Steam Deck experience, pre-configured for gaming | | **Performance** | CachyOS | Optimized packages, best frame times | | **Advanced Users** | Arch Linux | Full control, latest packages | | **Stability** | Debian/PikaOS | Rock-solid, good for production work | -## Fedora 42/43 (Most Recommended for Beginners) +## Fedora 43 (Most Recommended for Beginners) + +!!!warning "Fedora 42 is End of Life" + Fedora 42 reached EOL. Upgrade to Fedora 43 or try Fedora 44 Beta (ships kernel 6.19 + GNOME 50). ### Overview **Status:** Highly recommended, most tested - **Desktop:** GNOME or KDE Plasma -- **Kernel:** 6.18.3 or later (confirmed stable Jan 2026+), 6.17.11+ working (Dec 2025+), or 6.12-6.14 LTS (stable) -- **Mesa:** 25.1+ in mainline repos (Fedora 43) +- **Kernel:** 6.18.18 LTS (current LTS, recommended), 6.17.11+ working (Dec 2025+) +- **Mesa:** 25.x in mainline repos (Fedora 43) ### Pros @@ -31,7 +34,7 @@ Choosing the right Linux distribution for your BC-250 is important for a smooth ### Cons -- Kernel 6.15.0-6.15.6 and 6.17.8–6.17.10 break BC-250 (use 6.17.11+, 6.18.x, or 6.12-6.14 LTS) +- Kernel 6.15.0-6.15.6 and 6.17.8–6.17.10 break BC-250 (use 6.18.18 LTS or 6.17.11+) - Some users report MTG Arena crashes specifically on Fedora - Auto-updates can break things if not careful @@ -117,7 +120,7 @@ systemctl reboot - May need Arch migration if standard ISO fails - SMU governor now available via AUR packages without requiring a pre-patched kernel -- Kernel 6.15.0-6.15.6 and 6.17.8–6.17.10 cause panics (use 6.17.11+, 6.18.x, or LTS) +- Kernel 6.15.0-6.15.6 and 6.17.8–6.17.10 cause panics (use 6.18.18 LTS or 6.17.11+) - More complex setup !!!success "SMU Governor Alternative" @@ -128,7 +131,7 @@ systemctl reboot **Option 1: Arch + Migration (Recommended)** 1. Install Arch Linux following the [Arch Installation Guide](https://wiki.archlinux.org/title/Installation_guide) -2. Use `linux-lts` kernel (6.12.x - 6.14.x) +2. Use `linux-lts` kernel (6.12.x - 6.14.x or 6.18.18 LTS) 3. Boot with `nomodeset` if needed (remove after driver installation) 4. Use CachyOS migration script from their documentation 5. Install CachyOS LTS kernel during migration @@ -308,7 +311,7 @@ sudo apt update && sudo apt upgrade ### Kernel Compatibility !!!danger "Avoid Broken Kernel Versions" - Kernel 6.15.0-6.15.6 and 6.17.8–6.17.10 cause kernel panics and GPU initialization failures on BC-250. **Use 6.17.11+, 6.18.x for best performance or 6.12-6.14 LTS for stability.** + Kernel 6.15.0-6.15.6 and 6.17.8–6.17.10 cause kernel panics and GPU initialization failures on BC-250. **Use 6.18.18 LTS (recommended) or 6.17.11+ for best performance.** !!!warning "GPU Stability Testing" CLI stress tests (Furmark, etc.) may not catch GPU instability reliably. BC-250 design causes full system crashes at unstable voltages without artifacting first. Users attempting frequency tuning need this warning to prevent data loss. Incremental tuning with small voltage steps is required; always save work frequently when testing. @@ -356,7 +359,7 @@ sudo apt update && sudo apt upgrade ### Fedora (Easiest) -1. Download Fedora 42/43 Workstation ISO +1. Download Fedora 43 Workstation ISO 2. Flash to USB 3. Boot in "Basic Graphics Mode" 4. Install normally @@ -388,7 +391,7 @@ sudo apt update && sudo apt upgrade ### Fedora - **Issue:** Kernel 6.15.0-6.15.6 and 6.17.8-6.17.10 break GPU -- **Solution:** Pin kernel to 6.14 +- **Solution:** Pin kernel to 6.18 LTS ### Bazzite diff --git a/docs/linux/fedora.md b/docs/linux/fedora.md index e0132b6..1ad596c 100644 --- a/docs/linux/fedora.md +++ b/docs/linux/fedora.md @@ -56,7 +56,10 @@ Fedora is the most recommended distribution for BC-250, offering: ### Step 2: Select Boot Mode -**For Fedora 42/43 with working kernels (6.17.11+, 6.18.3+ or later):** +!!!warning "Fedora 42 is End of Life" + Fedora 42 reached EOL. If still running Fedora 42, upgrade to Fedora 43. Fedora 44 Beta is also available (ships kernel 6.19 + GNOME 50). + +**For Fedora 43 with working kernels (6.18.18 LTS or 6.17.11+):** You can try the standard "Install Fedora" option. If it boots successfully, no need for basic graphics mode. @@ -67,12 +70,13 @@ You can try the standard "Install Fedora" option. If it boots successfully, no n 3. This enables `nomodeset` automatically !!!info "Nomodeset May Not Be Required" - On Fedora 42/43 with working kernel versions (6.17.11+, 6.18.3+ or later), nomodeset is often no longer needed during installation. However, if you encounter a black screen, use basic graphics mode. + On Fedora 43 with working kernel versions (6.18.18 LTS or 6.17.11+), nomodeset is often no longer needed during installation. However, if you encounter a black screen, use basic graphics mode. !!!info "Recommended Kernel Versions" - - Kernel 6.18.3 or later: CONFIRMED stable (Jan 2026+) + - Kernel 6.18.18 LTS: Current LTS, RECOMMENDED - Kernel 6.17.11+: Working (Dec 2025+) - Kernels 6.17.8–6.17.10: Known broken, avoid + - Kernel 6.19.x: PCIe issues reported on BC-250 — avoid for now - Note: Unpatched kernels have 1000–2000 MHz frequency limits. Custom kernel compilation or distro patches (e.g., CachyOS) unlock higher ranges. ### Step 3: Complete Installation @@ -110,7 +114,7 @@ sudo dnf install -y git cmake make gcc-c++ libdrm-devel lm_sensors dnf list mesa-\* # Should show 25.1+ for Fedora 43 -# If Fedora 42 and < 25.1, may need mesa-git (unlikely now) +# Fedora 43 ships Mesa 25.x — no additional setup needed ``` ### Step 4: Install GPU Governor @@ -173,7 +177,7 @@ sudo grub2-mkconfig -o /boot/grub2/grub.cfg !!!info "Kernel Parameters Explained" - `quiet` - Reduces boot messages - `mitigations=off` - Disables CPU security mitigations (+18 FPS in Cyberpunk 2077) - - `amdgpu.sg_display=0` - Only needed for kernels < 6.10 (not required on Fedora 42/43) + - `amdgpu.sg_display=0` - Only needed for kernels < 6.10 (not needed on Fedora 43) ### Step 7: Reboot @@ -242,7 +246,7 @@ sudo dnf install mangohud goverlay gamemode gamescope ## Optional: Hold Kernel Version -Since kernel 6.15.0-6.15.6 and 6.17.8–6.17.10 break BC-250, you may want to prevent automatic kernel updates to broken versions. Note: 6.17.11+, 6.18.3+ are confirmed working: +Since kernel 6.15.0-6.15.6 and 6.17.8–6.17.10 break BC-250, you may want to prevent automatic kernel updates to broken versions. Note: 6.18.18 LTS and 6.17.11+ are confirmed working: ```bash # Install versionlock plugin @@ -315,7 +319,7 @@ sudo dnf remove kernel-6.17.9\* sudo dnf upgrade kernel # Or install LTS for stability -sudo dnf install kernel-6.14.4-104 +sudo dnf install kernel-6.18.18-200 ``` ### MTG Arena Crashes on Fedora diff --git a/docs/linux/kernel.md b/docs/linux/kernel.md index 45ce87b..7968733 100644 --- a/docs/linux/kernel.md +++ b/docs/linux/kernel.md @@ -7,7 +7,7 @@ The Linux kernel version and configuration is critical for BC-250 stability and ### Recommended Kernels **Best Compatibility:** -- **6.18.x LTS** - RECOMMENDED (CachyOS 6.18.0 reports 5-10% faster than 6.17) +- **6.18.18 LTS** - RECOMMENDED (current LTS, 5-10% faster than 6.17) - **6.17.11+** - Kernel fix applied, works well - **6.16.x** - All versions work well - **6.15.7 - 6.17.7** - Full BC-250 support @@ -17,18 +17,24 @@ The Linux kernel version and configuration is critical for BC-250 stability and - **6.13.x** - Stable - **6.14.x LTS** - Well-tested -**Confirmed Working Versions (Jan-Feb 2026):** +**Current Kernel Landscape (March 2026):** +- **7.0-rc4** - Mainline (not recommended for production use) +- **6.19.8** - Current stable (PCIe issues reported on BC-250 — see warning below) +- **6.18.18** - Current LTS — **RECOMMENDED** - **6.18.3** - Confirmed working (CachyOS, Debian sid, Ubuntu xanmod) - **6.18.0** - Confirmed working (CachyOS - 5-10% performance improvement over 6.17) - 6.17.11+ - Confirmed working (Fedora, Dec 2025) -- 6.16.5 (Fedora 42/43) +- 6.16.5 (Fedora 43) - 6.15.11-1-lts (Arch Linux) !!!success "Current Recommendation" - Use kernel **6.18.x LTS** for the best BC-250 performance (5-10% faster than 6.17). Alternatively, kernels **6.17.11+** also work well. + Use kernel **6.18.18 LTS** for the best BC-250 performance (5-10% faster than 6.17). Alternatively, kernels **6.17.11+** also work well. !!!warning "6.19.x: PCIe Issues Reported (March 2026)" - Community reports indicate that some 6.19.x kernel builds cause **all PCIe devices to stop working** on BC-250. If using 6.19.x, test thoroughly before committing. Stick to **6.18.x** or **6.17.11+** for proven stability. + Community reports indicate that some 6.19.x kernel builds (including current stable 6.19.8) cause **all PCIe devices to stop working** on BC-250. If using 6.19.x, test thoroughly before committing. Stick to **6.18.18 LTS** or **6.17.11+** for proven stability. + +!!!warning "7.0-rc: Mainline — Do Not Use in Production" + Kernel 7.0-rc4 is the current mainline release candidate. Not tested on BC-250 and not recommended for daily use. ### Broken Kernels @@ -233,7 +239,7 @@ For detailed setup instructions, see the [GPU Governor Setup guide](../system/go # Display kernel version uname -r -# Example output: 6.14.4-104.fc42.x86_64 +# Example output: 6.18.18-200.fc43.x86_64 ``` ### Installing Specific Kernel Version @@ -244,10 +250,10 @@ uname -r dnf list kernel --showduplicates # Install specific version -sudo dnf install kernel-6.14.4-104 +sudo dnf install kernel-6.18.18-200 # Set as default in GRUB if needed -sudo grub2-set-default "Fedora Linux (6.14.4-104)" +sudo grub2-set-default "Fedora Linux (6.18.18-200)" ``` **Arch Linux:** @@ -291,10 +297,10 @@ IgnorePkg = linux **Debian:** ```bash # Hold kernel package -sudo apt-mark hold linux-image-6.14.11-amd64 +sudo apt-mark hold linux-image-6.18.18-amd64 # Unhold -sudo apt-mark unhold linux-image-6.14.11-amd64 +sudo apt-mark unhold linux-image-6.18.18-amd64 ``` ### Removing Broken Kernel @@ -323,7 +329,7 @@ sudo pacman -R linux # if on broken version # Install known-good kernel sudo pacman -S linux-lts # 6.12 or 6.14 LTS # or -sudo pacman -S linux # check version is 6.15.7-6.17.7 +sudo pacman -S linux # check version is 6.17.11+ or 6.18.x ``` ## Kernel Patches for BC-250 @@ -451,8 +457,9 @@ glxinfo | grep "OpenGL renderer" | 6.17.0-6.17.7 | ✅ **Recommended** | Good support | | 6.17.8-6.17.10 | ❌ **Broken** | GPU driver broken | | 6.17.11+ | ✅ **Recommended** | Kernel fix applied | -| 6.18.x LTS | ✅ **Best** | 5-10% faster than 6.17 (CachyOS Jan 2026) | -| 6.19.x | ⚠️ **Testing** | Reports of PCIe device failures (Mar 2026) — test before committing | +| 6.18.x LTS | ✅ **Best** | 6.18.18 is current LTS, 5-10% faster than 6.17 | +| 6.19.x (6.19.8 stable) | ⚠️ **Testing** | Reports of PCIe device failures on BC-250 — test before committing | +| 7.0-rc | 🔬 **Mainline** | Not tested on BC-250, do not use in production | ## See Also diff --git a/docs/linux/mesa.md b/docs/linux/mesa.md index 3a23b79..e2315e6 100644 --- a/docs/linux/mesa.md +++ b/docs/linux/mesa.md @@ -59,17 +59,8 @@ glxinfo | grep "OpenGL version" No additional steps needed! -### Fedora 42 - -**Check version first:** - -```bash -dnf list mesa-\* -``` - -**If Mesa < 25.1:** - -Most Fedora 42 systems after updates should have 25.1+. If not, mesa-git COPR may be needed, but this is increasingly rare. +!!!warning "Fedora 42 is End of Life" + Fedora 42 reached EOL. Upgrade to Fedora 43 (Mesa 25.x in repos) or try Fedora 44 Beta. ### Arch Linux / CachyOS @@ -167,7 +158,7 @@ pacman -Q mesa glxinfo | grep "OpenGL renderer" # Should show: -# OpenGL renderer string: AMD Radeon Graphics (radv gfx1013 LLVM 18.1.8 DRM 3.59 6.14.4-104.fc42.x86_64) +# OpenGL renderer string: AMD Radeon Graphics (radv gfx1013 LLVM 18.1.8 DRM 3.59 6.18.18-200.fc43.x86_64) ``` !!!danger "llvmpipe Means No GPU" @@ -465,7 +456,7 @@ sudo dnf versionlock add mesa\* | 25.1.3+ | ✅ Minimum | Stable, bug fixes | | 25.1.5+ | ✅ Good | Improvements over 25.1.3 | | 25.2.4+ | ✅ **Recommended** | Current stable (Feb 2026) | -| 26.x | ✅ Latest | Available on Debian sid/Ubuntu 26.04 daily | +| 26.0 | ✅ Latest | Available on Debian sid/Ubuntu 26.04 daily | ## See Also diff --git a/docs/reference/quick-reference.md b/docs/reference/quick-reference.md index d952362..f51b08b 100644 --- a/docs/reference/quick-reference.md +++ b/docs/reference/quick-reference.md @@ -44,8 +44,8 @@ Fast answers to common questions. For detailed information, see the full documen ### Kernel Requirements -- **Use:** Kernel 6.17.11+, 6.18.x (best), 6.15.7-6.17.7 (good), or 6.12.x-6.14.x LTS (stable) -- **Avoid:** Kernel 6.15.0-6.15.6 and 6.17.8-6.17.10 (GPU initialization fails — fixed in 6.17.11+) +- **Use:** Kernel 6.18.18 LTS (recommended), 6.17.11+, or 6.12.x-6.14.x LTS (stable) +- **Avoid:** Kernel 6.15.0-6.15.6, 6.17.8-6.17.10 (GPU fails), and 6.19.x (PCIe issues on BC-250) - **Boot parameter:** `nomodeset` during install, remove after drivers installed ### Kernel Parameters @@ -101,7 +101,7 @@ amdgpu.sg_display=0 ### Operating System **Recommended:** -- Fedora 42/43 Workstation (easiest) +- Fedora 43 Workstation (easiest) - Bazzite (best for gaming) - CachyOS (best performance, harder setup) @@ -118,7 +118,7 @@ amdgpu.sg_display=0 | Component | Minimum | Recommended | |-----------|---------|-------------| | Mesa | 25.1.0 | 25.2.4+ | -| Kernel | 6.12.x | 6.17.11+ or 6.18.x | +| Kernel | 6.12.x | 6.18.18 LTS or 6.17.11+ | | Governor | Any | cyan-skillfish-governor-tt or -smu | [Linux setup guide →](../linux/distributions.md) @@ -336,7 +336,7 @@ RADV_DEBUG=nohiz,nocompute %command% 1. VRAM allocation (try 10GB/6GB fixed if using 512MB dynamic with ZRAM) 2. Disable ZRAM: `sudo systemctl disable zram-swap` 3. Update Mesa to latest -4. Check kernel version (use 6.15.7-6.17.7 or 6.12-6.14 LTS) +4. Check kernel version (use 6.18.18 LTS, 6.17.11+, or 6.12-6.14 LTS) ### High Temperatures @@ -356,7 +356,7 @@ RADV_DEBUG=nohiz,nocompute %command% 1. **Always clear CMOS after USB BIOS flash** 2. **Disable IOMMU in BIOS** (IOMMU is broken - MUST disable) 3. **Use nomodeset during install, remove after drivers installed** - 4. **Avoid kernel 6.15.0-6.15.6 and 6.17.8-6.17.10** (GPU driver fails — fixed in 6.17.11+) + 4. **Avoid kernel 6.15.0-6.15.6, 6.17.8-6.17.10** (GPU driver fails), **and 6.19.x** (PCIe issues) 5. **700mV minimum voltage** (GPU locks to 1500MHz below this) 6. **Active DP-HDMI adapters break audio** 7. **ACPI fix is essential** — required for C-State support and power management ([bc250-acpi-fix](https://github.com/bc250-collective/bc250-acpi-fix)) diff --git a/docs/troubleshooting/boot.md b/docs/troubleshooting/boot.md index a03c67c..8c5a0ff 100644 --- a/docs/troubleshooting/boot.md +++ b/docs/troubleshooting/boot.md @@ -163,26 +163,24 @@ glxinfo | grep "OpenGL version" # Then verify kernel version uname -r -# Should be 6.15.7-6.17.7 (best) or 6.12.x-6.14.x LTS (stable) +# Should be 6.18.18 LTS (recommended), 6.17.11+, or 6.12.x-6.14.x LTS (stable) # AVOID 6.15.0-6.15.6 and 6.17.8-6.17.10 ``` If kernel is 6.15.0-6.15.6 or 6.17.8-6.17.10: ```bash # Fedora - install working kernel -sudo dnf install kernel-6.16.5-* # or any 6.15.7-6.17.7 version -# Or for LTS stability: -sudo dnf install kernel-6.14.* +sudo dnf install kernel-6.18.18-* # current LTS, recommended # List available kernels sudo grubby --info=ALL # Set working kernel as default -sudo grubby --set-default /boot/vmlinuz-6.16.* +sudo grubby --set-default /boot/vmlinuz-6.18.* ``` !!!danger "Broken Kernel Versions" - Kernel versions 6.15.0-6.15.6 and 6.17.8-6.17.10 have driver incompatibility with Cyan Skillfish GPUs. Use 6.15.7-6.17.7, 6.17.11+, or 6.18.x for best performance, or 6.12.x-6.14.x LTS for stability. + Kernel versions 6.15.0-6.15.6 and 6.17.8-6.17.10 have driver incompatibility with Cyan Skillfish GPUs. Use 6.18.18 LTS (recommended) or 6.17.11+ for best performance. --- @@ -339,7 +337,7 @@ Boot older kernel: sudo grubby --info=ALL # Set older kernel as default -sudo grubby --set-default /boot/vmlinuz-6.13.* +sudo grubby --set-default /boot/vmlinuz-6.18.* # Or remove broken kernel sudo dnf remove kernel-6.15.5\* kernel-6.17.8\* # Fedora (example versions) @@ -865,7 +863,7 @@ If USB method fails: | Hangs at boot | IOMMU enabled | Disable IOMMU in BIOS | | GRUB shows, then black | Missing/wrong drivers | Add `nomodeset`, install Mesa 25.1+ | | Works after BIOS flash, then fails | CMOS not cleared | Clear CMOS battery | -| Works, then breaks after update | Kernel 6.15.0-6.15.6 or 6.17.8-6.17.10 installed | Install 6.17.11+, 6.18.x, or 6.12-6.14 LTS | +| Works, then breaks after update | Kernel 6.15.0-6.15.6 or 6.17.8-6.17.10 installed | Install 6.18.18 LTS or 6.17.11+ | --- @@ -914,13 +912,13 @@ A: Check if system updated kernel. Run `uname -r` from live USB after mounting s A: Did you remove `nomodeset` after installing drivers? It must be removed from GRUB config. **Q: How do I know if my kernel is the problem?** -A: BC-250 works best with 6.17.11+, 6.18.x, 6.15.7-6.17.7, or 6.12.x-6.14.x LTS. Kernels 6.15.0-6.15.6 and 6.17.8-6.17.10 break GPU drivers. Avoid 6.10 and below (too old). +A: BC-250 works best with 6.18.18 LTS (current recommendation) or 6.17.11+. Kernels 6.15.0-6.15.6 and 6.17.8-6.17.10 break GPU drivers. Kernel 6.19.x has PCIe issues on BC-250. Avoid 6.10 and below (too old). **Q: BIOS seems dead after flashing. Bricked?** A: 90% chance you just need to clear CMOS. Remove battery for 60 seconds. Almost never truly bricked. **Q: Can I prevent these boot issues?** -A: Yes! Avoid kernel 6.15.0-6.15.6 and 6.17.8-6.17.10, keep Mesa 25.1+, disable IOMMU in BIOS, always clear CMOS after BIOS flash. +A: Yes! Avoid kernel 6.15.0-6.15.6, 6.17.8-6.17.10, and 6.19.x (PCIe issues). Use 6.18.18 LTS. Keep Mesa 25.1+, disable IOMMU in BIOS, always clear CMOS after BIOS flash. --- diff --git a/docs/troubleshooting/display.md b/docs/troubleshooting/display.md index 03a467a..770ec24 100644 --- a/docs/troubleshooting/display.md +++ b/docs/troubleshooting/display.md @@ -102,7 +102,7 @@ After booting with nomodeset: ```bash # Install drivers (distro-specific) -# Fedora 42/43 - Mesa 25.1+ included in repos: +# Fedora 43 - Mesa 25.1+ included in repos: sudo dnf update sudo dnf install mesa-vulkan-drivers mesa-dri-drivers @@ -146,16 +146,15 @@ If kernel is 6.15.0-6.15.6 or 6.17.8-6.17.10: ```bash # Install working kernel # Fedora: -sudo dnf install kernel-6.16.5-* # or any 6.15.7-6.17.7 version -# Or for LTS stability: -sudo dnf install kernel-6.14.x +sudo dnf install kernel-6.18.18-* # current LTS, recommended +# Or: sudo dnf install kernel-6.17.11+ # Update GRUB to use working kernel as default sudo grub2-mkconfig -o /boot/grub2/grub.cfg ``` !!!danger "Broken Kernel Versions" - Kernel 6.15.0-6.15.6 and 6.17.8-6.17.10 have driver incompatibility with BC-250. Use 6.15.7-6.17.7, 6.17.11+, or 6.18.x for best performance, or 6.12-6.14 LTS for stability. + Kernel 6.15.0-6.15.6 and 6.17.8-6.17.10 have driver incompatibility with BC-250. Use 6.18.18 LTS (recommended) or 6.17.11+ for best performance. --- @@ -428,19 +427,19 @@ dmesg | grep -i iommu - Now no display after boot **Cause:** -Kernel 6.15.0-6.15.6 and 6.17.8-6.17.10 have driver incompatibility with BC-250. +Kernel 6.15.0-6.15.6 and 6.17.8-6.17.10 have driver incompatibility with BC-250. Use 6.18.18 LTS or 6.17.11+. **Solution:** Boot working kernel: 1. At GRUB, select "Advanced options" -2. Select kernel in 6.15.7-6.17.7 range (if available) or 6.12-6.14 LTS +2. Select kernel 6.18.x LTS, 6.17.11+, or 6.12-6.14 LTS 3. Boot Make working kernel default: ```bash # Fedora: -sudo grubby --set-default /boot/vmlinuz-6.16.x # or 6.14.x for LTS +sudo grubby --set-default /boot/vmlinuz-6.18.* # 6.18.18 LTS recommended # Or remove broken kernel entirely sudo dnf remove kernel-6.15.5\* kernel-6.17.8\* # example versions @@ -574,7 +573,7 @@ vulkaninfo | grep deviceName ## FAQ **Q: Display worked yesterday, now doesn't. What changed?** -A: Check if kernel updated (`uname -r`). If now on 6.15.0-6.15.6 or 6.17.8-6.17.10, boot working kernel (6.17.11+, 6.18.x, or 6.12-6.14 LTS). +A: Check if kernel updated (`uname -r`). If now on 6.15.0-6.15.6 or 6.17.8-6.17.10, boot working kernel (6.18.18 LTS or 6.17.11+). **Q: Can I use HDMI directly?** A: No, board only has DisplayPort. Must use DP cable or adapter. diff --git a/docs/troubleshooting/performance.md b/docs/troubleshooting/performance.md index 72c6337..3fa367d 100644 --- a/docs/troubleshooting/performance.md +++ b/docs/troubleshooting/performance.md @@ -180,12 +180,8 @@ Solution: Upgrade to Mesa 25.1.3 or newer sudo dnf update mesa* ``` -**Fedora 42:** -```bash -# Use COPR for Mesa 25.1+ -sudo dnf copr enable @exotic-soc/bc250-mesa -sudo dnf update mesa* -``` +!!!warning "Fedora 42 is End of Life" + Upgrade to Fedora 43 which ships Mesa 25.x in repos. **Arch/Manjaro:** ```bash @@ -272,12 +268,12 @@ See "GPU Locked at 1500MHz" section above. **Install Working Kernel** !!! danger "AVOID BROKEN KERNEL VERSIONS" - Kernel 6.15.0-6.15.6 and 6.17.8-6.17.10 break GPU driver support. Use 6.15.7-6.17.7, 6.17.11+, or 6.18.x for best performance, or 6.12.x-6.14.x LTS for stability. + Kernel 6.15.0-6.15.6 and 6.17.8-6.17.10 break GPU driver support. Use 6.18.18 LTS (recommended) or 6.17.11+ for best performance. **Arch/Manjaro:** ```bash -# Option 1: Install working 6.15.7-6.17.7 kernel -sudo pacman -S linux # Check version is in working range +# Option 1: Install working kernel (6.17.11+ or 6.18.x) +sudo pacman -S linux # Check version is 6.17.11+ or 6.18.x # Option 2: Install LTS kernel for guaranteed stability sudo pacman -S linux-lts linux-lts-headers # Set as default in bootloader @@ -286,7 +282,7 @@ sudo pacman -S linux-lts linux-lts-headers **CachyOS:** ```bash # Check version first -paru -S linux-cachyos # Ensure it's 6.15.7-6.17.7 +paru -S linux-cachyos # Ensure it's 6.17.11+ or 6.18.x # Or for LTS stability: paru -S linux-cachyos-lts linux-cachyos-lts-headers ``` @@ -653,7 +649,7 @@ rpm-ostree rollback Use this checklist to verify your system is properly configured: - [ ] Mesa version 25.1.3 or higher -- [ ] Kernel 6.17.11+, 6.18.x, 6.15.7-6.17.7, or 6.12.x-6.14.x LTS (NOT 6.15.0-6.15.6 or 6.17.8-6.17.10) +- [ ] Kernel 6.18.18 LTS (recommended), 6.17.11+, or 6.12.x-6.14.x LTS (NOT 6.15.0-6.15.6 or 6.17.8-6.17.10) - [ ] GPU governor installed and running (cyan-skillfish-governor-tt recommended) - [ ] `nomodeset` removed from kernel parameters - [ ] BIOS flashed to P3.00 with 512MB dynamic or 4-12GB fixed VRAM diff --git a/docs/troubleshooting/stability.md b/docs/troubleshooting/stability.md index 3a3a5c6..0bdbf33 100644 --- a/docs/troubleshooting/stability.md +++ b/docs/troubleshooting/stability.md @@ -35,7 +35,7 @@ Before diving into specific issues, check these common causes: uname -r ``` - **AVOID kernel 6.15.0-6.15.6 and 6.17.8-6.17.10** - Known to cause random GPU crashes under load - - **Recommended**: 6.15.7-6.17.7 (best performance) or 6.12.x-6.14.x LTS (stable) + - **Recommended**: 6.18.18 LTS (recommended) or 6.17.11+ - If on broken version, install working kernel immediately 2. **Verify governor voltage stability** @@ -233,12 +233,12 @@ Before diving into specific issues, check these common causes: **Solution**: -1. **Install working kernel (6.15.7-6.17.7 or 6.12-6.14 LTS)** +1. **Install working kernel (6.18.18 LTS, 6.17.11+, or 6.12-6.14 LTS)** **Arch/Manjaro**: ```bash - # Option 1: Install working 6.15.7-6.17.7 kernel - sudo pacman -S linux # Check version is in working range + # Option 1: Install working kernel (6.17.11+ or 6.18.x) + sudo pacman -S linux # Check version is 6.17.11+ or 6.18.x # Option 2: Install LTS kernel for guaranteed stability sudo pacman -S linux-lts linux-lts-headers @@ -249,10 +249,10 @@ Before diving into specific issues, check these common causes: **Fedora**: ```bash # Install older kernel - sudo dnf install kernel-6.14.x + sudo dnf install kernel-6.18.18-* # Set as default - sudo grubby --set-default /boot/vmlinuz-6.14.x + sudo grubby --set-default /boot/vmlinuz-6.18.* ``` **CachyOS**: Use LTS kernel option during installation @@ -664,7 +664,7 @@ journalctl -f | grep -i "error\|fail\|crash\|amdgpu" ### "GPU reset failed" - **Cause**: Kernel 6.15.0-6.15.6 or 6.17.8-6.17.10, overclocking instability, or GPU crash -- **Fix**: Install working kernel (6.15.7-6.17.7 or 6.12-6.14 LTS), reduce frequency/increase voltage +- **Fix**: Install working kernel (6.18.18 LTS, 6.17.11+, or 6.12-6.14 LTS), reduce frequency/increase voltage ### "Out of memory" - **Cause**: VRAM exhausted, BIOS settings not applied, ZRAM conflict @@ -798,7 +798,7 @@ If problems persist after trying these solutions: | Problem | Most Likely Fix | |---------|----------------| -| Random GPU crashes | Install working kernel (6.15.7-6.17.7 or 6.12-6.14 LTS) | +| Random GPU crashes | Install working kernel (6.18.18 LTS, 6.17.11+, or 6.12-6.14 LTS) | | BIOS settings not sticking | Clear CMOS after flashing | | Games crashing with ZRAM | Disable ZRAM or use fixed VRAM allocation | | General instability | Disable IOMMU in BIOS |