Merge branch 'main' into 'main'

add CoreCtrl power fix guide + boot parameters (grub only for now), CoreCtrl profile guide

See merge request lvra/lvra.gitlab.io!53

content/docs/performance/_index.md

@@ -18,10 +18,50 @@ This is very important to avoid stuttering, do not skip this step if you use AMD
 ### The simple way: Use CoreCtrl
 
 - Install [CoreCtrl](https://gitlab.com/corectrl/corectrl)
+- select the Global Profile
 - Select your GPU on the top
 - Set Performance mode to Advanced
 - Set Power profile to VR
-- Set the GPU and Memory sliders to max
+
+#### solution for CoreCtrl GPU values being set to the minimum
+
+Set the GPU and Memory sliders to max, OR append the kernel parameter `amdgpu.ppfeaturemask=0xffffffff` to your bootloader configuration.
+
+##### append kernel parameter in bootloader configuration
+
+<details>
+<summary>Grub</summary>
+
+###### most distros
+
+- open the file `/etc/default/grub` in your preferred command line text editor as root
+- append `amdgpu.ppfeaturemask=0xffffffff` to `GRUB_CMDLINE_LINUX_DEFAULT`, ensuring you keep the other existing parameters
+- regenerate the bootloader configuration with `grub-mkconfig -o /boot/grub/grub.cfg` ran as super user
+- reboot your system
+
+###### via Grubby (Fedora based distros)
+
+- run  `grubby --update-kernel=ALL --args=amdgpu.ppfeaturemask=0xffffffff` as a super user
+- reboot your system
+
+###### via update-grub (ubuntu based distros)
+
+- open the file `/etc/default/grub` in your preferred command line text editor as root
+- append `amdgpu.ppfeaturemask=0xffffffff` to `GRUB_CMDLINE_LINUX_DEFAULT`, ensuring you keep the other existing parameters
+- run the command `update-grub` as super user
+- reboot your system
+
+</details>
+
+#### Setup CoreCtrl to automatically swap the GPU power profile to and from VR when a runtime is active
+
+some users may want to only have the VR power profile be applied when using VR, instead of having it enabled all the time, or having to manually disable it when not using VR.
+- create a new profile in CoreCtrl by pressing the '+' in the top right corner
+- (optional) name the new profile 'VR'
+- change the Activation method to 'Automatic'
+- set the executable name to either `wivrn_server` (wivrn), `vrcompositor` (steamVR), `vrcompositor.real` (ALVR), `monado-service` (monado) or `envision`
+- you may want to make multiple profiles if you wish to frequently swap between runtimes
+
 
 ### Enable VR profile using a script