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
This commit is contained in:
Martin
2026-03-18 23:27:16 +01:00
parent 180f5dab6f
commit 45eaf62280
17 changed files with 166 additions and 163 deletions

View File

@@ -241,9 +241,9 @@ If GPU >90°C:
If using custom governor settings:
```bash
# Edit /etc/oberon-config.yaml
# Edit governor config (e.g., /etc/cyan-skillfish-governor-tt/config.toml)
# Reduce max_frequency or increase voltage
sudo systemctl restart oberon-governor
sudo systemctl restart cyan-skillfish-governor-tt
```
**3. Power Supply Issues**

View File

@@ -22,10 +22,10 @@ lspci -k | grep -A 3 VGA
# Verify Mesa version
glxinfo | grep "OpenGL version"
# Check governor status (if installed)
systemctl status oberon-governor
# or
# Check governor status
systemctl status cyan-skillfish-governor-tt
# or if using legacy governor:
# systemctl status oberon-governor
```
---
@@ -654,7 +654,7 @@ 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)
- [ ] GPU governor installed and running (cyan-skillfish-governor-tt or oberon-governor)
- [ ] 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
- [ ] `glxinfo` shows RADV driver, not llvmpipe

View File

@@ -53,15 +53,12 @@ Before diving into specific issues, check these common causes:
- Some boards freeze at 60-65°C if cooling is inadequate
4. **Test with locked frequency**
- Edit `/etc/oberon-config.yaml`:
```yaml
opps:
- frequency:
- min: 1500
- max: 1500
- voltage:
- min: 900
- max: 900
- Edit your governor config (e.g., `/etc/cyan-skillfish-governor-tt/config.toml`):
```toml
min_frequency = 1500
max_frequency = 1500
min_voltage = 900
max_voltage = 900
```
- Restart governor: `systemctl restart cyan-skillfish-governor-tt`
- If stable at locked frequency, it's a governor tuning issue
@@ -134,6 +131,26 @@ Before diving into specific issues, check these common causes:
```
Note: These are NOT universal - test your own board
### Black Screen on GPU Reset (Governor Running)
**Symptoms**: GPU crashes, screen goes black, system never recovers — hard reboot required
**Cause**: If the GPU crashes while the governor (cyan-skillfish) is running, the governor continues writing to sysfs during the GPU reset attempt, preventing recovery. The GPU gets stuck in a failed reset loop and the screen stays black.
**Workaround**:
1. **Disable governor before playing crash-prone games**
```bash
sudo systemctl stop cyan-skillfish-governor-tt
```
Re-enable after: `sudo systemctl start cyan-skillfish-governor-tt`
2. **Use stable voltage/frequency settings** to reduce the chance of GPU crashes in the first place — see the voltage-related instability section below.
*Source: Discord user nohanmv, Feb 26 2026*
---
### Governor-Related Instability
**Symptoms**: Random crashes during load changes, frequency spikes, voltage issues
@@ -147,21 +164,18 @@ Before diving into specific issues, check these common causes:
2. **Voltage too low at startup**
- Some boards crash on "default governor settings"
- Edit `/etc/oberon-config.yaml` to increase min voltage
- Edit your governor config to increase min voltage
- Quote: "Hey all, my board crashes on default governor settings. Did I loose the silicon lottery?"
3. **Frequency/voltage mismatch**
- Symptom: Crashes when GPU load increases/decreases
- Solution: Reduce frequency range or increase voltage headroom
- Example fix:
```yaml
opps:
- frequency:
- min: 1000
- max: 2000
- voltage:
- min: 750
- max: 1000
- Example fix (cyan-skillfish-governor-tt config.toml):
```toml
min_frequency = 1000
max_frequency = 2000
min_voltage = 750
max_voltage = 1000
```
---