
- •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
1
Introducing Comparescan
Comparescan is a sophisticated and comprehensive tool for performing waveform comparison functions. It can compare multiple hardware simulation runs or different areas of a single simulation run, compare single signals or complete simulations, and compare results that you obtain from the same or different simulators. Comparescan provides you with both a text description and a waveform view of any of the differences that it finds between simulations.
Comparescan is both flexible and programmable. It has a large number of applications, but it is still extremely easy to use.
This chapter contains the following topics:
■“Features” on page 8
■“Applications” on page 8
■“Organization of this Guide” on page 9
December 2000 |
7 |
Product Version 1.9 |

Comparescan User Guide
Introducing Comparescan
Features
Comparescan has the following functional features:
Compares SST2 or VCD files.
Creates error reports that you can use with Signalscan Waves.
Performs exact comparisons using a tolerance window.
Performs clocked comparisons.
Performs setup and hold checks.
Applications
You can use Comparescan in any of the following areas to help verify and analyze your simulation results:
Verification applications:
Compare simulations that you have performed at different levels (RTL versus gate or behavioral versus gate).
Compare simulations before and after design optimizations (for speed or area).
Compare simulations before and after you make technology changes (shrink or vendor).
Compare simulations that you have performed using different clock rates.
Compare different versions of your simulations for regression testing purposes.
Test vector applications:
Compare your best and worst case timing simulations.
Compare simulations before and after you perform backannotation.
Compare simulations before and after you perform a clock-tree insertion.
Multi-simulator applications:
Compare simulations that you have performed on different simulators.
(Comparescan understands event-ordering dependencies.)
Compare cycle-based and event-based simulations.
Compare simulations that you have performed on different types of simulators.
December 2000 |
8 |
Product Version 1.9 |

Comparescan User Guide
Introducing Comparescan
Organization of this Guide
The Comparescan User Guide is designed to help you to begin using Comparescan as quickly as possible.
Chapter 2, “Getting Started,” presents the comparescan command-line syntax and options.
Chapter 3, “Comparescan Tutorial,” guides you through a typical Comparescan session.
Chapter 4, “Comparescan Graphical User Interface,” describes each feature of the
Comparescan graphical user interface (GUI).
Chapter 5, “Application Examples,” describes how to use Comparescan to perform many different kinds of comparisons.
Chapter 6, “Writing Comparescan Rules,” explains how to write a rules file.
Appendix A, “Frequently Asked Questions,” provides the answers to some common questions about Comparescan.
December 2000 |
9 |
Product Version 1.9 |