
- •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
Index
A
Analog Comparison 101
B
Bothedge. See Command Options clkcompare -bothedge.
Boundary. See Command Options hierarchy -boundary.
C
Clock Compare. See Commands clkcompare
Clock Definition. See Commands clkdef Colors 100
Command 58 command line 11 Command Options
clkcompare -bothedge 81 -bothedge1 81 -bothedge2 81 -hold 81, 82 -hold1 81 -hold2 81 -negedge 81 -negedge1 81
-negedge2 81 -posedge 81 -posedge1 81 -posedge2 81 -sample 80 -sample1 80 -sample2 80 -setup 80, 82, 84 -setup1 80 -setup2 80
compare -neg 63 -pos 63 -tol 62
general
-checkstrength |
62 |
||||
-clock1shift |
62 |
|
|||
-clock2shift |
62 |
|
|||
-clockshift |
62 |
|
|||
-end |
61 |
|
|
||
-ignorestrength |
62 |
||||
-maxerrors |
61 |
|
|||
-shift |
62 |
|
|
||
-shift1 |
|
62 |
|
|
|
-shift2 |
|
62 |
|
|
|
-start |
61 |
|
|
||
-totalerrors |
61 |
|
|||
-when |
|
72 |
|
|
|
hierarchy |
|
|
|
|
|
-allvars |
69 |
|
|
||
-boundary |
69 |
|
|||
-depth |
69 |
|
|
||
-internal |
69 |
|
|||
stability |
|
|
|
|
|
-setup |
|
84 |
|
|
|
Commands |
|
|
|
|
|
clkcompare |
78 |
|
|||
clkdef |
77 |
|
|
|
|
compare |
67 |
|
|
||
datafile1 |
65 |
|
|
||
datafile2 |
66 |
|
|
||
loaddata |
93 |
|
|
||
nosequencetime 85 |
|||||
report |
91 |
|
|
|
|
savedata |
92 |
|
|
||
sequencetime |
85 |
|
|||
stability |
84 |
|
|
||
statemapping |
86 |
|
|||
threshold |
|
89 |
|
|
|
translate |
94 |
|
|
||
Comments. See Rules File Comments |
|||||
Compare Options Form |
40 |
||||
Compare. See Commands compare |
|||||
Comparescan |
|
|
|
||
command line |
11 |
|
|||
exit codes |
16 |
|
|
||
options 11 |
|
|
|||
rules |
12 |
|
|
|
|
starting |
11 |
|
|
||
csd file |
14 |
|
|
|
|
December 2000 |
104 |
Product Version 1.9 |

Comparescan User Guide
D
Default Comparison Rules 56
E
End Time. See Command Options general - end.
error database. See Comparescan
database. |
|
|
||
Error Messages |
|
|
||
Hierarchy View |
21 |
|
||
Maximum. See Command Options |
||||
general -maxerrors. |
||||
Printing |
99 |
|
|
|
TimeView |
29 |
|
|
|
Total. See Command Options general - |
||||
totalerrors. |
|
|||
Escaped Names. See Verilog Escaped |
||||
Names |
|
|
|
|
Examples |
|
|
|
|
Clock Compare |
48 |
|
||
Clock Definitions |
48 |
|
||
compare |
|
47 |
|
|
Golden File 53 |
|
|
||
Hierarchical Variation |
51 |
|||
Line Continuation 53 |
|
|||
Shifting Events |
52 |
|
||
Stability Checks |
50 |
|
||
Start and End Times |
52, 53 |
|||
Test File |
|
53 |
|
|
Tolerance |
52 |
|
|
|
exit codes |
16 |
|
|
F
Filenames 53
G
Getting Started
Source Code Tutorial 18 golden variable 68
groups
Mismatches 25
H
Hierarchical Comparison. See Rules File Hierarchical
Hierarchy View. See Hierarchy View
Hold. See Command Options clkcompare - hold.
M
markers mismatches 34
mismatch markers 34 Mismatches group 25
Module Naming. See Rules File Variable and Module Naming
N
Negedge. See Command Options
clkcompare -negedge.
O
Open. See Commands loaddata Options 11, 40
setting 61 -options
-bothedge 81 -bothedge1 81 -bothedge2 81 -boundary 69 -checkstrength 62
-clock1shift 62 -clock2shift 62 -clockshift 62 -depth 69 -end 61
-hold 81 -hold1 81 -hold2 81
-ignorestrength 62 -internal 69 -maxerrors 61 -neg 63
-negedge 81 -negedge1 81
December 2000 |
105 |
Product Version 1.9 |

Comparescan User Guide
-negedge2 |
81 |
When Statements 75 |
||||
-pos |
63 |
|
rules file |
|
|
|
-posedge |
81 |
setting options |
61 |
|||
-posedge1 |
81 |
|
|
|
||
-posedge2 |
81 |
S |
|
|
||
-sample |
80 |
|
|
|||
-sample1 |
80 |
|
|
|
||
-sample2 |
80 |
Sample. See Command Options clkcompare |
||||
-setup |
80 |
|
-sample. |
|
||
-setup1 |
80 |
Save. See Commands savedata |
||||
-setup2 |
80 |
secondary variable |
68 |
|||
-shift |
62 |
|
Sequence Time. See Commands Sequence |
|||
-shift1 |
62 |
|
Time |
|
|
|
-shift2 |
62 |
|
Signalscan |
23 |
|
|
-start |
61 |
|
Specify Files to Compare 66 |
|||
-tol |
62 |
|
|
Specifying Files to Compare 65 |
||
-totalerrors |
61 |
Stability. See Commands Stability |
||||
-when |
72 |
|
Start Time. See Command Options general - |
|||
|
|
|
|
start. |
|
|
P |
|
|
|
state file 15 |
|
|
|
|
|
State Mapping. See Commands |
|||
|
|
|
|
statementmapping |
||
posedge. See Command Options |
Strength Comparison. See Command |
|||||
clkcompare -posedge. |
Options general -checkstrength. |
|||||
preferences file 15 |
Strengths. See Rules File Strengths and |
|||||
Preferences Window 38 |
Values |
|
||||
R |
|
|
|
T |
|
|
Report. See Commands Report |
test variable |
68 |
|
|||
Results Viewing Window |
Threshold. See Commands threshold. |
|||||
Button Bar |
44 |
Time Units |
63, 102 |
|||
Menu Bar |
38 |
Time View. See Error Messages Time View |
||||
rules 12 |
|
|
Timed Verilog Expressions |
Rules File |
|
|
|
|
Tolerance. See Command Options compare |
Command Format |
58 |
|
-tol. |
||
Commands. See Also Rule Files Primary |
Translate. See Commands translate |
||||
Commands |
58 |
|
|
||
Comments |
59 |
|
|
|
V |
Examples |
31 |
|
|
|
|
General Options |
61 |
|
|
|
|
Hierarchical Comparison |
68 |
Values. See Rules File Strengths and |
|||
Line Continuation |
59 |
|
Values |
||
Primary Commands. See Also |
Variable and Module Naming in Different |
||||
Commands |
59 |
|
Files 70 |
||
Strengths and Values |
63 |
|
Variable Naming. See Rules File Variable |
||
Time Units |
63 |
|
|
|
and Module Naming |
Timed Verilog Expressions |
76 |
VCD 98 |
|||
Variable and Module Naming 68 |
Verilog Escaped Names 70 |
||||
Verilog Expressions |
75 |
|
Verilog Expression. See Rules File Verilog |
December 2000 |
106 |
Product Version 1.9 |

Comparescan User Guide
Expressions
W
when construct 48
When Option. See Command Options general -when.
X
X resources 15, 100
December 2000 |
107 |
Product Version 1.9 |