Wind River Linux and
Eurotech Catalyst TC
LiveUSB Evaluation
GETTING STARTED GUIDE
1.0
Copyright © 2011 Wind River Systems, Inc.
All rights reserved. No part of this publication may be reproduced or transmitted in any form or by any means
without the prior written permission of Wind River Systems, Inc.
Wind River, Tornado, and VxWorks are registered trademarks of Wind River Systems, Inc. The Wind River
logo is a trademark of Wind River Systems, Inc. Any third-party trademarks referenced are the property of their
respective owners. For further information regarding Wind River trademarks, please see:
www.windriver.com/company/terms/trademark.html
This product may include software licensed to Wind River by third parties. Relevant notices (if any) are
provided in your product installation at the following location:
installDir/product_name/3rd_party_licensor_notice.pdf.
Wind River may refer to third-party documentation by listing publications or providing links to third-party Web
sites for informational purposes. Wind River accepts no responsibility for the information provided in such
third-party documentation.
Corporate Headquarters
Wind River
500 Wind River Way
Alameda, CA 94501-1153
U.S.A.
Toll free (U.S.A.): 800-545-WIND
Telephone: 510-748-4100
Facsimile: 510-749-2010
For additional contact information, see the Wind River Web site:
www.windriver.com
For information on how to contact Customer Support, see:
www.windriver.com/support
For hardware support, see the Eurotech Web site:
http://support.eurotech-inc.com
Wind River Linux and Eurotech Catalyst TC LiveUSB Evaluation
Getting Started Guide
1.0
23 August 2011
Contents
iii
1 Introduction .........................................................................................................1
1.1 Overview................................................................................................................................... 1
1.2 What Is Included in the Kit ....................................................................................................... 1
1.3 Required Hardware ................................................................................................................... 2
1.3.1 Eurotech Catalyst TC Development Kit Specification............................................... 2
1.3.2 Host Computer Specification ..................................................................................... 2
1.4 LiveUSB Technology................................................................................................................ 3
2 Connecting the Hardware...................................................................................5
2.1 Connecting the Eurotech Catalyst TC and Your Host Computer.............................................. 5
2.2 Powering on the Eurotech Catalyst TC Development Kit......................................................... 5
3 Starting the Evaluation Software.......................................................................7
3.1 Booting the Host Computer.......................................................................................................7
3.2 Accepting the Agreements ........................................................................................................7
3.3 Obtaining an Evaluation License............................................................................................... 7
3.3.1 License Activation on an Internet-Connected Host Computer................................... 8
3.4 Starting Your Evaluation......................................................................................................... 10
3.5 Notes ....................................................................................................................................... 11
Appendix A Recovering Your Linux Image on the Eurotech Catalyst TC.............13
A.1 Making the Evaluation Image Recovery Tool USB Drive...................................................... 13
A.2 Recovering Your Eurotech Catalyst TC Development Kit Evaluation System....................... 14
Appendix B Activating the License Manually..........................................................17
B.1 Activating the License Manually on a Non-Internet-Connected Host..................................... 17
B.2 Activating the License Automatically on a Windows Host..................................................... 19
B.3 Activating the License Manually on a Windows Host ............................................................ 19
Wind River Linux and Eurotech Catalyst TC LiveUSB Evaluation
Getting Started Guide 1.0
iv
Appendix C Troubleshooting Your Evaluation Setup.............................................21
C.1 Network Topology Overview.................................................................................................. 21
C.2 Troubleshooting Your License Activation.............................................................................. 21
C.3 Troubleshooting Graphics Problems on Your LiveUSB Host Computer................................ 23
1
Introduction
Welcome to the Wind River Linux and Eurotech Catalyst TC LiveUSB Evaluation.
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 Eurotech Catalyst TC high-performance, low-power module. You will also use the
Wind River Tilcon Graphics Suite to see how to quickly develop and deploy rich user
interfaces for multifunctional embedded devices.
1.1 Overview
This evaluation will lead 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
Eurotech Catalyst TC Development Kit. It will also demonstrate the powerful user
interface tool, Tilcon Graphics Suite, and show how you can develop professional
graphical displays with absolutely no coding.
During this evaluation you will work with two separate systems:
a host computer on which you will perform tasks such as configuring the Linux OS
that runs on the target, analyzing test results and debugging code. You will also use
the host computer to view Wind River documentation and audio-visual material. The
preferred specification for the host computer is outlined below.
a Eurotech Catalyst TC Development Kit, referred to as a target system, on which
Wind River Linux will run.
1.2 What Is Included in the Kit
This kit includes the following components:
a Eurotech Catalyst TC Development Kit pre-loaded with a Wind River Linux kernel
and root file system (referred to as the LiveUSB Run-Time) that boots the system
into Linux and connects to the Wind River Workbench development tools running
on your host computer. The development kit also includes a 12 V DC adapter.
one bootable LiveUSB flash drive. You will use the LiveUSB flash drive to boot the
host computer. The LiveUSB includes a minimal desktop Fedora image and an
installation of Wind River Linux. This lets users start working with the Wind River
Workbench development suite and Wind River Linux quickly and easily.
1
Wind River Linux and Eurotech Catalyst TC LiveUSB Evaluation
Getting Started Guide 1.0
1.3 Required Hardware
1.3.1 Eurotech Catalyst TC Development Kit Specification
The Eurotech Catalyst TC 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
®
Platform Controller Hub (PCH EG20T). The Intel Atom
processor contains an integrated 2D/3D graphics engine supporting hardware-accelerated
graphics display and video processing capabilities, while the Intel PCH EG20T supports
extensive I/O and data storage capabilities. The module includes up to 2 GB system
SDRAM, RTC, optional e.MMC embedded flash drive, and optional TPM.
The Eurotech Catalyst TC integrates with an application-specific carrier board for a total
production solution. This flexible, modular architecture enables easy customization and
quick time-to-market. The Eurotech carrier board included in the development kit
provides a broad range of on-board peripherals including PCI Express (PCIe), Mini PCIe,
SIM card, Ethernet, USB2.0, LPC bus, CAN bus, RS232/422/485, SD/MMC, SMBus,
I2C bus, LVDS, SDVO, SATA, PS/2 mouse and keyboard, touch screen, backlight,
hardware monitors, GPIO, audio, and optional SPI flash memory.
This LiveUSB evaluation is available for the Eurotech Catalyst TC Development Kit with
the following specifications:
a USB port
a serial port
an Ethernet interface
1.3.2 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)
Other requirements: 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.
2
1 Introduction
1.4 LiveUSB Technology
3
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:
a fully configured and bootable version of the Fedora (Linux) operating system
the Wind River Linux platform, which includes the Wind River Workbench
development suite and a board support package for the Eurotech Catalyst TC
Development Kit
Wind River documentation, including this Getting Started Guide and the
Eurotech Catalyst TC Evaluation Tutorial
a set of audio-visual guides which will lead you through the Wind River Linux
evaluation
Wind River documentation for Wind River Workbench and Wind River Linux
The pre-configured LiveUSB environment lets you use Wind River development tools
without the 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 not use the hard
drive on the host computer. When used correctly, this evaluation will not write to the
hard drive of the host computer.
2
Connecting the Hardware
2.1 Connecting the Eurotech Catalyst TC and Your Host Computer
Before starting this evaluation you should ensure that your Eurotech Catalyst TC and
your LiveUSB host computer are correctly connected. The Eurotech Catalyst TC requires
several connections: power, a keyboard, a mouse, and an Ethernet connection. This
Ethernet connection should be to the same network switch or hub the LiveUSB host
computer is connected to for communication between the target and the Wind River
Workbench Development tools. This evaluation uses the wired connections for both the
Eurotech Catalyst TC and the LiveUSB host computer. Connect these as follows:
1. Ensure that your host computer is switched off.
2. Connect the Eurotech Catalyst TC to a keyboard and a mouse.
3. Connect an Ethernet cable between the Ethernet port on the Eurotech Catalyst TC and
a network switch or hub. Also connect your host computer to the same switch or hub.
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.
4. Connect the Eurotech Catalyst TC to the 12 V DC adapter supplied with the kit.
2.2 Powering on the Eurotech Catalyst TC Development Kit
You should ensure that your Eurotech Catalyst TC is correctly connected and is capable
of booting. To do this, plug the power adapter into the AC wall socket, and briefly press
the on/off button (SW2) on the carrier board. The system begins booting within a few
5
Wind River Linux and Eurotech Catalyst TC LiveUSB Evaluation
Getting Started Guide 1.0
6
seconds. The development kit is pre-loaded 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 system boots successfully, the display will show the main Wind River
Tilcon Graphics Suite Demo screen.
NOTE: You may shut down or reboot the target system 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
Eurotech Catalyst TC). To set up and use SSH to communicate with the target from your
host computer, see section 3.1 Communicating to the Target through the Terminal
Connection of the Eurotech Catalyst TC Evaluation Tutorial.
3
Starting 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. You should also have a keyboard and
mouse connected to the host computer.
Switch on your host computer. You may have to interrupt the boot process in order to
instruct the BIOS to boot from the LiveUSB flash drive instead of the internal hard drive.
The host computer boots into a preconfigured Fedora environment.
3.2 Accepting the Agreements
You will then be presented with several Product Evaluation License Agreements. Click
Accept to accept the agreements and proceed.
3.3 Obtaining an Evaluation License
Before you begin to evaluate the features of the Wind River tools included on this
LiveUSB, you must obtain an evaluation license. This requires an Internet connection,
either on the host on 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 machine on which the LiveUSB
runs.
7
Wind River Linux and Eurotech Catalyst TC LiveUSB Evaluation
Getting Started Guide 1.0
3.3.1 License Activation on an Internet-Connected Host Computer
If the host computer on which you will run your evaluation is connected to the Internet
then this method provides the easiest and quickest way to obtain an evaluation license.
For additional license activation methods, see
Appendix B.
1. On
ce your host has correctly booted you will be presented with the Wind River EDK
Agent dialog box. Click the Automatic License Activation option.
2. Click Next.
NOTE: If you use a network proxy, click Configure Network Proxy to enter your proxy
information.
8
3 Starting the Evaluation Software
3.3 Obtaining an Evaluation License
3. Fill in your registration details (including a valid email address), then click Submit.
3
4. You will be notified when the host computer successfully obtains an evaluation
license. You can then begin using the Wind River host tools.
NOTE: When obtaining a license, the host computer will attempt to connect to the
Internet over the first wired Ethernet interface. If your host has multiple interfaces, or if
you want to use wireless interfaces, you must make the necessary configuration changes.
9
Wind River Linux and Eurotech Catalyst TC LiveUSB Evaluation
Getting Started Guide 1.0
3.4 Starting Your Evaluation
After the host computer boots into the Fedora LiveUSB environment, you will see a
desktop that includes a number of icons, the Embedded Development Kit Agent which
includes a link to this document, and quick launches to the tools.
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 Applications > Wind River > Documentation
> Getting Started Guide. This document displays automatically when you first boot
the Fedora LiveUSB drive.
3. To watch videos of the exercises, select Applications >Wind River >Videos >
Evaluation Tutorial Videos.
1
2
3
10
3 Starting the Evaluation Software
3.5 Notes
11
4. To view the documentation for the Eurotech Catalyst TC platform, click the Eurotech
Hardware Documentation folder on the desktop.
3.5 Notes
You can exercise the evaluation in any way you choose—by following the video
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.
Appendix A Recovering Your Linux
Image on the
Eurotech Catalyst TC
Your Eurotech Catalyst TC Development Kit includes a pre-programmed LiveUSB run-
time flash drive loaded with Wind River Linux and a Tilcon Graphics Suite
demonstration. When you reset the target system, you should see the demonstration
screen.
If your target system does not boot into the demonstration, you can restore the run-time
flash drive to its factory settings by performing the following procedures. This procedure
has two phases:
making the evaluation image recovery tool USB drive
recovering your development target using the evaluation image recovery tool USB
drive
A.1 Making the Evaluation Image Recovery Tool USB Drive
Before you make the recovery tool USB drive, you must have booted the host computer
from the evaluation LiveUSB drive.
1. Insert a second USB flash drive that is 4 GB or larger into your host computer.
2. Open a terminal window.
13
Wind River Linux and Eurotech Catalyst TC LiveUSB Evaluation
Getting Started Guide 1.0
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-usb.img 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.
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.
A.2 Recovering Your Eurotech Catalyst TC Development Kit
Evaluation System
1. Press and hold the on/off button (SW2) to turn off the power to your system.
2. Connect a keyboard and a mouse to the target system.
3. Insert the evaluation image recovery tool USB drive into the dual USB port J4 on the
carrier board.
NOTE: Do not remove the evaluation image recovery tool USB drive until you return to
the command prompt.
4. Briefly press the on/off button to AC power to turn on the power to your system.
NOTE: If your system does not boot from the image recovery tool USB drive, cycle
power and immediately press and hold the F12 key until the Boot Manager screen
displays, then select the proper entry from the Boot Option Menu and press ENTER.
5. After the system boots, log in with the user name root and the password root.
6. Execute the command tgt=/dev/mmcblk0 ./reset_media.
NOTE: The reset_media script targets the block device /dev/sda by default. You can use
the parameter tgt to specify another block device. On the Eurotech Catalyst TC, you must
use the parameter tgt=/dev/mmcblk0 to target the embedded MMC flash device.
7. The following prompt displays:
Restore the internal media to its factory defaults? [y/n]
14
Appendix A Recovering Your Linux Image on the Eurotech Catalyst TC
15
8. Type Y then 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.
9. Press and hold the on/off button to turn off the power to your system.
10. Disconnect the evaluation image recovery tool USB drive.
11. Briefly press the on/off button to turn on the power to your system.
The Eurotech Catalyst TC target now boots into the Tilcon Graphics Suite
demonstration.
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
/
