Intel IXP2800 Manuals

Manuals and User Guides for Intel IXP2800. We have 1 Intel IXP2800 manual available for free PDF download: User Manual

Intel IXP2800 User Manual (320 pages)

Network Processors

Brand: Intel | Category: Computer Hardware | Size: 3.85 MB

Revision History
2
Table of Contents
3
Introduction
17
- About this Document
  17
- Intended Audience
  17
- Related Documents
  17
Developer Workbench
19
- Overview
  19
- About the Graphical User Interface (GUI)
  20
  - About Windows, Toolbars, and Menus
    20
The Developer Workbench GUI
20
- Hiding and Showing Windows and Toolbars
  21
Floating Window, Tool Bar, and Menu Bar
21
- Customizing Toolbars and Menus
  22
  - Creating Toolbars
    22
  - Renaming Toolbars
    23
  - Deleting Toolbars
    23
  - Adding and Removing Toolbar Buttons and Controls
    23
  - Customizing Menus
    24
  - Returning to Default Toolbar Settings
    24
  - GUI Toolbar Configurations
    25
- Workbench Projects
  25
  - Creating a New Project
    25
    
    Debug-Only Projects
    27
  - Opening a Project
    28
  - Saving a Project
    28
Specify Debug-Only UOF Files Dialog Box
28
- Closing a Project
  29
- Specifying a Default Project Folder
  29
- About the Project Workspace
  30
  - About Fileview
    30
  - About Threadview
    31
    
    Expanding and Collapsing Thread Trees
    31
    
    Renaming a Thread
    31
  - About Infoview
    32
- Working with Files
  32
  - Creating New Files
    32
  - Opening Files
    33
  - Closing Files
    33
  - Saving Files
    33
  - Saving Copies of Files
    34
  - Saving All Files at Once
    34
  - Working with File Windows
    34
  - Printing Files
    35
    
    Printing the File
    35
    
    Setting up the Printer
    35
  - Inserting into and Removing Files from a Project
    36
    
    Inserting Files into a Project
    36
    
    Removing Files from a Project
    36
  - Editing Files
    36
    
    Tab Configuration
    36
  - Go to Line
    37
Configure Tabs Dialog Box
37
Go to Line Dialog Box
37
- Bookmarks and Errors/Tags
  38
- About Find in Files
  38
- About Fonts and Syntax Coloring
  39
- About Macros
  40
The Assembler
40
- Root Files and Dependencies
  41
- Selecting Assembler Build Settings
  41
- Invoking the Assembler
  45
- Assembly Errors
  46
The Microengine C Compiler
47
The Linker
54
- Customizing Linker Settings
  54
- Building and Rebuilding a Project
  57
Configuring the IXP2400 Simulation Environment
58
- IXP2400 Clock Frequencies
  58
- IXP2400 Memory
  59
Clock Frequencies for the IXP2400
59
IXP2400 Memory Options
60
- IXP2400 MSF Device Configuration
  61
The Create Media Bus Device Dialog Box for CSIX
62
The Create Media Bus Device Dialog Box for X32Mphy16
63
- IXP2400 Network Connections
  65
Port Characteristics Edit Port Dialog Box
65
Network Connections Property Page - IXP2400
66
- IXP2400 CBUS Connections
  67
CBUS Connections Property Page - IXP2400
67
Configuring the IXP2800 Simulation Environment
68
- IXP2800 Clock Frequencies
  68
- IXP2800 Memory
  69
Clock Frequencies for the IXP2800
69
IXP2800 Memory Options
70
- IXP2800 MSF Device Configuration
  71
IXP2800 MSF Devices
71
The Create Media Bus Device Dialog Box for SPI-4
72
The Create Media Bus Device Dialog Box for CSIX
73
Port Characteristics Edit Port Dialog Box
75
- IXP2800 Network Connections
  76
Network Connections Property Page - IXP2800
76
- IXP2800 CBUS Connections
  77
CBUS Connections Property Page - IXP2800
77
Packet Simulation
78
- General Options
  79
Packet Simulation Options Property Sheet- General Tab
79
- Traffic Interface Logging
  80
Packet Simulation Options Dialog Box (IXP2400 and IXP2800) - Traffic Interface Logging
81
- Stop Control
  82
Packet Simulation Options (IXP2400 IXP2800) - Stop Control Tab
82
- Traffic Assignment
  83
Packet Simulation Options (IXP2400 and IXP2800) - the Traffic Assignment Tab
84
Assign Input to Port - Datastreams
85
Assign Input to Port - Network Traffic
85
Assign Output from Port
87
- Manage NTS Plug-Ins
  88
Manage NTS Plug-Ins Property Page
88
- Network Traffic Simulation Dlls
  89
Data Streams
90
Define Network Traffic - Data Stream Dialog Box
91
Create Stream Pop-Up
91
- Creating and Editing a POS IP Data Stream
  92
- Debugging
  104
Simulation and Hardware Mode Features
105
Instruction Markers
105
- Local Simulation Debugging with a Local Foreign Model
  106
  - Local Simulation Debugging with a Remote Foreign Model
    107
  - Hardware Debugging
    107
  - Portmapper
    108
  - Starting and Stopping the Debugger
    108
  - Changing Simulation Options
    108
    
    Marking Instructions
    108
Marking Instructions for the Network Processor
109
Using Imported Variable Data at Startup in Simulation Mode
112
Using Imported Variable Data at Startup in Hardware Mode
112
- Exporting the Startup Script
  113
- Changing Hardware Options
  113
  - Specifying Hardware Startup Options
    113
  - The Command Line Interface
    114
  - Command Scripts
    114
  - Thread Windows
    115
    
    Controlling Thread Window Activation
    115
    
    Thread Window Controls
    117
The Assembler Thread Window
117
The Compiled Thread Window
118
- Tracking the Active Thread
  119
- Running to Cursor
  119
- Toggle View
  119
- Activating Thread Windows
  120
- Displaying, Expanding, and Collapsing Macros (Assembled Threads Only)
  121
Expanding Macros
121
- Displaying and Hiding Instruction Addresses
  122
- Instruction Markers
  123
- Viewing Instruction Execution in the Thread Window
  123
- Document and Thread Window History
  124
- Run Control
  125
  - Single Stepping
    125
  - Stepping Microengines
    125
  - Stepping over
    126
  - Stepping into (Compiled Threads Only)
    126
  - Stepping out (Compiled Threads Only)
    126
  - Executing Multiple Cycles
    127
  - Running to a Specific Cycle
    127
  - Running to a Label or Microword Address
    127
  - Running Indefinitely
    127
  - Stopping Execution
    128
  - Resetting the Simulation
    128
  - About Breakpoints
    129
Inline Function Breakpoints in Source and List Views
130
Multi-Microengine Breakpoint Dialog Box
137
Displaying Register Contents
137
Data Watch
138
- Data Watches in C Thread Windows
  139
- Entering a New Data Watch
  139
- Watching Control and Status Registers and Pins
  140
- Watching General Purpose and Transfer Registers
  141
- Deleting a Data Watch
  142
- Changing a Data Watch
  143
- Changing the Data Watch Radix
  143
- Depositing Data
  143
- Breaking on Data Changes
  143
Memory Watch
144
- Entering a New Memory Watch
  145
- Adding a Memory Watch
  146
- Deleting a Memory Watch
  146
- Changing a Memory Watch
  146
- Changing the Memory Watch Address Radix
  146
- Changing the Memory Watch Value Radix
  147
- Depositing Memory Data
  147
Execution Coverage
147
The Execution Coverage Window
148
- Changing Execution Count Ranges and Colors
  149
- Displaying and Hiding Instruction Addresses
  149
- Instruction Markers
  149
- Miscellaneous Controls
  150
- Scaling the Bar Graph
  150
- Resetting Execution Counts
  150
Performance Statistics
150
- Displaying Statistics
  151
Performance Statistics - Summary Tab
151
Save Packet Simulation Stats to a File
152
Performance Statistics - Microenginetab
153
- Resetting Statistics
  154
Performance Statistics - All Tab
154
Thread and Queue History
154
History Window
155
- Displaying the History Window
  156
- Displaying Queues in the History Window
  156
- Hardware Debugging Restrictions
  156
- Scaling the Display
  156
Queue Display Property Sheet
156
- Thread Display Property Page
  157
- Displaying Code Labels
  157
Display Threads Property Page
157
- Displaying Reference History
  158
- Queue History
  161
Customize History
161
Queue Status Window
162
- Queue Status History
  163
- Setting Queue Breakpoints
  163
- Changing Thread History Colors
  164
- Displaying the History Legend
  165
- Tracing Instruction Execution
  165
- History Collecting
  166
Queue Status
162
History Dialog Box
167
Thread Status
167
The Thread Status Window
168
- Packet Simulation Status
  169
Packet Simulation Status Debug Window
169
- Running in Batch Mode
  170
Save Packet Simulation Stats to a File
170
Performance Monitoring Unit
173
- Introduction
  173
- PMU Limitations
  173
- Sampling Modes
  173
  - Time Based Sampling
    174
    
    Point Sampling
    174
TBS Point Sampling
174
- Window Sampling
  175
- Random Based, or Statistical Sampling
  175
TBS Window Sampling
175
Random Based Sampling
175
- PMU Graphical User Interface (GUI)
  176
  - Canned Analysis Property Sheet
    177
Canned Analysis Property Page
177
- Sampling Method Property Pages
  178
  - Time Based Sampling (TBS)
    178
Canned Analysis Property Page Entries and Buttons
178
Time-Based Sampling Property Page
179
TBS Property Page Entries and Buttons
179
- Random Based Sampling (RBS)
  181
Random Based Sampling Property Page
181
RBS Property Page Entries and Buttons
181
- Sampling Macros Dialog
  183
Sampling Macros
183
- Monitor Sampling Macro
  184
Monitor Sampling Macro Dialog Box
184
- Threshold Sampling Macro
  185
Threshold Sampling Macro Dialog Box
185
- Sampling Considerations
  186
- Event Selection Dialog Box
  186
- Output Formats
  187
Event Selection Dialog Box
187
Assembler
189
- Assembly Process
  189
  - Command Line Arguments
    189
  - Assembler Steps
    191
Assembly Process
191
- Case Sensitivity
  192
- Assembler Optimizations
  192
- Processor Type and Revision
  192
Microengine C Compiler
193
- The Command Line
  193
- Supported Compilations
  193
- Supported Option Switches
  194
Supported Uccl CLI Option Switches
194
- Compiler Steps
  198
Compilation Steps
198
- Case Sensitivity
  199
Linker
201
- About the Linker
  201
  - Configuration and Data Accessed by the Linker
    201
  - Shared Address Update (Flow)
    201
- Microengine Image Linker (UCLD)
  202
  - Usage
    202
  - Command Line Options
    202
Linker Command Line Options
202
- Generating a Microengine Application
  203
- Syntax Definitions
  203
  - Image Name Definition
    203
  - Import Variable Definition
    203
  - Microengine Assignment
    204
  - Code Entry Point Definition
    204
- Examples
  204
- Uca Source File (*.Uc) Example
  204
- Uca Output File (*.List) Example
  205
- Map File Example
  205
Memory Segment Usage
206
Microcode Object File (UOF) Format
207
- File Header
  207
- File Chunk Header
  207
  - UOF Object Header
    207
  - UOF Object Chunk Header
    208
  - Uof_Strt
    208
  - Uof_Imem
    208
  - Memory Initialization Value Attributes
    209
  - Uof_Initregsym
    209
  - Uof_Mseg
    209
  - Uof_Gtid
    210
  - Uof_Imag
    210
  - Uof_Codepage
    211
  - Uof_Meregtab
    211
  - Uof_Mereg
    211
  - Uof_Neighreg
    212
  - Uof_Neighregtab
    212
  - Uof_Importexpr
    212
  - Uof_Impexprtabtab
    212
  - Uof_Xferreflecttab
    212
  - Uof_Ucvar
    212
  - Uof_Ucvartab
    212
  - Uof_Initregsymtab
    213
  - Uof_Uwordfixup
    213
  - Uof_Codearea
    213
Dbg_Objs
213
- Debug Objects Header
  213
- Debug Object Chunk Header
  214
- Dbg_Strt
  214
- Dbg_Regtab
  214
- Dbg_Lbltab
  214
- Dbg_Symtab
  215
- Dbg_Srctab
  215
- Dbg_Typtab
  215
- Dbg_Scopetab
  215
- Dbg_Image
  215
- Dbg_Label
  216
- Dbg_Source
  216
- Dbg_Symb
  216
- Dbg_Type
  217
- Dbg_Structdef
  217
- Dbg_Structfield
  217
- Dbg_Enumdef
  217
- Dbg_Enumvalue
  218
- Dbg_Scope
  218
- Dbg_Valueloc
  218
- Dbg_Variable
  218
- Dbg_Sloc
  219
  - Dbg_Tloc
    219
  - Dbg_Rloctab
    219
  - Dbg_Lmloc
    219
  - Dbg_Liverange
    219
  - Dbg_Range
    220
  - Dbg_Instoprnd
    220
Foreign Model Simulation Extensions
221
- Overview
  221
Example of Foreign Model Usage
221
- Integrating Foreign Models with the Transactor
  222
- Foreign Model Dynamic-Link Library (DLL)
  223
- Simulating Media Devices
  223
- Creating a Foreign Model DLL
  223
  - DLL Sample Code
    224
Transactor
229
- Overview
  229
- Invoking the Transactor
  230
- Transactor Commands
  231
Transactor Optional Switches
231
Transactor Command
231
- Define
  232
- Undef
  233
- Benchmark
  234
- Close
  234
- Connect
  234
- Deposit
  235
- Dir
  236
- Examine
  236
- Exit
  237
- Force
  237
- Foreign_Model
  238
- Go_Thread
  239
- Gop
  239
- Goto
  239
- Goto_Addr
  240
- Help
  240
- Init
  241
- Inst
  241
- Load_Ixc
  242
- Log
  242
- Logical
  242
- Path
  243
- Pwd
  243
- Remove
  243
- Root_Init
  244
- Set_Clock
  244
- Set_Default_Go_Clk
  244
- Set_Default_Goto_Filter
  244
- Set_Float_Threshold
  245
- Show_Clocks
  245
- Sim_Delete
  245
- Sim_Reset
  246
- Time
  246
- Trace
  246
- Type
  247
- Ubreak
  247
- Unforce
  248
- Version
  248
- Watch
  248
- C Interpreter
  249
  - C Macros Supported
    250
  - Supported Data Types
    250
- Simulation Switches
  251
- Predefined C Functions
  252
- Error Handling
  254
- Printing Statistics from the Transactor
  255
  - Perf_Stat_Set( )
    255
  - Perf_Stat_Print( )
    255
Simulator Apis
257
- Foreign Model API
  257
  - For_Mod_Initialize
    257
  - For_Mod_Pre_Sim
    257
  - For_Mod_Post_Sim
    257
  - For_Mod_Exit
    257
  - For_Mod_Reset
    258
  - For_Mod_Delete
    258
- Overview of XACT API Functions
  258
XACT API Functions
258
- State Name Reference Routines
  260
  - Xact_Find_Wildcard_State_Name
    260
  - Xact_Get_Handle
    261
  - Xact_Delete_Handle
    261
  - Xact_Get_State_Info
    261
  - Xact_Get_State_Value
    262
  - Xact_Get_State_Field
    262
  - Xact_Get_Array_State_Value
    262
  - Xact_Set_State_Value
    263
  - Xact_Set_State_Field
    263
  - Xact_Set_Array_State_Value
    263
  - Xact_Add_Sim_State
    263
  - XACT_HANDLE Xact_Alloc_User_Sim_State
    264
  - Xact_Start_Of_Cycle
    264
  - Xact_Full_Cycle_Simulated
    264
  - Xact_Clock_Cycle
    264
  - Xact_Clock_Cycle_With_Remainder
    265
  - Xact_Get_Top_Level_Inst
    265
- Callback Creation and Deletion Functions
  265
- Miscellaneous Functions
  268
  - Xact_Define_Automatic_Sim_Halt
    268
  - Xact_Output_To_Console
    268
  - Xact_Printf
    268
  - Xact_Printf_Error
    268
  - Xact_Register_Console_Function
    268
  - Xact_Register_Console_Function_W_Arrayed_Args
    269
  - Xact_Unregister_Console_Function
    269
  - Xact_Executecommandstr
    269
  - Xact_Init_Gui_Console
    270
  - Xact_Gui_Execute_Command
    270
  - Xact_Start_Console()
    270
  - Xact_Initialize()
    270
  - Xact_Stop_Execution_At_Clk
    270
  - Xact_Exit_Transactor
    271
  - Xact_Ctrl_C_Switch
    271
  - Xact_Stop_Execution
    271
  - Xact_Gui_Interface
    271
Transactor States
273
- About States
  273
  - A.1 about States
    273
  - State Definition Format
    273
- Memory Setup
  273
- A.2 Memory Setup
  273
- Hardware States
  274
  - Chip Reference
    274
  - Sram
    274
  - Scratchpad
    274
    
    A.3 Hardware States
    274
    
    A.3.1 Chip Reference
    274
    
    A.3.2 Sram
    274
    
    A.3.3 Scratchpad
    274
  - Dram
    275
  - Rbuf
    275
    
    A.3.4 Dram
    275
    
    A.3.5 Rbuf
    275
  - Tbuf
    276
  - Fifo
    276
    
    A.3.6 Tbuf
    276
    
    A.3.7 Fifo
    276
- Microengine Registers
  277
  - Local Memory
    277
  - GPR a Bank
    277
    
    A.4 Microengine Registers
    277
    
    A.4.1 Local Memory
    277
    
    A.4.2 GPR a Bank
    277
  - GPR B Bank
    278
  - Transfer Register S in
    278
    
    A.4.3 GPR B Bank
    278
    
    A.4.4 Transfer Register S in
    278
  - Transfer Register S out
    278
  - Transfer Register D in
    279
  - A.4.6 Transfer Register D in
    279
  - Transfer Register D out
    279
  - Next Neighbor Registers
    280
- Csrs
  280
- Intel Xscale ® Memory Map Access
  280
- A.5 Csrs
  280
- IXP2400 and IXP2800 Transactor States
  281
IXP2400 Transactor States for QDR and MSF Pins
281
IXP2800 Transactor States for QDR and MSF Pins
283
- Transactor States for PCI Pins
  285
IXP2400 Transactor States for PCI Pins
285
IXP2800 Transactor States for PCI Pins
287
Developer Workbench Shortcuts-Files
289
Developer Workbench Shortcuts
289
- Introduction
  289
- B.1 Introduction
  289
Developer Workbench Shortcuts-Projects
290
Developer Workbench Shortcuts-Edit
290
Developer Workbench Shortcuts-Bookmarks
291
Developer Workbench Shortcuts-Breakpoints
291
Developer Workbench Shortcuts-Builds
292
Developer Workbench Shortcuts-Debug
292
Developer Workbench Shortcuts-Run Control
292
Developer Workbench Shortcuts-View
293
C Intel Xscale® Core Memory Bus Functional Model
295
- Summary of Apis
  295
- Enums
  301
- Defines
  301
  - C.2 Enums
    301
  - C.3 Defines
    301
PCI Bus Functional Model
303
- Loading the BFM
  303
- Initializing the BFM
  303
- Creating a Device
  303
- D.3 Creating a Device
  303
- Calling Console Functions from Another Foreign Model
  304
- Setting a Callback Function
  304
- Header File Pciconfx.h
  304
SPI4 Bus Functional Model
311
- Overview
  311
- SPI4 BFM Help
  311
  - E.1 Overview
    311
  - E.2 SPI4 BFM Help
    311
- Console Functions
  312
  - Device/Port Configuration
    312
    
    E.3 Console Functions
    312
    
    E.3.1 Device/Port Configuration
    312
    
    E.3.1.1Spi4_Define_Device
    312
    
    E.3.1.2Spi4_Set_Device_X_Param/Spi4_Set_Port_X_Param
    313
    
    E.3.1.3Spi4_Create_Device
    314
    
    E.3.1.4Spi4_Connect_Device
    314
    
    E.3.1.5Spi4_Enable_X
    314
  - Simulation Control
    315
    
    E.3.2 Simulation Control
    315
    
    E.3.2.1Spi4_Set_X_Stop_Control
    315
    
    E.3.2.2Spi4_Set_Sim_Options
    315
  - Flow Control
    316
    
    Spi4_Set_Tx_Calendar
    316
    
    E.3.4 Statistical Information Access
    317
    
    E.3.4.2Spi4_Get_Rx_Buffer_Byte/ Spi4_Get_Tx_Buffer_Byte and Spi4_Get_Rx_Buffer_Int32/Spi4_Get_Tx_Buffer_Int32
    318
    
    E.4 C-Api
    319

Intel Categories

Motherboard Computer Hardware Server Server Board

Desktop

More Intel Manuals

Intel IXP2800 Manuals

Intel IXP2800 User Manual (320 pages)

Table of Contents

Related Products

Intel Categories