8000 chuwi-minibook/GUIDE.md at main · fstanis/chuwi-minibook · GitHub
[go: up one dir, main page]

Skip to content

Latest commit

 

History

History
162 lines (120 loc) · 4.78 KB

GUIDE.md

File metadata and controls

162 lines (120 loc) · 4.78 KB

Installation Guide

Three steps: run the bootstrap script, flip two BIOS settings, install thermald. Reboot when done.

This page covers the standard setup. For manual per-component installation, GPU setup, display rotation internals and sleep modes, see GUIDE-ADVANCED.md.

1. Run the bootstrap script

On Ubuntu or Debian:

sudo tools/bootstrap-ubuntu.sh

On Arch, CachyOS or Manjaro (with sudo from your normal user account, not from a root shell — it builds a package, which refuses to run as root):

sudo tools/bootstrap-arch.sh

The script installs build dependencies, the four DKMS kernel modules (touchscreen fix, EC driver, DPTF enabler, I2C fix), the patched iio-sensor-proxy for auto-rotation and tablet mode, and the kernel command line arguments for deep sleep, the PSR screen-tearing fix and panel rotation. Panel rotation is skipped when Niri is installed, running or named in XDG_CURRENT_DESKTOP, because of the iio-niri issue. Use --panel-rotation to force it with a fixed iio-niri, or --no-panel-rotation to skip it on any desktop. Skipping leaves existing kernel arguments unchanged. See GUIDE-ADVANCED.md.

It is idempotent — safe to re-run at any time. If it stops with an error saying the running kernel is no longer installed, a package upgrade pulled in a new kernel: reboot and run it again.

2. BIOS tweaks

thermald needs two hidden BIOS settings changed to control CPU power limits.

  1. Unlock the hidden BIOS menus: echo 1 | sudo tee /sys/devices/platform/minibook_ec/bios_unlock
  2. Reboot into BIOS setup (press DEL during POST).
  3. Go to the Advanced tab.
  4. Navigate to Power & Performance -> CPU - Power Management Control -> CPU Lock Configuration
  5. Change CFG Lock to Disabled
  6. Go back to the top level of the Advanced tab.
  7. Navigate to Thermal Configuration -> CPU Thermal Configuration
  8. Change Tcc Activation Offset to 10

See thermald.md for what these do.

3. thermald

Patched thermal daemon. Requires steps 1 and 2.

On Arch, CachyOS and Manjaro (without sudo):

cd thermal_daemon
make install-arch

Add IgnorePkg = thermald to /etc/pacman.conf so upgrades don't replace it with the unpatched repo build.

On Debian and Ubuntu:

sudo apt install build-essential autoconf autoconf-archive automake \
  pkg-config gtk-doc-tools libglib2.0-dev libxml2-dev libupower-glib-dev \
  libevdev-dev systemd-dev
sudo apt remove thermald
cd thermal_daemon
./autogen.sh --sysconfdir=/etc --localstatedir=/var
make
sudo make install

On Fedora, sudo dnf remove thermald first and install the corresponding build dependencies.

Enable and restart:

sudo systemctl daemon-reload
sudo systemctl enable thermald
sudo systemctl restart thermald

Verify: journalctl -u thermald | grep minibook. See thermald.md for details.

4. Reboot and verify

Reboot, then run:

sudo tools/check-status.sh

The warnings section at the end lists anything still missing. Two more status scripts dig deeper — see GUIDE-ADVANCED.md.

Optional: higher refresh rate

The panel runs at 50 Hz stock. To try 90 Hz:

cd vbt_patch && make && cd ..
sudo tools/update-vbt-clock.sh 90

Treat this as an experiment, not a default. Panels vary between units, and a rate can survive a cold boot yet fail on the first suspend/resume. Test a suspend cycle before relying on it, and revert if the display misbehaves:

sudo tools/update-vbt-clock.sh --revert

See vbt-patch.md for choosing a rate and telling the two failure modes apart.

Optional: screen auto-rotation on other desktops

GNOME and KDE Plasma pick up rotation and tablet mode automatically. On Niri, Sway, Hyprland and other wlroots compositors you need a small bridge daemon — see iio-sensor-proxy.md.

On-screen keyboard (tablet mode)

In tablet mode the physical keyboard is disabled at the EC level (see minibook-ec.md), so text input needs an on-screen keyboard. There is no built-in popup-on-focus mechanism on Niri (unlike GNOME/KDE) -- wire one up manually with switch-events:

yay -S wvkbd-deskintl

Add to a Niri config file (e.g. ~/.config/niri/cfg/switch-events.kdl):

switch-events {
    tablet-mode-on {
        spawn "wvkbd-deskintl"
    }
    tablet-mode-off {
        spawn "pkill" "-x" "wvkbd-deskintl"
    }
}

wvkbd-deskintl has no dedicated Polish layout, but every diacritic (ą ć ę ł ń ó ś ź ż) is reachable through the "Cmp" (Compose) key: tap Cmp, then the base letter, then pick the accented variant from the popup that appears.

0