DAI Comparescan User's Guide
Table of Contents

License Agreement

Introducing DAI Comparescan

Overview of DAI Comparescan Components
Features
Intended Audience for this Guide
Applications
Verification applications:
Test Vector Applications:
Multi Simulator Applications:
Organization of this Guide
Platforms Supported
Simulators Supported
Conventions
Style Conventions
Rules File Language Syntax
Online Documentation
Contacting Design Acceleration, Inc.
Newsletter Subscriptions
Product Updates

Licensing and Installation

Overview
What You Need
Installing the Product
Installing the License
License Manager Commands
Installing The PLI Routines

Getting Started

Getting Started
Starting DAI Comparescan
Rules and SST files on the command line
DAI Comparescan Exit Codes
Examining previously saved DAI Comparescan output
The State File
The Preferences File
X RESOURCES: X11, .Xdefaults and AppDefaults

The DAI Comparescan Tutorial

Using DAI Comparescan
Starting DAI Comparescan
Specifying the files for comparison
Running the comparison
Interpreting the messages and errors
View the errors and messages in Hierarchy View
View the error and messages in Time View
Viewing the errors with DAI Signalscan
Viewing other errors with DAI Signalscan
Using a rules file for comparison
Using new rules file and simulation files for comparison
Exiting DAI Comparescan
Summary

User Interface Description

User Interface
The Results Viewing Window
The Compare Options Window
The Preferences Window
The Menu Bar
The Button Bar

Application Examples

Simple Examples
Absolute Compare Examples
Comparing a signal from two different files
Comparing two signals from the same file
Clock Compare Examples
Using one clock to compare two signals from different files
Using one clock to compare two signals from the same file
Using two clocks to compare two signals from different files
Using two clocks to compare two signals from the same file
Stability Check Examples
Checking setup only
Checking hold only
Checking setup and hold
Hierarchical Variations
Comparing signals at different levels in the hierarchy
Comparing modules at different levels in the hierarchy
Comparing all internal signals at the top level only
Comparing all internal signals down three levels
Comparing all module ports at the top level only
Comparing all module ports at the top two levels
Design Examples
More Examples
Comment Styles
Continuing long lines.
Specifying both a golden and a test file
Specifying a shift for the unnamed golden file.
Specifying start and end times for golden and test files.
Specifying file names using UNIX filename syntax.
Specifying files for compare.
Options can be specified in any order.
Specfiying start and end times for comparison.
Shifting events.
Skipping ranges of time. (NOT YET IMPLEMENTED)
Specifying compare command tolerance windows.
Simple compare commands.
More complex compare commands.
Using when constructs.
Clock definitions.
Specifying files for clock compare.
A clock compare.
Stability checks.

Frequently Asked Questions

DAI Comparescan Input
Can I compare VCD files?
Can I translate a VCD file to an SST file?
Can I compare a VCD file with some other format (like QSIM)?
Is it better to use SST files in DAI Comparescan?
DAI Comparescan Output
How do I view a comparison report generated earlier?
Can I print a report of my errors?
Can I run the tool in batch mode?
User Interface
How do I run the program without the GUI?
Why can't DAI Comparescan allocate colors?
How do I change the colors in the GUI?
I can't read the text in the GUI.
I just changed my ~/.Xdefaults file and nothing happened.
DAI Comparescan Features
How can I compare a digital simulation with an anolog simulation?
How do I match an X?
How do I compare only the top level signals in my design?
Comparing modules at different levels in the hierarchy.
I want a different "tolerance" window for every signal.
I specified time in the rules file. What are the default units?
DAI Comparescan Error Messages
What does "Out of Memory" mean?
How does DAI Comparescan allocate virtual memory?
What does "fork failed" mean?
How do I find out how big my processes are?
How do I find out how much memory my machine has?

Rules File Specifications and Syntax

The DAI Comparescan Rules File
General Command Format
Primary Commands in a Rules File
General Options
Rule File Conventions
Comments
Parsing and Execution
Continuing Long Lines
When Statements - Verilog Expressions
Timed Verilog Expressions
Specifying files to compare
Variable and Module Naming
Hierarchical Comparison
Verilog Escaped Names
Variable and Module Naming in Different Files
Default Comparison Rules
How the program gets option values
Time Units
Strengths and Values
Commands in the Rule File
datafile1 command
datafile2 command
compare command
compare example
Comparing signals by signal names.
Comparing signals by module names.
compare Options
clkdef command
clkcompare command
clkcompare example1
clkcompare example2
clkcompare and stability Options
stability command
sequencetime command
nosequencetime command
statemapping command
threshold command
report command
savedata
loaddata
translate command
Note: The translate command is not normally needed.
Translating big files
Translating files without using the translate command
Syntax Definition

Interfacing DAI Comparescan to Your Verilog Simulator

Overview
About DAI Signalscan Turbo (SST) Files
Producing SST Files from Your Simulator
Linking DAI Signalscan PLI Routines with Verilog-XL (2.0 or later)
Linking DAI Signalscan PLI Routines with Chronologic VCS
Linking DAI Signalscan PLI Routines with FrontLine PureSpeed
Linking DAI Signalscan PLI Routines with Fintronic FinSim
Signalscan PLI System Task Examples
Simple Example
Wrap Size Example
Specific Scopes Example
Limiting Depth of Recording Example
Recording Fan-in Example
Design Acceleration PLI System Tasks
$recordfile
$recordvars
$recordon and $recordoff
$recordfilecopy
$recordfilechange
$recordclose
$recordabort
$signalscan
$signalscankill
$signalscanabort

The Elan License Manager

Elan License Manager Manual Pages
da_enterkey
da_startdaemon
da_elmadmin
da_elmalert
da_elmd
da_elmrpt
da_elmusage
da_elmver
da_elm_resource

DAI Comparescan User's Guide - Generated 26 FEB 1997
�Copyright 1997 Design Acceleration, Inc. All rights reserved