getting started l.
Download
Skip this Video
Loading SlideShow in 5 Seconds..
Getting Started PowerPoint Presentation
Download Presentation
Getting Started

Loading in 2 Seconds...

play fullscreen
1 / 46

Getting Started - PowerPoint PPT Presentation


  • 484 Views
  • Uploaded on

Getting Started. 1.1 Components of Tornado Getting Help Hardware / Software Configuration Booting Starting Tornado WDB Agent. What is Tornado?. Development Tools. Tornado Development Tools: Launch - Launch Tornado tools WindSh - Access target interactively

loader
I am the owner, or an agent authorized to act on behalf of the owner, of the copyrighted work described.
capcha
Download Presentation

PowerPoint Slideshow about 'Getting Started' - Thomas


An Image/Link below is provided (as is) to download presentation

Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author.While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server.


- - - - - - - - - - - - - - - - - - - - - - - - - - E N D - - - - - - - - - - - - - - - - - - - - - - - - - -
Presentation Transcript
getting started
Getting Started

1.1 Components of Tornado

Getting Help

Hardware / Software Configuration

Booting

Starting Tornado

WDB Agent

development tools
Development Tools
  • Tornado Development Tools:
    • Launch - Launch Tornado tools
    • WindSh - Access target interactively
    • CrossWind - Source-level debugger
    • Browser - Display system information
    • Project Facility - Configure applications or VxWorks
    • WindView - Analyze multitasking application
    • Simulator - Simulate VxWorks target on host OS
  • Tools are customizable with Tcl:
    • Add new functionality
    • Customize user interface
    • some target-resident tools are available.
performance enhancements
Performance Enhancements
  • All tasks reside in a common address space.
  • All tasks run in supervisor (privileged) mode.
cross development cycle
Cross-development Cycle

Typical Tornado development configuration

tornado delivery
Tornado Delivery
  • Boot ROM’s for supported boards
    • Board specific
    • Use network to download VxWorks from host
    • Turnkey for standard boards
  • CD-ROM for product components
    • Tornado tools, which run on the host
    • The VxWorks OS, which runs on the target
    • Wind River Supplied BSP’s
  • Compiler ToolKit
  • Manuals on VxWorks and Tornado
tornado directory tree
Tornado Directory Tree

host Tornado host-resident tools

SETUP Setup program

/usr/wind share Shared XDR code

target VxWorks OS, Board SupportPackages

docs On-Line HTML documentation

host directory tree
Host Directory Tree

include Header files for Tornado tools

src VxColor demo source

host-osHost-specific tools

host bin Tornado and GNU host executables

lib Tornado Tool libraries

resource GUI, Tcl, and Help support files

tcl Standard Tcl distribution

target directory tree
Target Directory Tree

config Files to configure and build VxWorks

all Generic configuration files

bspNameBoard Support Package (BSP)

comps VxWorks component descriptor

files and configlettes

target proj Pre-built VxWorks bootable projects

h VxWorks header files

lib Libraries provided by VxWorks

src Partial VxWorks source code

unsupported Tools, drivers

getting started12
Getting Started

Components of Tornado

1.2 Getting Help

Hardware / Software Configuration

Booting

Starting Tornado

WDB Agent

overview
Overview
  • There are several classes of help resources:
  • Manuals on host tools:
    • Tornado User’s Guide
    • GNU ToolKit User’s Guide
    • WindView User’s Guide
  • Manuals on VxWorks OS:
    • VxWorks Programmer’s Guide
    • VxWorks Network Programmer’s Guide
    • VxWorks Reference Manual
    • BSP Reference (HTML)
  • Tornado Online HTML Manuals
  • Technical Support (if purchased)
other resources
Other Resources
  • Usenet newsgroups covering VxWorks and embedded programming topics, for example comp.os.vxworks.
  • Training courses:
    • Tornado Device Driver Workshop
    • Tornado BSP Training Workshop
    • Tornado Tools Training Workshop
  • Technical Support provides help with
    • installation problems and media errors
    • WRS software, documentation, and service errors
    • understanding WRS product functionality
  • WindSurf self-help web pages: search engine, FAQ, patches, document updates, known problems list, ...
getting started15
Getting Started

Components of Tornado

Getting Help

1.3 Hardware / Software Configuration

Booting

Starting Tornado

WDB Agent

setting up for cross development
Setting up for Cross-Development

To perform cross-development, you must:

  • Set up target hardware.
  • Define host environment variables and configure networking software.
  • Start the Tornado registry, wtxregd.
    • wtxregd manages a list of target servers. Tools contact the registry to look up target servers by name.
  • Specify target boot parameters and boot target.
  • Configure and launch target server.
    • Each target server manages host tools’ interaction with a particular target.
target hardware configuration
Target Hardware Configuration
  • VxWorks ROM’s replace the manufacturer’s ROM’s.
  • Boards may need to be jumpered. See the online BSP Reference entry for your BSP about hardware setup considerations.
  • Of course,
    • Static electricity and overheating can damage boards.
    • Connectors must be firmly in place (serial cables, ethernet cables, VME, etc.).
  • VME specific:
    • “System controller” in slot 0 (left-most slot).
    • Having empty slots between boards requires jumpering the backplane.
unix host software configuration
UNIX: Host Software Configuration
  • Set environment variables required by Tornado in your .cshrc (or .profile) file. The script torvars.csh (or torvars.sh) may be sourced to set these variables.
  • Modify the registry host’s start-up files to start the registry daemon, wtxregd, when the host boots.
  • Configure network access information:
    • Obtain target IP addresses
    • Assign host names to targets (optional)
    • If booting with RSH, list your target’s name in~/.rhosts.
    • If necessary, modify routing tables.
pc host software configuration
PC: Host Software Configuration
  • No environment variables need be set to work within the Tornado IDE under Windows. Source torVars.bat to use tools from the command line.
  • Registry startup procedure is defined when installing Tornado. The registry may be installed
    • in the Startup folder for Windows 95, 98 or NT 4.0.
    • as a service for Windows NT.
  • The registry may also be run manually.
  • When using Tornado, specify the registry host you wish to use on the Tools => Options... =>Tornado Registry page.
  • Consult Windows 95/98/NT documentation to install and configure TCP/IP for a PC.
getting started20
Getting Started

Components of Tornado

Getting Help

Hardware / Software Configuration

1.4 Booting

Starting Tornado

WDB Agent

boot rom
Boot ROM
  • Target’s boot ROM code executes on power up.
  • Boot ROM’s do not contain the VxWorks system under which your application runs.
  • VxWorks system image is an object module on the host.
  • The boot ROM code:
    • Allows setting of boot parameters.
    • Downloads VxWorks into target memory via the network.
    • Starts executing VxWorks.
boot parameters
Boot Parameters

[VxWorks Boot]: p

boot device : ei

unit number : 0

processor number : 0

host name : wolverine

file name : c:\tornado2\target\config\mv162\vxWorks

inet on ethernet (e): 147.11.12.204:ffffff00

host inet (h) : 147.11.12.165

user (u) : todd

ftp password (pw) : covert

flags (f) : 0

target name (tn) : t12-204

  • Unset boot parameters are not displayed by p:

gateway inet (g)

startup script (s)

other (o)

changing boot parameters
Changing Boot Parameters
  • Type “c” at the boot prompt to change the boot parameters interactively.
  • Target boards with NVRAM retain changes after power is cycled.
  • Alternatively, can type boot parameters on a single line at the boot prompt:

$ei(0,0)wolverine:c:\tornado2\target\config\mv162\vxWorks \h=147.11.12.165 e=147.11.12.204 u=todd pw=covert tn=t12-204

  • Keeping this line in a file on the host machine allows cut and paste (in host’s windowing system) for boot.
  • Can also make new boot ROM’s with correct default parameters (see the Reconfiguration chapter).
booting
Booting

[VxWorks Boot]: @

boot device : ei

unit number : 0

processor number : 0

host name : wolverine

file name : c:\tornado2\target\config\mv162\VxWorks

inet on ethernet (e) : 147.11.12.204:ffffff00

host inet (h) : 147.11.12.165

user (u) : todd

ftp password (pw) : covert

flags (f) : 0x0

target name (tn) : t12-204

Attached TCP/IP interface to ei0.

Attaching network interface lo0... done.

Loading... 424504 + 29664 + 29404

Starting at 0x20000...

Attached TCP/IP interface to ei unit 0

Attaching network interface lo0... done.

NFS client support not included.

VxWorks

Copyright 1984-1998 Wind River Systems, Inc.

CPU: Motorola MVME162

VxWorks: 5.4

BSP version: 1.2/0

Creation date: Apr 22 1999

WDB: Ready.

rebooting
Rebooting
  • Type reboot( )at a WindSh prompt.
  • Type CTRL-X in target console or UNIX WindSh.
  • Press abort button on board.
  • Press reset button on chassis.
  • On a power-on or other cold reboot, RAM is zeroed out to avoid parity errors reading uninitialized memory. A warm reboot skips this step.
    • Typing reboot( ) or CTRL-X generates a warm reboot.
    • In a VME environment, typically an abort generates a warm reboot, while a reset causes a cold reboot for all CPU’s on the bus.
alternative booting schemes
Alternative Booting Schemes
  • The shared memory network allows a target to boot over the VMEbus. This scheme is discussed in the appendix.
  • Boot from a local disk.
  • Boot one VxWorks target from another, using the FTP server.
  • Boot over a serial line, using SLIP, CSLIP, PPP, or TSFS. Slower than booting across ethernet.
  • Obtain boot parameters using DHCP or BOOTP, then download the boot file using TFTP.
  • Can put VxWorks in ROM. This will be covered in the Reconfiguration chapter.
getting started29
Getting Started

Components of Tornado

Getting Help

Hardware / Software Configuration

Booting

1.5 Starting Tornado

WDB Agent

accessing tools
Accessing Tools
  • Use a control panel to manage your Tornado session:
    • Create and manage target servers.
    • Start Tornado tools.
    • Invoke online manuals.
    • File requests for Technical Support.
    • Browse relevant Web sites.
  • For UNIX hosts, the control panel is the Launcher. Start control panel with:

% launch&

  • For PC hosts, the Tornado integrated development environment (IDE) serves as the control panel. Invoke the IDE with from the Start menu.
unix launcher
UNIX: Launcher

Menu Bar

Button Bar

Display

Panels

Tool Select

Icons

target server
Target Server
  • After booting a target, you must start a target server to access the target using the Tornado tools.
  • Target server provides host-based management of target resources needed by development tools:
    • Communication with debug agent on target.
    • Dynamic module loading and unloading.
    • Host-resident symbol table for target.
    • Allocation of memory on target for host tools.
    • Cache of target program text segment memory.
    • Virtual I/O facilities.
  • This scheme is flexible:
    • Minimizes tool’s impact on target.
    • Tools independent of type of communication link.
tornado architecture
Tornado Architecture
  • wtxregd must be started before target server and tools.
  • The tools, registry, and target server may run on different hosts.
unix creating target servers pt 1
UNIX:Creating Target Servers (Pt. 1)

Target name/

IP Address

Target

Server Name

Target

Server Lock

creating target servers pt 2
Creating Target Servers (Pt. 2)

Backend list

Target server

command line

Launch Button

pc managing target servers
PC: Managing Target Servers

Target Server Name

Target Server

Properties

Target name/

IP Address

Target Server

Command Line

Launch Button

connecting to target
Connecting To Target
  • Once the target server is successfully connected to the target,
    • (UNIX) An xterm will appear with connection information (provided the Verbose option was specified), or
    • (Windows) A dedicated target server window will display status. Look in taskbar system tray for .
  • Now Tornado tools may be started to interact with the target.
getting started39
Getting Started

Components of Tornado

Getting Help

Hardware / Software Configuration

Booting

Starting Tornado

1.6 WDB Agent

wdb agent configuration
WDB Agent Configuration
  • The WDB Agent acts on the target on behalf of the target server and Tornado tools:
    • Reading or modifying memory.
    • Setting or clearing break points.
    • Creating, starting, stopping, and deleting tasks.
    • Calling functions.
    • Gathering system object information.
  • Agent is configurable:
    • Specify task, external, or dual debug mode.
    • Select communication strategy consistent with target server back end.
    • Set amount of target memory reserved for agent’s use.
agent configuration
Agent Configuration
  • In the default VxWorks image, the WDB agent is defined, enabling WDB Agent support. All target agent components are in /development tool components/WDB agent components/.
  • Set WDB mode component to the appropriate debug strategy (select at least one of the two):
    • .../select WDB mode/WDB system debugging
    • .../select WDB mode/WDB task debugging
  • Set WDB communication type. Some example components are:
    • .../select WDB connection/WDB END driver connection
    • .../select WDB connection/WDB serial connection
  • Configure the agent’s serial channel (optional) by setting component parameters.
summary
Summary
  • Tornado’s three components:
    • VxWorks real-time operating system
    • Networking
    • Development tools
  • BSP (Board Support Package)
    • Located in wind/target/config/bspName
    • Contains board-specific files
  • Host executables are located in wind/host/host-os/bin/.
  • Help available:
    • Online documentation
    • Customer Support and WindSurf
summary44
Summary
  • Target hardware setup is described in BSP documentation.
  • Host environment.
    • Set environment variables for UNIX or command-line use.
    • Configure network facilities: IP addresses and hostnames.
  • Critical boot parameters:
    • boot device
    • VxWorks pathname
    • host internet address
    • target internet address
    • user name
    • processor number
summary45
Summary
  • Use control panel to manage a Tornado development session:
    • Create, restart, and kill target servers.
    • Start Tornado tools like WindSh, Browser, etc..
  • Invoke a target server for each target.
  • Target server manages:
    • Target resources used by host tools.
    • Target information.
    • Communication with target.
    • Tool-target interactions.
summary46
Summary
  • Configure WDB Agent:
    • Debug mode
    • Communication strategy