~~tag>VIM3 VIM3L qt5~~
====== VIM3/3L QT5 ======

===== Introduction =====

<WRAP info >
The default QT packages from Ubuntu official are built with OpenGL Desktop support, but for VIMs, there don’t have Mali GPU driver under X11, so you can’t use QT with GPU.In order to use QT with GPU (fbdev), we have rebuilt the QT packages with eglfs Mali GPU support.
</WRAP>

<WRAP alert >
  * Only support Framebuffer Console mode.
  * Install this version of library will break some official packages which depend on this library.
  * The QT5 with eglfs Mali GPU (fbdev) only supports Ubuntu 20.04 Linux 4.9.
</WRAP>

===== System Configuration =====

Please make sure you use the latest image, if not please follow [[/products/sbc/common/configurations/upgrade-system|Upgrade The System]] to upgrade your system.

Install QT5 packages.

```shell
sudo apt update
sudo apt install qt5-default qtbase5-examples
mkdir /tmp/qt5
cd /tmp/qt5
wget https://dl.khadas.com/repos/debs/vim3/focal/qt5/libqt5gui5_5.12.8%2Bdfsg-0ubuntu2_arm64.deb
sudo dpkg -i libqt5gui5_5.12.8+dfsg-0ubuntu2_arm64.deb
```
===== Demonstrate =====

Switch to Framebuffer mode.For desktop image, you can use ''Ctrl''+''Alt''+''F1'' to switch to framebuffer console mode.

Setup the environment variables below.
```shell
export QT_QPA_PLATFORM=eglfs
export QT_QPA_EGLFS_INTEGRATION=eglfs_mali
```

Run test:

```shell
/usr/lib/aarch64-linux-gnu/qt5/examples/opengl/qopenglwidget/qopenglwidget
```

If every thing works you will see the QT demo running on screen. 

<WRAP info >
For more demos, please check ''/usr/lib/aarch64-linux-gnu/qt5/examples''.
</WRAP>

===== Setup for TS050 Touchscreen (Only for VIM3/VIM3L) =====

If you want to run the QT demo on TS050 touchscreen you need to remove the HDMI cable first.

The TS050 touchscreen is ''portrait mode'' by default, if you want to use the QT under ''landscape mode'' you need to setup the environment variables below to rotate the screen and touchscreen:


<tabbox VIM3>

```shell
export QT_QPA_EGLFS_ROTATION=90
export QT_QPA_EGLFS_DISABLE_INPUT=1
export QT_QPA_EVDEV_TOUCHSCREEN_PARAMETERS=/dev/input/event3:rotate=90
export QT_QPA_GENERIC_PLUGINS=evdevtouch:/dev/input/event3
```

<tabbox VIM3L>

```shell
export QT_QPA_EGLFS_ROTATION=90
export QT_QPA_EGLFS_DISABLE_INPUT=1
export QT_QPA_EVDEV_TOUCHSCREEN_PARAMETERS=/dev/input/event4:rotate=90
export QT_QPA_GENERIC_PLUGINS=evdevtouch:/dev/input/event4
```
</tabbox>

For other orientation rotation, you can change them yourself.


===== Troubleshooting =====

When you install such version of library you will break some packages (such as qtcreator) which depend on the original library, if you don’t want to break the packages you can follow the instructions below to install the original QT5 library.

```shell
wget http://ports.ubuntu.com/pool/universe/q/qtbase-opensource-src/libqt5gui5_5.12.8+dfsg-0ubuntu1_arm64.deb
sudo dpkg -i libqt5gui5_5.12.8+dfsg-0ubuntu1_arm64.deb
```
===== See Also =====

[[https://doc.qt.io/qt-5/embedded-linux.html|Qt for Embedded Linux]]