• Stars
    star
    211
  • Rank 186,920 (Top 4 %)
  • Language
    Shell
  • License
    MIT License
  • Created about 6 years ago
  • Updated 4 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Scripts for UMPCs such as GPD Pocket, Pocket 2, MicroPC & TopJoy Falcon

UMPC hardware configuration for Ubuntu

Here are a couple of scripts for Ultra Mobile PCs (UMPC) such as the GPD Pocket, GPD Pocket 2, GPD Pocket 3, GPD MicroPC, GPD WIN 2, GPD P2 Max, GPD WIN Max and Topjoy Falcon for Ubuntu users.

  • umpc-ubuntu.sh: install the required hardware configuration on a running Ubuntu install.
  • umpc-ubuntu-respin.sh: modify an existing Ubuntu .iso image with UMPC specific hardware configuration.

Ultra Mobile PCs (UMPC) have had something of a resurgence in recent years thanks to very successful crowd funding campaigns for netbook style laptops featuring a high resolution touch displays housed in an aluminium alloy body. These scripts for UMPC devices are based on the excellent work by Hans de Goede, nexus511, stockmind and many others.

GPD Pockets

Pre-configured images

The Ubuntu MATE team offers bespoke images for the GPD Pocket, GPD Pocket 2, GPD Pocket 3, GPD WIN 2, GPD MicroPC, GPD P2 Max, GPD WIN Max and Topjoy Falcon that include the hardware specific tweaks to get these devices working "out of the box" without any faffing about. Some models of the OneMix Yoga devices are also supported.

What works

The Ubuntu MATE images for the UMPCs add the following tweaks:

  • Enable frame buffer, Plymouth and Xorg display rotation.
    • Supports modesetting and xorg-video-intel display drivers.
  • Enable TearFree rendering by default.
  • Enable touch screen rotation for Xorg and Wayland.
  • Enable scroll wheel emulation for Xorg.
    • While holding down the right track point button on the Pocket, Pocket 2 & Topjoy Falcon.
    • While holding down the centre track point button on the MicroPC & Pocket 3.
  • Enable double size console (tty) font resolution for high resolution devices.
  • Enable fractional scaling for 1920x1200 displays. (MATE Desktop only)
    • Results in an effective resolution of 1280x800 to make the display panels easily readable.
    • Simple to toggle on/off if you want to restore full resolution.
  • GPD Pocket:
    • BRMC4356 WiFi firmware enabled by default.
    • Fan control kernel module enabled by default.
  • GPD Pocket 3 & TopJoy Falcon:
    • Accelerometer support for automatic screen rotation.
  • GPD WIN Max:
    • Features a custom, persistent, EDID.

Known Issues

The GRUB menu is rotated 90 degrees

The workaround is to tilt your head. Issue affects:

  • GPD Pocket
  • GPD Pocket 3
  • GPD MicroPC
  • GPD WIN 2
  • GPD WIN Max
  • TopJoy Falcon

Boot splash is rotated 90 degrees

The workaround is to tilt your head. Issue affects:

  • GPD WIN Max

Touch coordinates incorrect when external HDMI monitor is connected

When a HDMI display is connected, the touch coordinates on the internal display are incorrect. Issue affects:

  • GPD Pocket 3

The Scripts

These scripts have been tested on Ubuntu MATE 20.04.1. All Ubuntu flavours should work although if you use Wayland your mileage may vary.

umpc-ubuntu.sh

Install one of the Ubuntu 20.04 (or newer) flavours on a supported UMPC device and run the following to inject the required hardware configuration.

git clone https://github.com/wimpysworld/umpc-ubuntu.git
cd umpc-ubuntu

Edit ./umpc-ubuntu.sh and change UMPC="gpd-pocket3" at the top of the script to match your computer, supported options are: gpd-pocket, gpd-pocket2, gpd-pocket3, gpd-p2-max, gpd-micropc, gpd-win2, gpd-win-max or topjoy-falcon.

Then run the script to enable the configuration tweaks.

sudo ./umpc-ubuntu.sh enable

umpc-ubuntu-respin.sh

git clone https://github.com/wimpysworld/umpc-ubuntu.git
cd umpc-ubuntu
  • Download an .iso image for one of the Ubuntu MATE 20.04 (or newer) or one of the other Ubuntu flavours.
sudo ./umpc-ubuntu-respin.sh -d gpd-pocket ubuntu-mate-20.04.3-desktop-amd64.iso
sudo ./umpc-ubuntu-respin.sh -d gpd-pocket2 ubuntu-mate-20.04.3-desktop-amd64.iso
sudo ./umpc-ubuntu-respin.sh -d gpd-pocket3 ubuntu-mate-21.10-desktop-amd64.iso
sudo ./umpc-ubuntu-respin.sh -d gpd-micropc ubuntu-mate-20.04.3-desktop-amd64.iso
sudo ./umpc-ubuntu-respin.sh -d gpd-p2-max ubuntu-mate-20.04.3-desktop-amd64.iso
sudo ./umpc-ubuntu-respin.sh -d gpd-win2 ubuntu-mate-20.04.3-desktop-amd64.iso
sudo ./umpc-ubuntu-respin.sh -d gpd-win-max ubuntu-mate-20.04.3-desktop-amd64.iso
sudo ./umpc-ubuntu-respin.sh -d topjoy-falcon ubuntu-mate-20.04.3-desktop-amd64.iso

A new .iso will be created that includes the additional hardware tweaks required by the selected UMPC device.

Accessing boot menus & BIOS

Switch the device on, immediately hold/tap the corresponding key(s).

Device BIOS Boot Menu
GPD Pocket Del Fn + F7
GPD Pocket 2 Fn + F12 Fn + F12
GPD Pocket 3 Fn + F7 Fn + F7
GPD WIN 2(!) Del Del
GPD WIN 3(!) Del Del
GPD MicroPC Del Fn + F7
GPD P2 Max Fn + F7 Fn + F7
GPD WIN Max F7 F7
OneMix Yoga 2 Fn + F7 Fn + F7
TopJoy Falcon Fn + F2 Fn + F12
  • GPD WIN 2/3(!): Boot it by holding Del (Fn+Backspace), navigate to Save & Exit and choose the storage device you want to boot from under Boot Override

Device matrix

Please help complete this table by running the following commands from an Ubuntu Live image:

xrandr --query
xinput
Device Monitor Resolution Rotation Keyboard/Mouse Touch Screen Kernel Req Ubuntu Req Common
GPD Pocket DSI-1 / DSI1 1200x1920 Right SINO WEALTH Gaming Keyboard Goodix Capacitive TouchScreen >= 4.14 >= 18.04.2 gpd-pocket
GPD Pocket 2 eDP-1 / eDP1 1200x1920 Right HAILUCK CO.,LTD USB KEYBOARD Mouse Goodix Capacitive TouchScreen >= 4.18 >= 18.04.2 gpd-pocket2
GPD Pocket 3 DSI-1 / DSI1 1200x1920 Right HAILUCK CO.,LTD USB KEYBOARD Mouse GXTP7380:00 27C6:0113 >= 5.15 >= 22.04 gpd-pocket3
GPD WIN 2 eDP-1 / eDP1 720x1280 Right HK-ZYYK-US-A1-02-00 USB Keyboard Mouse Goodix Capacitive TouchScreen >= 4.18 >= 19.04 gpd-win2
GPD WIN 3 DSI-1 / DSI1 720x1280 Right Goodix Capacitive TouchScreen >= 5.15 >= 22.04 gpd-win3
GPD MicroPC DSI-1 / DSI1 720x1280 Right AMR-4630-XXX-0- 0-1023 USB KEYBOARD Mouse n/a >= 5.2 >= 19.10 gpd-micropc
GPD P2 Max eDP-1 / eDP1 2560x1600 n/a HAILUCK CO.,LTD USB KEYBOARD Mouse Goodix Capacitive TouchScreen gpd-p2-max
GPD WIN Max eDP-1 / eDP1 800x1280 Right HTIX5288:00 093A:0255 Mouse Goodix Capacitive TouchScreen >= 5.4 >= 20.04.1 gpd-win-max
OneMix Yoga 1200x1920 Right HAILUCK CO.,LTD USB KEYBOARD Mouse Goodix Capacitive TouchScreen >= 4.18 >= 18.04.2
OneMix Yoga 1s eDP-1 / eDP1 1200x1920 Right HAILUCK CO.,LTD USB KEYBOARD Mouse Goodix Capacitive TouchScreen >= 4.18 >= 18.04.2 gpd-pocket2
OneMix Yoga 2 eDP-1 / eDP1 1200x1920 Right HAILUCK CO.,LTD USB KEYBOARD Mouse Goodix Capacitive TouchScreen >= 4.18 >= 18.04.2 gpd-pocket2
TopJoy Falcon DSI-1 / DSI1 1200x1920 Right HAILUCK CO.,LTD USB KEYBOARD Mouse Goodix Capacitive TouchScreen >= 4.18 >= 18.04.2 topjoy-falcon
Chuwi Minibook X DSI-1 / DSI1 1200x1920 Right SIPODEV USB Composite Device Mouse

More Repositories

1

deb-get

apt-get for .debs published via GitHub or direct download 📦
Shell
1,321
star
2

desktopify

Convert Ubuntu Server for Raspberry Pi into a Desktop
Shell
521
star
3

rolling-rhino

Rolling Rhino; convert Ubuntu into a rolling release. As seen on YouTube 📺
Shell
430
star
4

nix-config

Wimpy's NixOS, nix-darwin & Home Manager Configurations ❄️
Nix
367
star
5

retro-home

Retro Home; your home for retro-gaming 🕹
Shell
109
star
6

antsy-alien-attack

A game, written in Bash, that is a somewhat retro-a-like shoot 'em up. Hopefully.
Shell
107
star
7

obs-studio-portable

Portable OBS Studio for Ubuntu bundled with 50 plugins
Shell
83
star
8

argon1-ubuntu

Argon 1 Case and Argon Fan HAT controller for Ubuntu
Shell
70
star
9

obs-fully-loaded

OBS Studio, fully-loaded, for Ubuntu
Shell
57
star
10

little-spy

Airdrop into an enemy stronghold, recover stolen intelligence and technology. Fight your way out! 🎮
GDScript
41
star
11

ia-get

File downloader for archive.org ⬇️
Rust
38
star
12

stream-sprout

Restream a video source to multiple destinations such as Twitch, YouTube, Owncast and Peertube 📡
Shell
25
star
13

machinespawn

Wrapper for machinectl and systemd-nspawn for creating containers
Shell
22
star
14

redirect-livechat

A simple Python 🐍 server that redirects to a YouTube 📺 channel's most recent live chat 💬 URL
Python
16
star
15

trackmania-2020-ubuntu

Ubuntu Install & Launcher script for TrackMania 2020 🏁🏎
Shell
10
star
16

antsy-alien-attack-pico

The year is 2139. Planet Earth is under attack by aliens, and they're (still) antsy! 👾🛸💥
HTML
9
star
17

ubuntu-pi-image

Raspberry Pi 🥧 image creator for Ubuntu MATE 🧉
Shell
8
star
18

obs-studio-flaking-loaded

OBS Studio for NixOS ❄️ that bundles an extensive collection of 3rd party plugins
5
star
19

obs-dvd-screensaver

DVD screen saver for OBS Studio 📀
CMake
5
star
20

kruiz-control-triggers

Kruiz Control 🎛️ Triggers for Twitch Chatbot, OBS Studio Automation & DecAPI
HTML
3
star
21

obs-rgb-levels

RGB levels plugin for OBS Studio 🎚️🌈
CMake
1
star