/umpc-ubuntu

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

Primary LanguageShellMIT LicenseMIT

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 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 a bespoke images for the GPD Pocket, GPD Pocket 2, 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 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.
  • Enable double size console (tty) font resolution.
  • GRUB is usable post-install.
    • GPD Pocket, WIN 2, MicroPC & TopJoy Falcon GRUB is rotated 90 degrees, but functional.
    • GPD Pocket 2 and GPD P2 Max GRUB is correctly rotated and functional.
  • GPD Pocket BRMC4356 WiFi firmware enabled by default.
  • GPD Pocket fan control kernel module enable by default.

Known Issues

GPD Pocket, WIN 2, MicroPC, WIN Max and Topjoy Falcon

  • The GRUB2 menu is rotated 90 degrees on the GPD Pocket, MicroPC and Topjoy Falcon.
    • The workaround is to tilt your head.
  • The built in speaker in the GPD Pocket is mono and doesn't play audio from the right channel.
    • The workaround is to use headphones connected the 3.5mm audio jack.

GPD Pocket 2

  • The boot menu is not displayed in the GPD Pocket 2 live media.
    • The workaround is to wait and the system will boot after a few seconds or press Enter to boot immediately.
    • However, GRUB is fully functional and usable post-install.

GPD WIN 2, GPD WIN Max & Topjoy Falcon

  • The Plymouth splash screen is not correctly orientated; and for the GPD WIN Max incorrectly coloured.
    • The workaround is to not care.

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
sudo ./umpc-ubuntu.sh enable || disable

You must supply one of the following modes of operation

  • enable : apply the UMPC hardware configuration
  • disable : remove the UMPC hardware configuration
  • help : This help.

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 20.04 (or newer) flavours.
sudo ./umpc-ubuntu-respin.sh -d gpd-pocket ubuntu-mate-20.04.1-desktop-amd64.iso
sudo ./umpc-ubuntu-respin.sh -d gpd-pocket2 ubuntu-mate-20.04.1-desktop-amd64.iso
sudo ./umpc-ubuntu-respin.sh -d gpd-micropc ubuntu-mate-20.04.1-desktop-amd64.iso
sudo ./umpc-ubuntu-respin.sh -d gpd-p2-max ubuntu-mate-20.04.1-desktop-amd64.iso
sudo ./umpc-ubuntu-respin.sh -d gpd-win-max ubuntu-mate-20.04.1-desktop-amd64.iso
sudo ./umpc-ubuntu-respin.sh -d topjoy-falcon ubuntu-mate-20.04.1-desktop-amd64.iso

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

Accessing UMPC boot menus

GPD Pocket, GPD MicroPC, GPD P2 Max, OneMix Yoga 2

Switch the device on, immediately hold the Fn key and tap the F7 key until the Boot Manager screen appears.

GPD Win Max

Switch the device on, immediately hold the F7 key until the Boot Manager screen appears.

GPD Pocket 2 & Topjoy Falcon

Switch the device on, immediately hold the Fn key and tap the F12 key until the Boot Manager screen appears.

Accessing UMPC BIOS menus

GPD WIN 2

Switch the device on, when the GPD logo is displayed press Del to enter the BIOS, navigate to Save & Exit and choose the storage device you want to boot from under Boot Override

Topjoy Falcon

Switch the device on, immediately hold the Fn key and tap the F2 key until the BIOS appears.

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.18 >= 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 WIN 2 eDP-1 / eDP1 720x1280 Right HK-ZYYK-US-A1-02-00 USB Keyboard Mouse Goodix Capacitive TouchScreen >= 4.18 >= 19.04 gpd-pocket2
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 ? ? ? n/a