50->90Hz on Linux Chuwi MiniBook X (2023, N100)
The MiniBook X's built-in screen is locked at 50Hz. xrandr lists 60Hz modes, but picking one fails with Configure crtc 0 failed, and EDID overrides do nothing. That's because Intel's Linux driver takes DSI panel timings from the firmware's VBT (Video BIOS Table). The fix is to dump your own VBT, raise the panel's pixel clock so it refreshes at 90Hz, and have the driver load the patched file at boot.
Tested on: MiniBook X 2023 (N100), Arch Linux, linux-zen 7.3, GRUB + mkinitcpio, XFCE/X11. It gives the same pixel clock as godorowski's 90Hz patch, but it's built from your own VBT and has a correct checksum.
⚠️ Panel lottery. 90Hz drives the panel 1.8× faster than its rating (60Hz is 1.2×). Some panels show glitches at 90Hz, and one Windows user saw occasional artifacts after a year at 90Hz that went away at 60Hz. Chuwi says higher rates can affect Wi-Fi (see step 6). If 90Hz misbehaves, use 60 in step 2 instead, the safer choice that works on almost every panel. Use at your own risk. Every step can be undone, and nothing is written to the BIOS.
1. Dump your VBT
Use your own dump rather than someone else's file. BIOS versions differ.
sudo sh -c 'cat "$(ls -d /sys/kernel/debug/dri/*/i915_vbt | head -1)"' > ~/vbt_original.bin2. Patch it to 90Hz
Save this as vbt_hz.py. It finds your panel's timing entry (VBT block 58), sets the pixel clock for the target refresh rate, and fixes the checksum. Nothing else changes.
#!/usr/bin/env python3
# Usage: python3 vbt_hz.py vbt_original.bin vbt_90hz.bin 90
import struct, sys
src, dst, hz = sys.argv[1], sys.argv[2], float(sys.argv[3])
d = bytearray(open(src, 'rb').read())
assert d[:4] == b'$VBT', 'not a VBT dump'
vbt_size = struct.unpack_from('<H', d, 24)[0]
bdb = struct.unpack_from('<I', d, 28)[0]
p = bdb + struct.unpack_from('<H', d, bdb + 18)[0]
end = bdb + struct.unpack_from('<H', d, bdb + 20)[0]
blocks = {}
while p < end - 3:
bid, size = d[p], struct.unpack_from('<H', d, p + 1)[0]
blocks[bid] = p + 3
p += 3 + size
panel = d[blocks[40]] & 0x7f # LFP options: panel_type
e = blocks[58] + 2 + panel * struct.unpack_from('<H', d, blocks[58])[0] # generic DTD entry
clk, ha, hb, _, _, va, vb = struct.unpack_from('<I6H', d, e)
total = (ha + hb) * (va + vb)
new = round(total * hz / 1000)
print(f'panel {panel}: {ha}x{va}, {clk} kHz = {clk*1000/total:.3f} Hz -> {new} kHz = {new*1000/total:.3f} Hz')
struct.pack_into('<I', d, e, new)
d[26] = 0
d[26] = -sum(d[:vbt_size]) & 0xff # fix VBT checksum
open(dst, 'wb').write(d)python3 vbt_hz.py ~/vbt_original.bin ~/vbt_90hz.bin 90Expected output on this model: panel 0: 1200x1920, 136887 kHz = 50.002 Hz -> 246385 kHz = 90.000 Hz. If you don't see 1200x1920 at about 50Hz, stop: your VBT is laid out differently.
It's worth also building a 60Hz fallback now (... ~/vbt_60hz.bin 60, which gives 164257 kHz) and including both files in step 3.
3. Install the file into the boot image
The driver loads during early boot, so the file has to be inside the initramfs.
sudo install -Dm644 ~/vbt_90hz.bin /usr/lib/firmware/vbt_90hz.binAdd it to FILES in /etc/mkinitcpio.conf, e.g. FILES=(/usr/lib/firmware/vbt_90hz.bin) (add the 60Hz file there too if you built it), then:
sudo mkinitcpio -P4. Test it for one boot
At the GRUB menu, press e on your entry. At the end of the linux line, add i915.vbt_firmware=vbt_90hz.bin, then press Ctrl+X. This edit isn't saved, so if the screen is black or glitchy, power off and the next boot is normal.
Check it worked:
xrandr --verbose | grep -A2 '\*current'You should see 246.385MHz and 90.00Hz. The kernel log will also say Setting dangerous option vbt_firmware - tainting kernel, which is expected. Use it for a while, including once the laptop is warm, and watch for colored lines, flicker, a red tint or ghosting.
5. Make it permanent
Add i915.vbt_firmware=vbt_90hz.bin to GRUB_CMDLINE_LINUX_DEFAULT in /etc/default/grub, then:
sudo grub-mkconfig -o /boot/grub/grub.cfgTo undo: remove the option and rerun grub-mkconfig. Or, for a single boot, delete it at the GRUB menu with e. To drop to 60Hz, swap in vbt_60hz.bin.
6. Fixes for problems afterwards
Right third of the screen is dead. If you rotate the display, X can keep a portrait-sized desktop. Run:
xrandr --output DSI-1 --mode 1200x1920 --rate 90 --rotate right --fb 1920x1200Then re-apply your desktop's display settings (XFCE: Settings → Display → Apply) so the saved profile is updated.
Wi-Fi worse. Check iw dev wlan0 link. If you're on 2.4GHz (freq 24xx), switch to your router's 5GHz network and the problem may go away. This is where Chuwi's interference warning would apply. To force 5GHz for one network:
nmcli connection modify "<your network>" 802-11-wireless.band aArtifacts at 90Hz. Switch to the 60Hz file. If the artifacts disappear, the panel just can't handle 90Hz.
Why not 120Hz?
At 120Hz each row of pixels gets under 4 µs to charge (vs 9.3 µs stock), and the panel's liquid crystals can't settle in 8 ms. Owners report visible image degradation at 120Hz. 90Hz is about the practical ceiling for this panel.
Notes
- Avoid kernels 6.6.15–6.9.0. The display is broken on this laptop in that range.
- Other distros: same idea. Put the file in the initramfs (dracut:
install_items+=) and add the kernel option through your bootloader. - The N150 model may use the same panel, but this is untested. Check that step 2's output matches before going further.
Sources
- 90Hz VBT patch (godorowski): https://github.com/godorowski/Chuwi-minibook-x-90hz-mode-on-CachyOS
- Chuwi forum, 50Hz / CRU on Windows: https://forum.chuwi.com/t/minibook-x-2023-50hz-choppy-ghosting/41613
- Linux on MiniBook X: https://github.com/sonnyp/linux-minibook-x
- Display bug, kernels 6.6.15–6.9: https://gitlab.freedesktop.org/drm/intel/-/issues/10334