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 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 successfull 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.

Pre-configured images

The Ubuntu MATE team offers a bespoke images for the GPD Pocket, GPD Pocket 2, GPD MicroPC and Topjoy Falcon that include the hardware specific tweaks to get these devices working "out of the box" without any faffing about.

• https://ubuntu-mate.org/download/

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 whell 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.
• Enable resolution scaling for 1920x1200 displays. (MATE Desktop only)
  • Results in an effective resolution of 1280x800 to make the small display panels easily readable.
  • Simple to disable if you want to restore full resolution.
• GRUB is usable post-install.
  • GPD Pocket, MicroPC & TopJoy Falcon GRUB is rotated 90 degress, but functional.
  • GPD Pocket 2 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, MicroPC and Topjoy Falcon

• The GRUB2 menu is rotated 90 degress 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 two 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 immeditately.
  • However, GRUB is fully functional and usable post-install.

GPD Pocket, Pocket 2 & MicroPC, Topjoy Falcon

• The Plymouth splash screen is not rotated.
  • The workaround is to not care.

The Scripts

These scripts have been tested on Ubuntu MATE 18.04.2, 18.10, 19.04 and 19.10. All Ubuntu flavours should work although if you use Wayland your mileage may vary. The GPD MicroPC currently requires Ubuntu 19.10.

umpc-ubuntu.sh

Install one of the Ubuntu 18.04.2 (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 18.04.2 (or newer) flavours.

sudo ./umpc-ubuntu-respin.sh -d gpd-pocket ubuntu-mate-18.04.2-desktop-amd64.iso
sudo ./umpc-ubuntu-respin.sh -d gpd-pocket2 ubuntu-mate-18.04.2-desktop-amd64.iso
sudo ./umpc-ubuntu-respin.sh -d topjoy-falcon ubuntu-mate-18.04.2-desktop-amd64.iso
sudo ./umpc-ubuntu-respin.sh -d gpd-micropc ubuntu-mate-19.10-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, OneMix Yoga 2

Switch the devcice on, immediately hold the Fn key and tap 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

Topjoy Falcon

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

Device matrix

Device	Monitor	Resolution	Rotation	Trackpoint	Touch Screen	Kernel	Ubuntu
GPD Pocket	DSI-1 / DSI1	1200x1920	Right	SINO WEALTH Gaming Keyboard	Goodix Capacitive TouchScreen	>= 4.18	>= 18.04.2
GPD Pocket 2	eDP-1 / eDP1	1200x1920	Right	HAILUCK CO.,LTD USB KEYBOARD Mouse	Goodix Capacitive TouchScreen	>= 4.18	>= 18.04.2
GPD MicroPC	DSI-1 / DSI1	720x1280	Right	AMR-4630-XXX-0- 0-1023 USB KEYBOARD Mouse	n/a	>= 5.2	>= 19.10
TopJoy Falcon	DSI-1 / DSI1	1200x1920	Right	HAILUCK CO.,LTD USB KEYBOARD Mouse	Goodix Capacitive TouchScreen	>= 4.18	>= 18.04.2
OneMix Yoga	?	1200x1920	Right	HAILUCK CO.,LTD USB KEYBOARD Mouse	Goodix Capacitive TouchScreen	>= 4.18	>= 18.04.2
OneMix Yoga 2	eDP-1 / eDP1	1200x1920	Right	HAILUCK CO.,LTD USB KEYBOARD Mouse	Goodix Capacitive TouchScreen	>= 4.18	>= 18.04.2