Advantech FWA-T011 User manual

Copyright 2017 All rights reserved. Advantech Co. Ltd.
ADVANTECH
QUICKSTART LINUX IMAGE
GETTING STARTED GUIDE
FWA-T011
Revision 0.2

Copyright 2017. All rights reserved. Advantech Co. Ltd. Page 2
Revision History
Date
[mm/dd/yyyy]
Revision
QSL Image
Version
Modifications
08/13/2018
0.1
1.00
Initial version –draft-
01/21/2019
0.2
1.00
Update l3fwd description

Copyright 2017. All rights reserved. Advantech Co. Ltd. Page 3
Table of Contents
1. INTRODUCTION ....................................................................................8
1.1 OVERVIEW .......................................................................................................................... 8
1.2 SOFTWARE VERSIONS OF QUICKSTART IMAGE AND INTEGRATED UTILITIES............. 8
1.3 SUPPORTED PLATFORMS .................................................................................................. 8
1.4 BIOS VERSION................................................................................................................... 9
1.5 TERMINOLOGY ................................................................................................................... 9
1.6 SOFTWARE LICENSE DISCLAIMER..................................................................................10
2. GETTING STARTED ........................................................................... 11
2.1 ACCESSORIES AND FACILITIES REQUIRED.....................................................................11
2.2 CABLE AND SYSTEM CONNECTIONS...............................................................................12
2.3 ETHERNET PORT MAPPING ............................................................................................14
2.4 CONFIGURE SERIAL PORT CONNECTION ON PUTTY.....................................................15
2.5 BIOS SETTING .................................................................................................................17
2.6 SYSTEM BOOT UP AND LOG IN.......................................................................................20
2.7 SSH CONNECTION TO ACCESS THE QUICKSTART IMAGE............................................21
3. COMMAND LINE PARAMETERS OF UTILITIES AND TOOLS . 23
3.1 AFRU .................................................................................................................................23
3.1.1 Command Examples.........................................................................................................................23
3.2 SENSORS ...........................................................................................................................24
3.2.1 APM (Advantech Platform Monitor).........................................................................................24
3.2.2 LM-Sensors...........................................................................................................................................25
3.3 WI-FI................................................................................................................................28
3.3.1 AP Mode.................................................................................................................................................29
3.3.2 Station Mode........................................................................................................................................29
3.4 WIRELESS .........................................................................................................................31
3.4.1 Run start_lte_by_mmcli_nmcli.sh to establish the connection ......................................31
3.5 WDT.................................................................................................................................32
3.5.1 Watchdog on PCH ..............................................................................................................................32
3.5.2 Watchdog on SuperIO .....................................................................................................................33
3.6 SOFTWARE DEFINED BUTTON .......................................................................................33
3.7 SOFTWARE DEFINED LED..............................................................................................34
3.7.1 Locate i2c bus of IO expander......................................................................................................34
3.7.1.1 I2c raw command to control led............................................................................................35
3.7.1.2 Kernel GPIO sysfs to control led ............................................................................................36
3.8 LSETH ................................................................................................................................37
3.9 DPDK...............................................................................................................................38
3.9.1 lscpu ........................................................................................................................................................38
3.9.2 Intel DPDK Pktgen ............................................................................................................................39
3.9.2.1 Command Usage of Pktgen ......................................................................................................39
3.9.2.2 Loopback Example for Running Pktgen .............................................................................40

Copyright 2017. All rights reserved. Advantech Co. Ltd. Page 4
3.9.3 Intel DPDK L2 Forwarding............................................................................................................45
3.9.3.1 Command Usage of L2fwd........................................................................................................46
3.9.3.2 L2fwd Example with Running Pktgen.................................................................................46
3.9.4 Intel DPDK L3 Forwarding............................................................................................................51
3.9.4.1 Command Usage of L3fwd........................................................................................................51
3.9.4.2 L3fwd Example with Running Pktgen.................................................................................51
3.10 DUI ...................................................................................................................................56
3.10.1 Basic Concept ......................................................................................................................................56
3.10.2 Services and Functions ...................................................................................................................56
3.10.3 DUI CLI Command Usage ...............................................................................................................56
3.10.3.1 help .....................................................................................................................................................56
3.10.3.2 quit......................................................................................................................................................57
3.10.3.3 list........................................................................................................................................................57
3.10.3.4 set ........................................................................................................................................................57
3.10.3.5 start ....................................................................................................................................................58
3.10.3.6 stop .....................................................................................................................................................58
3.10.3.7 wait.....................................................................................................................................................58
3.10.3.8 status..................................................................................................................................................59
3.10.3.9 result..................................................................................................................................................59
3.10.3.10 info .....................................................................................................................................................59
3.10.3.11 log .......................................................................................................................................................60
3.10.3.12 run ......................................................................................................................................................61
3.10.4 DUI with Fast-Batch .........................................................................................................................62
3.10.5 Use Case Scenarios ...........................................................................................................................64
3.10.5.1 Execute a Single Diagnostic Function Test........................................................................64
3.10.5.2 Execute a Batch Test via Tcl Script .......................................................................................67
3.10.5.3 Usage of Fastbatch.sh .................................................................................................................72
3.11 SYSINFO ............................................................................................................................74
3.12 SHUTDOWN THE SYSTEM................................................................................................76
4. REFERENCES TO OPEN SOURCE SOFTWARE INGREDIENTS 77
5. TIPS, TRICKS AND TROUBLESHOOTING.................................... 78
5.1 PROBING A SPECIFIC LAN PORT....................................................................................78

Copyright 2017. All rights reserved. Advantech Co. Ltd. Page 5
List of Figures
Figure 1: RJ45 to RS232 Serial Console Cable.......................................................................... 12
Figure 2: USB to RS232 Serial Adapter Cable .......................................................................... 12
Figure 3: FWA-T011-4CA1S System Rear View....................................................................... 13
Figure 4: FWA-T011-4CA1S System Front View ..................................................................... 14
Figure 5: Putty Session Setting ................................................................................................ 16
Figure 6: Serial Connection Setting on Putty........................................................................... 16
Figure 7: Putty Keyboard Setting............................................................................................. 16
Figure 8: Putty Colours Setting................................................................................................ 17
Figure 9: BIOS POST................................................................................................................. 17
Figure 10: BIOS Setup Menu.................................................................................................... 18
Figure 11: BIOS Boot Option Setting ....................................................................................... 18
Figure 12: Select USB Drive as the First Boot Device .............................................................. 19
Figure 13: Save and Exit BIOS .................................................................................................. 19
Figure 14: Ubuntu Boot Menu................................................................................................. 20
Figure 15: Linux Shell............................................................................................................... 21
Figure 16: Ping 192.168.1.3 for Testing................................................................................... 22
Figure 17: Setup SSH Connection on Putty.............................................................................. 22
Figure 18: SSH Connection Login............................................................................................. 22
Figure 19: Usage of Afru.......................................................................................................... 23
Figure 20: Print Afru Version Information............................................................................... 23
Figure 21: System FRU Information......................................................................................... 24
Figure 22: Sensor Configuration File for the FWA-T011.......................................................... 27
Figure 23: Print the Usage of lm_sensors................................................................................ 28
Figure 24: Get Platform Sensor Readings................................................................................ 28
Figure 25: The ‘lseth’ Command.............................................................................................. 38
Figure 26: The ‘lseth’ Command Usage................................................................................... 38
Figure 27: Loopback Example Test with Pktgen...................................................................... 40
Figure 28: The ‘dpdk-devbind-atom-latest.py -s’ Command................................................... 42
Figure 29: Pktgen CLI ............................................................................................................... 43
Figure 30: Loopback Test Result.............................................................................................. 44
Figure 31: the Concept of L2 Forwarding ................................................................................ 45
Figure 32: L2 Forwarding with Pktgen..................................................................................... 46

Copyright 2017. All rights reserved. Advantech Co. Ltd. Page 6
Figure 33: Pktgen Testing Result ............................................................................................. 49
Figure 34: L2fwd Testing Result............................................................................................... 50
Figure 35: Pktgen Testing Result ............................................................................................. 54
Figure 36: The ‘help’ Command .............................................................................................. 57
Figure 37: The ‘help list’ Command......................................................................................... 57
Figure 38: The ‘quit’ Command ............................................................................................... 57
Figure 39: The ‘list’ Command................................................................................................. 57
Figure 40: The ‘set’ Command................................................................................................. 58
Figure 41: The ‘start’ Command to Start a Function ............................................................... 58
Figure 42: Execute all Functions of the Cpu Test Service ........................................................ 58
Figure 43: The ‘stop’ Command .............................................................................................. 58
Figure 44: The ‘wait’ Command .............................................................................................. 59
Figure 45: The ‘status’ Command............................................................................................ 59
Figure 46: The ‘result’ Command ............................................................................................ 59
Figure 47: The ‘info’ Command ............................................................................................... 60
Figure 48: The ‘log’ Command................................................................................................. 61
Figure 49: The ‘run’ Command................................................................................................ 62
Figure 50: Execute DUI Daemon.............................................................................................. 64
Figure 51: List DUI Diagnostic/Update Services and Functions............................................... 66
Figure 52: Execute cpu_ver Diagnostic Function .................................................................... 67
Figure 53: An Example of DUI Batch Test Script...................................................................... 68
Figure 54: Power off System.................................................................................................... 76
Figure 55: Speed LED on LAN Port 3........................................................................................ 78

Copyright 2017. All rights reserved. Advantech Co. Ltd. Page 7
List of Tables
Table 1: Software Versions of OS and Utilities...........................................................................8
Table 2: Supported Platforms.....................................................................................................9
Table 3: BIOS Version .................................................................................................................9
Table 4: Terminology............................................................................................................... 10
Table 5: FWA-T011 SKU Configuration.................................................................................... 11
Table 6: Components on the FWA-T011-4CA1S Rear Panel.................................................... 13
Table 7: Components on the FWA-T011-4CA1S Front Panel .................................................. 14
Table 8: LAN Port Mapping for the FWA-T011-4CA1S ............................................................ 15
Table 9: Open Source Software Ingredients............................................................................ 77

Copyright 2017. All rights reserved. Advantech Co. Ltd. Page 8
1. INTRODUCTION
1.1 Overview
This document describes the functionalities and the usage of the Advantech FWA-T011
QuickStart Linux Image. The QuickStart Image provided on a pre-installed USB flash drive is
based on the Ubuntu Linux distribution and is configured to run on supported Advantech x86
network appliance platforms (FWA-T011).
Useful software utilities and tools which are either Advantech proprietary or are under open
source license are integrated into the image to provide customers with a quick and easy
approach for platform evaluation.
1.2 Software Versions of QuickStart Image and Integrated Utilities
The following table describes the software versions of OS image and integrated utility
packages for each QuickStart Linux Image release:
FWA-T011
QuickStart
Image Release
OS and Integrated Utilities
Version
Description
v1.00
Ubuntu version 18.04 LTS
(kernel version 4.15.0-23-
generic x86_64)
Linux distribution
afru v2.32
Advantech utility to read the FRU
information on platforms without BMC
Sensor-Reader v0.10
Advantech utility to read hardware sensors
on platforms without BMC
lm-sensors v3.4.0
(libsensors v3.4.0)
Open source utility to read hardware
sensors on platforms without BMC
DPDK v18.02.1
Intel DPDK greatly boosts packet processing
performance and throughput, allowing
more time for data plane application.
DUI v0.36
Advantech Diagnostic and Upgrade
Infrastructure utility for off-line diagnostic
and software upgrade
Table 1: Software Versions of OS and Utilities
1.3 Supported Platforms
FWA-T011 QuickStart Image Release
Supported Platforms
v1.00
FWA-T011

Copyright 2017. All rights reserved. Advantech Co. Ltd. Page 9
Table 2: Supported Platforms
1.4 BIOS Version
The QuickStart Image has been validated on the supported platforms using the firmware
version as below:
Platform
BIOS Version
FWA-T011
V0.08
Table 3: BIOS Version
1.5 Terminology
Term
Description
Afru
Utility for retrieving FRU information
API
Application Programming Interface
BIOS
Basic Input Output System
BSD
Berkeley Software Distribution license
CLI
Command Line Interface
CPU
Central Processing Unit
DPDK
Data Plane Development Kit
DUI
Diagnostic and Upgrade Infrastructure
EEPROM
Electrically Erasable Programmable Read-Only Memory
Event
System event, e.g. power on, power off, reset, WDT timeout
FRU
Field Replaceable Unit
FW
Firmware
GPL
GNU General Public License
GUI
Graphic User Interface
HTTP
Hyper Text Transfer Protocol
IPMI
Intelligent Platform Management Interface
LAN
Local Area Network
LED
Light Emitting Diode
LGPL
GNU Lesser General Public License
LTE
Long Term Evolution
NIC
Network Interface Controller, a combination of MAC and PHY
aka LAN controller
OpenHPI
Open source implementation of the Service Availability Forum
Hardware Platform Interface
OS
Operating System
PCIe
PCI Express
PFA
PCI Function Address
PIN
Personal Identification Number
POST
Power On Self Test
SEL
System Event Log
SFP
Small Form-Factor Pluggable
SIM
Subscriber Identity Module
SKU
Stock Keeping Unit
SPD
Serial Presence Detect

Copyright 2017. All rights reserved. Advantech Co. Ltd. Page 10
SSD
Solid State Disk
SSH
Secure Shell
SW
Software
Tcl
Tool Command Line language
UMTS
Universal Mobile Telecommunications System
USB
Universal Serial Bus
WDT
Watchdog Timer
Table 4: Terminology
1.6 Software License Disclaimer
The QuickStart Linux Image is provided “as is”, without warranty of any kind, and for
evaluation purposes of the related Advantech platform only. No license, title or rights are
granted except for the purpose stated above.
Advantech does not guarantee or take any liability for correct operation of the QuickStart
Linux Image and any issues arising from use of the QuickStart Linux Image.
Advantech does not warrant that the QuickStart Linux Image does not violate any 3rd party
intellectual property, patents or rights. Use of the QuickStart Linux Image is at the sole
discretion and risk of the user, and use of any open source software is entirely governed by
the license terms of such software.
For licensing of any software and firmware ingredients of the QuickStart Linux Image, please
contact your Advantech representative.

Copyright 2017. All rights reserved. Advantech Co. Ltd. Page 11
2. GETTING STARTED
In this section, we will introduce the steps of booting up the Advantech QuickStart Image
from USB flash drive on an Advantech FWA-T011 network appliance.
The table below shows the SKU configuration of FWA-T011:
Part Number
Configuration
FWA-T011-2CA1S
Intel Apollo Lake CPUs (2-Core)
1x DDR3L/LPDDR3 DIMM slot
Intel® Celeron® N3350 chipset
4x RJ-45 LAN ports
1x M.2 2280 slot reserved for M.2 SATAIII SSD
1x M.2 2230 slot reserved for WiFi/BT module
1x M.2 3042 slot reserved for 3G/4G LTE
module and 1x Mini SIM type holder
36W 12V DC jack
FWA-T011-4CA1S
Intel Apollo Lake CPUs (4-Core)
1x DDR3L/LPDDR3 DIMM slot
Intel® Pentium® N4200 chipset
4x RJ-45 LAN ports
1x M.2 2280 slot reserved for M.2 SATAIII SSD
1x M.2 2230 slot reserved for WiFi/BT module
1x M.2 3042 slot reserved for 3G/4G LTE
module and 1x Mini SIM type holder
36W 12V DC jack
Table 5: FWA-T011 SKU Configuration
In this document, we use FWA-T011-4CA1S as an example platform. Please refer to the
FWA-T011 user’s manual for detailed HW information, e.g. port locations, etc.
2.1 Accessories and Facilities Required
The following accessories shall be prepared:
Advantech provided USB drive with FWA-T011-4CA1S QuickStart Linux Image
RJ45 to RS232 DB9 (female connector) serial console cable (supplied by Advantech as
accessory)

Copyright 2017. All rights reserved. Advantech Co. Ltd. Page 12
Figure 1: RJ45 to RS232 Serial Console Cable
RJ45 Ethernet cable (required for accessing the QuickStart Image via the
management LAN port on the FWA-T011) (user supplied)
Remote Linux or Windows PC/notebook (user platform) with Putty or other terminal
software installed (user supplied)
Putty is a free and open-source client application for Windows or Linux which
supports serial terminal, SSH and telnet connections.
In case the user platform does not have a RS232 port, you will need a USB to RS232
DB9 (male/male connector) serial adapter cable (user supplied).
Figure 2: USB to RS232 Serial Adapter Cable
2.2 Cable and System Connections
The system front view and rear view of the FWA-T011-4CA1S as well as the descriptions of
components on the front or rear panel are shown in Figure 3, Table 6, Figure 4, and Table 7
respectively. Before connecting FWA-T011-4CA1S to the power outlet, finish the cable
connections first.
Plug the Advantech Image USB drive into either one of the FWA-T011-4CA1S USB
2.0 ports (F7)
Connect the RS232 female end of RJ45/RS232 serial console cable to the RS232 male
end of USB/RS232 serial adapter cable
Plug RJ45/RS232 serial console cable into the FWA-T011-4CA1S console port (R6)
Plug USB/RS232 serial adapter cable into the USB port on the user platform
Connect the LAN port of the user platform to one of the LAN ports (R2 to R5) on
FWA-T011-4CA1S via RJ45 Ethernet cable or SFP fiber cable. This is only required if
you would like to access the QuickStart Image via SSH connection, refer to Section
2.7 for more details.

Copyright 2017. All rights reserved. Advantech Co. Ltd. Page 13
Figure 3: FWA-T011-4CA1S System Rear View
Item
Component
Description
R1
HDMI Port
1x HDMI port
R2
LAN Port 1
Intel i210 RJ45 port 1
R3
LAN Port 2
Intel i210 RJ45 port 2
R4
LAN Port 3
Intel i210 RJ45 port 3
R5
LAN Port 4
Intel i210 RJ45 port 4
R6
Console Connector
RS232 console connector
R7
DC-IN Connector
External DC power supply connector
Table 6: Components on the FWA-T011-4CA1S Rear Panel

Copyright 2017. All rights reserved. Advantech Co. Ltd. Page 14
Figure 4: FWA-T011-4CA1S System Front View
Item
Component
Description
F1
Power LED
Power status
F2
HDD LED
HDD disk activity
F3
LTE LED
LTE activity
F4
WiFi LED
WiFi activity
F5
Software Defined LED
Status signaling
F6
SW define button
Recessed software definable button
F7
USB Connector
2x USB2.0 Type A port
F8
Power button
Power on/off
Table 7: Components on the FWA-T011-4CA1S Front Panel
2.3 Ethernet Port Mapping
The QuickStart Image will assign device names to the onboard LAN ports (R2 to R5) based on
the rules below. Here we take the FWA-T011 platform as an example (see Table 8):
Assign device names eth0_X to the onboard LAN ports (R2 to R5), where X
represents the port number labelled on the front panel (e.g. R2 -> eth0_1, R3 ->
eth0_2).
For each Ethernet device, users can use the utility ‘lseth’(see Section 3.8 for more details) to
find out the PFA address of a specific Ethernet device. For example:
[Ethernet PCIe device] <-> [The PFA address]
eth0_1 <-> 01:00.0
eth0_2 <-> 02:00.0

Copyright 2017. All rights reserved. Advantech Co. Ltd. Page 15
The following table shows the Ethernet port mapping between physical LAN ports, Ethernet
PCIe devices and PFA addresses for our example. With the rules described earlier, the utility
‘lseth’ ,a mapping table for the FWA-T011 can be easily created.
Note that the PFA may be changed when BIOS upgrades, please refer to your platform for
more detail.
Device Name
Physical LAN Port
PFA
bus:dev:fun
Device ID
eth0_1
LAN Port 1
01:00.0
8086:1533
eth0_2
LAN Port 2
02:00.0
8086:1533
eth0_3
LAN Port 3
03:00.0
8086:1533
eth0_4
LAN Port 4
04:00.0
8086:1533
Table 8: LAN Port Mapping for the FWA-T011-4CA1S
2.4 Configure Serial Port Connection on Putty
FWA-T011 BIOS as well as host x86 system OS outputs are provided via a serial terminal
connection by default. This section explains how to configure Putty on a Windows platform
for RS232 serial console connection. Other serial terminal emulation clients can be used in a
similar way.
Start Putty and the Configuration setting GUI will be displayed. Please change COM port
number to the actual port number assigned for the USB/RS232 serial port device on your
computer. Use the Windows Device Manager to check the assignment if required.
In our example, we use COM3:
Specify ‘COM3’ ’115200’ ’Serial’ on Session setting
Specify ‘115200’ ‘8’ ‘1’ ‘None’ ‘None’ on Connection > Serial setting
Select ‘VT100+’ on Terminal > Keyboard setting
Check ‘The colour’ on Window > Colours setting

Copyright 2017. All rights reserved. Advantech Co. Ltd. Page 16
Figure 5: Putty Session Setting
Figure 6: Serial Connection Setting on Putty
Figure 7: Putty Keyboard Setting

Copyright 2017. All rights reserved. Advantech Co. Ltd. Page 17
Figure 8: Putty Colours Setting
Press Apply button to start Putty before you power on the FWA-T011. You shall see the BIOS
POST screen:
Figure 9: BIOS POST
2.5 BIOS Setting
During BIOS POST, press the DEL or F2 key when the related message appears in order to
enter the BIOS setup menu (c.f. Figure 10):

Copyright 2017. All rights reserved. Advantech Co. Ltd. Page 18
Figure 10: BIOS Setup Menu
Go to the Post & Boot menu, and check whether the USB drive had been selected as the first
boot option device (see Figure 11 and Figure 12Figure 12: Select USB Drive as the First Boot
Device ). If the setting is not correct, make the change, then save the configuration and exit
BIOS (see Figure 13):
Figure 11: BIOS Boot Option Setting

Copyright 2017. All rights reserved. Advantech Co. Ltd. Page 19
Figure 12: Select USB Drive as the First Boot Device
Figure 13: Save and Exit BIOS

Copyright 2017. All rights reserved. Advantech Co. Ltd. Page 20
2.6 System Boot Up and Log In
If everything goes smoothly, you shall see the Ubuntu boot menu first:
Figure 14: Ubuntu Boot Menu
Finally the Ubuntu login prompt will be observed. The default serial console login credentials
are:
User name: root
Password: qwerty
After logging in successfully, you will end up in the Linux shell and will be able to issue Linux
commands or run utilities provided with the Advantech QuickStart Linux Image: