VIA Technologies AMOS-820 SKU User manual

1.06-11172015-161400
DEVELOPMENT GUIDE
AMOS-820
HMI Solution Pack v2.0

Copyright
Copyright © 2015 VIA Technologies Incorporated. All rights reser ed.
No part of this document may be reproduced, transmitted, transcribed, stored in a retrie al system, or translated into any language,
in any form or by any means, electronic, mechanical, magnetic, optical, chemical, manual or otherwise without the prior written
permission of VIA Technologies, Incorporated.
Trademarks
All brands, product names, company names, trademarks and ser ice marks are the property of their respecti e holders.
Disclaimer
VIA Technologies makes no warranties, implied or otherwise, in regard to this document and to the products described in this
document. The information pro ided in this document is belie ed to be accurate and reliable as of the publication date of this
document. Howe er, VIA Technologies assumes no responsibility for the use or misuse of the information in this document and for
any patent infringements that may arise from the use of this document. The information and product specifications within this
document are subject to change at any time, without notice and without obligation to notify any person of such change.
VIA Technologies, Inc. reser es the right the make changes to the products described in this manual at any time without prior
notice.

AMOS
AMOSAMOS
AMOS-
--
-8
88
82
22
20
00
0 HMI Solution Pack
HMI Solution Pack HMI Solution Pack
HMI Solution Pack V
V V
V2.0
2.02.0
2.0 Development Guide
Development Guide Development Guide
Development Guide
iii
Revision History
Version
VersionVersion
Version Date
DateDate
Date Remarks
RemarksRemarks
Remarks
1.00 2015/1/30 Initial released.
1.01 2015/2/16 Changed the eMMC s index from 1 to 0, sdcard s index from 0 to 1.
Added notice to unmount partitions before flashing images to
SD/eMMC.
1.02 2015/2/17 Changed u-boot.bin to u-boot.imx.
Used EVK to flash images to SD/eMMC.
1.03 2015/8/12 Added section 4.2.2 and 4.2.3
1.04 2015/8/20 Corrected u-boot to U-boot
1.05 2015/9/2 Changed the way of U-boot booting kernel
1.06 2015/11/12
Changed document cover from AMOS-820 VAB-820 HMI Solution
Pack to AMOS-820 HMI Solution Pack.
Modified some descriptions for AMOS-820

AMOS
AMOSAMOS
AMOS-
--
-8
88
82
22
20
00
0 HMI Solution Pack
HMI Solution Pack HMI Solution Pack
HMI Solution Pack V
V V
V2.0
2.02.0
2.0 Development Guide
Development Guide Development Guide
Development Guide
iv
Table of Contents
1.
1.1.
1. Introductio
IntroductioIntroductio
Introduction
nn
n ................................
................................................................
................................................................
................................................................
................................................................
................................................................
..........................................
....................
.......... 1
11
1
1.1. Overview........................................................................................................ 1
1.2. Package Content ........................................................................................... 1
1.2.1. BSP Folder Contents............................................................................... 2
1.2.2. EVK Folder Contents .............................................................................. 2
2.
2.2.
2. Setup Building Environment
Setup Building EnvironmentSetup Building Environment
Setup Building Environment ................................
................................................................
................................................................
................................................................
...............................................
..............................
............... 3
33
3
2.1. Configure U untu......................................................................................... 3
2.1.1. Install the Host Packages ...................................................................... 3
3.
3.3.
3. Image Build
Image BuildImage Build
Image Build ................................
................................................................
................................................................
................................................................
................................................................
................................................................
...........................................
......................
........... 4
44
4
3.1 Extract AMOS-820 BSP .................................................................................... 4
3.2 Machine configurations .................................................................................... 4
3.3 Build an image.................................................................................................... 4
4.
4.4.
4. Image Deployment
Image DeploymentImage Deployment
Image Deployment ................................
................................................................
................................................................
................................................................
..............................................................
............................................................
.............................. 5
55
5
4.1 Booting from Micro SD storage card ............................................................ 5
4.1.1 Making a Micro SD card image ............................................................ 6
4.1.2 Setup U- oot parameters for Micro SD card ................................... 6
4.2 Booting from SPI ROM ..................................................................................... 7
4.2.1 Making Linux System eMMC................................................................. 7
4.2.1.1 Requirement................................................................................... 7
2.1.1.1. Burn u- oot.imx into SPI ROM .................................................. 8
2.1.1.2. Copy images to eMMC................................................................ 9
4.2.2 Setup U- oot parameters for SPI ROM.............................................. 9
4.3 Restore the default U- oot parameter ....................................................... 11

AMOS
AMOSAMOS
AMOS-
--
-8
88
82
22
20
00
0 HMI Solution Pack
HMI Solution Pack HMI Solution Pack
HMI Solution Pack V
V V
V2.0
2.02.0
2.0 Development Guide
Development Guide Development Guide
Development Guide
v
Lists of Figures
Figure 1 Micro SD/SPI oot switch diagram .............................................................. 5
Figure 2 U- oot parameter ............................................................................................ 6
Figure 3 Micro SD/SPI oot switch diagram .............................................................. 8
Figure 4 Micro SD/SPI oot switch diagram .............................................................. 9
Figure 5 U- oot parameter .......................................................................................... 10

AMOS
AMOSAMOS
AMOS-
--
-8
88
82
22
20
00
0 HMI Solution Pack
HMI Solution Pack HMI Solution Pack
HMI Solution Pack V
V V
V2.0
2.02.0
2.0 Development Guide
Development Guide Development Guide
Development Guide
vi
Lists of Tables
Ta le 1 AMOS-820 Solution Pack content................................................................ 1
Ta le 2 Images generated through Bit ake ............................................................... 4

AMOS
AMOSAMOS
AMOS-
--
-8
88
82
22
20
00
0 HMI Solution Pack
HMI Solution Pack HMI Solution Pack
HMI Solution Pack V
V V
V2.0
2.02.0
2.0 Development Guide
Development Guide Development Guide
Development Guide
1
1.
1.1.
1. Introduction
IntroductionIntroduction
Introduction
The purpose of this document is to provide a practical introduction on
developing software for the AMOS-820 (Bare oard: VAB-820 Freescale i.MX6
Quad) on a Yocto Project development host.
1.1. Overview
AMOS-820 HMI Solution Pack v2.0 is developed ased on fsl-yocto-
3.10.17_1.0.0 (Yocto 1.5 Dora) and it ena les hardware features.
There are four major oot components for Linux, the “
““
“u
uu
u-
--
-boot
bootboot
boot ,
, ,
, “
““
“*.dts
*.dts*.dts
*.dts ,
, ,
,
“
““
“uImage
uImageuImage
uImage and “
““
“Root File System
Root File SystemRoot File System
Root File System . The "u
"u"u
"u-
--
-boot"
boot"boot"
boot" is for initial peripheral hardware
parameter. The “
““
“*.dts
*.dts*.dts
*.dts is the device tree. The "uImage"
"uImage""uImage"
"uImage" is the Linux kernel
image, and the "
""
"Root
Root Root
Root File System"
File System"File System"
File System" is for Linux O.S.
1.2. Package Content
There are three folders in AMOS-820 Solution Pack.
BSP folder
BSP folderBSP folder
BSP folder Description
DescriptionDescription
Description
yocto-vab820-bsp-v2.0.7.tar.bz2 Source code
Document
DocumentDocument
Document folder
folder folder
folder Description
DescriptionDescription
Description
AMOS-820_HMI_SP_V2.0.7_Development Guide_1.06.pdf Development Guide
AMOS-820_HMI_SP_V2.0.7_Evaluation_Guide_1.03.pdf Evaluation Guide
EVK folder
EVK folderEVK folder
EVK folder Description
DescriptionDescription
Description
u-boot.imx U-Boot boot loader
uImage Kernel
uImage-imx6q-vab820.dtb
uImage-imx6dl-vab820.dtb
Device tree
via-image-x11-imx6qvab820.sdcard An SD card image
modules-imx6qvab820.tgz All modules drivers
Ta
TaTa
Table
ble ble
ble 1
11
1 AMOS
AMOSAMOS
AMOS 820
820820
820 Solution P
Solution PSolution P
Solution Pack content
ack contentack content
ack content

AMOS
AMOSAMOS
AMOS-
--
-8
88
82
22
20
00
0 HMI Solution Pack
HMI Solution Pack HMI Solution Pack
HMI Solution Pack V
V V
V2.0
2.02.0
2.0 Development Guide
Development Guide Development Guide
Development Guide
2
1.2.1. BSP Folder Contents
•vab820
vab820vab820
vab820-
--
-ycoto
ycotoycoto
ycoto-
--
-bsp
bspbsp
bsp-
--
-v2.0.7.tar.bz2:
v2.0.7.tar.bz2:v2.0.7.tar.bz2:
v2.0.7.tar.bz2: A complete and static Yocto BSP
including VAB-820 meta-files, and all the required packages have
een downloaded.
1.2.2. EVK Folder Contents
•via
viavia
via-
--
-i
ii
image
magemage
mage-
--
-x11
x11x11
x11-
--
-imx6qvab820.sdcard:
imx6qvab820.sdcard:imx6qvab820.sdcard:
imx6qvab820.sdcard: Image for evaluating the AMOS-
820 with OpenEm edded file system.

AMOS
AMOSAMOS
AMOS-
--
-8
88
82
22
20
00
0 HMI Solution Pack
HMI Solution Pack HMI Solution Pack
HMI Solution Pack V
V V
V2.0
2.02.0
2.0 Development Guide
Development Guide Development Guide
Development Guide
3
2.
2.2.
2. Setup Building Environment
Setup Building Environment Setup Building Environment
Setup Building Environment
This chapter will guide users through setting up the developing environment.
All the instructions in this guide are for U untu 12.04 (32 Bit or 64 Bit). Please
have the U untu installed in your PC/NB in advance.
To get the Yocto Project expected ehavior in a Linux Host Machine, the
packages and utilities descri ed elow must e installed. An important
consideration is hard disk space required in the host machine. The
recommended space is 120 GB at least.
2.1. Configure Ubuntu
2.1.1. Install the ost Packages
The following packages are installed to support Yocto development
environment and presented in a ash script that can e cut and pasted into
your environment for execution:
#/bin/bash
# Install LTIB dependant packages
sudo apt-get install wget git-core unzip texinfo libsdl1.2-dev gawk
diffstat build-essential chrpath
sudo apt-get install sed cvs subversion coreutils texi2html docbook-
utils python-pysqlite2 help2man make gcc g++ desktop-file-utils
libgl1-mesa-dev libglu1-mesa-dev mercurial autoconf automake groff
curl lzop asciidoc xterm

AMOS
AMOSAMOS
AMOS-
--
-8
88
82
22
20
00
0 HMI Solution Pack
HMI Solution Pack HMI Solution Pack
HMI Solution Pack V
V V
V2.0
2.02.0
2.0 Development Guide
Development Guide Development Guide
Development Guide
4
3.
3.3.
3. I
II
Image Build
mage Buildmage Build
mage Build
3.1 Extract AMOS-82 BSP
Do not use the root mode to unpack the BSP package on the terminal. It may
cause a failure to uild due to the file permission has een affected.
$ tar xvf yocto-vab820-bsp-v2.0.7.tar.bz2
3.2 Machine configurations
The via-setup-release.sh script integrates the VIA release layer into the Yocto
Project uild y inserting the layer into the < uild dir>/conf/ layers.conf file.
This setup script has the following optional parameters:
•- : sets the uild directory.
- < uild dir >
$ cd via-release-bsp
via-release-bsp$ MACHINE=imx6qvab820 source via-setup-release.sh -b
build-vab820
3.3 Build an image
AMOS-820 BSP supports 'via-image-x11' image name.
via-release-bsp/build-vab820$ bitbake via-image-x11
There are u- oot.imx, uImage, *.dts and root file system generated. The
location for this example can e found in the directory “via
“via“via
“via-
--
-relea
relearelea
release
sese
se-
--
-bsp/build
bsp/buildbsp/build
bsp/build-
--
-
vab820
vab820vab820
vab820/
//
/tmp/deploy/images/imx6qvab820
tmp/deploy/images/imx6qvab820tmp/deploy/images/imx6qvab820
tmp/deploy/images/imx6qvab820 . Users could refer to Ta le 2.
Binary
BinaryBinary
Binary Description
DescriptionDescription
Description
u-boot.imx U-Boot boot loader
uImage Kernel
uImage-imx6q-vab820.dtb
uImage-imx6dl-vab820.dtb
Device tree
via-image-x11-imx6qvab820.sdcard An SD card image
Table
Table Table
Table 2
22
2 Images generated through Bitbake
Images generated through Bitbake Images generated through Bitbake
Images generated through Bitbake

AMOS
AMOSAMOS
AMOS-
--
-8
88
82
22
20
00
0 HMI Solution Pack
HMI Solution Pack HMI Solution Pack
HMI Solution Pack V
V V
V2.0
2.02.0
2.0 Development Guide
Development Guide Development Guide
Development Guide
5
4.
4.4.
4. Image Deployment
Image DeploymentImage Deployment
Image Deployment
AMOS-820 supports two ooting ways. One is from Micro SD storage card
and the other is SPI ROM. This section will guide user through making the
Linux system oot media for AMOS-820.
Uses could use the image uilt from BSP, its location is mentioned in the
previous Section 3.3, or use the demo image in EVK/
EVK/ EVK/
EVK/ folder of AMOS-820 HMI
Solution Pack.
4.1 Booting from Micro SD storage card
The Micro SD card image ena les the full system to oot with U-Boot and
kernel.
If users setup the U- oot parameter for the first time, users need to oot from
the Micro SD card. Set the Micro SD/SPI oot switch (refer to Figure 1) to oot
from the Micro SD.
Fi
FiFi
Figure
gure gure
gure 1
11
1 Micro SD/SPI boot switch diagram
Micro SD/SPI boot switch diagram Micro SD/SPI boot switch diagram
Micro SD/SPI boot switch diagram

AMOS
AMOSAMOS
AMOS-
--
-8
88
82
22
20
00
0 HMI Solution Pack
HMI Solution Pack HMI Solution Pack
HMI Solution Pack V
V V
V2.0
2.02.0
2.0 Development Guide
Development Guide Development Guide
Development Guide
6
4.1.1 Making a Micro SD card image
Be careful of the following instruction efore making the Micro SD card image:
If there is any mounted partition in the Micro SD card, it should e unmounted
first. Then, to flash a SD card image, run the following command:
$ umount /dev/sd<partition>
$ sudo dd if=via-image-x11-imx6qvab820.sdcard of=/dev/sd<partition>
bs=1M && sync
4.1.2 Setup U-boot parameters for Micro SD card
Connect the AMOS-820 and host PC through COM2 of AMOS-820. Run serial
port communications program (GtkTerm, Minicom…..) on host PC to receive
the ooting message. Power on the AMOS-820 and press any key to stop the
ooting process as shown in Figure 2.
Figure
Figure Figure
Figure 2
22
2 U
UU
U boot parameter
boot parameterboot parameter
boot parameter
To check the parameter in U- oot:
VAB-820 U-Boot > printenv
bootcmd=run bootcmd_auto
...

AMOS
AMOSAMOS
AMOS-
--
-8
88
82
22
20
00
0 HMI Solution Pack
HMI Solution Pack HMI Solution Pack
HMI Solution Pack V
V V
V2.0
2.02.0
2.0 Development Guide
Development Guide Development Guide
Development Guide
7
The default parameter shows that it loads kernel y detecting the Micro SD
card. If the Micro SD card has een inserted, it loads kernel from Micro SD
card. If not, it loads kernel from eMMC.
If users would like to change loading kernel from Micro SD card or eMMC,
users could refer to the two examples elow.
The AMOS-820 will load kernel from Micro SD card.
VAB-820 U-Boot > setenv bootcmd 'run bootcmd_sd'
VAB-820 U-Boot > saveenv
VAB-820 U-Boot > boot
The AMOS-820 will load kernel from eMMC.
VAB-820 U-Boot > setenv bootcmd 'run bootcmd_mmc'
VAB-820 U-Boot > saveenv
VAB-820 U-Boot > boot
4.2 Booting from SPI ROM
AMOS-820 supports ooting from SPI ROM, loading kernel and Root
FileSystem from eMMC. It does not support ooting from eMMC.
If users would like to make a Linux system on eMMC, users need to urn U-
oot on SPI ROM, and urn kernel and Root FileSystem on eMMC.
4.2.1 Making Linux System eMMC
If users use AMOS-820 first, users must oot from Micro SD card and run the
following steps.
4.2.1.1
4.2.1.14.2.1.1
4.2.1.1 R
RR
Requirement
equirementequirement
equirement
There are three requirements.
•A Linux System Micro SD storage card made in section 4.1.1.
•A mass storage includes: “
““
“u
uu
u-
--
-boot.imx
boot.imxboot.imx
boot.imx and “
““
“via
viavia
via-
--
-image
imageimage
image-
--
-x11
x11x11
x11-
--
-
imx6qvab820.sdcard
imx6qvab820.sdcardimx6qvab820.sdcard
imx6qvab820.sdcard . Users could put those files in a USB flash or
Micro SD storage card.

AMOS
AMOSAMOS
AMOS-
--
-8
88
82
22
20
00
0 HMI Solution Pack
HMI Solution Pack HMI Solution Pack
HMI Solution Pack V
V V
V2.0
2.02.0
2.0 Development Guide
Development Guide Development Guide
Development Guide
8
•Set the Micro SD/SPI oot switch (refer to Figure 3) to oot from the
Micro SD.
Figure
Figure Figure
Figure 3
33
3 Micro SD/SPI boot switch diagram
Micro SD/SPI boot switch diagram Micro SD/SPI boot switch diagram
Micro SD/SPI boot switch diagram
Connect the AMOS-820 and host PC through COM2 of AMOS-820. Run serial
port communications program (GtkTerm, Minicom…..) on host PC to receive
the ooting message. Power on the AMOS-820 and oot from Micro SD card
into system.
Login account is root
rootroot
root and press <Enter>.
...
Poky (Yocto Project Reference Distro) 1.5.1 imx6qvab820 /dev/ttymxc1
imx6qvab820 login:root
2.1.1.1.
2.1.1.1.2.1.1.1.
2.1.1.1. Burn
Burn Burn
Burn u
uu
u-
--
-boot.imx into SPI ROM
boot.imx into SPI ROMboot.imx into SPI ROM
boot.imx into SPI ROM
Run “ls /dev/mtdblock*
/mtdblock*/mtdblock*
/mtdblock*” to check the SPI ROM device, which is identified as
“
““
“/dev/mtdblock0
/dev/mtdblock0/dev/mtdblock0
/dev/mtdblock0 .
$ ls /dev/mtdblock*
/dev/mtdblock0
Run the following command to urn u- oot.imx into SPI ROM.
$ sudo dd if=u-boot.imx of=/dev/mtdblock0 bs=512 seek=2

AMOS
AMOSAMOS
AMOS-
--
-8
88
82
22
20
00
0 HMI Solution Pack
HMI Solution Pack HMI Solution Pack
HMI Solution Pack V
V V
V2.0
2.02.0
2.0 Development Guide
Development Guide Development Guide
Development Guide
9
The previous U- oot parameters will e stored in SPI ROM. If users would like
to clear the U- oot parameters to default values, run the following command:
$ sudo dd if=/dev/zero of=/dev/mtdblock0 bs=512 seek=1536 count=16
2.1.1.2.
2.1.1.2.2.1.1.2.
2.1.1.2. Copy
Copy Copy
Copy images to eMMC
images to eMMCimages to eMMC
images to eMMC
Be careful of the following instructions efore copying images to eMMC:
If there is any mounted partition in eMMC, it should e unmounted first.
Then, run the following command to urn the image into eMMC.
$ sudo dd if=via-image-x11-imx6qvab820.sdcard of=/dev/mmcblk0 bs=1M
4.2.2 Setup U-boot parameters for SPI ROM
Set the Micro SD/SPI oot switch (refer to Figure 4) to oot from SPI ROM.
Figure
FigureFigure
Figure 4
44
4 Micro SD/SPI boot switch diagram
Micro SD/SPI boot switch diagram Micro SD/SPI boot switch diagram
Micro SD/SPI boot switch diagram
Connect the AMOS-820 and host PC through COM2 of AMOS-820. Run serial
port communications program (GtkTerm, Minicom…..) on host PC to receive
the ooting message. Power on the AMOS-820 and press any key to stop the
ooting process as shown in Figure 5.

AMOS
AMOSAMOS
AMOS-
--
-8
88
82
22
20
00
0 HMI Solution Pack
HMI Solution Pack HMI Solution Pack
HMI Solution Pack V
V V
V2.0
2.02.0
2.0 Development Guide
Development Guide Development Guide
Development Guide
1
Figure
Figure Figure
Figure 5
55
5 U
U U
U boot parameter
boot parameterboot parameter
boot parameter
To check the parameter in U- oot:
VAB-820 U-Boot > printenv
bootcmd=run bootcmd_auto
...
The default parameter shows that it loads kernel y detecting the Micro SD
card. If the Micro SD card has een inserted, it loads U oot from SPI ROM and
kernel from Micro SD card. If not, it loads kernel from eMMC.
If users would like to change loading kernel from Micro SD card or eMMC,
users could refer to the two examples elow.
The AMOS-820 will load kernel from Micro SD card.
VAB-820 U-Boot > setenv bootcmd 'run bootcmd_sd'
VAB-820 U-Boot > saveenv
VAB-820 U-Boot > boot

AMOS
AMOSAMOS
AMOS-
--
-8
88
82
22
20
00
0 HMI Solution Pack
HMI Solution Pack HMI Solution Pack
HMI Solution Pack V
V V
V2.0
2.02.0
2.0 Development Guide
Development Guide Development Guide
Development Guide
11
The AMOS-820 will load kernel from eMMC.
VAB-820 U-Boot > setenv bootcmd 'run bootcmd_mmc'
VAB-820 U-Boot > saveenv
VAB-820 U-Boot > boot
4.3 Restore the default U-boot parameter
User could type “destroyenv” in U- oot to restore the default parameter.
VAB-820 U-Boot > destroyenv
VAB-820 U-Boot > reset