- •Contents
- •Introducing Comparescan
- •Features
- •Applications
- •Organization of this Guide
- •Getting Started
- •Starting Comparescan
- •Specifying Input Files
- •Specifying Simulation Results Databases for Comparison
- •Specifying a Comparescan Rules File
- •Specifying a Comparescan Error Database for Viewing
- •Using Automatically Generated Files
- •Using the State File
- •Using the Preferences File
- •Using X Resources
- •Understanding Comparescan Exit Status Codes
- •Comparescan Tutorial
- •Accessing the Tutorial Source Files
- •Simulation Results Databases
- •Comparescan Rules Files
- •Generating a Comparescan Error Database
- •Viewing a Comparescan Error Database
- •Viewing Errors in Hierarchical Order
- •Viewing Errors in Signalscan Waves
- •Viewing Multiple Objects in Signalscan Waves
- •Viewing Errors in Time Order
- •Exiting Comparescan
- •Giving More Information in the Rules File
- •Reviewing the demo.rules Rules File
- •Using the demo.rules Rules File
- •Viewing Clocked Miscompares in Signalscan Waves
- •Comparescan Graphical User Interface
- •Comparescan Window
- •Menu Bar
- •File Menu
- •Tools Menu
- •View Menu
- •Window Menu
- •Button Bar
- •Application Examples
- •Making Absolute Comparisons
- •Specifying the Filename of an Object
- •Comparing Two Objects from the Same File
- •Comparing Two Objects on a Condition
- •Making Clocked Comparisons
- •Using One Clock and Two Simulation Files
- •Using One Clock and One Simulation File
- •Using Two Clocks and Two Simulation Files
- •Using Two Clocks and One Simulation File
- •Performing a Clock Compare with Timing Checks
- •Checking Stability
- •Specifying Objects in the Design Hierarchy
- •Command Option Examples
- •Specifying Start and End Times for Golden and Test Files
- •Specifying Start and End Times for Comparison
- •Specifying a Time Shift
- •Specifying compare Command Tolerance Windows
- •Special Syntax Examples
- •Commenting
- •Continuing Long Lines
- •Specifying Both a Golden and a Test File
- •Specifying Filenames Using UNIX Filename Syntax
- •Writing Comparescan Rules
- •Default Comparison Rules
- •Absolute and Clocked Comparisons
- •Rules File Parsing and Execution
- •Command Syntax and Options
- •General Command Syntax
- •Command Summary
- •General Command Options
- •datafile1
- •datafile2
- •compare
- •clkdef
- •clkcompare
- •stability
- •sequencetime
- •nosequencetime
- •statemapping
- •threshold
- •report
- •savedata
- •loaddata
- •translate
- •Frequently Asked Questions
- •Comparescan Input
- •Comparescan Output
- •How do I view a comparison report that I have generated?
- •Can I print a report of my errors?
- •Can I run the tool in batch mode?
- •Graphical User Interface (GUI)
- •How do I run the program without the user interface?
- •Why can’t Comparescan allocate colors?
- •How do I change the colors in the GUI?
- •Why can’t I read the text in the GUI?
- •Comparescan Features
- •How can I compare a digital simulation with an analog simulation?
- •How do I match an X value?
- •How do I compare only the top-level signals in my design?
- •How do I compare modules at different levels in the hierarchy?
- •What if I want a different tolerance window for every signal?
- •Comparescan Error Messages
- •What does “Out of Memory” mean?
- •What does “fork failed” mean?
- •Index
Comparescan User Guide
2
Getting Started
This chapter provides an overview of the Comparescan user interface and options.
This chapter discusses the following topics:
■“Starting Comparescan” on page 11
■“Specifying Input Files” on page 12
■“Using Automatically Generated Files” on page 14
■“Using X Resources” on page 15
■“Understanding Comparescan Exit Status Codes” on page 16
December 2000 |
10 |
Product Version 1.9 |
Comparescan User Guide
Getting Started
Starting Comparescan
To invoke Comparescan, enter the following syntax on the command line:
% comparescan [options] [input_filenames]
This syntax allows for a variety of combinations when invoking Comparescan:
■Run Comparescan and enter the simulation databases later:
comparescan [options]
■Specify the simulation database files on the command line:
comparescan [options] golden_simfile secondary_sim_file
■Specify the rules file on the command line:
comparescan [options] rules_file
■Specify the rules file and simulation database files on the command line:
comparescan [options] golden_simfile secondary_sim_file rules_file
■Specify a previously-saved Comparescan error database:
comparescan [options] CSD_file
The available comparescan command-line options are described in Table 2-1 on page 11. The input filenames are described later, in “Specifying Input Files” on page 12.
Table 2-1 Comparescan Command-Line Options
Option |
Description |
|
|
-batch |
Run Comparescan in batch mode. You must specify input files |
|
on the command line if you use the -batch option. |
-f[ile] filename |
Specify the name of a file that contains the comparescan |
|
command-line options that you want to use. |
-h[elp] |
Display a brief description of the comparescan command-line |
|
syntax and options. |
-hostid |
Display the host ID for this machine. |
-nobanner |
Do not display any text at startup. |
-nogbanner |
Do not display any graphics banner at startup. |
-p[ref] filename |
Specify a preferences filename and location, overriding the |
|
default of ~/.comparescan.pref. |
December 2000 |
11 |
Product Version 1.9 |