diff --git a/docs/gaming/compatibility.md b/docs/gaming/compatibility.md index 8d2a3ec..4626aac 100644 --- a/docs/gaming/compatibility.md +++ b/docs/gaming/compatibility.md @@ -390,7 +390,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.15.7-6.17.7 or 6.12-6.14 LTS, avoid 6.15.0-6.15.6 and 6.17.8+ +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 ## See Also diff --git a/docs/getting-started/prerequisites.md b/docs/getting-started/prerequisites.md index b55b2e8..bae874d 100644 --- a/docs/getting-started/prerequisites.md +++ b/docs/getting-started/prerequisites.md @@ -112,7 +112,7 @@ The BC-250 requires Linux for GPU support. Windows has NO drivers. **Avoid:** -- Kernel 6.15.0-6.15.6 and 6.17.8+ (GPU driver issues) +- Kernel 6.15.0-6.15.6 and 6.17.8-6.17.10 (GPU driver issues — fixed in 6.17.11+) [Full distribution comparison →](../linux/distributions.md) diff --git a/docs/getting-started/quick-start.md b/docs/getting-started/quick-start.md index da799e6..317c605 100644 --- a/docs/getting-started/quick-start.md +++ b/docs/getting-started/quick-start.md @@ -166,7 +166,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.15.7-6.17.7 or 6.12-6.14 LTS, NOT 6.15.0-6.15.6 or 6.17.8+) +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) 3. Verify nomodeset was removed from GRUB ### Poor Performance / Low FPS diff --git a/docs/linux/cachyos.md b/docs/linux/cachyos.md index 794de55..e5ee9c9 100644 --- a/docs/linux/cachyos.md +++ b/docs/linux/cachyos.md @@ -361,7 +361,7 @@ sensors # Expected: nct6687, GPU temp, fan speeds **Broken kernels (avoid):** - **6.15.0 - 6.15.6** - GPU initialization failures, kernel panics -- **6.17.8+** - GPU driver issues +- **6.17.8-6.17.10** - GPU driver issues (fixed in 6.17.11+) If you accidentally install a broken kernel: ```bash diff --git a/docs/linux/distributions.md b/docs/linux/distributions.md index c960274..18332aa 100644 --- a/docs/linux/distributions.md +++ b/docs/linux/distributions.md @@ -387,7 +387,7 @@ sudo apt update && sudo apt upgrade ### Fedora -- **Issue:** Kernel 6.15.0-6.15.6 and 6.17.8+ break GPU +- **Issue:** Kernel 6.15.0-6.15.6 and 6.17.8-6.17.10 break GPU - **Solution:** Pin kernel to 6.14 ### Bazzite diff --git a/docs/linux/kernel.md b/docs/linux/kernel.md index 8dd55a2..09e4ccb 100644 --- a/docs/linux/kernel.md +++ b/docs/linux/kernel.md @@ -25,7 +25,10 @@ The Linux kernel version and configuration is critical for BC-250 stability and - 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. **6.19.x** is the current stable branch. + 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. + +!!!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. ### Broken Kernels @@ -444,7 +447,7 @@ glxinfo | grep "OpenGL renderer" | 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 | ✅ **Current Stable** | Latest stable branch | +| 6.19.x | ⚠️ **Testing** | Reports of PCIe device failures (Mar 2026) — test before committing | ## See Also diff --git a/docs/reference/quick-reference.md b/docs/reference/quick-reference.md index e8fb9c6..7ffb2dc 100644 --- a/docs/reference/quick-reference.md +++ b/docs/reference/quick-reference.md @@ -45,7 +45,7 @@ Fast answers to common questions. For detailed information, see the full documen ### Kernel Requirements - **Use:** Kernel 6.15.7 - 6.17.7 (best) or 6.12.x - 6.14.x LTS (stable) -- **Avoid:** Kernel 6.15.0-6.15.6 and 6.17.8+ (GPU initialization fails) +- **Avoid:** Kernel 6.15.0-6.15.6 and 6.17.8-6.17.10 (GPU initialization fails — fixed in 6.17.11+) - **Boot parameter:** `nomodeset` during install, remove after drivers installed ### Kernel Parameters @@ -353,7 +353,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+** (GPU driver fails) + 4. **Avoid kernel 6.15.0-6.15.6 and 6.17.8-6.17.10** (GPU driver fails — fixed in 6.17.11+) 5. **700mV minimum voltage** (crashes below this) 6. **Active DP-HDMI adapters break audio** diff --git a/docs/troubleshooting/boot.md b/docs/troubleshooting/boot.md index 1490dcc..a03c67c 100644 --- a/docs/troubleshooting/boot.md +++ b/docs/troubleshooting/boot.md @@ -164,10 +164,10 @@ 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) -# AVOID 6.15.0-6.15.6 and 6.17.8+ +# 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+: +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 @@ -182,7 +182,7 @@ sudo grubby --set-default /boot/vmlinuz-6.16.* ``` !!!danger "Broken Kernel Versions" - Kernel versions 6.15.0-6.15.6 and 6.17.8+ have driver incompatibility with Cyan Skillfish GPUs. Use 6.15.7-6.17.7 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.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. --- @@ -865,7 +865,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+ installed | Install 6.15.7-6.17.7 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.17.11+, 6.18.x, or 6.12-6.14 LTS | --- @@ -908,19 +908,19 @@ drm.debug=0x1f # DRM debug output A: Add `nomodeset` to kernel parameters at GRUB. This is the #1 solution for BC-250 boot issues. **Q: System worked yesterday, today won't boot. Nothing changed.** -A: Check if system updated kernel. Run `uname -r` from live USB after mounting system drive. If 6.15.0-6.15.6 or 6.17.8+, that's the problem. +A: Check if system updated kernel. Run `uname -r` from live USB after mounting system drive. If 6.15.0-6.15.6 or 6.17.8-6.17.10, that's the problem. **Q: Installed drivers but still have black screen?** 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.15.7-6.17.7 or 6.12.x-6.14.x LTS. Kernels 6.15.0-6.15.6 and 6.17.8+ break GPU drivers. Avoid 6.10 and below (too old). +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). **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+, keep Mesa 25.1+, disable IOMMU in BIOS, always clear CMOS after BIOS flash. +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. --- diff --git a/docs/troubleshooting/display.md b/docs/troubleshooting/display.md index 3fb50a2..d378744 100644 --- a/docs/troubleshooting/display.md +++ b/docs/troubleshooting/display.md @@ -20,7 +20,7 @@ Display problems are the #1 issue new BC-250 users encounter. This guide covers 2. BIOS settings not applied (CMOS not cleared) 3. Incompatible display adapter (active DP-HDMI) 4. IOMMU enabled in BIOS -5. Broken kernel version (6.15.0-6.15.6 or 6.17.8+) driver issues +5. Broken kernel version (6.15.0-6.15.6 or 6.17.8-6.17.10) driver issues --- @@ -142,7 +142,7 @@ Check kernel version: uname -r ``` -If kernel is 6.15.0-6.15.6 or 6.17.8+: +If kernel is 6.15.0-6.15.6 or 6.17.8-6.17.10: ```bash # Install working kernel # Fedora: @@ -155,7 +155,7 @@ sudo grub2-mkconfig -o /boot/grub2/grub.cfg ``` !!!danger "Broken Kernel Versions" - Kernel 6.15.0-6.15.6 and 6.17.8+ have driver incompatibility with BC-250. Use 6.15.7-6.17.7 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.15.7-6.17.7, 6.17.11+, or 6.18.x for best performance, or 6.12-6.14 LTS for stability. --- @@ -424,11 +424,11 @@ dmesg | grep -i iommu ### Broken Kernel Versions - No Display **Problem:** -- Upgraded kernel to 6.15.0-6.15.6 or 6.17.8+ +- Upgraded kernel to 6.15.0-6.15.6 or 6.17.8-6.17.10 - Now no display after boot **Cause:** -Kernel 6.15.0-6.15.6 and 6.17.8+ 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. **Solution:** @@ -574,7 +574,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+, boot working kernel (6.15.7-6.17.7 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.17.11+, 6.18.x, or 6.12-6.14 LTS). **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 2f249a4..8c8c51c 100644 --- a/docs/troubleshooting/performance.md +++ b/docs/troubleshooting/performance.md @@ -311,14 +311,14 @@ See "GPU Locked at 1500MHz" section above. - Previously working setup suddenly has poor performance after kernel update - Random GPU crashes under load - System freezes during gaming -- Running kernel 6.15.0-6.15.6 or 6.17.8+ +- Running kernel 6.15.0-6.15.6 or 6.17.8-6.17.10 **Solution:** **Install Working Kernel** !!! danger "AVOID BROKEN KERNEL VERSIONS" - Kernel 6.15.0-6.15.6 and 6.17.8+ break GPU driver support. Use 6.15.7-6.17.7 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.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. **Arch/Manjaro:** ```bash @@ -686,7 +686,7 @@ rpm-ostree rollback Use this checklist to verify your system is properly configured: - [ ] Mesa version 25.1.3 or higher -- [ ] Kernel 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+) +- [ ] 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) - [ ] GPU governor installed and running (oberon or cyan-skillfish) - [ ] `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 70b95ff..d503679 100644 --- a/docs/troubleshooting/stability.md +++ b/docs/troubleshooting/stability.md @@ -8,7 +8,7 @@ This guide addresses system crashes, freezes, random reboots, and instability is Before diving into specific issues, check these common causes: -1. **Kernel version**: Are you running kernel 6.15.0-6.15.6 or 6.17.8+? (Known to cause GPU crashes) +1. **Kernel version**: Are you running kernel 6.15.0-6.15.6 or 6.17.8-6.17.10? (Known to cause GPU crashes) 2. **BIOS settings**: Did you clear CMOS after flashing BIOS? 3. **VRAM allocation**: Are you using 512MB dynamic with ZRAM enabled? 4. **IOMMU**: Is it disabled in BIOS? @@ -34,7 +34,7 @@ Before diving into specific issues, check these common causes: ```bash uname -r ``` - - **AVOID kernel 6.15.0-6.15.6 and 6.17.8+** - Known to cause random GPU crashes under load + - **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) - If on broken version, install working kernel immediately @@ -214,9 +214,9 @@ Before diving into specific issues, check these common causes: ### Broken Kernel Versions - GPU Driver Failures -**Symptoms**: Kernel panics, GPU errors in dmesg, system crashes under GPU load on 6.15.0-6.15.6 or 6.17.8+ +**Symptoms**: Kernel panics, GPU errors in dmesg, system crashes under GPU load on 6.15.0-6.15.6 or 6.17.8-6.17.10 -**Critical issue**: Kernel 6.15.0-6.15.6 and 6.17.8+ break GPU driver support for BC-250 +**Critical issue**: Kernel 6.15.0-6.15.6 and 6.17.8-6.17.10 break GPU driver support for BC-250 **Solution**: @@ -650,7 +650,7 @@ journalctl -f | grep -i "error\|fail\|crash\|amdgpu" ## Common Error Messages ### "GPU reset failed" -- **Cause**: Kernel 6.15.0-6.15.6 or 6.17.8+, overclocking instability, or GPU crash +- **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 ### "Out of memory" @@ -712,7 +712,7 @@ Silicon lottery is real - some boards are less stable than others. 1. **Check thermal paste every 6 months** (or use PTM7950) 2. **Clean heatsink fins** from dust buildup 3. **Verify fan operation** regularly -4. **Monitor kernel updates** (avoid 6.15.0-6.15.6 and 6.17.8+) +4. **Monitor kernel updates** (avoid 6.15.0-6.15.6 and 6.17.8-6.17.10) 5. **Back up working configurations** (BIOS settings, governor config) ### Documentation