Skip to content
Scripts for UMPCs such as GPD Pocket, Pocket 2, MicroPC & TopJoy Falcon
Shell
Branch: master
Clone or download
Latest commit da5f8c4 Aug 17, 2019

README.md

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

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 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 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, WIN 2, 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, WIN 2, 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 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 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

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
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
You can’t perform that action at this time.