Skip to content

Commit 1d3d638

Browse files
authored
content: update asusctl to 6.3.4, clarify suite architecture, fix image refs (#27)
- fix: bottom navigation issues - Bump asusctl and rog-control-center to 6.3.4 - Clarify architecture: asusd (backend daemon), asusctl (CLI frontend), - Replace lone "Luke Jones" mentions with "asus-linux team"; link to releases page at gitlab.com/asus-linux/asusctl/-/releases - Fix broken image reference: High-Tide.avif -> high-tide.avif (case sensitivity on Linux) - Add missing untracked images that were already referenced in content ## Summary <!-- What does this PR do? One or two sentences. --> ## Type of change <!-- Check all that apply --> - [ ] `feat` — new page or feature - [x] `fix` — bug fix (broken link, incorrect command, layout issue) - [x] `content` — update or improve existing content - [x] `docs` — changes to CONTRIBUTING, README, or meta documentation - [ ] `chore` — maintenance (dependencies, config, CI/CD) - [ ] `refactor` — restructuring without content changes - [x] `style` — formatting, whitespace, typos ## Checklist - [x] PR title follows the commit convention (e.g. `fix: correct nmcli command in eduroam guide`) - [x] Both EN and NL versions updated (if applicable) - [x] Images are in AVIF format (not PNG/JPG) - [x] No broken image references (`/images/*.avif` all exist in `static/images/`) - [x] Tested locally with `hugo server`
1 parent be4b644 commit 1d3d638

43 files changed

Lines changed: 556 additions & 357 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

content/_index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ toc: false
2525
<div class="hx-mt-6"></div>
2626

2727
{{< callout type="info" >}}
28-
**Personal documentation.** I'm not a developer or Linux expert just someone who switched to Linux on this laptop and figured things out along the way. I share what worked for me so others don't have to start from scratch. Everything here is at your own risk. Feel free to reach out if something doesn't work; I'm happy to think along. Running kernel 6.19.3-2 on CachyOS (Arch).
28+
**Personal documentation.** I'm not a developer or Linux expert, just someone who switched to Linux on this laptop and figured things out along the way. I share what worked for me so others don't have to start from scratch. Everything here is at your own risk. Feel free to reach out if something doesn't work; I'm happy to think along. Running kernel 6.19.3-2 on CachyOS (Arch).
2929
{{< /callout >}}
3030

3131
## Current System Configuration
@@ -66,7 +66,7 @@ toc: false
6666
>}}
6767
{{< hextra/feature-card
6868
title="Secure Boot"
69-
subtitle="Custom signing keys with sbctl, HSI:3 to HSI:4"
69+
subtitle="Custom signing keys with sbctl, UEFI Secure Boot enabled"
7070
icon="shield-check"
7171
link="docs/hardware/secure-boot"
7272
>}}

content/_index.nl.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ toc: false
2525
<div class="hx-mt-6"></div>
2626

2727
{{< callout type="info" >}}
28-
**Persoonlijke documentatie.** Ik ben geen developer of Linux-expertgewoon iemand die overgestapt is naar Linux op deze laptop en dingen uitzoekend onderweg. Ik deel wat werkte zodat anderen niet helemaal opnieuw hoeven te beginnen. Alles is op eigen risico. Kom je ergens niet uit, laat het gerust weten ik denk graag mee. Draait kernel 6.19.3-2 op CachyOS (Arch).
28+
**Persoonlijke documentatie.** Ik ben geen developer of Linux-expert, gewoon iemand die overgestapt is naar Linux op deze laptop en dingen uitzoekend onderweg. Ik deel wat werkte zodat anderen niet helemaal opnieuw hoeven te beginnen. Alles is op eigen risico. Kom je ergens niet uit, laat het gerust weten; ik denk graag mee. Draait kernel 6.19.3-2 op CachyOS (Arch).
2929
{{< /callout >}}
3030

3131
## Huidige Systeemconfiguratie
@@ -66,7 +66,7 @@ toc: false
6666
>}}
6767
{{< hextra/feature-card
6868
title="Secure Boot"
69-
subtitle="Aangepaste ondertekeningssleutels met sbctl, HSI:3 naar HSI:4"
69+
subtitle="Aangepaste ondertekeningssleutels met sbctl, UEFI Secure Boot ingeschakeld"
7070
icon="shield-check"
7171
link="docs/hardware/secure-boot"
7272
>}}

content/docs/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Everything I've documented while running CachyOS on the ROG Zephyrus G16. Start
3030
>}}
3131
{{< hextra/feature-card
3232
title="Secure Boot"
33-
subtitle="Custom signing keys with sbctl, HSI:3 to HSI:4"
33+
subtitle="Custom signing keys with sbctl, UEFI Secure Boot enabled"
3434
icon="shield-check"
3535
link="hardware/secure-boot"
3636
>}}

content/docs/_index.nl.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Alles wat ik heb opgeschreven tijdens het draaien van CachyOS op de ROG Zephyrus
3030
>}}
3131
{{< hextra/feature-card
3232
title="Secure Boot"
33-
subtitle="Aangepaste ondertekeningssleutels met sbctl, HSI:3 naar HSI:4"
33+
subtitle="Aangepaste ondertekeningssleutels met sbctl, UEFI Secure Boot ingeschakeld"
3434
icon="shield-check"
3535
link="hardware/secure-boot"
3636
>}}

content/docs/applications.md

Lines changed: 132 additions & 49 deletions
Large diffs are not rendered by default.

content/docs/applications.nl.md

Lines changed: 131 additions & 48 deletions
Large diffs are not rendered by default.

content/docs/getting-started.md

Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,12 @@
11
---
22
title: "Getting Started"
3-
weight: 2
3+
weight: 1
4+
next: docs/hardware/nvidia-driver-installation
45
---
56

6-
This is my personal setup documentation for the ROG Zephyrus G16 running CachyOS (Arch). I'm not a software engineer or developer just someone who switched to Linux and ran into a lot of things that didn't work out of the box. I figured I'd write it all down so others don't have to go through the same trial and error.
7+
This is my personal setup documentation for the ROG Zephyrus G16 running CachyOS (Arch). I'm not a software engineer or developer, just someone who switched to Linux and ran into a lot of things that didn't work out of the box. I figured I'd write it all down so others don't have to go through the same trial and error.
78

8-
If something here helps you, great. If you run into something I haven't covered, feel free to reach out I'm happy to think along.
9+
If something here helps you, great. If you run into something I haven't covered, feel free to reach out; I'm happy to think along.
910

1011
## Hardware
1112

@@ -26,21 +27,21 @@ If something here helps you, great. If you run into something I haven't covered,
2627

2728
After testing multiple distributions, I settled on CachyOS (Arch) as my daily driver. CachyOS is an Arch-based distribution with hardware-specific optimizations that make it stand out for the Zephyrus G16:
2829

29-
- **BORE/EEVDF scheduler** CachyOS ships with an improved CPU scheduler that provides better responsiveness and lower latency under mixed workloads
30-
- **Improved power management** — Better handling of suspend/resume and ACPI power states on AMD+NVIDIA hybrid setups
31-
- **Dynamic refresh rate support** — Out-of-the-box support for variable refresh rate on the ROG Nebula Display
32-
- **Built-in iGPU and dGPU drivers** — The AMD Radeon 890M and NVIDIA RTX 4060 work correctly from a fresh install, including GPU switching via `asusctl armoury`
33-
- **ASUS Linux patches** — Part of [Luke Jones'](https://asus-linux.org/) work has been merged into the Linux kernel mainline (the `asus-armoury` driver since 6.19), while additional ROG-specific patches and `asusctl` tooling improvements are carried by CachyOS. Both `asusctl` and `rog-control-center` are available directly from the CachyOS repos install two packages and you're done, no deep system configuration required. CachyOS currently ships the most complete set of optimizations for this hardware
30+
- **BORE/EEVDF scheduler**: CachyOS ships with an improved CPU scheduler that provides better responsiveness and lower latency under mixed workloads
31+
- **Improved power management**: better handling of suspend/resume and ACPI power states on AMD+NVIDIA hybrid setups
32+
- **Dynamic refresh rate support**: out-of-the-box support for variable refresh rate on the ROG Nebula Display
33+
- **Built-in iGPU and dGPU drivers**: the AMD Radeon 890M and NVIDIA RTX 4060 work correctly from a fresh install, including GPU switching via `asusctl armoury`
34+
- **ASUS Linux patches**: part of [Luke Jones'](https://asus-linux.org/) work has been merged into the Linux kernel mainline (the `asus-armoury` driver since 6.19), while additional ROG-specific patches and `asusctl` tooling improvements are carried by CachyOS. Both `asusctl` and `rog-control-center` are available directly from the CachyOS repos; install two packages and you're done, no deep system configuration required. CachyOS currently ships the most complete set of optimizations for this hardware
3435

35-
Fedora is a strong second a solid option if you prefer a more stable release cycle over rolling, and you're in good shape as long as you're on kernel 6.19 (already available on Fedora, but make sure to update). That said, CachyOS still feels more polished for this hardware: the CPU scheduler tuning (BORE/EEVDF), pre-configured NVIDIA driver support, and tighter integration with `asusctl` make day-to-day use more seamless out of the box.
36+
Fedora is a strong second, a solid option if you prefer a more stable release cycle over rolling, and you're in good shape as long as you're on kernel 6.19 (already available on Fedora, but make sure to update). That said, CachyOS still feels more polished for this hardware: the CPU scheduler tuning (BORE/EEVDF), pre-configured NVIDIA driver support, and tighter integration with `asusctl` make day-to-day use more seamless out of the box.
3637

3738
## CachyOS Kernel Manager
3839

39-
CachyOS ships the **CachyOS Kernel Manager** as a pre-installed GUI tool. It lets you manage installed kernels and configure the `sched-ext` scheduler the Linux kernel's extensible scheduler framework that allows userspace schedulers to replace the default one.
40+
CachyOS ships the **CachyOS Kernel Manager** as a pre-installed GUI tool. It lets you manage installed kernels and configure the `sched-ext` scheduler, the Linux kernel's extensible scheduler framework that allows userspace schedulers to replace the default one.
4041

4142
I use `scx_lavd` with the profile set to **Auto**. LAVD (Latency-criticality Aware Virtual Deadline) is a scheduler designed for mixed interactive and compute workloads, which makes it well-suited for a laptop used for both daily tasks and gaming.
4243

43-
![CachyOS Kernel Manager Configure sched-ext with scx_lavd](/images/cachyos-kernel-manager-sched-ext.avif)
44+
![CachyOS Kernel Manager - Configure sched-ext with scx_lavd](/images/cachyos-kernel-manager-sched-ext.avif)
4445

4546
The scheduler can be changed at any time without a reboot.
4647

@@ -67,7 +68,7 @@ Set up hardware-backed LUKS unlock with a YubiKey, and optionally configure GDM
6768

6869
### Applications
6970

70-
Install and configure applications browser, communication tools, development environment, and utilities. Includes non-obvious workarounds for Brave on GNOME Wayland and touchpad scroll speed.
71+
Install and configure applications: browser, communication tools, development environment, and utilities. Includes non-obvious workarounds for Brave on GNOME Wayland and touchpad scroll speed.
7172

7273
[Applications]({{< relref "/docs/applications" >}})
7374

content/docs/getting-started.nl.md

Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,12 @@
11
---
22
title: "Aan de slag"
3-
weight: 2
3+
weight: 1
4+
next: docs/hardware/nvidia-driver-installation
45
---
56

6-
Dit is mijn persoonlijke setup-documentatie voor de ROG Zephyrus G16 op CachyOS (Arch). Ik ben geen software-engineer of developer gewoon iemand die overgestapt is naar Linux en daarna tegen van alles aanliep wat niet meteen werkte. Ik heb alles opgeschreven zodat anderen niet hetzelfde hoeven uit te zoeken als ik.
7+
Dit is mijn persoonlijke setup-documentatie voor de ROG Zephyrus G16 op CachyOS (Arch). Ik ben geen software-engineer of developer, gewoon iemand die overgestapt is naar Linux en daarna tegen van alles aanliep wat niet meteen werkte. Ik heb alles opgeschreven zodat anderen niet hetzelfde hoeven uit te zoeken als ik.
78

8-
Als iets hier je helpt: mooi. Loop je ergens tegenaan wat ik niet behandeld heb, laat het gerust weten ik denk graag mee.
9+
Als iets hier je helpt: mooi. Loop je ergens tegenaan wat ik niet behandeld heb, laat het gerust weten; ik denk graag mee.
910

1011
## Hardware
1112

@@ -26,21 +27,21 @@ Als iets hier je helpt: mooi. Loop je ergens tegenaan wat ik niet behandeld heb,
2627

2728
Na het testen van meerdere distributies ben ik overgestapt op CachyOS (Arch) als mijn dagelijkse driver. CachyOS is een op Arch gebaseerde distributie met hardware-specifieke optimalisaties die het onderscheiden voor de Zephyrus G16:
2829

29-
- **BORE/EEVDF scheduler** CachyOS wordt geleverd met een verbeterde CPU-scheduler die betere responsiviteit en lagere latency biedt bij gemengde workloads
30-
- **Verbeterd energiebeheer** — Betere afhandeling van suspend/resume en ACPI power states op AMD+NVIDIA hybride setups
31-
- **Ondersteuning voor dynamische verversingsfrequentie** — Standaard ondersteuning voor variable refresh rate op het ROG Nebula Display
32-
- **Ingebouwde iGPU- en dGPU-drivers** — De AMD Radeon 890M en NVIDIA RTX 4060 werken correct vanaf een verse installatie, inclusief GPU-switching via `asusctl armoury`
33-
- **ASUS Linux-patches** — Een deel van het werk van [Luke Jones](https://asus-linux.org/) is gemerged in de Linux kernel zelf (de `asus-armoury`-driver vanaf 6.19), terwijl aanvullende ROG-specifieke patches en `asusctl`-verbeteringen via CachyOS worden meegeleverd. Zowel `asusctl` als `rog-control-center` zijn direct beschikbaar vanuit de CachyOS repos twee packages installeren en je bent klaar, zonder diepe systeemconfiguratie. CachyOS bevat op dit moment de meest volledige set aan optimalisaties voor deze hardware
30+
- **BORE/EEVDF scheduler**: CachyOS wordt geleverd met een verbeterde CPU-scheduler die betere responsiviteit en lagere latency biedt bij gemengde workloads
31+
- **Verbeterd energiebeheer**: betere afhandeling van suspend/resume en ACPI power states op AMD+NVIDIA hybride setups
32+
- **Ondersteuning voor dynamische verversingsfrequentie**: standaard ondersteuning voor variable refresh rate op het ROG Nebula Display
33+
- **Ingebouwde iGPU- en dGPU-drivers**: de AMD Radeon 890M en NVIDIA RTX 4060 werken correct vanaf een verse installatie, inclusief GPU-switching via `asusctl armoury`
34+
- **ASUS Linux-patches**: een deel van het werk van [Luke Jones](https://asus-linux.org/) is gemerged in de Linux kernel zelf (de `asus-armoury`-driver vanaf 6.19), terwijl aanvullende ROG-specifieke patches en `asusctl`-verbeteringen via CachyOS worden meegeleverd. Zowel `asusctl` als `rog-control-center` zijn direct beschikbaar vanuit de CachyOS repos; twee packages installeren en je bent klaar, zonder diepe systeemconfiguratie. CachyOS bevat op dit moment de meest volledige set aan optimalisaties voor deze hardware
3435

35-
Fedora is een sterke tweede een solide keuze als je de voorkeur geeft aan een stabielere releasecyclus boven rolling. Je zit goed zolang je op kernel 6.19 draait, die al beschikbaar is op Fedora, maar je moet wel even updaten. Dat gezegd hebbende voelt CachyOS nog altijd beter aan voor deze hardware: de CPU-scheduler tuning (BORE/EEVDF), vooraf geconfigureerde NVIDIA-driver ondersteuning en nauwere integratie met `asusctl` maken het dagelijks gebruik soepeler, zonder extra configuratie.
36+
Fedora is een sterke tweede, een solide keuze als je de voorkeur geeft aan een stabielere releasecyclus boven rolling. Je zit goed zolang je op kernel 6.19 draait, die al beschikbaar is op Fedora, maar je moet wel even updaten. Dat gezegd hebbende voelt CachyOS nog altijd beter aan voor deze hardware: de CPU-scheduler tuning (BORE/EEVDF), vooraf geconfigureerde NVIDIA-driver ondersteuning en nauwere integratie met `asusctl` maken het dagelijks gebruik soepeler, zonder extra configuratie.
3637

3738
## CachyOS Kernel Manager
3839

39-
CachyOS wordt geleverd met de **CachyOS Kernel Manager** als voorgeïnstalleerde GUI-tool. Hiermee beheer je geïnstalleerde kernels en configureer je de `sched-ext` scheduler het extensible scheduler framework van de Linux kernel waarmee een userspace-scheduler de standaard kan vervangen.
40+
CachyOS wordt geleverd met de **CachyOS Kernel Manager** als voorgeïnstalleerde GUI-tool. Hiermee beheer je geïnstalleerde kernels en configureer je de `sched-ext` scheduler, het extensible scheduler framework van de Linux kernel waarmee een userspace-scheduler de standaard kan vervangen.
4041

4142
Ik gebruik `scx_lavd` met het profiel ingesteld op **Auto**. LAVD (Latency-criticality Aware Virtual Deadline) is een scheduler die ontworpen is voor gemengde interactieve en compute-workloads, wat hem goed geschikt maakt voor een laptop die je zowel dagelijks als voor gaming gebruikt.
4243

43-
![CachyOS Kernel Manager Configure sched-ext met scx_lavd](/images/cachyos-kernel-manager-sched-ext.avif)
44+
![CachyOS Kernel Manager - Configure sched-ext met scx_lavd](/images/cachyos-kernel-manager-sched-ext.avif)
4445

4546
De scheduler kan op elk moment worden gewijzigd zonder herstart.
4647

@@ -67,7 +68,7 @@ Stel hardware-gebaseerde LUKS-ontgrendeling in met een YubiKey, en configureer o
6768

6869
### Applicaties
6970

70-
Installeer en configureer applicaties browser, communicatietools, ontwikkelomgeving en hulpprogramma's. Inclusief niet-voor-de-hand-liggende workarounds voor Brave op GNOME Wayland en touchpad-scrollsnelheid.
71+
Installeer en configureer applicaties: browser, communicatietools, ontwikkelomgeving en hulpprogramma's. Inclusief niet-voor-de-hand-liggende workarounds voor Brave op GNOME Wayland en touchpad-scrollsnelheid.
7172

7273
[Applicaties]({{< relref "/docs/applications" >}})
7374

content/docs/hardware/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "Hardware & Drivers"
3-
weight: 10
3+
weight: 2
44
toc: false
55
---
66

content/docs/hardware/_index.nl.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "Hardware & Drivers"
3-
weight: 10
3+
weight: 2
44
toc: false
55
---
66

0 commit comments

Comments
 (0)