Field guides for running Linux on Monster (Clevo/TONGFANG-based) notebooks. Every fix here was hit, diagnosed and verified on real hardware. Monster ships rebadged Clevo barebones, so most of this applies equally to TUXEDO, XMG/Schenker, System76 and other machines built on the same shells.
Machines behind this repository:
- Monster TULPAR T6 V2.1 AI Creator — Ubuntu 26.04, kernel 7.0 (daily driver)
- Monster TULPAR T6 V2.1 AI Creator — same hardware, Arch Linux + Hyprland, kernel 7.2
- Monster ABRA A5 V20.2 — Ubuntu 22.04, kernel 6.8
| Symptom | Guide |
|---|---|
| Keyboard backlight dead, touchpad locked at hardware level | unlock the keyboard backlight and touchpad |
| Machine hard-freezes at random — no logs, only a power cycle helps | stop random hard freezes from PCIe ASPM |
Bluetooth peripherals crash-disconnect (Intel AX211, Hardware error 0x0c) |
pin stable AX211 Bluetooth firmware |
nvidia-smi fails after a kernel upgrade |
restore NVIDIA after a kernel upgrade |
| dGPU never idles on battery (Hyprland, hybrid graphics) | idle the dGPU on battery under Hyprland |
| Login screen comes up black on some boots (hybrid graphics, Wayland) | fix a black GDM greeter |
pcieport … D3cold to D0 spam in the journal |
silence Thunderbolt D3cold log spam |
| TUXEDO Control Center shows no fan or temperature (ABRA A5) | show fan and temperature in TUXEDO Control Center |
| Power-profile switcher in a custom shell does nothing | switch power profiles from a custom shell |
Fn hotkeys dead under Hyprland |
bind Fn hotkeys under Hyprland |
| Want a terminal thermal dashboard | install the thermal dashboard |
| Panel color looks wrong next to the Windows X-Rite profile | assign an EDID color profile |
| Bluetooth still crashing after the firmware pin | use a USB Bluetooth adapter |
| Fresh install on a TULPAR T6 V2.1 | set up a TULPAR T6 V2.1 |
- The Windows-to-Linux driver map — what every Monster driver becomes on Linux, what is always broken out of the box, and the recommended baseline install.
- Your model: set up a TULPAR T6 V2.1, alongside its hardware reference.
- Unlock the keyboard backlight and touchpad
— you will need this one. Both are dead on every Monster until the
tuxedo-driversDMI patch is in.
Documents are split by what you need from them, following Diátaxis:
- docs/how-to/ — you have the symptom and want it gone. Commands only.
- docs/explanation/ — why the hardware behaves this way, how each fault was actually tracked down, and which promising fixes turned out to be dead ends.
- docs/reference/ — driver maps, hardware tables, EC
register maps,
tccdprofile definitions. Things you look up. - notes/ — open investigations and abandoned efforts. Working state, not advice.
- Why
tuxedo-driversreject Monster hardware — theMONSTERDMI vendor string and the compatibility gate that stops every EC feature from loading. - Why a DRAM-less NVMe freezes the machine — the Phison controller that will not wake from PCIe ASPM L1, and the panic that spent two weekends masquerading as bad RAM.
- AX211 Bluetooth firmware crashes — the firmware build bisection: 3243 is stable, 3604, 3831 and 3882 all crash.
- Hyprland picks the dGPU as primary renderer — why the obvious fix breaks external monitors.
- The ABRA A5 EC never reports temperature
— what the DSDT declares, what the firmware actually populates, and why
tccdloses the fan reading and the temperature together. tccdversuspower-profiles-daemon— two daemons, one of which owns nothing on this hardware.- X-Rite panel calibration on Linux — the factory ICC lives in the panel EEPROM, not in any installer. What your options really are.
- Windows-to-Linux driver map
- TULPAR T6 V2.1 hardware
- ABRA A5 EC field map
tccdprofiles- Keyboard backlight controls
- AX211 Bluetooth configuration
- Thermal sensor sources
- tuxedo-abra-fan-fix/ — the out-of-tree hwmon driver for the ABRA A5, reverse-engineered from the DSDT and EC MMIO registers.
- bios-dumps/ — UEFI Setup variable dumps for the TULPAR T6, for hunting hidden BIOS options.
- notes/ — open investigations and abandoned efforts: AX211 audio glitches (open) and whether a monster-linux project makes sense.
| Component | TULPAR T6 V2.1 AI Creator | ABRA A5 V20.2 |
|---|---|---|
| CPU | Intel Core Ultra 7 155H (Meteor Lake) | Intel Core i5-13500H (Raptor Lake) |
| GPU | NVIDIA RTX 4070 Laptop (Max-Q) | NVIDIA RTX 4050 Laptop |
| EC | ITE IT5570E | — |
| BIOS | 1.07.04TFB | N.1.13MON07 |
| OS | Ubuntu 26.04 LTS · Arch Linux | Ubuntu 22.04 LTS |
| Kernel | 7.0.0-15-generic · 7.2 | 6.8.0-124-generic |
| NVIDIA driver | 580.142 (-open) |
— |
tuxedo-drivers |
4.22.2 | 4.22.2 (+ tuxedo-abra-fan 1.0 out-of-tree) |
| TUXEDO Control Center | 3.0.4 | 2.1.17 |
Every guide records the exact system it was verified on, with a date, in its own metadata block. Several were written against Ubuntu 24.04 and kernel 6.17 and have survived the move to 26.04 and kernel 7.0 unchanged.
Read CONTRIBUTING.md and docs/STYLE.md. The short version: do not document a fix you have not run, date everything, and give every how-to a rollback section.
tools/check-docs.pymust exit clean before a pull request.