Contents


Contents

About This Manual

Purpose
Audience
Organization
Related Documentation
Notation Conventions
Support

1 Introduction to the pSOSystem Environment

1.1 Target Architecture
1.1.1 The pSOSystem Environment
1.1.2 Application Code
1.2 Host Development System Layout
1.2.1 Configuration Files
1.2.2 Board-Support Packages
1.2.3 The System Library
1.2.4 The Working Directory
1.2.4.1 The System Configuration File
1.2.4.2 The Driver Configuration File
1.2.5 Sample Applications
1.3 The Standard Download/Debug Sequence
1.3.1 Requirements for Downloading the Executable Image
1.3.2 Starting the Executable Image
1.3.3 Debugging the Operating System and Application Code
1.4 The pSOSystem Boot ROMs
1.4.1 Inside the Boot ROMs
1.4.2 Using the Boot ROMs

2 pSOSystem Tutorial for Workstations

2.1 Recommended Software and Hardware
2.2 Creating a Working Directory
2.3 Invoking the pRISM IDE
2.4 A Closer Look at the HELLO Sample Application
2.5 Building an Executable Image
2.6 Downloading the Executable Image
2.6.1 Starting the Boot ROMs
2.6.2 Downloading the Executable Image ram.hex
2.6.3 Starting the Executable Image
2.6.4 Executing the HELLO Sample Application
2.7 Using the SpOTLIGHT Debugger Over a Serial Channel
2.7.1 Assigning the Serial Port
2.7.2 Changing the Printing Method
2.7.3 Adding the pROBE+ RBUG Module
2.7.4 Rebuilding the Executable Image
2.7.5 Reconfiguring the ROMs
2.7.6 Connecting the pRISM IDE to the Target System
2.7.7 Downloading the Executable Image
2.7.8 Starting the Downloaded Operating System
2.7.9 Executing the Hello Sample Application
2.8 Using the SpOTLIGHT Debug Server Over Ethernet
2.8.1 Connecting to the Network
2.8.2 Adding the pNA+ TCP/IP Network Manager to the Downloaded System
2.8.3 Output Over Ethernet
2.8.4 Rebuilding the Executable Image
2.8.5 Reconfiguring the ROMs
2.8.6 Invoking the SpOTLIGHT Debugger on the Host
2.9 Further Investigation
2.10 Changing the Baud Rate

3 pSOSystem Tutorial for PCs

3.1 Recommended Software and Hardware
3.2 Setting Up a Working Directory
3.2.1 Specifying Your Board-Support Package
3.2.2 Configuring SpOTLIGHT
3.3 Invoking the pRISM IDE
3.4 Examining the root.c File
3.5 Building an Executable Image
3.6 Downloading the Executable Image
3.6.1 Starting the Boot ROMs
3.6.2 Downloading the Executable Image ram.hex
3.6.3 Starting the Executable Image
3.6.4 Executing the hello Sample Program
3.7 Using the SpOTLIGHT Debugger Over a Serial Channel
3.7.1 Assigning the Serial Port
3.7.2 Changing the Printing Method
3.7.3 Adding the pROBE+ RBUG Module
3.7.4 Rebuilding the Executable Image
3.7.5 Reconfiguring the ROMs for a Serial Channel
3.7.6 Connecting the pRISM IDE to the Target System
3.7.7 Downloading the Executable Image
3.7.8 Starting the Downloaded Operating System
3.7.9 Executing the hello Sample Application
3.8 Using the SpOTLIGHT Debug Server Over Ethernet
3.8.1 Adding the pROBE+ RBUG Module
3.8.2 Adding the pNA+ Network Manager
3.8.3 Configuring the Host
3.8.4 Output Over Ethernet
3.8.5 Rebuilding the Executable Image
3.8.6 Reconfiguring the ROMs for Ethernet
3.8.7 Invoking the SpOTLIGHT Debugger on the Host
3.9 Further Investigation
3.10 Changing the Baud Rate

4 SpOTLIGHT Debugger Tutorial for Workstations

4.1 SpOTLIGHT Debugger demo Application
4.2 Creating a Working Directory
4.3 Building an Executable Image
4.4 Setting Up Your Target
4.5 SpOTLIGHT Debugger Tutorial
4.6 SpOTLIGHT Debugger in System Debug Mode
4.6.1 Invoking the SpOTLIGHT Debugger and Getting Started
4.6.2 Task Roster Window
4.6.3 Displaying pSOS+ Object Information
4.6.4 Service Breaks
4.6.5 Viewing Files and Functions
4.6.6 Viewing and Modifying Program Variables
4.6.7 Debugging Shared Code and Task Windows
4.6.8 Displaying Stack Trace and Local Variables
4.6.9 Profiling for Performance Tuning and Analysis
4.6.10 Interactive System Calls and Target Output
4.7 SpOTLIGHT Debugger in Task Debug Mode
4.7.1 Entering Task Debug Mode
4.7.2 Adding or Removing Debug Tasks
4.7.3 Breakpoints
4.7.4 Execution Commands
4.7.5 Booting and Initializing the pSOS+ Kernel
4.7.6 Exiting Task Debug Mode

5 SpOTLIGHT Debugger Tutorial for PCs

5.1 SpOTLIGHT Debugger demo Application
5.2 Creating a Working Directory
5.3 Building an Executable Image
5.4 Setting Up Your Target
5.5 Setting Up Your Host
5.6 SpOTLIGHT Debugger Tutorial
5.7 SpOTLIGHT Debugger in System Debug Mode
5.7.1 Invoking the SpOTLIGHT Debugger and Getting Started
5.7.2 Task Roster Window
5.7.3 Displaying pSOS+ Object Information
5.7.4 Service Breaks
5.7.5 Viewing Files and Functions
5.7.6 Viewing and Modifying Program Variables
5.7.7 Debugging Shared Code and Task Windows
5.7.8 Displaying Stack Trace and Local Variables
5.7.9 Interactive System Calls and Target Output
5.8 SpOTLIGHT Debugger in Task Debug Mode
5.8.1 Entering Task Debug Mode
5.8.2 Adding or Removing Debug Tasks
5.8.3 Breakpoints
5.8.4 Execution Commands
5.8.5 Booting and Initializing the pSOS+ Kernel
5.8.6 Exiting Task Debug Mode

6 Shared Memory MultiProcessing Tutorial

6.1 Introduction
6.2 The mpdemo Sample Application
6.2.1 Client Task Execution
6.2.2 Server Task Execution
6.2.3 Console Output
6.2.4 Soft-fail and Rejoin
6.3 Planning the Target System
6.3.1 Assigning Node Numbers
6.3.2 VMEbus Memory Addresses
6.3.3 Selecting a Directory Address
6.4 Setting Up the Hardware
6.5 Testing the Hardware
6.6 Creating a Working Directory
6.7 Building, Downloading, and Starting the Executable Images
6.7.1 Configuring and Downloading to Node 1
6.7.2 Configuring and Downloading to Other Nodes
6.8 Running the Sample Application

7 Understanding and Developing Board-Support Packages

7.1 The Contents of a BSP
7.2 Board-Support Package Routines
7.2.1 Initialization Functions
7.2.2 Interrupt and Exception Handling
7.2.3 Parameter Storage and Retrieval
7.2.4 Serial Drivers
7.2.4.1 Writing Polled Serial Drivers
7.2.4.2 Writing Interrupt-Driven Serial Drivers
7.2.5 Tick Timer
7.2.6 LAN Interfaces
7.2.7 Shared Memory Communication Routines

8 Configuration and Startup

8.1 Overview
8.1.1 sys_conf.h: the System Configuration File
8.1.2 Parameter Storage and the Startup Dialog
8.2 sys_conf.h
8.2.1 Storage and Dialog Parameters
8.2.2 Operating System Components
8.2.3 Serial Channel Configuration
8.2.4 LAN Configuration
8.2.5 Shared Memory Configuration
8.2.6 Miscellaneous Parameters
8.2.7 I/O Devices
8.2.8 Component Configuration Parameters
8.2.8.1 pSOS+, pSOS+m Configuration Table Parameters
8.2.8.2 pROBE+ Configuration Table Parameters
8.2.8.3 pHILE+ Configuration Table Parameters
8.2.8.4 pREPC+ Configuration Table Parameters
8.2.8.5 pNA+ Configuration Table Parameters
8.2.8.6 pSE+ Configuration Table Parameters
8.2.8.7 OpEN Configuration Table Parameters
8.2.8.8 General Serial Block Configuration Parameters
8.2.8.9 Loader Configuration Parameters
8.2.8.10 pMONT Configuration Parameters
8.3 Adding Drivers to the System
8.4 Customizing the System Startup Sequence

A pSOSystem Files and Directories

A.1 apps
A.2 bin
A.3 bsps
A.4 configs
A.5 drivers
A.6 include
A.7 sys

B Board-Specific Information

B.1 IDT 79S381 Evaluation Board
B.1.1 ROM Installation and Hardware Setup
B.1.2 Serial Channel Usage
B.1.3 Memory Layout
B.1.4 Making a pSOSystem Boot ROM
B.1.5 Setting the Ethernet Hardware Address
B.2 IDT 79S460 Evaluation Board
B.2.1 ROM Installation and Hardware Setup
B.2.2 Serial Channel Usage
B.2.3 Memory Layout
B.2.4 Making a pSOSystem Boot ROM
B.2.5 Setting the Ethernet Hardware Address
B.3 IDT 79S465 Evaluation Board
B.3.1 ROM Installation and Hardware Setup
B.3.2 Serial Channel Usage
B.3.3 Memory Layout
B.3.4 Making a pSOSystem Boot ROM
B.3.5 Setting the Ethernet Hardware Address
B.4 Densan DVE R3900 Board
B.4.1 ROM Installation and Hardware Setup
B.4.2 Serial Channel Usage
B.4.3 Memory Layout
B.4.4 Making a pSOSystem Boot ROM
B.4.5 Setting the Ethernet Hardware Address
B.5 LSI 4001 Board
B.5.1 ROM Installation and Hardware Setup
B.5.2 Serial Channel Usage
B.5.3 Memory Layout
B.5.4 Making a pSOSystem Boot ROM
B.5.5 Setting the Ethernet Hardware Address
B.6 LSI Integra100 Board
B.6.1 ROM Installation and Hardware Setup
B.6.2 Serial Channel Usage
B.6.3 Memory Layout
B.6.4 Making a pSOSystem Boot ROM
B.6.5 Setting the Ethernet Hardware Address

Index





psos_support@isi.com

Copyright © 1996, Integrated Systems, Inc. All rights reserved.