GPD devices fan linux kernel driver

Caution

This driver has not been fully tested and reviewed.

It may cause damage to your device. Use at your own risk.

Continuous testing on my GPD Win Max 2 2023 (7840U) with kernel_zen in nixos-unstable

Should support

• GPD Win Mini (7840U)
• GPD Win Mini (8840U)
• GPD Win Max 2
• GPD Win Max 2 2023 (7840U)
• GPD Win Max 2 2024 (8840U)
• GPD Win 4 (6800U)
• GPD Win 4 (7840U)

Usage

• Current fan speed

  $ cat /sys/devices/platform/gpd_fan/hwmon/hwmon*/fan1_input

• Set fan speed control mode

  # 0: disable (full speed)
  # 1: manual
  # 2: auto
  $ echo 2 | sudo tee /sys/devices/platform/gpd_fan/hwmon/hwmon*/pwm1_enable

• Set fan speed

  # range: 0-255
  $ echo 127 | sudo tee /sys/devices/platform/gpd_fan/hwmon/hwmon*/pwm1

More about fields in hwmon subsystem, please read https://www.kernel.org/doc/Documentation/hwmon/sysfs-interface .

This driver should auto detected your device, if not, please report an issue.

For testing not detected device, use model parameter gpd_fan_model to specify your device.

Supported models:

• wm2
• win4
• win_mini

Install

• Arch Linux(thx @dreirund): gpd-fan-driver-dkms-git
• NixOS: nixosModules.default

Upstreaming

The driver is tried to upstreaming to the kernel mainline. The work progress could be seen in branch in-tree and my linux fork. The main branch will write whatever I'd like and the in-tree branch will catering to the preferences of kernel developers.

Datasheet

Credit

• Bilibili: @范东东咚咚

Device		DMI			EC RAM		Read (rpm)	Write (pwm)
Series	CPU	Manufacturer	Product	Version	REG_ADDR	REG_DATA		Addr		Max	Auto (=0)
GPD Win Mini	7840U	GPD	G1617-01		0x4E	0x4F	0x0478	0x047A		244	0x047A
	8840u
	HX 370		G1617-02
			G1617-02-L
GPD Pocket 4			G1628-04
			G1628-04-L
GPD Duo			G1622-01					0x047A	0x047B
			G1622-01-L
GPD Win 4	6800U		G1618-04	Default string	0x2E	0x2F	0xC880	0xC311		127	0xC311
	7840U			Ver. 1.0	0x4E	0x4F	0x0218	0x1809		184	0x0275
				Ver.1.0
GPD Win Max 2	6800U		G1619-04
	7840U
	8840U
	HX 370		G1619-05