Install scripts, small kernel drivers and configuration that make Linux work on the ASUS ProArt P16 H7607BA, the arm64 laptop with the NVIDIA N1X ("RTX Spark") SoC (Blackwell GPU, 20-core ARM CPU, MediaTek MT8901 platform blocks). With them, Ubuntu 26.04 gets a working battery indicator, speakers and microphone, keyboard, touchpad, touchscreen, keyboard backlight, Fn keys, suspend, GNOME power modes (ASUS fan modes), a battery charge limit, hardware sensors, haptic touchpad clicks and GPU acceleration, including for snap apps.
Everything here was worked out on one unit; see docs/technical-notes.md for the why and docs/hardware.md for the hardware map. Interested in local LLMs on the N1X (Qwen3.8 27B and Flash-Next with vLLM: speed, context, quality, coding agents, unified-memory fixes)? That has its own repository: local-llm-rtx-spark (short summary in docs/local-llm-benchmarks.md). Other NVIDIA N1X/GB10 machines share parts of the platform (FF-A EC service, MT8901 SoundWire audio, the snap EGL issue), so some fixes may help there too - reports welcome.
Status: community bring-up, not supported by ASUS or NVIDIA. Several steps use kernel packages from Ubuntu's
-proposedpocket and out-of-tree drivers. Keep a fallback kernel in the GRUB menu.
Disclaimer. This is an unofficial community project. It installs a kernel from Ubuntu's
-proposedpocket, changes the operating system the firmware sees (acpi_osi), loads out-of-tree kernel modules, installs speaker firmware and changes the login (PAM) configuration. It was tested on one ASUS ProArt P16 H7607BA with BIOS H7607BA.300 and Ubuntu 26.04 only. Use it at your own risk; there is no warranty of any kind (seeLICENSE). Keep a fallback kernel in GRUB and a backup of your data.Not affiliated with or endorsed by ASUS, NVIDIA, MediaTek, Cirrus Logic, Dolby, Canonical or Mozilla. ASUS, ProArt, NVIDIA, RTX, Dolby and all other trademarks belong to their respective owners and are used only to describe the hardware this project supports.
- Kernel and boot:
install/01-kernel.shinstallslinux-nvidiafrom-proposedand addsacpi_osi="!Windows 2022". If the system does not boot, choose the previous kernel under Advanced options in GRUB. - Speaker firmware:
install/03-audio.shdownloads ASUS' Windows audio driver, checks its SHA-256 and extracts the Cirrus tuning files. Wrong tuning files could stress the speakers; the script only accepts the exact file it was tested with. - Face login:
optional/howdy-polkit.shlets admin dialogs accept your face by opening the polkit helper's sandbox for cameras. Read its header before using it.
| Symptom on Linux | Cause | Fix |
|---|---|---|
| Keyboard, touchpad and touchscreen do not work | generic kernel lacks the MT8901 I2C/GPIO drivers; firmware hides the power controller | install/01-kernel.sh |
| Battery always shows 0 %, AC adapter not detected | EC answers over FF-A never reach ACPI | drivers/proart-battery |
| No sound card, no sound, quiet or muffled speakers | missing UCM profile and ASUS speaker tuning, tweeters off | install/03-audio.sh, user/install-user.sh |
| Touchpad detected but the pointer does not move | pressure range confuses libinput | install/06-touchpad.sh |
| Touchpad clicks do not vibrate (haptic touchpad) | pad has no auto trigger | proart-haptic.service (install/06-touchpad.sh) |
| Keyboard backlight keeps blinking or fading, F4 does nothing | keyboard stays in ASUS OOBE demo mode | drivers/hid-asus-proart |
| Fn keys / Fn-lock (Fn+Esc) do nothing | no asus-wmi on arm64 | drivers/hid-asus-proart |
| After shutting down, the power button only works with the charger plugged in | PSCI power-off makes the EC cut the battery | drivers/proart-battery (powers off via UEFI) |
| Laptop does not wake up from suspend | "deep" sleep instead of Modern Standby; PCIe ASPM L1.2 | s2idle in install/01-kernel.sh, ASPM left at default |
| GNOME power modes do nothing, no Performance mode, fan always the same | ASUS fan modes only reachable through the EC | drivers/proart-battery |
| No battery charge limit ("preserve battery health") | same | drivers/proart-battery |
| Temperatures of 1000-6000 C, fan at 164613644 rpm | power meters exposed as thermal zones, broken EC path | drivers/proart-battery |
| 4K YouTube stutters, video decoded on the CPU | Firefox snap without NVIDIA; Firefox blocklists NVIDIA decoding; VA-API cannot export frames on the N1X | install/07-video-firefox.sh (Vulkan video decoding) |
| H.264 videos (e.g. VOE) turn blocky for a few seconds | NVIDIA's Vulkan H.264 decoder returns wrong frames for some streams | install/07-video-firefox.sh (Vulkan layer: Firefox decodes H.264 in software) |
| x86 Windows games / Star Citizen do not start (arm64), RSI Launcher reacts after a second | no x86 emulation; vsync presents stall, wineserver round trips, threads on efficiency cores | optional/gaming/, docs/gaming.md |
| GPU stuck at 20-30 W even on the charger (AI, games, rendering slow) | the firmware tells the NVIDIA driver "battery" all the time, so it applies its battery cap | install/02-nvidia.sh (RMSkipACPIBattCap); on battery a platform limit of ~20 W remains |
| Snap apps (Snap Store, Chromium/Electron/Qt apps) slow, render with llvmpipe | snapd does not expose libnvidia-rmapi-tegra |
install/09-snap-gpu.sh |
| Dragging windows/files stutters at 120-180 Hz or with several monitors, GPU idle | GNOME Shell runs on the efficiency cores at ~340 MHz (energy-aware scheduling) | user/install-user.sh (uclamp drop-in) |
| Every sound starts crackling a few minutes after an echo canceller / voice assistant starts | the internal mic becomes the clock for the speakers and its timing derails | keep mic and speakers in separate graphs (docs 4.6) |
| Speakers crackle, then go silent while some apps are open (e.g. OpenCode) | an app asking for a small buffer takes PipeWire to 256 samples; the SoundWire speakers xrun there | minimum buffer of 1024 samples, config/pipewire/61-proart-min-quantum.conf (docs 4.7) |
| Sound settings list "Internal speakers – ProArt P16 Audio" next to the speakers, the mic as "Internal microphone array – ProArt P16 Audio" | GNOME names card ports " – "; the woofer port of the crossover is listed too | port names in the UCM profile, woofer port hidden (docs 4.1) |
| Speakers muted before a reboot are unmuted after it | WirePlumber 0.5 drops the mute of filter sinks (the 2-way crossover) | user/install-user.sh |
| GNOME Calls shows "no modem" for a Bluetooth phone, mute does nothing | PipeWire's oFono emulation is incomplete, callaudiod expects a phone | optional/phone-handsfree.sh |
| Component | Stock Ubuntu 26.04 | With this project |
|---|---|---|
| Keyboard, touchpad, touchscreen + stylus | not detected | works (linux-nvidia kernel; touchpad needs the libinput quirk) |
| Keyboard backlight | blinks constantly (OOBE demo mode), no control | steady (OOBE off); F4 cycles off/1/2/3 with the GNOME level OSD; slider in the status menu (patched hid-asus, verified) |
| Fn keys / Fn-lock | Fn-lock (Fn+Esc) does nothing | media keys first, Fn+Esc switches; state shown in the top bar and as a notification (proart-fnlock) |
| Display (3840x2400 OLED) | framebuffer only, 60 Hz, no acceleration | NVIDIA 615, 120 Hz |
| GPU video decoding | - | Firefox decodes AV1/VP9/HEVC on NVDEC through Vulkan video: YouTube 2160p60 with the decoder process at 20-30 % CPU instead of 260-700 %; H.264 in software, because the driver's Vulkan H.264 decoder is broken; VA-API decodes but cannot export frames |
| Speakers | no sound card | 2-way speakers: ASUS woofer tuning, tweeters enabled, time-aligned crossover, tone control |
| Headphone jack, internal mic, headset mic | no sound card | works (NVIDIA UCM profile); tweeters mute when headphones are plugged in |
| Battery / AC adapter | 0 % / not detected | works (proart_battery): level, charging/discharging, power draw and time remaining (verified) |
| Power modes (GNOME) | Balanced / Power Saver do nothing | Performance / Balanced / Power Saver switch the ASUS fan modes (performance / standard / silent): 3.2 / 3.0 / 2.1 GHz all-core |
| Battery charge limit | - | GNOME "Preserve battery health" stops charging at 80 % (ASUS battery care) |
| Sensors | fan 164613644 rpm, "temperatures" of 1000-6000 C | fan rpm, EC temperatures, system and SoC power (proart_ec hwmon); misleading ACPI zones hidden |
| GPU in snap apps | CPU rendering (llvmpipe): snapd does not expose libnvidia-rmapi-tegra |
NVIDIA EGL through a small glvnd shim (install/09-snap-gpu.sh) |
| Wi-Fi, Bluetooth | works | works |
| Phone calls via a paired phone | - | GNOME Calls rings, answers, dials; call audio on the laptop; mute button (optional/phone-handsfree.sh) |
| Webcam, IR camera | works | works; 50 Hz anti-flicker; optional face login (Howdy: login, lock screen, sudo, optionally admin dialogs) |
| USB-C, second M.2 slot | works / slot empty | unchanged (second slot: 2280, single-sided SSDs only per ASUS) |
| Suspend (s2idle) | "deep" sleep never wakes up | wakes up reliably; open: after sleeps of more than a few minutes the internal mic stays silent and the speakers crackle until a reboot (audio state the firmware sets at boot is lost; under investigation), and the fans keep running while asleep |
| Haptic touchpad feedback | no vibration on click | click felt on press and release (proart-haptic.service, strength adjustable) |
| Battery through ACPI | - | not working: the EC echoes the ACPI requests; proart_battery is the workaround |
| Dolby Atmos | - | not available on Linux; EasyEffects presets as an approximation |
| Laptop | ASUS ProArt P16 H7607BA, BIOS H7607BA.300 (2026-08-11) |
| OS | Ubuntu 26.04 LTS (resolute), GNOME 50 on Wayland |
| Kernel | linux-nvidia 7.0.0-1023.24 (resolute-proposed) with acpi_osi="!Windows 2022" |
| NVIDIA | 615.71.09 open kernel modules (prebuilt), nvidia-vaapi-driver 0.0.14 |
| Audio | PipeWire 1.6.2, WirePlumber 0.5.13, alsa-ucm-conf 1.2.15.3 + NVIDIA's mt8901 profiles |
| Other | libinput 1.31.1, Firefox 158 (Mozilla arm64 .deb), EasyEffects 8.1.2 |
Run the root steps with sudo (or pkexec) from the repository folder, in this order:
sudo bash install/01-kernel.sh # linux-nvidia + NVIDIA kernel modules, acpi_osi, GRUB default
sudo bash install/02-nvidia.sh # NVIDIA user space
sudo reboot
sudo bash install/03-audio.sh # UCM profile, ASUS speaker tuning, proart_audio
sudo bash install/04-battery.sh # proart_battery: battery, fan modes, charge limit
sudo bash install/05-keyboard.sh # patched hid-asus (backlight levels + OSD, Fn-lock, no blinking)
sudo bash install/06-touchpad.sh # libinput quirk
sudo bash install/07-video-firefox.sh # Firefox from Mozilla's APT repo, GPU video decoding for all profiles
sudo bash install/08-camera.sh # webcam anti-flicker 50 Hz (skip on 60 Hz mains)
sudo bash install/09-snap-gpu.sh # NVIDIA EGL for snap apps (otherwise they render on the CPU)
sudo bash install/10-power.sh # only for earlier installs: removes the PCIe ASPM setting
sudo bash install/11-protect.sh # keeps the setup across Ubuntu updates (UCM diversion, apt hook)
sudo reboot
user/install-user.sh # as your user: speaker crossover, tweeter service, names, VA-API env,
# Fn-lock top-bar indicator
Then log out and back in once. bash tools/check.sh checks every component (OK / WARN / FAIL). Tone control for the speakers:
proart-eq # show: bass, mid, presence, treble (dB)
proart-eq bass=3 treble=0 # change live; saved in the PipeWire config
proart-eq 2 3 3 1 # all four at once
sudo bash optional/perf-mode.sh # perf-mode performance|balanced|quiet (cpufreq governor)
sudo bash optional/howdy.sh # face login with the IR camera: build + configure
sudo /usr/local/bin/howdy -U $USER -y add # enroll your face - repeat 3-4 times (straight on, head
# slightly lowered, other light, with/without glasses)
sudo bash optional/howdy-enable.sh # login, lock screen, sudo (not admin dialogs)
sudo bash optional/howdy-polkit.sh # ALSO admin dialogs - weakens a sandbox, read the header first
sudo bash optional/easyeffects.sh # EasyEffects + presets (not needed with the crossover;
# add --autostart for login start)
sudo bash optional/nvbroadcast.sh # NV Broadcast (community app, CPU modes on arm64) + v4l2loopback
sudo bash optional/ui-control.sh # ydotool for scripted desktop control
sudo bash optional/phone-handsfree.sh # phone calls through a paired phone in GNOME Calls (Bluetooth)
sudo bash optional/gaming/emulators.sh # FEX-Emu (x86 + AVX), RootFS, GPU thunks, ntsync [--hangover]
bash optional/gaming/star-citizen.sh [dir] # Star Citizen / RSI Launcher via Wine under FEX (app menu, Lutris)
bash optional/gaming/steam-library.sh DIR # Steam (snap) installs games on another drive
| Tool | Purpose |
|---|---|
measure-speakers.py response|latency |
sweep response and woofer/tweeter time alignment with the built-in mic (as user) |
ffa-probe.sh |
raw answers of the EC services behind FF-A (root) |
touchpad-diag.py, haptic-features.py, haptic-probe.py |
touchpad reports, haptic controller, pressure/vibration (root) |
dump-acpi.sh |
copy and decompile the ACPI tables (root) |
key-events.py [seconds] |
key events and raw HID reports of the internal keyboard next to the backlight level (root) |
- Howdy makes one attempt per authentication. After a timeout the lock screen waits for the
password; press
Escand any key to start a new attempt with face recognition. - Fn-lock indicator:
F1–F12= function keys first,Media= media keys first. - Keyboard backlight after installing the driver into a running session:
install/05-keyboard.shrestarts UPower and gsd-power so F4 and the slider work immediately; after a reboot this is automatic.
Every script lists its own removal steps in a Remove: comment at the top. The user part:
user/install-user.sh --remove. To go back to the stock kernel, pick it in GRUB, then remove the
linux-nvidia packages and the acpi_osi parameter from /etc/default/grub (update-grub).
install/ numbered root steps (lib.sh: shared helpers)
optional/ face login, EasyEffects, NV Broadcast, desktop automation, CPU modes, gaming (FEX, Star Citizen, Steam)
drivers/ proart-battery, proart-audio, hid-asus-proart (DKMS), proart-ffa-probe (diagnostic)
config/ pipewire (2-way crossover), wireplumber (device names), ucm2, libinput, udev, environment.d
user/ user tools (proart-eq, proart-tweeter, ...), systemd user unit, install-user.sh
tools/ diagnostics and measurements
docs/ hardware map, technical notes, gaming
No firmware is included. install/03-audio.sh downloads ASUS' Windows audio driver for the ProArt
P14 (Audio_Driver_ARM_Cirrus_Z_V1.0.678.52824, which also carries the P16 tuning), checks its
SHA-256, unpacks it without running it and installs the Cirrus Logic CS35L56 firmware and ASUS
speaker tuning for SSID 1043:1484. Those files are licensed by Cirrus Logic / ASUS.
- NVIDIA: N1X kernel support, MT8901 SoundWire/ASoC/SOF audio stack (NV-Kernels #566, #567) and the mt8901 UCM profiles (alsa-ucm-conf #862)
- Omarchy (omarchy-pkgs): hid-asus patches for the
0B05:4B42keyboard and the approach of taking the speaker tuning from ASUS' Windows driver - JackHack96/EasyEffects-Presets, Digitalone1/EasyEffects-Presets
- Howdy, nvidia-vaapi-driver, NV Broadcast, LSP plugins (limiter)
This project is licensed under the GNU General Public License v2.0 (see LICENSE).
- Scripts, configuration and documentation: GPL-2.0-only
drivers/proart-battery,drivers/proart-audio,drivers/proart-ffa-probe,drivers/proart-haptic,drivers/snap-egl-shim: GPL-2.0-onlydrivers/hid-asus-proart: GPL-2.0-or-later (derived from the Linux kernel's hid-asus)config/ucm2: BSD-3-Clause (NVIDIA, from alsa-ucm-conf PR #862)
Files downloaded at install time (ASUS/Cirrus speaker firmware, EasyEffects presets, Howdy, Firefox) keep their own licenses and are not part of this repository.