win3-resources/scripts/README.md

82 lines
2.2 KiB
Markdown

# Scripts
A collection of scripts for the GPD Win 3. Mostly to minimize the reuqired typing on the keyboard.
To install scripts, copy them somewhere on your Win 3, then add them to your path. This is done by adding a line to the end of `~/.bashrc`
## Quickstart
To quickly install the scripts, make sure `git` is installed and run this in a terminal:
```bash
mkdir -p ~/.local
git clone https://gitea.quad.moe/quad/win3-resources.git ~/.local/gpd-win3
echo -e "\n# GPD Win 3 scripts\nPATH=\"\${PATH}:\${HOME}/.local/gpd-win3/scripts\"" >> ~/.bashrc
```
Then restart your terminal. Run `tdp check` to test if it's working. It should report back current TDP.
## TDP
Lets you set the TDP using `intel_rapl`. Tested on Ubuntu 21.04.
Also supports shortened commands for minimal typing on the mediocre keyboard.
PL1 is set to number provided, PL2 is set 2W higher, maybe PL2 will be customizable in the future.
You will have to enter your sudo password when changing TDP.
Common TDPs are:
- 8W (Ultra-low power, mostly just 2D games)
- 12W (Low-power)
- 15W (Balanced)
- 20W (High perf)
- 30W (Max perf)
For details on how to use, run `tdp help`.
Common examples:
```bash
# Check current TDP
tdp check
# Set TDP to 8W
tdp set 8
# Set TDP to 8W (Shortened)
tdp s 8
# Check both PL1 and PL2
tdp check --detail
# Check both PL1 and PL2 (Shortened)
tdp c -d
```
*Protip:* Add `tdp check` to the end of your `.bashrc` file. Then your terminal will display the TDP every time it's opened, without needing to run any command.
### Setting TDP at boot
Copy `tdp-set.service` into `/etc/systemd/system/`
Edit `/etc/systemd/system/tdp-set.service` and change the `ExecStart=` line so it points to your tdp script, and type in your preferred wattage at the end.
Enable the service:
```
sudo systemctl deamon-reload
sudo systemctl enable tdp-set.service
```
Reboot your Win 3, then run `tdp check` to verify that TDP was set correctly.
## Touch fix
The script `touch-fix` unloads, then loads the touchscreen modules needed by the Win 3. This makes the touchscreen work, but only until next reboot. Useful until a permanent fix is available.
Example commands:
```bash
# Reload touchscreen module
touch-fix
```