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
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360 | ###############################################################################
# Copyright (c) 2021-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
# Automatically Map Symbols and Run Skill Export
# @section
# Miscellaneous Userware Examples
# @description
# Open a design database, automatically map all symbols for all database
# cells matching by name, render the schematic for each module and export
# the schematic as a Skill file.
# @files
# cust22/exportSkill.tcl
# @tag
# zdb skill
###############################################################################
##
# Define and initialize all possible command line options.
#
set ExportSkill(commandLineOptions) {}
foreach {
name required defaultValue
} {
"-binfile" true ""
"-symlibDir" true ""
"-skillFile" false ""
"-skillLibrary" false "sv_lib"
"-o" false ""
} {
lappend ExportSkill(commandLineOptions) $name $required $defaultValue
set ExportSkill($name) $defaultValue
}
# =============================================================================
# CreateSymbolDatabase -
# =============================================================================
#
proc ExportSkill:CreateSymbolDatabase {symlibDir} {
global ExportSkill
zmessage print LOG "Create the Symbol Database."
set ExportSkill(symbolDatabaseList) {}
foreach symlib [glob -directory $symlibDir "*.sym"] {
zmessage print LOG "Process symbol library '$symlib'."
set db [zdb new]
$db symlib add $symlib
$db symlib copy
lappend ExportSkill(symbolDatabaseList) $db
set library [lindex [$db symlib info] 1]
set ExportSkill(symbolDatabase:$db:fname) $symlib
set ExportSkill(symbolDatabase:$db:library) $library
zmessage print LOG "Added [$db count cell] symbols from 'library' lib."
}
}
# =============================================================================
# OpenDesignDatabase -
# =============================================================================
#
proc ExportSkill:OpenDesignDatabase {binfile} {
global ExportSkill
zmessage print LOG "Open the Design Database"
set ExportSkill(designDatabase) [zdb open $binfile]
}
# =============================================================================
# MapSymbols -
# =============================================================================
#
proc ExportSkill:MapSymbols {} {
global ExportSkill
zmessage print LOG "Map Symbols"
set db $ExportSkill(designDatabase)
$db foreach cell cell {
set name [$db oid oname $cell]
zmessage print LOG "Process database cell '$name'."
foreach symDB $ExportSkill(symbolDatabaseList) {
set symbol [$symDB search cell $name]
if {[$symDB oid isnull $symbol]} {
continue
}
set symFile $ExportSkill(symbolDatabase:$symDB:fname)
set library $ExportSkill(symbolDatabase:$symDB:library)
zmessage print LOG "Found symbol in library '$library' ($symFile)"
if {[$db isModule $cell]} {
$db flag $cell set leafcell
}
##
# Prepare the cell for running Skill export.
#
$db attr $cell set @symbol=[$symDB attr $symbol getValue @symbol]
$db attr $cell set @libName=$library
$db attr $cell set @cellName=$name
break
}
}
$db setPrimitive -clear -flag -operator -libcell -celldefine -symbol
}
# =============================================================================
# SaveBinfile -
# =============================================================================
#
proc ExportSkill:SaveBinfile {binfile} {
global ExportSkill
if {$binfile eq ""} {
return
}
zmessage print LOG "Save the updated binfile"
$ExportSkill(designDatabase) save $binfile
}
# -----------------------------------------------------------------------------
# _listOfUsedModules - Create a list of all used modules (e.g. by skipping
# modules inside a module flagged as a leaf cell or with a
# symbol assigned).
# -----------------------------------------------------------------------------
#
proc ExportSkill:_listOfUsedModules {db parentModule} {
global ExportSkill
if {[info exists ExportSkill(moduleTable:$parentModule)]} {
return
}
set ExportSkill(moduleTable:$parentModule) 1
lappend ExportSkill(usedModulesList) $parentModule
$db foreach inst $parentModule inst {
if {[$db isModule $inst]} {
set module [$db oid createModBased [$db moduleOf $inst]]
ExportSkill:_listOfUsedModules $db $module
}
}
}
# =============================================================================
# ExportSkill -
# =============================================================================
#
proc ExportSkill:ExportSkill {skillFile skillLibrary} {
global ExportSkill
if {$skillFile eq ""} {
return
}
zmessage print LOG "Run Skill export for all used modules."
set db $ExportSkill(designDatabase)
##
# Create a list of all used modules (e.g. by skipping modules inside a
# module flagged as a leaf cell or with a symbol assigned).
#
set ExportSkill(usedModulesList) {}
$db foreach top top {
ExportSkill:_listOfUsedModules $db $top
}
set logMsg "[llength ExportSkill(usedModulesList)]/[$db count module] "
append logMsg "modules used."
zmessage print LOG $logMsg
array unset ExportSkill "moduleTable:*"
##
#
#
set cmd [list skillexport start]
lappend cmd -spiceunits
lappend cmd -norangelabel
lappend cmd -scale [expr {1.0 / (16 * 10)}]
lappend cmd -libname $skillLibrary
lappend cmd $skillFile
{*}$cmd
##
# Create a new headless schematic object optimized for skillexport.
#
set schem [$db schematic -skillexport]
##
# Set configuration properties.
#
foreach {
name value
} {
ongrid 1
sheetwidth 0
sheetheight 0
geitarget 3
analoglayout 0
} {
zmessage print LOG "Configure schematic property $name = $value"
$schem property $name $value
}
##
# Loop over all used database modules and render the schematic.
#
foreach module $ExportSkill(usedModulesList) {
##
# Get the name of the module.
#
set moduleName [$db oid oname $module]
zmessage print LOG "Process module '$moduleName'."
##
# Generate the schematic of the module.
#
$schem loadmodule $moduleName
##
# Begin the graphic export.
#
set gei [$schem gex begin]
##
# Create the skillexport command.
#
set cmd [list skillexport module $moduleName $gei]
##
# The oper collectModuleParam is used to produce correct pPar() calls.
#
$db oper collectModuleParam
set param [$db attr $module getValue @param]
foreach p [split $param ","] {
lappend cmd -param $p
}
##
# Run the skillexport command.
#
zmessage print LOG "Run Skill export: '$cmd'."
eval $cmd
##
# End the graphic export.
#
$schem gex end
}
##
# Free the created schematic object.
#
$schem free
skillexport end
}
# =============================================================================
# ProcessOptions -
# =============================================================================
#
proc ExportSkill:ProcessOptions {argc argv} {
global ExportSkill
zmessage print LOG "Process $argc command line options: $argv"
##
# Process all given command line options.
#
for {set i 0} {$i < $argc} {incr i} {
set arg [lindex $argv $i]
if {$arg ni $ExportSkill(commandLineOptions)} {
error "Unknown option '$arg'."
}
if {[incr i] >= $argc} {
error "Missing value for option '$arg'."
}
set ExportSkill($arg) [lindex $argv $i]
}
##
# Check that all required options are given.
#
foreach {name required defaultValue} $ExportSkill(commandLineOptions) {
if {$required && ($ExportSkill($name) eq $defaultValue)} {
error "The option '$name' is required."
}
}
}
# =============================================================================
# Cleanup -
# =============================================================================
#
proc ExportSkill:Cleanup {} {
global ExportSkill
##
# Close all symbol databases.
#
foreach db $ExportSkill(symbolDatabaseList) {
$db close
}
##
# Close the design database.
#
$ExportSkill(designDatabase) close
}
##
# Start the actual Skill export flow.
#
ExportSkill:ProcessOptions $argc $argv
ExportSkill:OpenDesignDatabase $ExportSkill(-binfile)
ExportSkill:CreateSymbolDatabase $ExportSkill(-symlibDir)
ExportSkill:MapSymbols
ExportSkill:SaveBinfile $ExportSkill(-o)
ExportSkill:ExportSkill $ExportSkill(-skillFile) $ExportSkill(-skillLibrary)
ExportSkill:Cleanup
|