EZ3-VX3230. Wind River VxWorks and Kontron EZ3-VX3230 Live USB Evaluation Getting Started Guide. SD.DT.F68-0e - September 2010

Transcription

1 EZ3-VX3230 Photo du Produit Wind River VxWorks and Kontron EZ3-VX3230 Live USB Evaluation Getting Started Guide SD.DT.F68-0e - September 2010 If it's embedded, it's Kontron.

2 Preface EZ3-VX3230 Getting Started Revision History Publication Title: EZ3-VX3230 Getting Started Doc. ID: SD.DT.F68-0e Rev. Brief Description of Changes Date of Issue 0e Initial Version Copyright 2010 Kontron AG. All rights reserved. All data is for information purposes only and not guaranteed for legal purposes. Information has been carefully checked and is believed to be accurate; however, no responsibility is assumed for inaccuracies. Kontron and the Kontron logo and all other trademarks or registered trademarks are the property of their respective owners and are recognized. Specifications are subject to change without notice. Page i SD.DT.F68-0e

3 EZ3-VX3230 Getting Started Preface Proprietary Note This document contains information proprietary to Kontron. It may not be copied or transmitted by any means, disclosed to others, or stored in any retrieval system or media without the prior written consent of Kontron or one of its authorized agents. The information contained in this document is, to the best of our knowledge, entirely correct. However, Kontron cannot accept liability for any inaccuracies or the consequences thereof, or for any liability arising from the use or application of any circuit, product, or example shown in this document. Kontron reserves the right to change, modify, or improve this document or the product described herein, as seen fit by Kontron without further notice. Trademarks This document may include names, company logos and trademarks, which are registered trademarks and, therefore, proprietary to their respective owners. Environmental Protection Statement This product has been manufactured to satisfy environmental protection requirements where possible. Many of the components used (structural parts, printed circuit boards, connectors, batteries, etc.) are capable of being recycled. Final disposition of this product after its service life must be accomplished in accordance with applicable country, state, or local laws or regulations. The Waste Electrical and Electronic Equipment (WEEE) Directive aims to: > reduce waste arising from electrical and electronic equipment (EEE) > make producers of EEE responsible for the environmental impact of their products, especially when they become waste > encourage separate collection and subsequent treatment, reuse, recovery, recycling and sound environmental disposal of EEE > improve the environmental performance of all those involved during the lifecycle of EEE SD.DT.F68-0e Page ii

4 Preface EZ3-VX3230 Getting Started Conventions This guide uses several types of notice: Note, Caution, ESD. Note: this notice calls attention to important features or instructions. Caution: this notice alert you to system damage, loss of data, or risk of personal injury. ESD: This banner indicates an Electrostatic Sensitive Device. All numbers are expressed in decimal, except addresses and memory or register data, which are expressed in hexadecimal. The prefix `0x' shows a hexadecimal number, following the `C' programming language convention. The multipliers `k', `M' and `G' have their conventional scientific and engineering meanings of *10 3, *10 6 and *10 9 respectively. The only exception to this is in the description of the size of memory areas, when `K', `M' and `G' mean *2 10, *2 20 and *2 30 respectively. When describing transfer rates, `k' `M' and `G' mean *10 3, *10 6 and *10 9 not *2 10 *2 20 and *2 30. In PowerPC terminology, multiple bit fields are numbered from 0 to n, where 0 is the MSB and n is the LSB. PCI and CompactPCI terminology follows the more familiar convention that bit 0 is the LSB and n is the MSB. Signal names ending with an asterisk (*) or a hash (#) denote active low signals; all other signals are active high. Signal names follow the PICMG 2.0 R3.0 CompactPCI Specification and the PCI Local Bus 2.3 Specification. For Your Safety Your new Kontron product was developed and tested carefully to provide all features necessary to ensure its compliance with electrical safety requirements. It was also designed for a long fault-free life. However, the life expectancy of your product can be drastically reduced by improper treatment during unpacking and installation. Therefore, in the interest of your own safety and of the correct operation of your new Kontron product, you are requested to conform with the following guidelines. High Voltage Safety Instructions Warning! All operations on this device must be carried out by sufficiently skilled personnel only. Caution, Electric Shock! Before installing a not hot-swappable Kontron product into a system always ensure that your mains power is switched off. This applies also to the installation of piggybacks. Serious electrical shock hazards can exist during all installation, repair and maintenance operations with this product. Therefore, always unplug the power cable and any other cables which provide external voltages before performing work. Page iii SD.DT.F68-0e

5 EZ3-VX3230 Getting Started Preface Special Handling and Unpacking Instructions ESD Sensitive Device! Electronic boards and their components are sensitive to static electricity. Therefore, care must be taken during all handling operations and inspections of this product, in order to ensure product integrity at all times Do not handle this product out of its protective enclosure while it is not used for operational purposes unless it is otherwise protected. Whenever possible, unpack or pack this product only at EOS/ESD safe work stations. Where a safe work station is not guaranteed, it is important for the user to be electrically discharged before touching the product with his/her hands or tools. This is most easily done by touching a metal part of your system housing. It is particularly important to observe standard anti-static precautions when changing piggybacks, ROM devices, jumper settings etc. If the product contains batteries for RTC or memory backup, ensure that the board is not placed on conductive surfaces, including anti-static plastics or sponges. They can cause short circuits and damage the batteries or conductive circuits on the board. General Instructions on Usage In order to maintain Kontron s product warranty, this product must not be altered or modified in any way. Changes or modifications to the device, which are not explicitly approved by Kontron and described in this manual or received from Kontron s Technical Support as a special handling instruction, will void your warranty. This device should only be installed in or connected to systems that fulfill all necessary technical and specific environmental requirements. This applies also to the operational temperature range of the specific board version, which must not be exceeded. If batteries are present, their temperature restrictions must be taken into account. In performing all necessary installation and application operations, please follow only the instructions supplied by the present manual. Keep all the original packaging material for future storage or warranty shipments. If it is necessary to store or ship the board, please re-pack it as nearly as possible in the manner in which it was delivered. Special care is necessary when handling or unpacking the product. Please consult the special handling and unpacking instruction on the previous page of this manual. SD.DT.F68-0e Page iv

6 Table Of Contents EZ3-VX3230 Getting Started Table Of Contents Chapter 1 - Introduction Overview What Is Included in the Embedded Development Kit Required Hardware Kontron EZ3-VX3230 Specification Host Computer Specification LiveUSB Technology Chapter 2 - Connecting the Kontron EZ3-VX Connecting the Kontron EZ3-VX3230 to Your Host Computer Powering On the Kontron EZ3-VX Chapter 3 - Starting the Evaluation Software Booting the Host Computer Accepting the Agreements Obtaining an Evaluation License Starting Your Evaluation Notes Appendix A - Recovering Your VxWorks Image on the Kontron EZ3-VX Appendix B - Troubleshooting Your License Activation Page v SD.DT.F68-0e

7 EZ3-VX3230 Getting Started Introduction Chapter 1 - Introduction Welcome to the Wind River VxWorks and Kontron EZ3-VX3230 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 Kontron EZ3-VX 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 EZ3-VX3230. During this evaluation you will work with two separate systems: a host computer on which you will perform tasks such as configuring the VxWorks 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 Kontron EZ3-VX3230, 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 EZ3-VX What Is Included in the Embedded Development Kit The kit includes the following hardware preconfigured for this evaluation: a Kontron EZ3-VX3230, pre-loaded with a VxWorks and a Benchmarks Demonstration Application. This kit includes a VPX chassis, a VX3230 Single Board Computer, a Rear Transition Module, a power cable, and a serial cable with an adapter. a bootable LiveUSB flash drive. This lets you start working with the Wind River Workbench development suite quickly and easily. a USB flash drive containing the VxWorks Evaluation Image Recovery Tool. This allows you to recover your VxWorks software on the EZ3-VX3230 to its factory setting. SD.DT.F68-0e Page 1

8 Introduction EZ3-VX3230 Getting Started 1.3 Required Hardware Kontron EZ3-VX3230 Specification The Kontron EZ3-VX3230 is a high performance, commercial off-the-shelf single turnkey PowerPC 3U VPX platform engineered for reliability. The system is equipped with the following. a Kontron VX3230 Single Board Computer a Freescale MPC8544 microprocessor running at 1 GHz 1 GB DDR2-533 SDRAM memory 128 kbits nvsram 8 GB on-board flash memory pre-configured with VxWorks and the Benchmarks Demonstration Application U-Boot monitor two Ethernet 10/100/1000Base-T ports accessible on the front panel ETH0 used by VxWorks An Ethernet cable is not included. an RS232 RJ11 DCE serial port accessible on the front panel Both U-Boot and VxWorks direct their input and output through the serial port. a USB 2.0 port accessible on the front panel used by the VxWorks Image Recovery software a Rear Transition Module a 3U VPX chassis and power cable an RJ11 serial DTE serial cable with a RJ11 to DB9 female (DCE) adapter 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: Host memory: USB requirements: Other requirements: Intel Core2, 2 GHz or greater (recommended) 2 GB RAM (recommended) USB 2.0 connection (required) Static IP addresses: host computer ( ) target ( ) You do not need to install any software on you host computer prior to the evaluation. Page 2 SD.DT.F68-0e

9 EZ3-VX3230 Getting Started 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 Wind River Workbench Development Suite (pre-installed) Wind River VxWorks 6.8 RTOS prepared with a board support package for the Kontron VX3230 Wind River documentation, including this Getting Started Guide and the Wind River VxWorks EZ3-VX3230 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 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 hard drive of the host computer. SD.DT.F68-0e Page 3

10 Connecting the Kontron EZ3-VX3230 EZ3-VX3230 Getting Started Chapter 2 - Connecting the Kontron EZ3-VX Connecting the Kontron EZ3-VX3230 to Your Host Computer The Kontron EZ3-VX3230 (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 RJ11 serial cable between the Serial socket on the faceplate of the VX3230 Single Board Computer and the primary serial port on your host machine. A RJ11 to DB9 female DCE adapter is required. 3. Connect an Ethernet cable from the ETH0 port on the faceplate of VX3230 Single Board Computer to a hub or router. Connect an Ethernet cable from the primary Ethernet port on your host machine to the same hub or router. Note that the evaluation host and VX3230 SBC will be assigned a pre-configured static IP addresses during the evaluation. The Ethernet connection must connect to the same network switch or hub as the host PC, to allow communication between the target and the Wind River Workbench Development tools. 4. Insert the LiveUSB drive into a USB port on the host computer. 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 must change to a static IP address (so the tools can communicate with the target). Page 4 SD.DT.F68-0e

11 EZ3-VX3230 Getting Started Connecting the Kontron EZ3-VX Powering On the Kontron EZ3-VX Connect the power cable to the power port on the back of the VPX chassis. 2. Turn the power on from the switch at the back of the VPX chassis. SD.DT.F68-0e Page 5

12 Starting the Evaluation Software EZ3-VX3230 Getting Started Chapter 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. 1. Configure your hardware as shown in the following figure before you boot your host computer. 2. Switch on your host computer. You may have to interrupt the boot process in order 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 environment. 3.2 Accepting the Agreements You will then be presented with a Product Evaluation License Agreement. Click Accept to accept the agreement and proceed. Page 6 SD.DT.F68-0e

13 EZ3-VX3230 Getting Started Starting the Evaluation Software 3.3 Obtaining an Evaluation License When you start your LiveUSB for the first time, you must obtain an evaluation license in order to activate the software on the LiveUSB flash drive. This requires an Internet connection. The license lasts for thirty days from the acceptance of the agreements and is valid for any machine on which the LiveUSB runs. Follow the on-screen instructions during boot up. You must enter your registration details including a valid address. After a few minutes, the LiveUSB will be activated and ready to use. 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, including a link to this document and quick launches to the tools. For your convenience, there are several pull down menus under Applications > Wind River at the top of the screen. Wind River Wind River VxWorks and Kontron EZ3-VX3230 LiveUSB Evaluation, Kontron EZ3-VX3230 Evaluation Tutorial. 1. Select Applications > WindRiver > Documentation > Evaluation Tutorial to open the 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. SD.DT.F68-0e Page 7

14 Starting the Evaluation Software EZ3-VX3230 Getting Started 3. Select Applications > WindRiver > Videos > Evaluation Tutorial 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 at any point in the evaluation, you can resume where you stopped. The version of Fedora on the LiveUSB stick is minimal. It uses a RAM file system and does not release memory after use. 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 Page 8 SD.DT.F68-0e

15 EZ3-VX3230 Getting Started Recovering Your VxWorks Image on the Kontron EZ3-VX3230 Appendix A - Recovering Your VxWorks Image on the Kontron EZ3-VX3230 Your Kontron EZ3-VX3230 comes with VxWorks 6.8 and a Web Based Benchmarks demonstration factory-installed on the VX3230 SBC. When you reset the module, the system boots into U-Boot, then loads and boots VxWorks and the Web Based Benchmarks demonstration. Your terminal should look similar to the following. If your target does not boot into the demonstration, you can restore the on-board flash drive to its factory settings by performing the following procedure. This procedure will take over three minutes to complete. 1. Insert the VxWorks Evaluation Image Recovery USB Drive into the front of the VX3230 Single Board Computer. 2. Connect the serial port on the front panel of VX3230 Single Board Computer to a terminal configured for BPS. You can use the Terminal view in Wind River Workbench for this purpose. You must boot the LiveUSB and bring up a terminal as described in the Wind River VxWorks EZ3-VX3230 Evaluation Tutorial. 3. Turn the power on from the switch at the back of the VPX chassis. 4. When U-Boot begins to boot, press any key to stop the bootstrap. The VX3230 => prompt displays. SD.DT.F68-0e Page 9

16 Recovering Your VxWorks Image on the Kontron EZ3-VX3230 EZ3-VX3230 Getting Started 5. From the command line, execute the command: usb start; fatload usb 1:1 0x vxworks; usb stop; bootvx 0x After a few seconds, the output shows that U-Boot is booting VxWorks. 7. The VxWorks banner displays, followed by a series of messages as VxWorks detects the USB drives. 8. The terminal displays the start of the VxWorks Evaluation Image Recovery, and warns you not to power off the Vx3230 or remove the USB flash drive. Do not remove the VxWorks Evaluation Image Recovery Tool USB Drive until prompted. 9. The VxWorks Evaluation Image Recovery USB software partitions and formats the on-board USB drive. This step consumes the most of the time of procedure. Page 10 SD.DT.F68-0e

17 EZ3-VX3230 Getting Started Recovering Your VxWorks Image on the Kontron EZ3-VX After the utility formats the on-board USB device, it remounts the devices, copies VxWorks and the Benchmarks Demo DKMs to the on-board flash drive, configures U-Boot and the VxWorks boot line. 11.On completion, the utility indicates that the procedure is finished, and prompts you to remove the VxWorks Evaluation Image Recovery USB drive. 12.Remove the USB flash drive. The system begins to reboot. 13.The system reboots U-Boot. Allow the system to boot. Do not hit any key to stop U-Boot. SD.DT.F68-0e Page 11

18 Recovering Your VxWorks Image on the Kontron EZ3-VX3230 EZ3-VX3230 Getting Started 14.The system loads VxWorks from the on-board flash drive and boots it. Output resembling the following indicates that the recovery succeeded. Page 12 SD.DT.F68-0e

19 EZ3-VX3230 Getting Started Troubleshooting Your License Activation Appendix B - 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. 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 page From the main Fedora menu, select Applications > Wind River > IP Address > Switch to DHCP. SD.DT.F68-0e Page 13

20 Troubleshooting Your License Activation EZ3-VX3230 Getting Started 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 page 7 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-USA-4WRS) license@windriver.com > Japan: Phone: license-jp@windriver.com > Europe, Middle East, Africa: Phone: +(00)(800) license-emea@windriver.com Page 14 SD.DT.F68-0e

21 MAILING ADDRESS TELEPHONE AND Kontron Modular Computers S.A.S. +33 (0) rue Marcelin Berthelot - BP 244 sales@kontron.com ZI TOULON EST support-kom-sa@kontron.com TOULON CEDEX - France For further information about other Kontron products, please visit our Internet web site: