If it’s embedded, it ’s Kontron.

Wind River VxWorks and Kontron COM Express™ Computer-on-Modules LiveUSB Evaluation

1.1 // 1st of November 2010

» Getting Started Guide «» Getting Started Guide «

COM Express™ basic COM Express™ compact

Wind River VxWorks and Kontron COM Express™ Computer-on-Modules LiveUSB Evaluation

Getting Started Guide

2

1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.2 What is included in the Kit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.3 Required Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.4 LiveUSB Technology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2 Connecting the COM Express™ COM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2.1 Assembling the COM Express™ COM . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2.2 Connecting the COM Express™ miniBaseboard Type 2 (Target) to Your

Host Computer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2.3 Powering on the COM Express™ miniBaseboard Type 2 . . . . . . . . . . . . . . 5

3 Starting the Evaluation software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3.1 Booting the Host Computer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3.2 Accepting the Agreements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3.3 Obtaining an Evaluation License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

3.4 Starting your Evaluation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

3.5 Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

3.6 About Wind River . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

3.7 About Kontron . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

A Appendix A Troubleshooting Your License Activation . . . . . . . . . . . . . . . . 8

A.1 Network Topology Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

A.2 Troubleshooting Your License Activation . . . . . . . . . . . . . . . . . . . . . . . 8

A.3 Recreating the VxWorks Boot Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

COnTEnTS

www.kontron.com

Getting Started Guide

3 www.kontron.com

1 Introduction

Welcome to the Wind River VxWorks 6.8 and Kontron COM Express™ Computer-on-Modules 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 VxWorks, the world’s most popular real-time operating system, on the provided Kontron COM Express™ Computer-on-Modules.

1 .1 Overview

This evaluation will lead you through the steps required to create VxWorks kernel projects, downloadable kernel modules (DKM), and real-time process projects (RTPs), and outline how Wind River tools can aid in the debugging and analysis of embedded systems based on the Kontron COM Express™ Computer-on-Modules.

During this evaluation you will work with two separate systems:

» a host computer on which you will perform tasks such as building VxWorks, analysing test results and debugging code. You will also use the host computer to view Wind River documentation and audio-visual material. You can use almost any modern laptop or desktop PC as a host computer. The preferred specification for the host computer is outlined below. » a Kontron COM Express™ COM, referred to as a target system, on which VxWorks will run.

During the evaluation you will connect these two systems together (using serial and Ethernet connections) and use them in a mode referred to as cross-development. In this mode you will run Wind River Workbench Development Suite on your host computer to write, build, and debug software code which will run on the Kontron Computer-on-Module.

1 .2 What is included in the Kit

This kit includes the following components:

» a Kontron COM Express™ Starterkit Type 2 or a COM Express™ miniStarterkit Type 2, including an COM Express™ minibaseboard Type 2 pre assembled with an ETXexpress® or microETXexpress® Computer-on-Module, a 1GB DDR2 Memory and heatsink. The kit includes power supply, cables and documentations.

» one 2 GB USB flash drive preloaded with the VxWorks 6.8 operating system

» one bootable 8 GB Wind River LiveUSB Environment memory stick. This enables users to quickly and easily boot and start working with the Wind River Workbench development suite on a host computer. Its use is fully described in this document.

» one serial cable to enable connection between the host computer and the Kontron COM Express™ Computer-on- Module

» one Ethernet cable for communication between the target and the Wind River Workbench Development tools

1 .3 Required Hardware

1 .3 .1 COM Express™ Starterkit VxWorks Specification

This ETXexpress®-XX or microETXexpress®-XX LiveUSB evaluation is delivered with (and is designed to operate with) a standard Kontron COM Express™ Starterkit Type 2 or a COM Express™ miniStarterkit Type 2 fully assembled with:

» the selected Kontron COM Express basic or compact Computer-on-Module

» 1GB Memory

» Heatsink

» COM Express™ miniBaseboard Type 2, for COM Express™ modules

» a fan with a massive copper core that fits on a standard ETXexpress® Heatspreader or microETXexpress® Heatsink

» a PicoATX 120W and 12 V PSU for running the COM Express™ miniBaseboard Type 2 (COM Express™ miniStarterkit Type 2 version) » a Switchable ATX PSU 115V/230V~ (COM Express™ Starterkit Type 2 version)

» a USB flash drive with manuals and datasheets

» additional cables Ethernet/serial

For these evaluation kits, the Kontron COM Express™ COM boots from a USB flash drive which is pre-loaded with a fully functional VxWorks 6.8 image that boots the board into VxWorks and connects to the Wind River Workbench development tools running on your host PC.

1 .3 .2 Host Computer Specification

During this evaluation you will run Wind River Workbench Development Suite, for which you will need a suitable host computer. The host computer may be a laptop or desktop PC with the following specifications:

You do not need to install any software on your host computer prior to the evaluation.

Host architecture: Intel® Core™ Duo, 2GHz or greater (recommended)Host memory: 2GB RAM (recommended)USB requirements: USB 2.0 connection (required)Host-target communication: Ethernet, serial

Getting Started Guide

4 www.kontron.com

1 .4 LiveUSB Technology

All the software required to run this evaluation on your host computer is delivered on a fully configured, bootable Wind River LiveUSB Environment memory stick (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 11 (Linux) operating system

» Wind River Workbench Development Suite (pre-installed)

» Wind River VxWorks 6.8 RTOS prepared with a dedicated board support package for the selected COM Express™ COM

» Wind River documentation, including this Getting Started Guide and the Wind River VxWorks and Tilcon Graphics Suite Kontron COM Express™ Evaluation Tutorial

» A set of audio-visual guides that will lead you through the VxWorks evaluation

» Wind River documentation for Workbench and VxWorks

The pre-configured LiveUSB environment allows users to use Wind River development tools without the need to install, configure or build anything prior to the evaluation. Your evaluation should begin almost immediately after you have booted the LiveUSB.Note that, once booted, the LiveUSB software uses the RAM memory of the host computer and the flash memory available in the LiveUSB stick itself – it does not use the hard drive on the host computer. When used currently, this evaluation will not write to the hard drive of the host computer.

2 Connecting the COM Express™ COM

2 .1 Assembling the COM Express™ COM

Before starting this evaluation you should ensure that your Kontron COM Express™ COM is correctly connected. Ensure that you work within a statically safe area and that you have all the required tools available (a Phillips (crosshead) and a flat-bladed screwdriver). Assemble the board as follows.

Your COM Express™ COM will normally be delivered fully assembled onto the COM Express™ miniBaseboard Type 2, in which you should begin assembly at step 5 below . However, if it is necessary to assembly the COM (inclu-ding the heatspreader), you should begin at step 1 .

1. Carefully remove the Kontron COM, the memory, and the cooling fan and heatsink from its packaging.

2. Place the DDR2 RAM into the memory socket on the COM Express™ COM.

3. Fix the heatsink: Apply the thermal grease to the bottom of the standard CPU cooler (don’t forget to remove the protective film) and carefully place the standard CPU cooler onto the black heatspreader plate on the COM Express™ module. Fix the fan to the COM Express™ module using the four screws and washers provided.

4. Carefully place the COM Express™ COM and fan assembly onto the COM Express™ miniBaseboard, making sure that the COM Express™ connectors are correctly aligned. Using firm but even pressure, squeezes the COM Express™ COM down onto the COM Express™ miniBaseboard until it is securely plugged on. Fix the board down using the three screws provided (from the underside of the board).

___________________________________________________

5. Connect the ATX power supply respectively plug the three pin power cable from the cooling fan onto the three pin connector beside the power supply connector.

6. Plug the ATX style power adaptor module into the 20 pin power supply connector on the COM Express™ miniBaseboard and plug the four pin additional power cable (attached to the power adaptor) into the adjacent four pin connector.

7. Plug the 9-pin serial cable adaptor into the COM1 connector on the COM Express™ miniBaseboard (close to the reset and power switches).

2 .2 Connecting the COM Express™ miniBaseboard to Your Host Computer

The COM Express™ miniBaseboard (the target) requires two connections to the host computer — a serial connection for the console output and an Ethernet connection for communication between the target and the Wind River Workbench Development tools. Connect these as follows.

1. Ensure that your host computer is switched off.

2. Connect the 9-way serial cable between the COM1 socket from the COM Express™ miniBaseboard and the primary serial port on your host machine.

3. Connect an Ethernet cable between the Ethernet port on the COM Express™ miniBaseboard and the primary Ethernet port on your host machine. You can either connect the target and the host computer directly connection, or through a hub or switch. Note that the

Getting Started Guide

5 www.kontron.com

evaluation host and COM Express™ COM will be assigned pre-configured static IP addresses during the evaluation. 4. Connect a mouse to one of the USB ports on the COM Express™ miniBaseboard.

5. Connect a monitor to the COM Express™ miniBaseboard using a DVI cable.

6. Insert the VxWorks USB flash drive into one of the USB ports on the COM Express™ miniBaseboard.

7. Ensure that the 12V power supply for the COM Express™ miniBaseboard is correctly connected.

2 .3 Powering on the COM Express™ miniBaseboard

1. Ensure that your COM Express™ miniBaseboard is correctly assembled and is capable of booting.

2. On the COM Express™ miniBaseboard, press the power switch (the blue switch closest to the corner of the board). The board begins to boot within a few seconds.

NOTE: The selected COM Express™ COM boots a special version of VxWorks 6.8 that is specifically configured for development purposes. This reference platform was designed for development flexibility, and as such it may take up to 60 seconds to boot.

3. The ROM BIOS detects the VxWorks boot loader on the USB flash drive --allow the COM to continue.

4. The VxWorks boot loader counts down --allow the boot loader to continue.

5. After VxWorks boots successfully, the monitor displays the main Wind River Tilcon Graphics Suite Demo screen. Please detect and explore the application videos with OpenGLmedical and industrial solutions.

The Wind River Tilcon Graphics Suite demonstration is visible independently from a connection to the host computer as well. From this point on you can use the Reset button if you need to reset the board. (Note that you can also use the Wind River tools to reset the COM Express™ miniBaseboard).

3 Starting the Evaluation Software

3 .1 Booting the Host Computer

Before booting your host computer, ensure that the USBLive Evaluation stick is correctly plugged into a USB port on the host computer. You should also have a keyboard and mouse connected to the host computer.

1. Configure your hardware as shown in the following figure before you boot your host computer

2. Switch on your host computer.

NOTE: You may have to interrupt the boot process to instruct the BIOS to boot from the USB flash drive instead of the internal hard drive.

The host computer boots into a preconfigured Fedora (Linux) environment.

Getting Started Guide

6 www.kontron.com

3 .2 Accepting the Agreements

You will then be presented with a product evaluation license agreement and an object code development license and distribution agreement. Click Accept to accept the agreements and proceed.

3 .3 Obtaining an Evaluation License

When you start your LiveUSB for the first time, an activation agent automatically attempts to obtain an evaluation license for the software on the LiveUSB stick. This requires an Internet connection.

NOTE: The host 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.

Follow the on-screen instructions. You must enter your registration details including a valid email address. After a few minutes, the LiveUSB will be activated and ready to use.The license lasts for thirty days from the acceptance of the agreements and is valid for any machine on which the LiveUSB runs.

3 .4 Starting Your Evaluation

Change your hardware configuration to match the configuration shown in the following figure.

After the host computer boots into the Fedora 11 Live USB environment, you will be presented with a desktop that includes a number of icons, including a link to this document and quick launches to the tools.

For your convenience, there are also a number of pull down menus under Applications > WindRiver at the top of the screen.

1. Select Applications > WindRiver > Documentation > Evaluation Tutorial to open the Wind River VxWorks and Tilcon Graphics Suit, Kontron COM Evaluation Tutorial. 2. Select Applications > WindRiver > Documentation > Getting Started Guide to access the Getting Started Guide. This document displays when you first boot the Fedora Live USB drive.

3. Select Applications > WindRiver > Videos to access videos of the exercises.

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

» The evaluation is interruptible—if you stop partway through, you can resume where you stopped.

» To download updated materials (if available), visit http://www.windriver.com/evaluations/livebundles.

Getting Started Guide

7 www.kontron.com

3 .7 About Kontron

Kontron designs and manufactures standards-based and custom embedded and communications solutions for OEMs, systems integrators, and application providers in a variety of markets. Kontron engineering and manufacturing facilities, located throughout Europe, Americas, and Asia-Pacific, work together with streamlined global sales and support services to help customers reduce their time-to-market and gain a competitive advantage. Kontron’s diverse product portfolio includes: boards and mezzanines, Computer-on-Modules, HMIs and displays, systems, and custom capabilities. Kontron is a premier member of the Intel® Embedded and Communications Alliance. For half a decade now, Kontron has been named a VDC Platinum Embedded Board Vendor. Based entirely on user feedback, industry professionals evaluate vendors on over 45 non-product related criteria. Kontron is only one of two companies to receive the platinum award 5-years running. Kontron is listed on the German TecDAX stock exchange under the symbol „KBC“. For more information, visit: www.kontron.com.

3 .6 About Wind River

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 River500 Wind River WayAlameda, CA 94501-1153U.S.A

Toll free (u.s.a.): 800-545-WINDTelephone: 510-748-4100Facsimile: 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

Copyright © 2010 Wind River Systems, Inc. and Kontron AG 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.

Europe, Middle East & AfricaOskar-von-Miller-Str. 1 85386 Eching/Munich Germany

Tel.: +49 (0)8165/ 77 777 Fax: +49 (0)8165/ 77 279

info@kontron.com

CORPORATE OffICESnorth America14118 Stowe Drive Poway, CA 92064-7147 USA

Tel.: +1 888 294 4558 Fax: +1 858 677 0898

info@us.kontron.com

Asia Pacific17 Building,Block #1,ABP. 188 Southern West 4th Ring Road Beijing 100070, P.R.China

Tel.: + 86 10 63751188 Fax: + 86 10 83682438

info@kontron.cn

Getting Started Guide

8 www.kontron.com

A . Appendix A Troubleshooting Your Evaluation Setup

A .1 . network Topology Overview

For retrieving the evaluation license: To retrieve the evaluation license, the LiveUSB host computer must have access to the Internet. The host computer will attempt to retrieve an IP address on its first wired interface dynamically via DHCP. Although wireless connections may be available on the LiveUSB host computer, they are disabled in the default configuration. If you wish to connect to the Internet over a wireless connection, you must determine the configuration yourself.

For running the evaluation: The steps in the tutorial have been tested using wired interfaces only. Both the target and the LiveUSB host computer must be set to their respective static IP address. Before running the evaluation tutorial, you must switch the LiveUSB host computer to its static IP address. The script that sets the static IP address uses the lowest numbered eth interface that it finds. For example, if the host computer has eth1 and eth2 interfaces, then eth1 will be set to the

static IP address. A .2 . Troubleshooting Your License Activation

During the license activation procedure you may see the following Information dialog.

This indicates that the license activation agent cannot communicate with the Wind River license server. Perform the following procedure to repair this problem.

NOTE: Automatic proxy configuration is not supported. If you are using this configuration, contact Wind River licensing (step 5).

1. Configure your system as shown in section 3.1.

2. From the main Fedora menu, select Applications > Wind River > IP Address > Switch to DHCP.

3. From the main Fedora menu, select Applications > Wind River > Evaluation License Activation >Activate 30 Day Evaluation.

4. Perform the steps in section 3.3 to complete your license activation.

5. If this procedure does not work, contact Wind River licensing at the appropriate location.

north America, South America, Asia/Pacific:Phone: 800-872-4977 (800-USA-4WRS)Email: license@wind Japan:Phone: 81-3-5778-6001Email: license-jp@windriver.com Europe, Middle East, Africa:Phone: +(00)(800) 4977-4977Email: license-emea@windriver.com

Getting Started Guide

9 www.kontron.com

A .3 . Recreating the VxWorks Boot Drive

Before you recreate the VxWorks boot drive, you must boot your host computer from the evaluation LiveUSB. NOTE: Perform this procedure only if you lose or damage the VxWorks boot drive (which is normally plugged into your COM Express™ miniBaseboard) delivered with your evaluation kit.

1. Insert a second USB flash drive that is 1 GB or larger into your host computer. NOTE: Copy any data you wish to keep from the flash drive to a protected location before you continue. This procedure will overwrite the USB flash drive with the VxWorks boot image.

2. Open a terminal window. 3. Execute the command su to become the root user, then execute the following command to transfer the recovery image to the target device.

dd if=/WindRiver/workspace/Boot-Image/usb-recovery . 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, execute the command sync to ensure that all data is written to the USB flash drive. 5. When the command prompt returns, remove the USB flash drive. You can now use the USB flash drive to boot your Kontron COM Express™ Computer-on-Module.