Add cachyos_setup.sh for DAMX driver setup

[scorpionTaj]

This script automates the process of building, signing, and installing the DAMX driver for CachyOS. It includes checks for required keys, builds the driver using Clang, signs the driver, and provides installation instructions.

[scorpionTaj]

Request for Release Inclusion

Could you please also include this script (scripts/cachyos_setup.sh) in the release archives (.tar.xz or .zip) for the next version?

Currently, users downloading the release via the "Releases" tab won't get this script unless they clone the repository manually. Including it in the release package would ensure a seamless experience for CachyOS and Secure Boot users who prefer downloading the stable release.

[Copilot]

Pull request overview

This PR introduces a specialized setup script for CachyOS users to build, sign, and install the Linuwu Sense driver with Clang compiler support. The script automates the driver compilation process, handles Secure Boot signature requirements, and provides clear installation instructions for both new installations and driver updates.

Key changes:

• Automated driver building using Clang/LLD toolchain specific to CachyOS
• Secure Boot key discovery and driver signing functionality
• Post-installation guidance for integrating with the main DAMX setup

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Krak8]

Hey @scorpionTaj I am trying to install this on cachyos which has secureboot using sbctl how do I use your script to install this?

[scorpionTaj]

@Krak8 so sorry for being late :-) , you can install the latest release build from the repo and put that script in the driver "Linuwu Sense" directory and then run it like in the screenshot

[Krak8]

thanks for this

[scorpionTaj]

@Krak8 you are welcome 👍🏼

[Mukilan473]

sorry if I sound dumb but how do I install it I have the AN17-42 model and I have a seperate copy of the driver modified for my laptop (just added quirks with the help from FAQ) I downloaded the script seperately and copied it to the Linuwu-Sense and I get this error ensure sbctl is installed (which I installed) and verify keys are generated the thing is I verified the secure boot key from the bios during installation as the bios doesn't load if it's not a signed os any help is appreciated and sorry for the bad english
~/Documents/DAMX-0.9.1/scripts ❯ ./cachyos_setup.sh 🔒 Root privileges are required to sign drivers. 🔑 Please enter your password to continue... 🔧 Preparing to build for CachyOS... ❌ Error: Secure Boot keys (db.key/db.pem) not found. Ensure you have sbctl installed and keys generated.

[scorpionTaj]

Troubleshooting the "Keys Not Found" Error

Don't worry, you don't sound dumb at all! Secure Boot on Linux is notoriously tricky. The error happens because the script can't find your db.key and db.pem files, which are needed to sign the driver so your BIOS will trust it.

1. Fix the Script Location

The error in your terminal shows you are running the script from inside the scripts folder:
~/Documents/DAMX-0.9.1/scripts ❯ ./cachyos_setup.sh

Move the script up one level into the main Linuwu-Sense folder. It must be in the same folder as the Makefile and the src folder to work.

2. Verify/Generate your Keys

Even if sbctl is installed, you must ensure the keys actually exist on your system and are enrolled in your BIOS.

• Run sudo sbctl status to check your current state.
• If it shows that keys are not created or enrolled, please follow the official CachyOS Secure Boot Guide here: 👉 [CachyOS Secure Boot Setup](https://wiki.cachyos.org/configuration/secure_boot_setup/)

Follow the steps in that wiki to create and enroll your keys. Once sbctl status shows that your keys are enrolled and Secure Boot is active, you can proceed.

3. Help the Script find the Keys

Sometimes the script's "search" function misses the sbctl folder. If you have confirmed your keys exist but the script still fails, you can tell it exactly where they are.

Open cachyos_setup.sh in a text editor and change lines 20 and 21 to:

KEY="/var/lib/sbctl/keys/db/db.key"
CERT="/var/lib/sbctl/keys/db/db.pem"

4. Run the Script again

Once the keys are ready and the script is in the main folder, run:

sudo ./cachyos_setup.sh

[Mukilan473]

that did the trick thank you friend

[Krak8]

this is pretty useful for users with secureboot on !
I will request the author to add this useful script on main repo thx (merge)

[scorpionTaj]

I’ll be opening a new one shortly to reflect the updated local-setup.sh and the new build process for Secure Boot files across all distributions. this is it #152