Advantech AdvLinuxTU User manual

AdvLinuxTU
User Manual
V1.1.2

Contents
1. About This Manual.................................................................................................1
2. AdvLinuxTU Overview..........................................................................................1
2.1. Hardware Support List.......................................................................................................1
2.2. Kernel Version...................................................................................................................2
2.3. Software version：............................................................................................................2
2.4. User and Password.............................................................................................................2
2.5. Main Features.....................................................................................................................2
2.6. AdvLinuxTU Screenshot ...................................................................................................3
3. Installation Guide....................................................................................................4
3.1. System Requirements.........................................................................................................4
3.2. Prepare for Installation.......................................................................................................4
3.3. Install from USB disk ........................................................................................................4
3.4. Raid mode & Installation Steps..........................................................................................5
3.4.1. Setting RAID Mode................................................................................................5
3.4.2. Create RAID Volume .............................................................................................6
3.5. Boot Mode & Installation Steps.........................................................................................8
3.5.1. Legacy Boot Mode Installation Steps .....................................................................8
3.5.2. UEFI Boot Mode Installation Steps......................................................................14
4. Advantech device driver.......................................................................................20
5. EAPI(Embedded API) Solution............................................................................20
6. AdvLinuxTU X-Windows Introduction ...............................................................20
6.1. X-Windows overview ......................................................................................................20
6.2. X-windows tools..............................................................................................................20
6.2.1. X Terminal............................................................................................................20
6.2.2. Thunar...................................................................................................................21
6.2.3. Browser.................................................................................................................22
6.3. X-Windows Configuration...............................................................................................22
6.3.1. Resolution configuration.......................................................................................23
6.3.2. IP configuration ....................................................................................................24
6.3.3. Sound card configuration......................................................................................25
7. Introduction of console mode tools ......................................................................26
7.1. Date and time configuration.............................................................................................26
7.2. Ftp service........................................................................................................................26
7.3. SSH service......................................................................................................................26
7.4. Qt Runtime and Development Environment....................................................................26
7.4.1. Qt runtime environment........................................................................................26
7.4.2. Qt Development environment...............................................................................26
8. System backup and restore ...................................................................................28
8.1. How to backup.................................................................................................................28
8.2. How to restore..................................................................................................................28
9. WISE-PaaS/AppHub ............................................................................................30
9.1. What is WISE-PaaS/AppHub ..........................................................................................30
9.2. Features............................................................................................................................30

9.3. How to use .......................................................................................................................31
9.3.1. Server runtime environment setup........................................................................32
9.3.2. Device environment setup ....................................................................................32
9.3.3. Device Enroll to server .........................................................................................33

AdvLinuxTU Manual
1
1. About This Manual
Thank you for choosing Advantech. This manual is for AdvLinuxTU and can be
copied and distributed in any medium.
AdvLinuxTU is based on Xbuntu 18.04.x, its kernel is 4.15.
2. AdvLinuxTU Overview
AdvLinuxTU is an embedded Linux system designed for Advantech embedded
devices, and it is especially optimized for TPC/UNO/PPC/ITA series.
2.1. Hardware Support List
AdvLinuxTU can be installed on all Advantech devices theoretically, but only the
following device is tested.
TPC Series
TPC-B200-J12AE
TPC-B500-633AE
TPC-5152T-633AE
TPC-5212W-633AE
TPC-2181WP-533AE
TPC-2211W-J12AE
TPC-2151T-J12AE
TPC-312-R83xA
TPC-312-R85xA
TPC-312-R87xA
TPC-315-R83xA
TPC-315-R85xA
TPC-315-R87xA
TPC-317-R83xA
TPC-317-R85xA
TPC-317-R87xA
TPC-324W-P83xA
TPC-324W-P85xA
TPC-324W-P87xA
UNO Series
UNO-247

AdvLinuxTU Manual
2
UNO-420
UNO-1372G-J0x1AE
UNO-2271G-E(0)xxxE
UNO-2272G-JxAE
UNO-2372G-E0xxAE
UNO-2372G-J0xxAE
UNO-2372G-J1xxAE
UNO-2473G-ExAE
UNO-2473G-JxAE
UNO-2484G-6xxxAE
UNO-2484G-7xxxAE
UNO-2483G-4xxAE
UNO-137-E1
UNO-410-E1
UNO-430-E1
WISE-5580
2.2. Kernel Version
Kernel version: 4.15
2.3. Software version：
Xorg: 1.19.6
Qt：5.9.5
glibc：2.27
gcc: 7.3.0
2.4. User and Password
There are three users in AdvLinuxTU by default. The user and default password is as
follows：
root:111111
advantech:111111
sysuser: 1111111
2.5. Main Features
AdvLinuxTU has many important features coming for industrial customers. Here we
list some of them and give a brief introduction. We will explain them in detail in later

AdvLinuxTU Manual
3
sections.
Provide Embedded QT runtime environment
The user can run embedded QT application.
Auto login
The installation offers an auto login option; if the user chooses it, the user will be
able to auto login to AdvLinuxTU after the installation.
USB installation support
The user can burn the AdvLinuxTU ISO to a USB disk, and then the user can
install AdvLinuxTU to Advantech device from the USB disk.
Hardware auto detection
When installing AdvLinuxTU, the installation will detect the hardware
automatically and install all drivers it needs. Therefore, once the installation is
completed, no more drivers will be needed unless the user adds some other
devices such as Advantech data collecting card to the embedded device.
Online Installation and Update
You can use apt-get command to install and update software, extending
AdvLinuxTU functions.
2.6. AdvLinuxTU Screenshot
Picture 2-6-1 Default Desktop

AdvLinuxTU Manual
4
3. Installation Guide
In this chapter, we will introduce the installation step by step.
3.1. System Requirements
Recommended requirements:
Storage size:
32 G or more
Memory size:
2 G or more
3.2. Prepare for Installation
We suggest that the user makes a copy of data in storage medium in order to prevent
data lost in case of improper operation during installation.
AdvLinuxTU supports installing from USB disk.
Prepare：
AdvLinxTU ISO
USB Disk （storage size is more than 2G）
Rufus utility
3.3. Install from USB disk
We use Rufus tool to Burn AdvLinuxTU ISO file to USB disk, Rufus is a utility that
helps format and create bootable USB flash drives, Rufus is open source and is
100% Free Software (GPL v3)，You can download from https://rufus.ie/
System Requirements for Rufus:
Windows 7 or later, 32 or 64 bit doesn't matter. Once downloaded, the application is
ready to use.

AdvLinuxTU Manual
5
Picture 3-3-1 Select the AdvLinuxTU ISO File and start to burn
Burn the ISO as follows:
a) Insert USB disk to windows PC
b) Start Rufus tool
c) Select AdvLinuxTU ISO
d) Click START to start burn
3.4. Raid mode & Installation Steps
UNO-2483G,UNO-2484G,UNO-3283G,TPC-B500 support raid mode.
3.4.1. Setting RAID Mode
Enter the BIOS interface, set the hard disk mode to RAID mode.

AdvLinuxTU Manual
6
3.4.2. Create RAID Volume
Enter “ctr + i”will show the RAID interface, choose “Create RAID Volume” and
press enter.
Enter “Shift + y”to Create Raid Volume. At present, RAID1 is mainly supported. The
specific steps are as follows

AdvLinuxTU Manual
7
Don’t modify the defalt “Volume1”, otherwise AdvlinuxTU will install failed.
You can see Volume1 show up.
Enter “Shift + y”to exit.

AdvLinuxTU Manual
8
3.5. Boot Mode & Installation Steps
AdvLinuxTU supports two boot modes: Legacy and UEFI.
3.5.1. Legacy Boot Mode Installation Steps
3.5.1.1. BIOS Configuration
Step1: CSM configuration

AdvLinuxTU Manual
9
Step2: USB configuration
Step3: Boot Option #1 selection

AdvLinuxTU Manual
10
3.5.1.2. System Mode Selection (Gui/Console)
If you want to boot into the graphical interface, select the first one.
If you want to boot into the character interface, select the second one.

AdvLinuxTU Manual
11
3.5.1.3. OS Installation
If the device has multiple disks (two disks have been tested at most), picture a and
picture b will be show to select disk for installation. But it will auto install except in
this case.
Select disk for installation, enter “Install Now”.
Picture a

AdvLinuxTU Manual
12
Enter “Yes”, it will start the installation.
Picture b
Picture c

AdvLinuxTU Manual
13
Picture d
3.5.1.4. Change Boot Option #1
Enter Reboot and go into BIOS, change device hard disk as Boot Option #1.

AdvLinuxTU Manual
14
3.5.2. UEFI Boot Mode Installation Steps
3.5.2.1. BIOS Configuration
Step1: CSM configuration
Step2: USB configuration

AdvLinuxTU Manual
15
Step3: Boot Option #1 selection
3.5.2.2. System Mode Selection (Gui/Console)
If you want to boot into the graphical interface, select the first one.
If you want to boot into the character interface, select the second one.

AdvLinuxTU Manual
16
3.5.2.3. OS Installation
If the device has multiple disks (two disks have been tested at most), picture a and
picture b will be show to select disk for installation. But it will auto install except in
this case.
Select disk for installation, enter “Install Now”.
Picture a

AdvLinuxTU Manual
17
Enter “Yes”, it will start the installation.
Picture b
Picture c