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