- •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
Application Examples
The following command specifies both the negative and positive tolerances as 10. The -tol option is a shortcut for specifying both the positive and negative tolerances.
datafile2 test.trn -tol 10
Special Syntax Examples
The examples in this section demonstrate Comparescan rule syntax. For more detail, see Chapter 6, “Writing Comparescan Rules.”
Commenting
Use a pound character (#) or two forward slashes (//) at the beginning of a comment.
# Comment to the end of the line. // Comment to the end of the line.
datafile1 golden.trn # Comment to the end of the line. datafile2 test.trn // Comment to the end of the line.
Continuing Long Lines
Use a backslash character (\) at the end of a line to continue that line on the next line.
compare top.module1.module2.module25.signalA \
top.module1.module4.module25.signalZ \
-neg 10 -pos 20
Note: The backslash must be the last character on a continued line.
Specifying Both a Golden and a Test File
The file that is specified as datafile1 is treated as the golden file, and the file that is specified as datafile2 is treated as the secondary file.
datafile1 file1.trn
datafile2 file2.trn
Specifying Filenames Using UNIX Filename Syntax
You can specify filenames in a rules file, on the comparescan command line, or on the
Compare Options form. The ../.. and ~ path specifiers are supported, as shown in the following examples:
December 2000 |
53 |
Product Version 1.9 |
Comparescan User Guide
Application Examples
datafile1 ../../file1.trn -start 200 -end 2000 datafile1 /tmp/file2.trn -start 200 -end 2000 datafile1 ~/sim/file2.trn -start 200 -end 2000 datafile1 ~bobh/../sim/file2.trn -start 200 -end 2000
Options Can Be Specified in Any Order
The following commands are equivalent:
datafile1 golden.trn -start 200 -end 2000
datafile1 golden.trn -end 2000 -start 200
December 2000 |
54 |
Product Version 1.9 |