Kontron M2M Smart Service Developer Kit User manual

Kontron M2M Smart Services Developer Kit
Wind River Linux LiveUSB Getting Started Guide
with Eurotech ESF™
Document Revision 1.03
Part Number: 930-0052-00

www.kontron.com
www.kontron.com
» Table of Contents «
1Introduction ..................................................................................1
1.1About this Manaual...................................................................................................................................1
1.2Overview .................................................................................................................................................1
1.3Required Hardware ...................................................................................................................................2
Intel® Atom™ based Reference Platform for M2M Specification.................................................................2
Host Computer Specification................................................................................................................2
1.4LiveUSB Technology ..................................................................................................................................2
2Connecting the Hardware.................................................................4
2.1Connecting the Kontron M2M System M2M and Your Host Computer.................................................................4
2.2Ports and Antennas...................................................................................................................................6
2.3Powering the Kontron M2M System .............................................................................................................7
3Starting the Evaluation Software.......................................................8
3.1Booting the Host Computer........................................................................................................................8
3.2Accepting the Agreements .........................................................................................................................8
3.3Obtaining an Evaluation License.................................................................................................................8
3.4Starting Your Software Evaluation ............................................................................................................11
3.5Notes....................................................................................................................................................11
4Getting Started with ESF™..............................................................12
4.1Everyware(TM) Software Framework (ESF).................................................................................................12
4.2Configuring with Denali...........................................................................................................................12
4.3Everyware™ Device Cloud (EDC)................................................................................................................13
5Recovering Your Linux Image on the Kontron M2M System..................14
5.1Making the Evaluation Image Recovery Tool USB Drive.................................................................................15
5.2Recovering your Kontron M2M System Software Evaluation System ...............................................................16
6Manual License Activation..............................................................17
6.1Manual License Activation on a non-Internet connected host .......................................................................17
6.2Automatic License Activation on a Windows host........................................................................................19

www.kontron.com
www.kontron.com
6.3Manual License Activation on a Windows host ............................................................................................19
7Troubleshooting Your Evaluation Setup............................................20
7.1Network Topology Overview......................................................................................................................20
For retrieving the evaluation license: ..................................................................................................20
For running the evaluation:................................................................................................................20
8Troubleshooting Graphics Problems on Your LiveUSB Host Computer ....23

1
1Introduction
Welcome to the Wind River Linux LiveUSB Getting Started Guide. Using the specially configured evaluation environment
provided in this kit you will quickly be able to use Wind River’s market leading development tools and run Wind River Linux
(the industry-leading Linux platform for embedded device development) on the Kontron M2M System. You will also usethe
Wind River Tilcon Graphics Suite to see howto quickly develop and deploy rich user interfaces for multifunctional embedded
devices.
1.1 About this Manaual
Thank you for purchasing and using the Kontron M2M Smart Service Developer Kit. Your kit was developed by Kontron in
collaboration with Intel, Eurotech and WindRiver.
This manual is for smart services developers who are responsible for using the developer kit. This document is a companion
document to the User Manual and the Out-of-boxGuide. The latest version of all documents are available for download from
Kontron’s website:
http://us.kontron.com/products/systems+and+platforms/m2m/m2m+smart+services+developer+kit.html
Then select downloads and manuals from the menus on that page to get to the Kontron M2M Smart Services Developer Kit user
documentation.
Kontron would like to point out that the information contained in this manual may be subjectto technical alteration,
particularly as a result of the constant upgrading of Kontron products.The attached documentation does not entail any
guarantee on the part of Kontron with respect to technical processes described in the manual or any product characteristics
set out in the manual. Kontron does not accept any liability forany printing errors or other inaccuracies in the manual unless
it can be proven that Kontron is aware of such errors or inaccuracies or that Kontron is unaware of these as a result of gross
negligence and Kontron has failed to eliminatethese errors or inaccuracies for this reason. Kontron expressly informs the
user that this manual only contains a general description of technical processes and instructionswhich may not be applicable
in every individual case. In cases of doubt, please contact Kontron.
This manual is protected by copyright. All rightsare reserved by Kontron. Copies of all or part of this manual or translations
into a different language may only be made with the prior written consent of Kontron. Kontron points out thatthe
information contained in thismanual is constantly being updated in line with the technical alterations and improvements
made by Kontron to the products and thus this manual only reflects the technical status of the products by Kontron the time
of printing.
© 2011 by Kontron America, Inc.
Printing and duplication, even of sections, is only permissible with the express approval of:
Kontron America, Inc.
1.2 Overview
This evaluation leads you through the steps to use Wind River Workbench, configure a Linux kernel and file system, work with
patches, and outline how Wind River tools can aid in the debugging and analysis of embedded systems based on the Kontron
M2M System. It also demonstrates the powerful user interface tool, Tilcon Graphics Suite, and shows howyou can develop
professional graphical displays with absolutely no coding.
During this evaluation you will work with twoseparate systems:
•A host computer (workstation) on which you willperform tasks such as configuring the Linux OS that runson the target,
analyzing test results and debugging code. You will also use the host computer to view Wind River documentation and
guide material. The preferred specification for the host computer is outlined below.
•The Kontron M2M system included in the Kontron M2M Smart Services developer Kit running Wind River Linux, referred to
as a target system.
•Software Included in the Kontron M2M Smart Services Developer Kit

2
This kit includes the following components:
•The Kontron M2M System, pre-flashed with a Wind River Linux kernel and root file system, and Eurotech’s Everyware
Software Framework (ESF) pre-installed on the microSD with recovery image available on the LiveUSB.
•One bootable LiveUSB flash drive (viewable as a non-boot device under Windows) to boot a host development
workstation. The Live USB contains software packages and components which help package WindRiver Linux for the
Embedded Platform. The User/Developer can quickly start working with the Wind River Workbench development suite and
can build a bootable image of Wind River Linux for the target.
•Several scripts located in /root/examples on theKontron M2M System which will activate and demonstrate various
hardware capabilities (i.e. Wi-Fi, 3G).
1.3 Required Hardware
Intel® Atom™ based Reference Platform for M2M Specification
The Kontron M2M System is built on a COM Express module, which integrates with a carrier board to provide a System
controller. The Kontron M2M System is a high-performance, low-power module based on the Intel® Atom™ processor. It uses
an integrated two-chip solution comprised of the Intel® Atom™ E6xx series processor and Intel®System Controller Hub EG20.
This evaluation is available for the Kontron M2M system with the following specifications:
•An internal microSD boot device.
•An Ethernet interface with default static IP address of172.31.255.1
For this evaluation kit,the Kontron M2M System has been pre-flashed with a fully functionalWind River Linux image that
boots the board into Linux and connectsto the Wind River Workbench development tools running on your host computer.
Host Computer Specification
During this evaluation you will run the Wind River Workbench development suite which requires a suitable host computer.
This host computer can be a laptop or desktop PC with the following specifications:
Host architecture: Intel Core2, 2 GHz or greater (recommended)
Host memory: 2 GB RAM (recommended)
USB requirements: USB 2.0 connection (required)
Static IP addresses: host computer (172.31.255.254)
target (172.31.255.1)
You do not need to install any software on your host computer prior to the evaluation.
1.4 LiveUSB Technology
All the software required for this evaluation on your host computer is delivered on a fully configured,
bootable USB flash drive (referred to as a LiveUSB) that you can boot on most standard modern PCs. The
LiveUSB contains:
1. A fully configured and bootable version of the Fedora (Linux) operating system.
2. The Wind River Linux platform, which includes the Wind River Workbench
development suite and a board support package for the Kontron M2M System.
3. Wind River documentation, including this Getting Started Guide.
4. A set of guides which will lead you through the Wind River Linux evaluation.

3
5. Wind River documentation for Wind River Workbench and Wind River Linux.
6. Eurotech’s ESF Hello World Tutorial and Denali User Guide.
The pre-configured LiveUSB environment lets you use Wind River development tools withoutthe need to install, configure, or
build anything prior to the evaluation. You can begin the evaluation immediately after you have booted the LiveUSB.
Note that, once booted, the LiveUSB software uses the RAM memory of the host PC and the flash memory available in the
LiveUSB flash drive itself—it does notuse the hard drive on the host computer. When used as designed, this evaluation will
not write to hard drive of the host computer.

4
2Connecting the Hardware
2.1 Connecting the Kontron M2M System M2M and Your Host Computer
1. Connect an Ethernet cable between the Ethernet port on the Kontron M2M system and a
network switch or hub. Also connect your host computer to the same switch or hub.
2. Optionally connect the Kontron M2M System to a USB keyboard, a USB mouse, and a display
if the GUI Demo is to be exercised.
NOTE: The evaluation host will be assigned a dynamic IP address in the normal manner if your
network has a DHCP server. Initially you need an Internet connection to obtain an evaluation
license. Before you begin the evaluation you will be directed to change to a static IP address so
the tools can communicate with the target.
3. Connect the Kontron M2M System to the 12 V DC adapter supplied with the kit.

5
Workbench and demo setup for using LiveUSB Drive
Keyboard
and mouse
Needed for GUI
Demo/Tutorials
WAN/Internet
DVI/HDMI
Monito
r
Router
PC
Kontron
M2M
System
LiveUSB
Flash Drive
USB Hub
Keyboard
and mouse
Included in
the box
DVI/HDMI
Monitor

6
2.2 Ports and Antennas
Refer to the figure below for locations of ports and where to attach the antennas:
Auxiliary 3G Antenna
Connector (for selected SKUs
only)/ Auxiliary Wi-Fi Antenna
Connector (for other SKUs)
2.4 GHz Antenna Connector
(Primary Wi-Fi Antenna)
2.4 GHz Antenna Connector
(for 802.15.4 communication)
3G Antenna
Connecto
r
Micro
SD
p
ort
Micro USB Port
2x HDMI Ports
(The primary MicroHDMI port
is near the MicroUSB port
and the one closest to the
antenna connector is the
secondary MicroHDMI port)
RJ-45 Ethernet Port
USB 2.0 Host
MicroUSB Port
Power Connector
3G SIM Slot
Client USB Port for Serial
Redirection (selected SKUs
only)
Reset Button
11 indicator lights
(1 bi-color status LED, green disk activity
LED, then green+yellow+red LEDs for
WWAN
,
WLAN
,
and WPAN
)
User input button (softwareenabled)
Note: The MicroUSB port closest to the lower antenna is a USB host port. The other Micro-USB port can
be either a host or client port, depending on BIOS settings (and the configuration of the S3 switch inside
the Kontron/Intel® Atom™ based Reference Platform). These ports have static configurations and can
provide 5Vdc power. DO NOT PLUG USB OTG (On-The-Go) DEVICES INTO THESE MICROUSB PORTS.
Headphone/Live out
Microphone

7
2.3 Powering the Kontron M2M System
You should ensure that yourKontron M2M System is correctly connected and is capable of booting. To do this plug the power
adapter into the AC wall socket – there is no on/off switch. The board should begin booting within a few seconds. The Kontron
M2M System is preprogrammed with Wind River Linux,which is specifically configured for development purposes. The
preprogrammed image also includes a Wind River Tilcon Graphics demonstration.
If your target board boots successfully, and an optional displayis connected, the display will show the main Wind River Tilcon
Graphics Suite Demo screen.
NOTE: You may shut down or reboot the target board using a secure shell (SSH) connection—
powering off by disconnecting power can cause problems. SSH is a network protocol that allows
data exchanges between two devices—it opens a shell on the host computer that lets a user execute
commands on a remote machine (in this case, the Kontron M2M System). To set up and use SSH
to communicate with the target from your host computer, see Sec 3.1Communicating to the Target
through the Terminal of the Kontron M2M System Evaluation Tutorial. Alternately the
CTRL+ALT+F1 keys can be pressed simultaneously to switch the user to a command line console
where the user can login as root with a password of root and then issue a “poweroff” command.

8
3Starting the Evaluation Software
3.1 Booting the Host Computer
Before booting your host computer, ensure that the LiveUSB flash drive is correctly plugged into a USB port on the host
computer.
Switch on your host computer. You may have to interrupt the boot process in order to instructthe BIOS to boot from the
LiveUSB flash drive instead of the internal hard drive.
The host computer boots into a preconfigured Fedora environment.
NOTE: Your host computer may have a graphics driver that is not compatible with the default boot settings. Inthis case you
will see distorted graphics or nographics at all. If you have this issue, please consult Section 8: Troubleshooting Graphics
Issues on your LiveUSB Host.
3.2 Accepting the Agreements
You will then be presented with several License Agreements to read and several Product Evaluation License Agreements to
accept. Click ACCEPT to accept each agreement and proceed.
3.3 Obtaining an Evaluation License
Before you begin to evaluate the features ofthe Wind River tools included on the LiveUSB, you will be requiredto obtain an
evaluation license. This requires an Internet connection, either on the hoston which you will be running the evaluation or, in
the case of Manual License Activation, an Internet connection on some other available machine.
Whichever method you use,the license is valid for any machineon which the LiveUSB runs.

License Act
i
If the host
o
and quicke
s
Activiation
.
1
.
2
.
i
vation on an I
n
o
n which you wi
s
t way of obtain
i
.
.
Once your
h
dialog box.
.
If you are n
3. If you
d
your p
r
n
ternet connect
e
ll be running y
o
i
ng an evaluati
o
h
ost has correc
t
Click the Aut
ot
using a net
w
d
o use a netwo
r
r
oxy info.
e
d host
o
ur evaluation i
s
o
n license. For
a
t
ly booted you
omatic Licen
s
w
ork proxy the
n
r
k proxy then
p
9
s
connected to t
h
a
dditional licen
s
will be presen
t
s
e Activation
o
n
press the Ne
x
p
ress the Conf
i
h
e Internet the
n
s
e activation m
e
t
ed with the fo
l
o
ption.
x
t
b
utton and c
o
ig
ure Networ
k
n
this method p
e
thods, see Sec
t
l
lowing Wind
R
o
ntinue at step
5
k
Prox
y
b
utton
,
rovides the eas
i
t
ion 6: Manual
L
R
iver EDK A
g
5
below.
,
where you ca
n
i
est
L
icense
g
ent
n
enter

10
4. Once completed press the Save Changes button and then press the Next button (from the previous
screen shot).
5. Fill in your registration details (including a valid email address) and click the Submit button at the
bottom of the form.
3
6. You will be notified when host successfully obtains an Evaluation license. You can then begin using the
Wind River host tools.
NOTE: When obtaining a license the host will attempt to connect to the Internet over the
wired Ethernet interface (eth0). It is strongly suggested that you use a wired Ethernet
connection. If your host has multiple interfaces, or if you want to use wireless interfaces,
you must make the necessary configuration changes.

11
3.4 Starting Your Software Evaluation
After the host computer boots into the Fedora LiveUSB environment, you will see adesktop that includes a number of icons,
including a link to this document and quick launches to the tools. Check online for the latest versions of documentation.
For your convenience, there are several pull down menus under Applications->Wind River.
1. To open the evaluation tutorial, select Applications > Wind River > Documentation >
Evaluation Tutorial.
2. To view this guide at any time, select Getting Started Guide.
3. In a future release there will be videos of the exercises, at that time select
Applications > Wind River > Videos > Evaluation Tutorial Videos.
3.5 Notes
You can exercise the evaluation in any way you choose—by following the tutorials, trying your own software, running
benchmarks, and so on.
The evaluation is safe to use with your existing machine. When correctly used no data will be written outside of the LiveUSB
flash drive.
The evaluation is interruptible—if you stop at any point in the evaluation, you can resume where you stopped.
The version of Fedora on the LiveUSB flash drive is minimal. It uses a RAM file system. When the size of the file system
approaches the memory limits of the computer, operations may degrade. If a slowdown or stop occurs, shut down the
computer, reboot, and resume the evaluation.
To download updated materials, visit www.windriver.com/evaluations

12
4Getting Started with ESF™
4.1 Everyware(TM) Software Framework (ESF)
Each Kontron M2M System in the Kontron Smart Services Developers Kit can be loaded with Eurotech’s Everyware™ Software
Framework. ESF is a Java/OSGi based application framework and development tooling based on the open source Eclipse IDE.
ESF is a programming environment that wraps the complexity of low level device management with high level constructs.
This approach permits simpler and faster programming, with shorter, easier to read code and transparent portability across
different hardware platforms.
ESF can be installed into Wind River Workbench and the Kontron M2M Smart Service Developer Kit filesystem by following the
instructions at http://esf.eurotech.com/doc/FRI/ESF_Install.html.
With ESF installed, please start your evaluation by following the step bystep ESF Hello World Tutorial located here
http://esf.eurotech.com/doc/FRI/ESF_Hello_World.html
For further information on ESF, please go to http://esf.eurotech.com.
4.2 Configuring with Denali
Denali is provided with ESF as a set of bundles that provide a web GUI for routing and device interface management on the
Kontron M2M System. It allows for configuration of the cellular modem, Ethernet, Wi-Fi, static routing, firewalling, terminal
servers and clients. For access and documentation, please refer to the Denali User Guide on located here
http://esf.eurotech.com/doc/FRI/Denali_User_Manual.html.

13
4.3 Everyware™ Device Cloud (EDC)
The Everyware™ Device Cloud is a complete, scalable infrastructure that, workingtogether with ESF, enables theKontron M2M
System to send and receive data to the EDC cloud where end applications or pre-made user designed componentsconsume it.
With EDC, it is possible to modulate the size of the infrastructure as required, for instance starting with just a few test
samples and then deploying the same devices in tens of thousands. Scaling up does not require any change: EDC cloud scales
accordingly to provide you with the performance and capacity you need.
Please follow the instructions within the DenaliUser Guide (http://esf.eurotech.com/doc/FRI/Denali_User_Manual.html.) to
get your credentials for access.

14
5Recovering Your Linux Image on the Kontron M2M System
Your Kontron M2M System comes factory-installed with Wind River Linux and a Tilcon Graphics Suite demonstration. When
you reset the target system, you should see the demonstration screen if the optional display is connected.
Without a connected display you will have to sshinto the target.
If your target does not boot into the demonstration or allow you to ssh into it, you can restore the microSD
memory to its factory settings by performing the following procedure:

15
5.1 Making the Evaluation Image Recovery Tool USB Drive
Before you make a bootable recovery USB image, you must have booted the host computer from the evaluation LiveUSB drive
(or from a development workstation that has had the LiveUSB contents installed on its hard drive). Then:
1. Insert a second USB flash drive that is 2 GB or larger into your host computer (Note: This is not supplied
as part of the kit).
2. Open a terminal window.
3. Change to the root user, then execute the following commands to transfer the recovery image to the target
device.
cd /home/wruser/WindRiver/workspace/WRLinux-Platform
dd if=recovery-boot.iso of=/dev/sdX bs=4M
NOTE: Replace the placeholder /dev/sdX with the specific device file assigned to your USB flash drive
when it was inserted. The X in sdX can be found using dmesg or the df command.
If the USB drive mounted automatically when you inserted it (that is, if an icon appeared on the desktop or
a file manager window opened), you must unmount the device before you proceed to copy the image to the
device.
4. When the command prompt returns, and the activity light (if any) on your flash drive stops blinking,
remove the flash drive.

16
5.2 Recovering your Kontron M2M System Software Evaluation System
1. Disconnect the power adapter from AC power to turn off your system.
2. You must connect a USB keyboard, a USB mouse, a display, and the evaluation image recovery tool
USB drive to the target board.
NOTE: Do not remove the recovery tool USB drive until you return to the command prompt.
3. Make sure the MicroSD card on the processor card is seated well. This step will require the unit to be
disassembled and will most likely not be necessary. A poorly seated MicoSD card can result in Timeout
crashes of the ./reset_media utility listed below.
4. Reconnect the power adapter to AC power to turn on your system.
NOTE: If your system does not boot from the image recovery tool USB drive, reapply power and
immediately press and hold the F7 key until the Boot Manager screen displays, then select the proper
entry from the Boot Option Menu and press ENTER.
5. To prevent Date/Time stamp errors it may be necessary to go to the BIOS and set the current date.
6. After the system boots, log in with the user name root and the password root.
7. Execute the command ./reset_media.
8. The following prompt displays:
Restore the internal media to its factory defaults? [y/n]
9. Type Ythen press ENTER to begin re-installing the evaluation image.
NOTE: Be patient - the re-install operation needs several minutes to complete.
Do not power down the target or remove the evaluation image recovery tool USB drive until the command
prompt displays again on the monitor.
10. Disconnect the power adapter from AC power again to turn off your system.
11. Disconnect the evaluation image recovery tool USB drive.
12. Reconnect the power adapter to AC power to turn on your system.
13. The Kontron M2M System target now boots into the Tilcon Graphics Suite demonstration.
DVI/HDMI
i
Keyboard
Bootable Recovery USB Stick
NOT the LiveUSB Stick used on host
User supplied – not part of kit

6
M
6.1
M
If the host
o
network en
v
communica
M
anual
L
M
anual Lic
e
o
n which you wi
v
ironment) the
n
tion through s
o
1. O
n
A
g
2. R
e
L
icense
A
e
nse Acti
v
ll be running y
o
n
Manua
l
Licen
s
o
me other host.
n
ce your host
h
g
ent dialog bo
x
e
ad the instruct
i
A
ctivati
o
v
ation on
a
o
ur evaluation i
s
s
e Activation m
a
h
as correctly b
o
x
. Click the M
a
i
ons and then
c
17
o
n
a
non-Inte
r
s
not connected
a
kes it possible
o
oted you will
b
a
nual License
c
lick the Next
b
r
net conn
e
to the Internet
to obtain an Ev
a
b
e presented w
i
Activation o
p
b
utton.
2
e
cted host
(for example, i
t
a
luation license
i
th the followi
n
p
tion.
t
is in a secure
by using email
n
g Wind Rive
r
r
EDK