Revert "fix: replace deprecated oberon-governor refs with cyan-skillfish-governor-smu"

This reverts commit 2925c62316.
2026-07-16 04:11:44 +00:00 · 2026-03-21 23:34:00 +01:00
parent 2925c62316
commit c99e298337
14 changed files with 283 additions and 152 deletions
--- a/README.md
+++ b/README.md
@@ -23,7 +23,7 @@
 - **Gaming compatibility** - tested games, settings, FPS data
 - **Driver setup** - RADV configuration, environment variables
 - **Community cases catalogue** - 145 case/enclosure designs, searchable and filterable
- **System configuration** - GPU governor (cyan-skillfish-governor-smu recommended), sensors, power management
+- **System configuration** - GPU governor (cyan-skillfish-governor-tt default, oberon-governor alternative), sensors, power management

 ## Building Locally

--- a/docs/bios/overclocking.md
+++ b/docs/bios/overclocking.md
@@ -427,11 +427,12 @@ Higher clocks mean more heat and power draw. Keep GPU below 85°C under load. Se

 **Check:**
 ```bash
-# Verify governor running
-systemctl status cyan-skillfish-governor-smu
+# Verify governor running (use whichever you installed)
+systemctl status cyan-skillfish-governor-tt
+# Or: systemctl status oberon-governor

 # Restart governor
-sudo systemctl restart cyan-skillfish-governor-smu
+sudo systemctl restart cyan-skillfish-governor-tt

 # Check applied settings
 cat /sys/class/drm/card1/device/pp_od_clk_voltage
--- a/docs/getting-started/quick-start.md
+++ b/docs/getting-started/quick-start.md
@@ -134,8 +134,9 @@ glxinfo | grep "OpenGL version"
 vulkaninfo | grep deviceName
 # Should show: AMD Radeon Graphics (RADV GFX1013)

-# Check governor running
-systemctl status cyan-skillfish-governor-smu
+# Check governor running (use whichever you installed)
+systemctl status cyan-skillfish-governor-tt
+# Or: systemctl status oberon-governor
 # Should show: active (running)

 # Check GPU frequency
--- a/docs/linux/arch.md
+++ b/docs/linux/arch.md
@@ -168,7 +168,7 @@ sudo ./bc520-manjaro.sh

 1. **Package Installation**
   - Installs base-devel, git, cmake, lm_sensors
-   - Installs build tools for GPU governor
+   - Installs build tools for Oberon governor

 2. **RADV Environment Configuration**
   - Creates `/etc/environment.d/99-radv-bc250.conf`:
@@ -189,8 +189,8 @@ sudo ./bc520-manjaro.sh
   - Creates `/etc/modules-load.d/nct6683-bc250.conf`
   - Enables temperature monitoring

-5. **GPU Governor**
-   - Installs GPU frequency governor
+5. **Oberon Governor**
+   - Clones and compiles governor
   - Enables dynamic frequency scaling (1000MHz-2000MHz+)
   - Without this, GPU is locked at 1500MHz

@@ -288,8 +288,10 @@ nvtop      # Real-time GPU monitoring
 ### Verify Governor Running

 ```bash
-# Check governor status:
-systemctl status cyan-skillfish-governor-smu
+# Use whichever governor you installed:
+systemctl status cyan-skillfish-governor-tt   # TT variant (recommended)
+systemctl status cyan-skillfish-governor-smu  # SMU variant
+systemctl status oberon-governor              # legacy
 ```

 ### Check Frequency Scaling
@@ -315,7 +317,7 @@ The `*` moves between frequencies based on load.

 **Manual start:**
 ```bash
-sudo systemctl restart cyan-skillfish-governor-smu
+sudo systemctl restart cyan-skillfish-governor-tt  # or oberon-governor
 ```

 ---
@@ -454,6 +456,7 @@ IgnorePkg = linux

 **Governor projects:**
 - [Cyan Skillfish Governor TT/SMU](https://github.com/filippor/cyan-skillfish-governor) (AUR, recommended)
+- [Oberon Governor](https://gitlab.com/mothenjoyer69/oberon-governor) (legacy)

 ---

--- a/docs/linux/bazzite.md
+++ b/docs/linux/bazzite.md
@@ -333,14 +333,15 @@ sudo systemctl restart cyan-skillfish-governor-tt
 **Solution:**

 ```bash
-# Check governor status
-systemctl status cyan-skillfish-governor-smu
+# Check governor status (use whichever you installed)
+systemctl status cyan-skillfish-governor-tt
+# Or: systemctl status oberon-governor

 # If not running:
-sudo systemctl enable --now cyan-skillfish-governor-smu.service
+sudo systemctl enable --now cyan-skillfish-governor-tt.service

 # Restart if running:
-sudo systemctl restart cyan-skillfish-governor-smu
+sudo systemctl restart cyan-skillfish-governor-tt

 # Verify frequency scaling
 cat /sys/class/drm/card1/device/pp_dpm_sclk
@@ -441,7 +442,7 @@ rpm-ostree rebase ostree-image-signed:docker://ghcr.io/vietsman/bazzite-gnome-pa
 - **Bazzite Official:** [bazzite.gg](https://bazzite.gg)
 - **Setup script:** [vietsman/bc250-documentation](https://github.com/vietsman/bc250-documentation)
 - **Patched images:** [vietsman/bazzite-patched](https://github.com/vietsman/bazzite-patched)
- **GPU Governor:** [cyan-skillfish-governor-smu](https://github.com/filippor/cyan-skillfish-governor) (recommended, no kernel patch needed)
+- **GPU Governor:** [cyan-skillfish-governor-tt](https://github.com/filippor/cyan-skillfish-governor) (recommended) or [oberon-governor](https://gitlab.com/mothenjoyer69/oberon-governor) (legacy)

 ---

--- a/docs/linux/cachyos.md
+++ b/docs/linux/cachyos.md
@@ -165,21 +165,20 @@ sudo systemctl enable --now cyan-skillfish-governor-tt.service
 systemctl status cyan-skillfish-governor-tt
 ```

-**Method 3: Build from source**
+**Method 3: Build oberon-governor from source (legacy)**
 ```bash
 # Install dependencies
 sudo pacman -S base-devel cmake git

 # Clone and build
-git clone https://github.com/filippor/cyan-skillfish-governor.git
-cd cyan-skillfish-governor
-git checkout smu
+git clone https://gitlab.com/mothenjoyer69/oberon-governor.git
+cd oberon-governor
 cmake .
 make -j$(nproc)
 sudo make install

 # Enable and start
-sudo systemctl enable --now cyan-skillfish-governor-smu.service
+sudo systemctl enable --now oberon-governor.service
 ```

 **Verify it's working:**
@@ -437,7 +436,7 @@ CachyOS now works well on BC-250 with standard installation. The complex custom
 - **CachyOS Website:** [cachyos.org](https://cachyos.org/)
 - **CachyOS Wiki:** [wiki.cachyos.org](https://wiki.cachyos.org/)
 - **CachyOS GitHub:** [github.com/CachyOS](https://github.com/CachyOS)
- **GPU Governor:** [cyan-skillfish-governor-smu](https://github.com/filippor/cyan-skillfish-governor) (recommended, no kernel patch needed)
+- **GPU Governor:** [cyan-skillfish-governor](https://github.com/filippor/cyan-skillfish-governor) (recommended) or [oberon-governor](https://gitlab.com/mothenjoyer69/oberon-governor) (legacy)

 ---

--- a/docs/linux/debian.md
+++ b/docs/linux/debian.md
@@ -210,29 +210,50 @@ A GPU governor is required for proper GPU frequency scaling.

 The SMU governor is available as a .deb package from [filippor's COPR](https://github.com/filippor/cyan-skillfish-governor). It bypasses kernel patching entirely.

-**Option 2: Build cyan-skillfish-governor-smu from source**
+**Option 2: Build oberon-governor from source (legacy)**

 ```bash
 # Install dependencies
-sudo apt install build-essential cmake git libdrm-dev
+sudo apt install build-essential cmake git libdrm-dev libyaml-cpp-dev

 # Clone and build
-git clone https://github.com/filippor/cyan-skillfish-governor.git
-cd cyan-skillfish-governor
-git checkout smu
+git clone https://gitlab.com/mothenjoyer69/oberon-governor.git
+cd oberon-governor
 cmake .
 make -j$(nproc)
 sudo make install

-# Enable and start
+# Create systemd service
+sudo nano /etc/systemd/system/oberon-governor.service
+```
+
+Add the following content:
+
+```ini
+[Unit]
+Description=Oberon GPU Governor
+After=multi-user.target
+
+[Service]
+Type=simple
+ExecStart=/usr/local/bin/oberon-governor
+Restart=on-failure
+
+[Install]
+WantedBy=multi-user.target
+```
+
+Enable and start:
+
+```bash
 sudo systemctl daemon-reload
-sudo systemctl enable --now cyan-skillfish-governor-smu.service
+sudo systemctl enable --now oberon-governor.service
 ```

 Verify:

 ```bash
-systemctl status cyan-skillfish-governor-smu
+systemctl status oberon-governor
 cat /sys/class/drm/card1/device/pp_dpm_sclk
 ```

@@ -350,8 +371,8 @@ uname -r
 ### Check Governor

 ```bash
-# Service status
-systemctl status cyan-skillfish-governor-smu
+# Service status (use whichever you installed)
+systemctl status cyan-skillfish-governor-smu  # or oberon-governor

 # GPU frequency
 cat /sys/class/drm/card1/device/pp_dpm_sclk
@@ -472,14 +493,15 @@ sudo apt install -t experimental mesa-vulkan-drivers libgl1-mesa-dri --reinstall
 ### Governor Not Working

 ```bash
-# Check service
-systemctl status cyan-skillfish-governor-smu
+# Check service (use whichever you installed)
+systemctl status oberon-governor          # legacy
+systemctl status cyan-skillfish-governor-smu  # SMU variant

 # Check logs
-journalctl -u cyan-skillfish-governor-smu -f
+journalctl -u oberon-governor -f

 # Restart service
-sudo systemctl restart cyan-skillfish-governor-smu
+sudo systemctl restart oberon-governor
 ```

 ---
@@ -521,7 +543,7 @@ sudo apt install htop
 - **Debian:** [debian.org](https://www.debian.org/)
 - **PikaOS:** [pikaos.org](https://pikaos.org)
 - **Xanmod Kernel:** [xanmod.org](https://xanmod.org/)
- **GPU Governor:** [cyan-skillfish-governor-smu](https://github.com/filippor/cyan-skillfish-governor) (recommended, no kernel patch needed)
+- **GPU Governor:** [cyan-skillfish-governor](https://github.com/filippor/cyan-skillfish-governor) (recommended) or [oberon-governor](https://gitlab.com/mothenjoyer69/oberon-governor) (legacy)

 ---

@@ -537,8 +559,8 @@ glxinfo | grep "OpenGL version"
 # Check GPU
 vulkaninfo | grep deviceName

-# Check governor
-systemctl status cyan-skillfish-governor-smu
+# Check governor (use whichever you installed)
+systemctl status cyan-skillfish-governor-smu  # or oberon-governor

 # Check GPU frequency
 cat /sys/class/drm/card1/device/pp_dpm_sclk
--- a/docs/linux/distributions.md
+++ b/docs/linux/distributions.md
@@ -82,8 +82,7 @@ Choosing the right Linux distribution for your BC-250 is important for a smooth

 ```bash
 # After installation, install governor:
-rpm-ostree install cyan-skillfish-governor-smu
-sudo systemctl enable --now cyan-skillfish-governor-smu.service
+curl -s https://raw.githubusercontent.com/vietsman/bc250-documentation/refs/heads/main/oberon-setup.sh | sudo sh

 # Pin working version after successful boot:
 rpm-ostree pin 0
--- a/docs/linux/fedora.md
+++ b/docs/linux/fedora.md
@@ -131,8 +131,17 @@ sudo systemctl enable --now cyan-skillfish-governor-tt
 !!!info "Governor Package Update"
    The `filippor/bazzite` COPR now provides `cyan-skillfish-governor-tt` (Skillfish-TT optimized), which is confirmed stable as of Dec 2025. This is now the community default (Jan 2026+).

-!!!tip "SMU Variant (No Kernel Patch Needed)"
-    The `filippor/bazzite` COPR also provides `cyan-skillfish-governor-smu`, which manages GPU frequency via SMU firmware and does not require any kernel patch. Install with `sudo dnf install cyan-skillfish-governor-smu`.
+!!!info "Alternative COPR Option"
+    You can also use `@exotic-soc/oberon-governor` for the original oberon-governor package if preferred.
+
+**Option 2: Build oberon-governor from source (legacy)**
+
+```bash
+git clone https://gitlab.com/mothenjoyer69/oberon-governor.git
+cd oberon-governor
+cmake . && make && sudo make install
+sudo systemctl enable --now oberon-governor.service
+```

 ### Step 5: Configure Sensors

--- a/docs/reference/quick-reference.md
+++ b/docs/reference/quick-reference.md
@@ -169,23 +169,22 @@ The governor controls GPU frequency and voltage. **Required for gaming performan
 ### Installation

 ```bash
-# Fedora (recommended):
+# Fedora/Bazzite (recommended):
 sudo dnf copr enable filippor/bazzite
-sudo dnf install cyan-skillfish-governor-smu
-sudo systemctl enable --now cyan-skillfish-governor-smu.service
+sudo dnf install cyan-skillfish-governor-tt
+sudo systemctl enable --now cyan-skillfish-governor-tt.service

-# Bazzite:
-rpm-ostree install cyan-skillfish-governor-smu
-sudo systemctl enable --now cyan-skillfish-governor-smu.service
+# Bazzite (automated script):
+curl -s https://raw.githubusercontent.com/vietsman/bc250-documentation/refs/heads/main/oberon-setup.sh | sudo sh

-# Arch/CachyOS:
+# Arch/CachyOS (SMU - no kernel patch needed):
 yay -S cyan-skillfish-governor-smu
 sudo systemctl enable --now cyan-skillfish-governor-smu.service
 ```

 ### Configuration

-Edit `/etc/cyan-skillfish-governor-smu/config.toml`:
+Edit `/etc/cyan-skillfish-governor-tt/config.toml`:

 ```toml
 # Safe starting point:
@@ -259,18 +258,19 @@ sudo reboot
 ### Governor Management

 ```bash
-# Check status
-systemctl status cyan-skillfish-governor-smu
+# Check status (use whichever you installed)
+systemctl status cyan-skillfish-governor-tt
+# Or: systemctl status oberon-governor

 # Start/stop
-sudo systemctl start cyan-skillfish-governor-smu
-sudo systemctl stop cyan-skillfish-governor-smu
+sudo systemctl start cyan-skillfish-governor-tt
+sudo systemctl stop cyan-skillfish-governor-tt

 # Restart after config change
-sudo systemctl restart cyan-skillfish-governor-smu
+sudo systemctl restart cyan-skillfish-governor-tt

 # View logs
-journalctl -u cyan-skillfish-governor-smu -f
+journalctl -u cyan-skillfish-governor-tt -f
 ```

 ---
@@ -373,7 +373,7 @@ RADV_DEBUG=nohiz %command%
 ### Official Documentation
 - **GitHub:** https://github.com/mothenjoyer69/bc250-documentation
 - **BIOS Repo:** https://gitlab.com/TuxThePenguin0/bc250-bios/
- **Governor:** [Cyan Skillfish Governor SMU](https://github.com/filippor/cyan-skillfish-governor) (recommended)
+- **Governor:** Multiple forks (Oberon, Cyan Skillfish)

 ### Community
 - **Discord:** Active community, link in GitHub
@@ -382,7 +382,8 @@ RADV_DEBUG=nohiz %command%
 ### Key Contributors
 - mothenjoyer69 - Setup scripts
 - Average Data Hoarder - Modded BIOS
- FilippoR - Cyan Skillfish Governor, COPR packages, Bazzite integration
+- Segfault - Oberon Governor
+- FilippoR - COPR packages, Bazzite integration

 ---

--- a/docs/system/governor.md
+++ b/docs/system/governor.md
@@ -75,12 +75,18 @@ The GPU governor is essential for BC-250 performance, enabling dynamic frequency

 **Repository:** [github.com/filippor/cyan-skillfish-governor (smu branch)](https://github.com/filippor/cyan-skillfish-governor/tree/smu)

-### Oberon Governor (Deprecated)
+### Oberon Governor (Legacy — Still Stable)

 **Developer:** mothenjoyer69 / TuxThePenguin0
 **Type:** Two-state governor (min/max frequency)
-**Status:** Deprecated — use cyan-skillfish-governor-smu instead

+**Features:**
+- Simple configuration
+- Proven stability
+- Low CPU overhead (0.4%)
+- Binary states: 1000 MHz idle, 2000 MHz load
+
+**COPR:** `@exotic-soc/oberon-governor`
 **Repository:** [gitlab.com/mothenjoyer69/oberon-governor](https://gitlab.com/mothenjoyer69/oberon-governor)

 ### NexGen3D Setup Script (Bazzite Beginners)
@@ -106,7 +112,7 @@ Installs cyan-skillfish-governor-tt + zram + CPU mitigations. De facto standard
 **Repository:** [github.com/ZEROAESQUERDA/PS5GPU-BC250](https://github.com/ZEROAESQUERDA/PS5GPU-BC250)

 !!!warning "Disable Other Governors First"
-    You must disable any running GPU governor (cyan-skillfish-governor-smu, cyan-skillfish-governor-tt) before using PS5GPU-BC250. Running multiple frequency controllers simultaneously will cause conflicts.
+    You must disable any running GPU governor (oberon, cyan-skillfish) before using PS5GPU-BC250. Running multiple frequency controllers simultaneously will cause conflicts.

 ---

@@ -151,7 +157,9 @@ sudo systemctl enable --now cyan-skillfish-governor-smu.service
    Using COPR packages means you don't need to manually compile the governor from source. The packages are pre-built and maintained.

 !!!info "COPR Package Status"
-    The `filippor/bazzite` COPR provides `cyan-skillfish-governor-smu` and `cyan-skillfish-governor-tt`, confirmed working as of Dec 2025–Mar 2026. The SMU variant is recommended as it requires no kernel patch.
+    The `filippor/bazzite` COPR provides `cyan-skillfish-governor-tt` which is confirmed working as of Dec 2025–Mar 2026.
+
+    **Use `@exotic-soc/oberon-governor`** for the original Oberon governor - this is the working package that properly handles the BC-250's sysfs interface.

 ### Option 2: Build from Source (All Distros)

@@ -165,16 +173,15 @@ sudo dnf install -y libdrm-devel cmake make gcc-c++ git
 sudo pacman -S base-devel cmake git

 # Debian/Ubuntu
-sudo apt install build-essential cmake git libdrm-dev
+sudo apt install build-essential cmake git libdrm-dev libyaml-cpp-dev
 ```

 **Clone and Build:**

 ```bash
 # Clone repository
-git clone https://github.com/filippor/cyan-skillfish-governor.git
-cd cyan-skillfish-governor
-git checkout smu
+git clone https://gitlab.com/mothenjoyer69/oberon-governor.git
+cd oberon-governor

 # Build
 cmake . && make
@@ -183,21 +190,20 @@ cmake . && make
 sudo make install

 # Enable service
-sudo systemctl enable --now cyan-skillfish-governor-smu.service
+sudo systemctl enable --now oberon-governor.service
 ```

-### Option 3: Bazzite (rpm-ostree)
+### Option 3: Bazzite Automated Script

 ```bash
-# Install via rpm-ostree
-rpm-ostree install cyan-skillfish-governor-smu
-sudo systemctl enable --now cyan-skillfish-governor-smu.service
+# Download and run setup script
+curl -s https://raw.githubusercontent.com/vietsman/bc250-documentation/refs/heads/main/oberon-setup.sh | sudo sh

 # Verify installation
-systemctl status cyan-skillfish-governor-smu
+systemctl status oberon-governor
 ```

-### Option 4: Arch/CachyOS (AUR)
+### Option 4: Cyan-Skillfish Governor (Other Distros)

 **Arch/CachyOS:**
 ```bash
@@ -217,15 +223,66 @@ sudo dpkg -i cyan-skillfish-governor-tt_amd64.deb

 ## Configuration

-### Cyan Skillfish Governor SMU Config
+### Oberon Governor Config

-**Config File:** `/etc/cyan-skillfish-governor-smu/config.toml`
+**Config File:** `/etc/oberon-config.yaml`

-The SMU governor manages GPU frequency via SMU firmware calls and does not require any kernel patch. See the [GitHub repository](https://github.com/filippor/cyan-skillfish-governor/tree/smu) for configuration options.
+**Default Configuration:**
+```yaml
+opps:
+  frequency:
+    min: 1000    # Minimum GPU frequency (MHz)
+    max: 2000    # Maximum GPU frequency (MHz)
+  voltage:
+    min: 700     # Minimum voltage (mV)
+    max: 1000    # Maximum voltage (mV)
+```
+
+**Safe Overclocking Config:**
+```yaml
+opps:
+  frequency:
+    min: 1000
+    max: 2175    # Slight overclock
+  voltage:
+    min: 700
+    max: 1025    # Slightly higher voltage for stability
+```

 **Restart after changes:**
 ```bash
-sudo systemctl restart cyan-skillfish-governor-smu
+sudo systemctl restart oberon-governor
+```
+
+### Filip's Multi-Step Config
+
+**Config File:** `/etc/oberon-config.yaml`
+
+**Advanced Multi-Step Configuration:**
+
+!!!warning "Requires Kernel Patch (or SMU Governor)"
+    The 350 MHz minimum frequency requires either the GPU frequency range kernel patch (pre-included in Bazzite) or the SMU governor. On stock kernels without the patch, the governor will crash with `std::__ios_failure`. Use `min: 1000` on stock kernels, or switch to `cyan-skillfish-governor-smu` which bypasses the patch requirement entirely.
+
+```yaml
+opps:
+  frequency:
+    min: 350     # Requires kernel patch! Use 1000 on stock kernel
+    max: 2175    # Overclocked maximum
+  voltage:
+    min: 700
+    max: 1025
+  steps: 24      # Number of frequency steps (creates 25 levels: 0-24)
+
+governor:
+  polling_delay_ms: 50        # How often to check GPU load
+  up_threshold_high: 85       # Load % to jump to maximum
+  up_threshold_low: 70        # Load % to step up one level
+  down_threshold_high: 45     # Load % to step down one level
+  down_threshold_low: 5       # Load % to drop to minimum
+  gfx_temp_soft_lim: 80       # Temp to step down (°C)
+  gfx_temp_hard_lim: 90       # Temp to drop to minimum (°C)
+  soc_temp_hard_lim: 90       # SoC temp limit (°C)
+  overheat_reset_ms: 10000    # Cool-down time after overheat
 ```

 ### Cyan-Skillfish Governor TT Config
@@ -274,8 +331,9 @@ echo vc 0 2000 1000 > /sys/devices/pci0000:00/0000:00:08.1/0000:01:00.0/pp_od_cl
 ### Check Governor is Running

 ```bash
-# Check service status
-systemctl status cyan-skillfish-governor-smu
+# Check service status (use whichever you installed)
+systemctl status cyan-skillfish-governor-tt
+# Or: systemctl status oberon-governor

 # Should show: active (running)
 ```
@@ -339,30 +397,35 @@ mangohud %command%  # Steam launch option

 **Check service:**
 ```bash
-# Check governor status:
-sudo systemctl status cyan-skillfish-governor-smu
+# Check whichever governor you installed:
+sudo systemctl status cyan-skillfish-governor-tt
+# Or: sudo systemctl status oberon-governor

 # Check logs
-sudo journalctl -u cyan-skillfish-governor-smu
+sudo journalctl -u cyan-skillfish-governor-tt
+# Or: sudo journalctl -u oberon-governor
 ```

 **Solutions:**

 **1. Enable service:**
 ```bash
-sudo systemctl enable cyan-skillfish-governor-smu
+sudo systemctl enable cyan-skillfish-governor-tt
+# Or: sudo systemctl enable oberon-governor
 ```

 **2. Check config file exists:**
 ```bash
-ls -l /etc/cyan-skillfish-governor-smu/config.toml
+ls -l /etc/cyan-skillfish-governor-tt/config.toml
+# Or: ls -l /etc/oberon-config.yaml

 # If missing, reinstall governor
 ```

 **3. Manual restart:**
 ```bash
-sudo systemctl restart cyan-skillfish-governor-smu
+sudo systemctl restart cyan-skillfish-governor-tt
+# Or: sudo systemctl restart oberon-governor
 ```

 **Workaround (Arch/CachyOS):**
@@ -377,18 +440,20 @@ Some users report governor doesn't activate until GPU is used:
 1. Governor not running
 2. Config file missing/incorrect
 3. Governor binary not installed
-4. Wrong COPR package installed
+4. Wrong COPR package installed (filippor vs exotic-soc)

 **Debug:**
 ```bash
-# Check governor binary exists
-which cyan-skillfish-governor-smu
+# Check governor binary exists (use whichever you installed)
+which cyan-skillfish-governor-tt
+# Or: which oberon-governor

 # Check config
-cat /etc/cyan-skillfish-governor-smu/config.toml
+cat /etc/cyan-skillfish-governor-tt/config.toml
+# Or: cat /etc/oberon-config.yaml

 # Check for errors in logs
-sudo journalctl -u cyan-skillfish-governor-smu --no-pager -n 20
+sudo journalctl -u cyan-skillfish-governor-tt --no-pager -n 20
 ```

 ### Governor Crashes with iostream Error
@@ -400,24 +465,27 @@ terminate called after throwing an instance of 'std::__ios_failure'
 Aborted
 ```

-**Cause:** Legacy oberon-governor package is incompatible with kernel 6.17+.
+**Cause:** Wrong COPR package. The `filippor:bazzite` oberon-governor package is incompatible with kernel 6.17+.

-**Solution:** Migrate to cyan-skillfish-governor-smu:
+**Solution:**
 ```bash
-# Remove old oberon-governor
-sudo systemctl stop oberon-governor
-sudo systemctl disable oberon-governor
+# Remove broken package
 sudo dnf remove oberon-governor

-# Install cyan-skillfish-governor-smu
-sudo dnf copr enable filippor/bazzite
-sudo dnf install cyan-skillfish-governor-smu
+# Disable broken COPR
+sudo dnf copr disable filippor/bazzite
+
+# Add working COPR
+sudo dnf copr enable @exotic-soc/oberon-governor
+
+# Install working package
+sudo dnf install oberon-governor

 # Enable and start
-sudo systemctl enable --now cyan-skillfish-governor-smu.service
+sudo systemctl enable --now oberon-governor.service

 # Verify it's running
-systemctl status cyan-skillfish-governor-smu
+systemctl status oberon-governor
 ```

 **Verify fix:**
@@ -458,15 +526,18 @@ cat /sys/class/drm/card1/device/pp_dpm_sclk
 **Solutions:**

 **1. Increase voltage:**
-```bash
-# Edit /etc/cyan-skillfish-governor-smu/config.toml
-# Increase max voltage from 1000 to 1050 mV
+```yaml
+# Edit /etc/oberon-config.yaml
+opps:
+  voltage:
+    max: 1050  # Increase from 1000 to 1050
 ```

 **2. Reduce max frequency:**
-```bash
-# Edit /etc/cyan-skillfish-governor-smu/config.toml
-# Reduce max frequency from 2000 to 1900 MHz
+```yaml
+opps:
+  frequency:
+    max: 1900  # Reduce from 2000
 ```

 **3. Check temperatures:**
@@ -478,46 +549,57 @@ sensors
 ### Governor High CPU Usage

 **Normal CPU Usage:**
- Cyan-Skillfish SMU: 0.9-1.3% CPU
- Cyan-Skillfish TT: 0.9-1.3% CPU
+- Oberon original: 0.4% CPU
+- Filip's enhanced: 0.4-1.0% CPU
+- Cyan-Skillfish: 0.9-1.3% CPU

 **If CPU usage > 2%:**

 **Check polling interval:**
-```toml
-# Reduce polling frequency in /etc/cyan-skillfish-governor-smu/config.toml
-# Increase polling interval
+```yaml
+# Reduce polling frequency
+governor:
+  polling_delay_ms: 100  # Increase from 50
 ```

 **Check for bugs:**
 ```bash
-# View governor logs
-sudo journalctl -u cyan-skillfish-governor-smu -f
+# View governor logs (use whichever you installed)
+sudo journalctl -u cyan-skillfish-governor-tt -f
+# Or: sudo journalctl -u oberon-governor -f
 ```

 ## Performance Comparison

-| Governor | Idle Freq | Max Freq | CPU Usage | Response Time | Kernel Patch | Performance |
-|----------|-----------|----------|-----------|---------------|--------------|-------------|
-| **None** | 1500 MHz | 1500 MHz | 0% | N/A | No | ⭐⭐ |
-| **Cyan-Skillfish SMU** | Variable | 2000+ MHz | 0.9-1.3% | 24ms | No | ⭐⭐⭐⭐⭐ |
-| **Cyan-Skillfish TT** | Variable | 2000+ MHz | 0.9-1.3% | 24ms | Yes | ⭐⭐⭐⭐⭐ |
+| Governor | Idle Freq | Max Freq | CPU Usage | Response Time | Performance |
+|----------|-----------|----------|-----------|---------------|-------------|
+| **None** | 1500 MHz | 1500 MHz | 0% | N/A | ⭐⭐ |
+| **Oberon** | 1000 MHz | 2000 MHz | 0.4% | 100ms | ⭐⭐⭐⭐ |
+| **Filip's** | 350-1000 MHz | 2175 MHz | 0.4-1.0% | 50-100ms | ⭐⭐⭐⭐⭐ |
+| **Cyan-Skillfish** | Variable | 2000+ MHz | 0.9-1.3% | 24ms | ⭐⭐⭐⭐⭐ |

 ## Governor Comparison

-### When to Use Cyan-Skillfish SMU (Recommended)
+### When to Use Oberon (Original)

- **No kernel patch needed:** Works on any distro out-of-box
- **SMU firmware control:** Bypasses kernel frequency/voltage limits
- **Easy to install:** Available on AUR, COPR, .deb, .rpm, Nix
- **Best for:** All users, especially on Arch/CachyOS/Debian where kernel patching is inconvenient
+- **Simple setup:** Just works out-of-box
+- **Proven stability:** Most tested
+- **Low overhead:** Minimal CPU usage
+- **Best for:** Beginners, stability-focused builds

-### When to Use Cyan-Skillfish TT
+### When to Use Filip's Enhanced

- **Maximum control:** Precise frequency control with multiple voltage points
- **Best efficiency:** Continuous scaling with thermal throttling awareness
- **Advanced config:** Multiple voltage/frequency safe-points
- **Best for:** Advanced users, overclockers (requires kernel frequency range patch)
+- **Better performance:** Multi-step scaling
+- **Available as package:** Easy to install
+- **Good balance:** Performance + stability
+- **Best for:** Most users, gaming builds
+
+### When to Use Cyan-Skillfish
+
+- **Maximum control:** Precise frequency control
+- **Best efficiency:** Continuous scaling
+- **Advanced config:** Multiple voltage points
+- **Best for:** Advanced users, overclockers

 ## Overclocking with Governor

@@ -526,8 +608,9 @@ sudo journalctl -u cyan-skillfish-governor-smu -f
 **Step 1: Test Maximum Stable Frequency**

 ```bash
-# Stop governor
-sudo systemctl stop cyan-skillfish-governor-smu
+# Stop governor (use whichever you installed)
+sudo systemctl stop cyan-skillfish-governor-tt
+# Or: sudo systemctl stop oberon-governor

 # Manually set test frequency
 echo vc 0 2100 1050 > /sys/devices/pci0000:00/0000:00:08.1/0000:01:00.0/pp_od_clk_voltage
@@ -539,15 +622,20 @@ echo vc 0 2100 1050 > /sys/devices/pci0000:00/0000:00:08.1/0000:01:00.0/pp_od_cl

 **Step 2: Update Governor Config**

-```bash
-# Edit /etc/cyan-skillfish-governor-smu/config.toml
-# Set your stable max frequency (e.g. 2100 MHz) and voltage (e.g. 1050 mV)
+```yaml
+# /etc/oberon-config.yaml
+opps:
+  frequency:
+    max: 2100  # Your stable frequency
+  voltage:
+    max: 1050  # Your stable voltage
 ```

 **Step 3: Restart and Test**

 ```bash
-sudo systemctl restart cyan-skillfish-governor-smu
+sudo systemctl restart cyan-skillfish-governor-tt
+# Or: sudo systemctl restart oberon-governor

 # Test with games/benchmarks
 # Monitor temperatures
--- a/docs/system/power.md
+++ b/docs/system/power.md
@@ -141,9 +141,9 @@ Apply changes:
 sudo systemctl restart cyan-skillfish-governor-tt
 ```

-**Cyan Skillfish Governor SMU Configuration:**
+**Oberon Governor Configuration (legacy):**

-Default configuration file: `/etc/cyan-skillfish-governor-smu/config.toml` — see [Governor page](governor.md) for details.
+Default configuration file: `/etc/oberon-config.yaml` — see [Governor page](governor.md) for details.

 **More Granular Control:**

@@ -475,24 +475,25 @@ voltage = 1035

 ### Governor Behavior Comparison

-**Cyan Skillfish Governor SMU (recommended):**
- Manages clock speeds through SMU firmware calls
- No kernel patch needed on any distro
- Available on AUR, COPR, .deb, .rpm, Nix
- Best option for all users
+**Oberon Governor (legacy):**
+- Binary mode: Switches between min and max frequency
+- Set point: 20-40% GPU load (with hysteresis)
+- Response time: 100 ms to burst to max
+- CPU usage: 0.4% idle, 0.4% under load
+- Simple, stable, proven

-**Cyan Skillfish Governor TT (alternative):**
+**Cyan Skillfish Governor TT (recommended):**
 - Continuous adjustment between multiple frequency steps
 - Set point: 70-95% GPU load (configurable)
 - Response time: 20-24 ms to burst to max
 - CPU usage: 0.9% idle, 1.3% under load
 - Granular control, more responsive, thermal throttling aware
- Requires kernel frequency range patch (pre-included in Bazzite)

 **Which to Choose:**

- **Cyan Skillfish SMU**: Recommended default — no kernel patches needed, bypasses kernel frequency/voltage limits via SMU firmware
- **Cyan Skillfish TT**: Alternative — better power efficiency, smoother performance, thermal throttling support (requires kernel patch)
+- **Cyan Skillfish TT**: Recommended default — better power efficiency, smoother performance, thermal throttling support
+- **Cyan Skillfish SMU**: No kernel patches needed — bypasses kernel frequency/voltage limits via SMU firmware
+- **Oberon**: Legacy option — lower CPU overhead, simpler config

 ---

@@ -554,8 +555,9 @@ max_voltage = 1025    # Increased from 1000
 **Solutions:**
 ```bash
 # Increase voltage in 25 mV steps
-# Edit /etc/cyan-skillfish-governor-smu/config.toml
-# Increase max voltage until stable
+# Edit /etc/oberon-config.yaml
+  - voltage:
+    - max: 1025  # Increase until stable
 ```

 **4. High Idle Power (>100W)**
@@ -736,7 +738,9 @@ Expected results:

 **Check Governor Status:**
 ```bash
-systemctl status cyan-skillfish-governor-smu
+systemctl status cyan-skillfish-governor-tt
+# or if using legacy governor:
+# systemctl status oberon-governor
 ```

 **Check Current Power State:**
@@ -789,6 +793,7 @@ sensors | grep PPT

 **Governor Projects:**
 - [Cyan Skillfish Governor TT/SMU](https://github.com/filippor/cyan-skillfish-governor) (recommended)
+- [Oberon Governor](https://gitlab.com/mothenjoyer69/oberon-governor) (legacy)

 **Power Monitoring:**
 - [CoolerControl](https://gitlab.com/coolercontrol/coolercontrol)
--- a/docs/troubleshooting/display.md
+++ b/docs/troubleshooting/display.md
@@ -254,7 +254,7 @@ sudo systemctl restart cyan-skillfish-governor-tt
 Test with lower power limit:
 ```bash
 # Limit max frequency to reduce power draw
-# Edit /etc/cyan-skillfish-governor-smu/config.toml
+# Edit /etc/oberon-config.yaml
 max_frequency: 1500
 ```

--- a/docs/troubleshooting/performance.md
+++ b/docs/troubleshooting/performance.md
@@ -23,7 +23,9 @@ lspci -k | grep -A 3 VGA
 glxinfo | grep "OpenGL version"

 # Check governor status
-systemctl status cyan-skillfish-governor-smu
+systemctl status cyan-skillfish-governor-tt
+# or if using legacy governor:
+# systemctl status oberon-governor
 ```

 ---