Eurotech Catalyst TC Owner's manual

Brand: Eurotech

Model: Catalyst TC

Type: Owner's manual

Wind River Linux and

Eurotech Catalyst TC

LiveUSB Evaluation

GETTING STARTED GUIDE

1.0

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

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

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.

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.

1 Introduction

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.

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

Wind River Linux and Eurotech Catalyst TC LiveUSB Evaluation

Getting Started Guide 1.0

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.

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.

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.

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.

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.

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.

3 Starting the Evaluation Software

3.5 Notes

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.

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]

Appendix A Recovering Your Linux Image on the Eurotech Catalyst TC

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 ...

Eurotech Catalyst TC Owner's manual

Eurotech Catalyst TC Owner's manual

Eurotech Catalyst TC Owner's manual

Related papers

Other documents