TOC PREV NEXT



Using This Manual

Organization
Conventions
Font Conventions
Symbol Conventions
Mouse Conventions
Note, Caution, and Warning Conventions
Format Conventions
Commonly Used Terms and Acronyms
Related Publications
Suppor
Contacting Integrated Systems Support

Overview of the pRISM+ Environment

1.1 What is pRISM+?
1.2 pSOSystem Application Development Environment (ADE)
1.3 pRISM+ Host Tools
1.3.1 pRISM+ Manager
1.3.2 pRISM+ Configuration Wizard
href1.3.3 pRISM+ Editor
1.3.4 pRISM+ Source Code Engineering Tool - SNiFF+ [Optional]
1.3.5 Object Browser
1.3.6 Embedded System Profiler (ESp) [Optional]
1.3.7 pRISM+ Shell
1.3.8 pRISM+ Cross-Compiler Suite
1.3.9 pRISM+ Source-Level Debugger -- SearchLight
1.3.10 SingleStep Debugger [Optional]
1.3.11 Run-time Analysis (RTA) Suite [Optional]
1.4 pRISM+ Communications Infrastructure
1.4.1 Communication Server
1.4.2 Debug Server
1.5 Getting More Information About pRISM+
1.5.1 pRISM+ Documentation
1.5.2 Documentation Roadmap

Understanding pSOSystem

2.1 What Is pSOSystem?
2.2 System Architecture
2.2.1 Target Architecture
2.2.2 Host Development System Layout
2.2.3 Sample Applications
2.3 System Configurations
2.3.1 Host System Configuration
2.3.1 pSOSystem System Library
2.4 Where to Go From Here?

Quick Start with a Tutorial

3.1 Before You Begin
3.2 Launch pRISM+
3.3 Start A New Project with pRISM+
3.4 Choosing a Project Tool
3.5 Using pRISM+ Editor
3.5.1 Choosing a pSOSystem Sample Application As a Starting Point
3.5.2 Setting Up a New Project
3.5.3 Getting Acquainted with pRISM+ Editor
3.6 Using SNiFF+
3.6.1 Choosing a pSOSystem Sample Application As a Starting Point
3.6.2 Setting Up a New Project
3.6.3 Getting Acquainted with SNiFF+
3.7 Configuring the Target Board
3.7.1 Connecting the Target Board to the Host Machine
3.7.2 Starting the Terminal Emulation Program on a Windows Platform
3.7.3 Starting the Terminal Emulation Program on a UNIX Platform
3.8 Configuring the Target Communications Parameters
3.9 Adding a Target Board to the pRISM+ Target List
3.10 Downloading and Debugging with SingleStep Source-Level Debugger
3.11 Downloading/Debugging with SearchLight Source-Level Debugger
3.12 Using Object Browser
3.12.1 About Object Browser
3.13 Using ESp
3.13.1 Configuring an Experiment
3.13.2 Starting a Data Collection
3.13.3 Analyzing the Data

Understanding the pRISM+ Manager

4.1 The pRISM+ Development Environment
4.1.1 Overview
4.1.2 pRISM+ Manager and the pRISMSpace
4.1.3 The Tool Manager
4.1.4 The Target Manager
4.1.5 After Downloading the Application

pRISM+ Editor

5.1 Makefile Browser
5.1.1 Makefile View
5.1.2 Source View
5.1.3 Additional Makefiles
5.1.4 Current Project and Current Target
5.2 Program Editor
5.3 Message View
5.4 Using the pRISM+ Editor
5.4.1 Creating New Source Files
5.4.2 Saving New Source Files
5.4.3 Copying an Existing Source Files
5.4.4 Adding Source Files to Your Project
5.4.5 Error Checking Your Files
5.4.6 Introducing an Error
5.4.7 Profiling Your Project
5.4.8 Accessing the Link Map Analyzer Tool
5.4.9 Including Custom Libraries
5.4.10 Adding a Makefile
5.4.11 Adding a BSP Makefile
5.4.12 Removing a Makefile
5.4.13 Using the Buffer List

Using SNiFF+ in the pRISM+ Environment

6.1 Overview
6.2 Key Features of pRISM+ Application Development Framework
6.2.1 Source Code Comprehension
6.2.2 Team Development
6.2.3 Mixed-Platform Development
6.2.4 Integrated Make Support
6.2.5 Flexible Application Development Framework
6.3 Key SNiFF+ Concepts
6.3.1 Code Comprehension and Browsing
6.3.2 Source Code Parsing
6.3.3 Projects
6.3.4 Workspaces
6.3.5 Working Environments
6.3.6 How File Sharing Works
6.3.7 SNiFF+ Build and Make Support
6.3.8 Building Targets When Using Team Working Environments
6.4 Using the pRISM+ Application Development Framework
6.4.1 Team Development Support
6.4.2 pRISM+ Default Working Environments Settings
6.4.3 Restoring the Default Working Environment Settings
6.4.4 What Can You Do with pRISM+ Team Support?
6.5 pSOSystem Source Projects
6.5.1 File and Directory View of a pSOSystem Sample Application
6.5.2 pSOSystem Projects
6.5.3 Browse View Versus Build View of pSOSystem Source Projects
6.5.4 Browsing pSOSystem
6.5.5 Utilities Programs
6.6 pRISM+ Make Support
6.6.1 pRISM+ Make Options at a Glance
6.6.2 pSOSystem Application Make Structure
6.6.3 Make Attributes of pSOSystem Source Projects
6.6.4 Making a pSOSystem Target Executable
6.6.5 Using pSOSystem Makefiles
6.6.6 Using the SNiFF+ Makefile-Generation Feature
6.6.7 Generating Makefiles for Your Project
6.6.8 Hybrid Make Model
6.6.9 Doing Team-Based Builds
6.6.10 Building from the Command Line
6.7 Using the pRISM+ Application Development Framework with SNiFF+
6.7.1 Starting a New Project with pRISM+
6.7.2 Starting a Project from Your Existing Code Base
6.7.3 Integrating a Custom Board Support Package into pRISM+
6.7.4 Converting a Project Made with pRISM+ Editor
6.7.5 Starting with an Existing Application for a Previous Version of pRISM+/pSOSystem

pRISM+ Configuration Wizard

7.1 pRISM+ Wizard Features
7.2 pRISM+ Wizard Interface and Modes
7.2.1 pRISM+ Wizard Interface
7.2.2 pRISM+ Wizard Modes
7.2.3 Error Checking
7.2.4 Upgrading a Configuration File

The SearchLight Debugger - A Tutorial

8.1 What is SearchLight Debugger?
8.2 Starting SearchLight Debugger and Downloading an Application
8.2.1 Accessing SearchLight Debugger
8.2.2 Downloading an Application
8.3 Debugging in System Debug Mode
8.3.1 Step, Stepi, Next and Nexti Commands and Code Views
8.3.2 Setting and Removing an OS Breakpoint
8.3.3 Viewing Memory Variables
8.3.4 Viewing Registers
8.3.5 Navigating Through the Files Window
8.3.6 Using Find to Locate a Text String and Set a Breakpoint
8.3.7 Examining the Call Stack
8.3.8 Examining System Objects
8.4 Debugging in Task Debug Mode
8.4.1 Accessing Task Debug Mode
8.4.2 Setting Breakpoints in TDM
8.4.3 Removing Tasks from Task Debug Mode
8.4.4 Exiting Task Debug Mode
8.4.5 Conclusion

The SingleStep Debugger - A Tutorial

9.1 What is SingleStep Debugger?
9.2 Using SingleStep Debugger
9.2.1 Before You Begin
9.2.2 Starting SingleStep Debugger for pSOSystem
9.2.3 The Toolbar and Source Windows
9.2.4 Invoking the Command Window
9.2.5 Running the System Debug Tutorial
9.2.6 Source, Mixed, and Disassembly Display Modes

ESp

10.1 ESp Prerequisites
10.2 Placing User-Defined Event in the Application
10.3 Refining Data Collection Needs
10.3.1 Buffer Management
10.3.2 Event Specification
10.4 Tailoring the Configuration Table
10.5 Tailoring the Application's Stacks
10.6 Post-Mortem Analysis in ESp

Object Browser

11.1 Monitoring for Stack Problems
11.1.1 Stack Problem Setup
11.1.2 Understanding Your Stack Graphics Data
11.2 Finding Memory Leaks
11.3 Checking for Deadlocks and Priority Inversion
11.4 Logging Data in the CSV Files
11.5 Selective Logging of Data in Graph Frame

Run-Time Analysis (RTA) Suite

12.1 Overview
12.1.1 Run-Time Error Checker
12.1.2 Visual Interactive Profiler
12.1.3 Link Map Analyzer
12.1.4 Stack Use Analyzer

pRISM+ Shell

13.1 Using Interactive pSOS-Aware Commands
13.1.1 Obtaining Status of a pSOS Object
13.1.2 Modifying Communication Timeouts
13.1.3 Downloading a pSOS+ Executable
13.1.4 Using pRISM+ Shell with SearchLight Debugger
13.2 Using and Invoking a pRISM+ Shell Tcl Script
13.2.1 Using an Existing Tcl Script for Testing
13.2.2 pRISM+ Shell Script Example
13.3 Using Low-Level TCL/CORBA Services
13.4 Customizing the pRISM+ Shell

pRISM+ Target Agents

14.1 pMONT+ Target Agent
14.1.1 Target Requirements for Monitoring an Application
14.1.2 Configuring pMONT+
14.1.3 pMONT+ Driver Usage
14.1.4 pMONT+ Behavior on the Target
14.1.5 log_event() System Call
14.1.6 Memory Usage
14.2 pROBE+ Target Agent
14.2.1 pROBE+ Behavior on the Target
14.2.2 Configuring pROBE+

Customize the pRISM+ Tools/Environment

15.1 Customizing Your pRISM+ Tools
15.1.1 Customizing Your Toolbar
15.1.2 Incorporating a Custom BSP for pSOSystem
15.2 Customizing Your pRISM+ Environment
15.2.1 Multiple pRISM+ Installations
15.2.2 Multiple-users Configuration (UNIX Only)
15.2.3 Mixed-Platform Development for Solaris and Windows
15.2.4 Redefining Your Environment Variables
15.2.5 Redefining Your Color Settings (Solaris and HP-UX)
15.2.6 Setting a Printer for On-line Help (Solaris and HP-UX)

Board-Support Package Information

A.1 IBM 403GA/GC Evaluation Board
A.1.1 Hardware Setup
A.1.2 Building pSOSystem Boot ROM
A.1.3 Booting with pSOSystem
A.1.4 Memory Layout and Usage
A.1.5 Devices Supported for The IBM 403GA/GC Evaluation Board
A.1.6 Serial Driver Multiplexor Considerations
A.1.7 Miscellaneous
A.2 Motorola FADS860/FADS821/FADS823/FADS850
A.2.1 Hardware Setup
A.2.2 Building pSOSystem FLASH Image
A.2.3 Booting With pSOSystem
A.2.4 Memory Layout and Usage
A.2.5 Devices Supported for the Motorola FADS860/FADS821/ FADS823/FADS850
A.2.6 VME Configuration for Shared Memory and pSOS+m Use
A.2.7 Miscellaneous Information
A.2.8 Serial Driver Multiplexor Considerations
A.2.9 Miscellaneous
A.3 Motorola MBX 821/860
A.3.1 Hardware Setup
A.3.2 Building pSOSystem Boot ROM
A.3.3 Booting With pSOSystem
A.3.4 FLASH Programming
A.3.5 Memory Layout and Usage
.3.6 Devices Supported for Motorola MBX 821/860
A.3.7 Miscellaneous Information
A.3.8 Serial Driver Multiplexor Considerations
A.3.9 Miscellaneous
A.4 Software Development Systems PowerPC Simulator
A.4.1 Serial Channel Usage and Other Peripherals
A.4.2 CPU Type and FPU Support
A.4.3 Memory Layout
A.4.4 Miscellaneous
A.5 Yellowknife PPC603/MPC750
A.5.1 Hardware Setup
A.5.2 Building pSOSystem Boot Image
A.5.3 Building pSOSystem Boot ROMs
A.5.4 Devices Supported for The YellowKnife Board
A.5.5 Serial Driver Multiplexor Information
A.5.6 Using Yellowknife With The SDS Debugger
A.5.7 Miscellaneous

pRISM+ Environment Variables

B.1 pRISM+ Variables for the Windows Environment
B.2 pRISM+ Variables for the UNIX Environment

pRISM+ Supported Host/Target Connections

C.1 Using a Serial Connection
C.1.1 Building a pSOSystem Application
C.1.2 Configuring Target Environment
C.1.3 Configuring Target Communications Parameters
C.1.4 Configuring Host Tools Connection with the Target
C.1.5 Using pRISM+ Tools
C.2 Using an Ethernet Connection
C.2.1 Building a pSOSystem Application
C.2.2 Configuring Target Environment
C.2.3 Booting pSOSystem
C.2.4 Configuring Host Tools Connection with the Target
C.2.5 Using pRISM+ Tools
C.3 Using a Communication Server Remotely
C.3.1 Building a pSOSystem Application
C.3.2 Configuring Target Environment
C.3.3 Booting pSOSystem
C.3.4 Using pRISM+ Tools
C.4 Using BDM/JTAG Connections
C.4.1 Introduction
C.4.2 Sys_conf.h Settings
C.4.3 Configuring Target Environment
C.4.4 Configuring the Host Environment
C.5 Using the TFTP Server
C.5.1 Building a pSOSystem Application
C.5.2 Sys_conf.h Settings
C.5.3 Configuring Target Environment
C.5.4 Configuring Host Environment
C.5.5 Using the TFTP Server Connection

pRISM+ Shell Commands

D.1 Overview
D.2 pRISM+ Shell Command Reference
boot
breakpoint
cb
cn
comm
condvar
connect
csabout
db
dcn
debugger
di
disassemble
disconnect
dl
dm
dr
dssession
ev
evaluate
evt
fl
fm
go
halt
he
help
il
init
initialize
lb
log
memory
mod
mutex
osbreakpoint
partition
pm
pr
probe
psos
q*
queue
quit
region
register
sc
semaphore
session
sf
stackfrm
t*
target
task
tsd
version
D.3 Comparison of pROBE+ and pRISM+ Shell Commands
D.4 TCL Commands
type
vinfo
bind
set
new
delete
toString
invoke
slength

pSOSystem Source Projects

E.1 Generic pSOSystem Projects
E.2 Drivers Project
E.3 Bsp Projects
E.4 Sample Application Projects
E.5 Sample Application Projects
E.6 VPATH
E.7 pLUGINS+ Scripts
E.7.1 Scripts to Create SNiFF+ Projects for pSOSystem
E.7.2 Integration scripts
E.7.3 Startup scripts

Glossary gloss-1

Index index-1


TOC PREV NEXT