1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
###############################################################################
# Copyright (c) 2020-2024 by Altair Engineering, Inc.
# All rights reserved.
#
# Altair Engineering, Inc. makes this software available as part of the Vision
# tool platform.  As long as you are a licensee of the Vision tool platform
# you may make copies of the software and modify it to be used within the
# Vision tool platform, but you must include all of this notice on any copy.
# Redistribution without written permission to any third party, with or
# without modification, is not permitted.
# Altair Engineering, Inc. does not warrant that this software is error free
# or fit for any purpose.  Altair Engineering, Inc. disclaims any liability for
# all claims, expenses, losses, damages and costs any user may incur as a
# result of using, copying or modifying the software.
# =============================================================================
#   @userware
#       Report Fan-In Cone
#   @section
#       Create Reports
#   @description
#       Example Tcl script that uses Zdb API commands to get fanIn cones
#       of a node to a DFF driver.
#       Usage:
#         starsh reportFanInCone.tcl design.zdb report.txt
#   @files
#       cust33/reportFanInCone.tcl
#   @tag
#       zdb batch report cone
###############################################################################


# =============================================================================
# Start - Report fanIn cone.
# =============================================================================
#
proc ReportFanInCone:Start {db report startOid} {
    ##
    # Open the report file.
    #
    set out [open $report "w"]

    ##
    # Get the top design.
    #
    set top [$db get_top_design]

    ##
    # Get start pins/ports.
    #
    set startList {}
    switch -- [$db oid type $startOid] {
        "net" {
            $db foreach pin $startOid pin {
                set dir [$db directionOf $pin]
                switch -- [$db oid type $pin] {
                    "pin" {
                        if {$dir == "out"} {
                            continue
                        }
                    }
                    "port" {
                        if {$dir == "in"} {
                            continue
                        }
                    }
                }
                lappend startList $pin
            }
        }
        "port" -
        "pin" -
        default {
            lappend startList $startOid
        }
    }

    ##
    # Print start oid to report file
    #
    puts $out "Start: [$db oid print $startOid]"

    ##
    # Loop over all start oids
    #
    foreach startOid $startList {
        ##
        # Get cone starting at start,
        # stopping at flagged FF driver.
        #
        set result [$db cone \
            -in \
            -paths \
            -targetFlaggedCell clock \
            $startOid]

        ##
        # Print results.
        #
        foreach path $result {
            ##
            # get depth and oidList for one result path
            #
            set depth [lindex $path 0]
            set oidList [lrange $path 1 end]

            ##
            # print depth and oids for one result path
            #
            puts $out "\t---------------$depth----------------"
            foreach oid $oidList {
                puts $out "\t[$db oid print $oid]"
            }
        }
    }

    ##
    # Close the report file.
    #
    close $out
}


##
# Check for 3 command line options
#
if {$argc != 3} {
    set    msg "Wrong #of args. Usage:\n"
    append msg "[info nameofexecutable] [info script] <BINFILE> <REPORTFILE>"
    append msg " <PINorPORTorNETOID>"
    error $msg
}

##
# The design is given as the first argument on the command line.
#
set binfile [lindex $argv 0]

##
# The report file is the second argument on the command line.
#
set report [lindex $argv 1]

##
# The start OID is the third argument on the command line.
#
set startOid [lindex $argv 2]

##
# Open the binfile.
#
set db [zdb open $binfile]

##
# Create fanIn cone report.
#
ReportFanInCone:Start $db $report $startOid

##
# Close the opened database.
#
$db close