Virtuoso AMS Environment User Guide
A
Variables for ams.env Files
The variables and values in ams.env files specify the basic behavior of the AMS netlister and
AMS Design Prep. This appendix describes the mechanism used to load ams.env files and what these variables do.
This appendix contains the following sections:
■How AMS Designer Determines the Set of Variables on page 360
■Why AMS Designer Uses ams.env Files, Not .cdsenv Files on page 360
■List of ams.env Variables on page 362
■Detailed Descriptions of ams.env Variables on page 366
April 2004 |
359 |
Product Version 5.3 |
Virtuoso AMS Environment User Guide
Variables for ams.env Files
How AMS Designer Determines the Set of Variables
The environment variables used by the AMS netlister and AMS Design Prep are stored in ams.env files. A file containing the default values is shipped with the software in theshare/ cdssetup/amsDirect directory. You can customize these default values by placing ams.env files with altered default values in any of the locations listed in thesetup.loc file shipped in the share/cdssetup directory of the Cadence installation hierarchy. Any ams.env files found in the locations listed in thesetup.loc file are progressively loaded, starting from the bottom of the list and working upward, with values for variables in subsequent files overwriting values for the same variables in previous files. This merging process produces the base set of values for ams.env variables. Note that any ams.env file found in the working directory (“.”), isnot included in establishing the base set.
After the base set is established, the ams.env file in the working directory is read. After the run directory is chosen, any ams.env file found there is read. The variables in the working directory and run directory ams.env files together constitute thelocal set of values.
Immediately after the ams.env files are read, the current set of values consists of the values from the base set of variables overlaid by the values from the local set of variables. If the GUI in an AMS Designer tool is then used to modify the current set of values, AMS Designer writes the changes into the local (working directory and run directory) ams.env files. When writing the changes, AMS Designer compares the current value of each variable with its corresponding value in the base set. If the current and base values are different, the variable is written to one of the local ams.env files. If the current value is the same as that found in the base set, the variable is not written.
Variables are written to the local ams.env files as follows:
Location of ams.env file |
Included variables |
working directory |
amsDirect, amsDirect.vhdl, amsDirect.vlog |
run directory |
amsDirect.prep, amsDirect.simcntl |
Why AMS Designer Uses ams.env Files, Not .cdsenv Files
AMS Designer uses the values of the variables found in ams.env files to control the behavior of the AMS Designer tools. Be aware that the similarly-named variables found in .cdsenv
files have no effect at all on AMS Designer. AMS Designer does not read the variables in
.cdsenv files because theams.env file mechanism provides the following advantages.
■The ams.env files are read every time an AMS Designer tool performs an operation, not just once as the .cdsenv files are read. The repeated reads ensure that each tool uses the current values, even if those values are changed by a different tool. This approach
April 2004 |
360 |
Product Version 5.3 |
Virtuoso AMS Environment User Guide
Variables for ams.env Files
ensures, for example, that if you change an AMS option from the CIW, the new value is used even if you then run AMS Designer from the hierarchy editor.
■Each time AMS Designer writes the ams.env variables, it splits them into two files: an ams.env file in the working directory and anams.env file in the run directory. This arrangement allows the variables used for netlisting and compiling to be in a location that is common to both AMS Design Prep and the AMS netlister (running from either the CIW or the hierarchy editor). This arrangement also allows the variables used for cds_globals module processing, elaboration, and simulation to be customized in each run directory.
April 2004 |
361 |
Product Version 5.3 |
Virtuoso AMS Environment User Guide
Variables for ams.env Files
List of ams.env Variables
The variables that you can use in ams.env are all included in the default ams.env file. In each entry of the ams.env file, the first column is the tool, the second column is the variable, the third column is the data type, and the fourth column contains the value to be used. For additional information about individual variables, see “Detailed Descriptions of ams.env Variables” on page 366.
The default ams.env file contains the following entries.
amsDirect |
amsCompMode |
boolean |
nil |
amsDirect |
amsDefinitionViews |
string |
"" |
amsDirect |
amsExcludeParams |
string |
"" |
amsDirect |
amsExpScalingFactor |
cyclic |
"no" |
amsDirect |
amsLSB_MSB |
boolean |
nil |
amsDirect |
amsMaxErrors |
int |
50 |
amsDirect |
amsScalarInstances |
boolean |
t |
amsDirect |
amsVerbose |
boolean |
nil |
amsDirect |
hdlVarFile |
string |
"" |
amsDirect |
includeInstCdfParams |
boolean |
nil |
amsDirect |
logFileName |
string |
"ams_direct.log" |
amsDirect |
modifyParamScope |
cyclic |
"no" |
amsDirect |
simRunDirLoc |
string |
"" |
amsDirect |
initFile |
string |
"" |
amsDirect.prep |
allowUndefParams |
boolean |
t |
amsDirect.prep |
analogControlFile |
string |
"" |
amsDirect.prep |
cdsGlobalsLib |
string |
"" |
amsDirect.prep |
cdsGlobalsView |
string |
"" |
amsDirect.prep |
compileExcludeLibs |
string |
"" |
amsDirect.prep |
compileMode |
cyclic |
"incremental" |
amsDirect.prep |
connectRulesCell |
string |
"mixedsignal" |
amsDirect.prep |
connectRulesCell2 |
string |
"ConnRules_5V_full" |
amsDirect.prep |
connectRulesLib |
string |
"" |
amsDirect.prep |
connectRulesView |
string |
"" |
amsDirect.prep |
detailedDisciplineRes |
boolean |
nil |
amsDirect.prep |
discipline |
string |
"logic" |
amsDirect.prep |
forceGlobalSync |
boolean |
nil |
amsDirect.prep |
language |
string |
"verilog" |
amsDirect.prep |
ncelabArguments |
string |
"" |
amsDirect.prep |
ncsimArguments |
string |
"" |
amsDirect.prep |
ncsimGUI |
boolean |
t |
amsDirect.prep |
ncsimTcl |
boolean |
nil |
amsDirect.prep |
netlistMode |
cyclic |
"incremental" |
amsDirect.prep |
runNcelab |
boolean |
t |
amsDirect.prep |
runNcsim |
boolean |
t |
amsDirect.prep |
simVisScriptFile |
string |
"" |
amsDirect.prep |
timescale |
string |
"1ns/1ns" |
amsDirect.prep |
use5xForVHDL |
boolean |
t |
amsDirect.prep |
useNcelabNowarn |
boolean |
t |
amsDirect.prep |
useNcelabSdfCmdFile |
boolean |
t |
amsDirect.prep |
useNcsimNowarn |
boolean |
t |
amsDirect.prep |
useSimVisScriptFile |
boolean |
t |
amsDirect.prep |
vlogGroundSigs |
string |
"gnd!" |
amsDirect.prep |
vlogSupply0Sigs |
string |
"" |
amsDirect.prep |
vlogSupply1Sigs |
string |
"" |
amsDirect.prep |
wfDefaultDatabase |
boolean |
nil |
amsDirect.prep |
wfDefInstCSaveLvl |
int |
1 |
April 2004 |
362 |
Product Version 5.3 |
Virtuoso AMS Environment User Guide
Variables for ams.env Files
amsDirect.prep |
wfDefInstSaveCurrents |
boolean |
nil |
amsDirect.prep |
wfDefInstSaveVoltages |
boolean |
t |
amsDirect.prep |
wfDefInstVSaveAll |
boolean |
nil |
amsDirect.prep |
wfDefInstVSaveLvl |
int |
1 |
amsDirect.prep |
wfDefInstVSaveObjects |
cyclic |
"All_data" |
amsDirect.prep |
ncelabAccess |
cyclic |
"Read" |
amsDirect.prep |
ncelabAfile |
string |
"" |
amsDirect.prep |
ncelabAnnoSimtime |
boolean |
nil |
amsDirect.prep |
ncelabCoverage |
boolean |
nil |
amsDirect.prep |
ncelabDelayMode |
cyclic |
"None" |
amsDirect.prep |
ncelabDelayType |
cyclic |
"None" |
amsDirect.prep |
ncelabDisableenht |
boolean |
nil |
amsDirect.prep |
ncelabEpulseFiltering |
cyclic |
"None" |
amsDirect.prep |
ncelabEpulseNeg |
boolean |
nil |
amsDirect.prep |
ncelabExpand |
boolean |
nil |
amsDirect.prep |
ncelabExtendtcheckdatalimit int |
0 |
|
amsDirect.prep |
ncelabExtendtcheckreferencelimit |
int 0 |
|
amsDirect.prep |
ncelabGenafile |
string |
"" |
amsDirect.prep |
ncelabIeee1634 |
boolean |
nil |
amsDirect.prep |
ncelabInterconnmultisrc |
boolean |
nil |
amsDirect.prep |
ncelabLibverbose |
boolean |
nil |
amsDirect.prep |
ncelabLoadpli1 |
string |
"" |
amsDirect.prep |
ncelabLoadvpi |
string |
"" |
amsDirect.prep |
ncelabLogFileAction |
cyclic |
"Overwrite log file" |
amsDirect.prep |
ncelabMaxErrors |
int |
50 |
amsDirect.prep |
ncelabMessages |
boolean |
nil |
amsDirect.prep |
ncelabMixEsc |
boolean |
nil |
amsDirect.prep |
ncelabModelFilePaths |
string |
"" |
amsDirect.prep |
ncelabNeverwarn |
boolean |
nil |
amsDirect.prep |
ncelabNoautosdf |
boolean |
nil |
amsDirect.prep |
ncelabNocopyright |
boolean |
nil |
amsDirect.prep |
ncelabNoipd |
boolean |
nil |
amsDirect.prep |
ncelabNonegtchk |
boolean |
nil |
amsDirect.prep |
ncelabNonotifier |
boolean |
nil |
amsDirect.prep |
ncelabNosource |
boolean |
nil |
amsDirect.prep |
ncelabNostdout |
boolean |
nil |
amsDirect.prep |
ncelabNoTchkMsg |
boolean |
nil |
amsDirect.prep |
ncelabNoTchkXgen |
boolean |
nil |
amsDirect.prep |
ncelabNotimingchecks |
boolean |
nil |
amsDirect.prep |
ncelabNovitalaccl |
boolean |
t |
amsDirect.prep |
ncelabNoVpdmsg |
boolean |
nil |
amsDirect.prep |
ncelabNoVpdXgen |
boolean |
nil |
amsDirect.prep |
ncelabNowarn |
string |
"" |
amsDirect.prep |
ncelabNtcWarn |
boolean |
nil |
amsDirect.prep |
ncelabOmichecklvl |
cyclic |
"Standard" |
amsDirect.prep |
ncelabPathpulse |
boolean |
nil |
amsDirect.prep |
ncelabPlinooptwarn |
boolean |
nil |
amsDirect.prep |
ncelabPlinowarn |
boolean |
nil |
amsDirect.prep |
ncelabPresrvResFn |
boolean |
nil |
amsDirect.prep |
ncelabPulseE |
int |
100 |
amsDirect.prep |
ncelabPulseIntE |
int |
100 |
amsDirect.prep |
ncelabPulseIntR |
int |
100 |
amsDirect.prep |
ncelabPulseR |
int |
100 |
amsDirect.prep |
ncelabRelax |
boolean |
nil |
amsDirect.prep |
ncelabSdfCmdFile |
string |
"" |
amsDirect.prep |
ncelabSdfNocheckCelltype boolean |
nil |
|
amsDirect.prep |
ncelabSdfNoHeader |
boolean |
nil |
amsDirect.prep |
ncelabSdfNoWarnings |
boolean |
nil |
amsDirect.prep |
ncelabSdfprecision |
string |
"" |
amsDirect.prep |
ncelabSdfverbose |
boolean |
nil |
amsDirect.prep |
ncelabSdfWorstcaseRounding boolean |
nil |
|
April 2004 |
363 |
Product Version 5.3 |
Virtuoso AMS Environment User Guide
Variables for ams.env Files
amsDirect.prep |
ncelabStatus |
boolean |
t |
|
|
amsDirect.prep |
ncelabTopLvlGeneric |
string |
"" |
|
|
amsDirect.prep |
ncelabUpdate |
boolean |
t |
|
|
amsDirect.prep |
ncelabUseAddArgs |
boolean |
nil |
|
|
amsDirect.prep |
ncelabUseAfile |
boolean |
nil |
|
|
amsDirect.prep |
ncelabUseExtendtcheckdatalimit |
|
boolean |
nil |
|
amsDirect.prep |
ncelabUseExtendtcheckreferencelimit |
boolean |
nil |
||
amsDirect.prep |
ncelabUseGenafile |
boolean |
nil |
|
|
amsDirect.prep |
ncelabUseGeneric |
boolean |
nil |
|
|
amsDirect.prep |
ncelabUsePulseE |
boolean |
nil |
|
|
amsDirect.prep |
ncelabUsePulseIntE |
boolean |
nil |
|
|
amsDirect.prep |
ncelabUsePulseIntR |
boolean |
nil |
|
|
amsDirect.prep |
ncelabUsePulseR |
boolean |
nil |
|
|
amsDirect.prep |
ncelabUseSdfprecision |
boolean |
nil |
|
|
amsDirect.prep |
ncelabV93 |
boolean |
nil |
|
|
amsDirect.prep |
ncelabVipdelay |
cyclic |
"Typical" |
|
|
amsDirect.prep |
ncsimEpulseNoMsg |
boolean |
nil |
|
|
amsDirect.prep |
ncsimExtassertmsg |
boolean |
nil |
|
|
amsDirect.prep |
ncsimLoadvpi |
string |
"" |
|
|
amsDirect.prep |
ncsimLogFileAction |
cyclic |
"Overwrite log file" |
||
amsDirect.prep |
ncsimMaxErrors |
int |
50 |
|
|
amsDirect.prep |
ncsimMessages |
boolean |
nil |
|
|
amsDirect.prep |
ncsimNeverwarn |
boolean |
nil |
|
|
amsDirect.prep |
ncsimNocifcheck |
boolean |
nil |
|
|
amsDirect.prep |
ncsimNosource |
boolean |
nil |
|
|
amsDirect.prep |
ncsimNostdout |
boolean |
nil |
|
|
amsDirect.prep |
ncsimNowarn |
string |
"" |
|
|
amsDirect.prep |
ncsimOmichecklvl |
cyclic |
"None" |
|
|
amsDirect.prep |
ncsimPlinooptwarn |
boolean |
nil |
|
|
amsDirect.prep |
ncsimPlinowarn |
boolean |
nil |
|
|
amsDirect.prep |
ncsimProfile |
boolean |
nil |
|
|
amsDirect.prep |
ncsimProfthread |
boolean |
nil |
|
|
amsDirect.prep |
ncsimRedmem |
boolean |
nil |
|
|
amsDirect.prep |
ncsimStatus |
boolean |
nil |
|
|
amsDirect.prep |
ncsimUnbuffered |
boolean |
nil |
|
|
amsDirect.prep |
ncsimUpdate |
boolean |
t |
|
|
amsDirect.prep |
ncsimUseAddArgs |
boolean |
nil |
|
|
amsDirect.simcntl |
scaddlglblopts |
string |
"" |
|
|
amsDirect.simcntl |
scaddltranopts |
string |
"" |
|
|
amsDirect.simcntl |
scannotate |
cyclic |
"sweep" |
|
|
amsDirect.simcntl |
scapprox |
boolean |
nil |
|
|
amsDirect.simcntl |
scaudit |
cyclic |
"detailed" |
|
|
amsDirect.simcntl |
sccheckstmt |
cyclic |
"all" |
|
|
amsDirect.simcntl |
sccmin |
string |
"0.0" |
|
|
amsDirect.simcntl |
sccompatible |
cyclic |
"spectre" |
|
|
amsDirect.simcntl |
scdebug |
boolean |
nil |
|
|
amsDirect.simcntl |
scdiagnose |
boolean |
nil |
|
|
amsDirect.simcntl |
scdigits |
int |
5 |
|
|
amsDirect.simcntl |
scerror |
boolean |
t |
|
|
amsDirect.simcntl |
scerrpreset |
cyclic |
"moderate" |
|
|
amsDirect.simcntl |
scfastbreak |
boolean |
nil |
|
|
amsDirect.simcntl |
scgmin |
string |
"1e-12" |
|
|
amsDirect.simcntl |
scgmincheck |
cyclic |
"max_v_only" |
|
|
amsDirect.simcntl |
schomotopy |
cyclic |
"all" |
|
|
amsDirect.simcntl |
sciabstol |
string |
"1e-12" |
|
|
amsDirect.simcntl |
scic |
cyclic |
"all" |
|
|
amsDirect.simcntl |
scicstmt |
string |
"" |
|
|
amsDirect.simcntl |
scignshorts |
boolean |
nil |
|
|
amsDirect.simcntl |
scinfo |
boolean |
t |
|
|
amsDirect.simcntl |
scinventory |
cyclic |
"detailed" |
|
|
amsDirect.simcntl |
sclimit |
cyclic |
"dev" |
|
|
April 2004 |
364 |
Product Version 5.3 |
Virtuoso AMS Environment User Guide
Variables for ams.env Files
amsDirect.simcntl |
sclteratio |
string |
"" |
amsDirect.simcntl |
scmacromod |
boolean |
nil |
amsDirect.simcntl |
scmaxiters |
int |
5 |
amsDirect.simcntl |
scmaxnotes |
int |
5 |
amsDirect.simcntl |
scmaxrsd |
string |
"" |
amsDirect.simcntl |
scmaxstep |
string |
"" |
amsDirect.simcntl |
scmaxwarn |
int |
5 |
amsDirect.simcntl |
scmethod |
cyclic |
"<Default value>" |
amsDirect.simcntl |
scnarrate |
boolean |
t |
amsDirect.simcntl |
scnotation |
cyclic |
"eng" |
amsDirect.simcntl |
scnote |
boolean |
t |
amsDirect.simcntl |
scopptcheck |
boolean |
t |
amsDirect.simcntl |
scpivabs |
string |
"0.0" |
amsDirect.simcntl |
scpivotdc |
boolean |
nil |
amsDirect.simcntl |
scpivrel |
string |
"1e-3" |
amsDirect.simcntl |
scquantities |
cyclic |
"no" |
amsDirect.simcntl |
screadic |
string |
"" |
amsDirect.simcntl |
screadns |
string |
"" |
amsDirect.simcntl |
screlref |
cyclic |
"<Default value>" |
amsDirect.simcntl |
screltol |
string |
"" |
amsDirect.simcntl |
scrforce |
string |
"1.0" |
amsDirect.simcntl |
scscale |
int |
1 |
amsDirect.simcntl |
scscalem |
int |
1 |
amsDirect.simcntl |
scalem |
string |
"1.0" |
amsDirect.simcntl |
scale |
string |
"1.0" |
amsDirect.simcntl |
scmodelevaltype |
cyclic |
"s" |
amsDirect.simcntl |
scmosvres |
string |
"0.50" |
amsDirect.simcntl |
scscfincfile |
string |
"" |
amsDirect.simcntl |
scscftimestamp |
string |
"" |
amsDirect.simcntl |
scscfusefileflag |
boolean |
nil |
amsDirect.simcntl |
scskipcount |
int |
0 |
amsDirect.simcntl |
scskipdc |
cyclic |
"no" |
amsDirect.simcntl |
scskipstart |
string |
"0.0" |
amsDirect.simcntl |
scskipstop |
string |
"0.0" |
amsDirect.simcntl |
scspeed |
int |
0 |
amsDirect.simcntl |
scspscflag |
boolean |
nil |
amsDirect.simcntl |
scstats |
boolean |
nil |
amsDirect.simcntl |
scstep |
string |
"" |
amsDirect.simcntl |
scstop |
string |
"0.0" |
amsDirect.simcntl |
scstrobedelay |
string |
"0.0" |
amsDirect.simcntl |
scstrobeperiod |
string |
"0.0" |
amsDirect.simcntl |
sctemp |
string |
"27.0" |
amsDirect.simcntl |
sctempeffects |
cyclic |
"all" |
amsDirect.simcntl |
sctitle |
string |
"" |
amsDirect.simcntl |
sctnom |
string |
"27.0" |
amsDirect.simcntl |
sctopcheck |
cyclic |
"full" |
amsDirect.simcntl |
sctransave |
cyclic |
"allpub" |
amsDirect.simcntl |
scusemodeleval |
boolean |
nil |
amsDirect.simcntl |
scvabstol |
string |
"1e-6" |
amsDirect.simcntl |
scwarn |
boolean |
t |
amsDirect.simcntl |
scwrite |
string |
"" |
amsDirect.simcntl |
scwritefinal |
string |
"" |
amsDirect.simcntl |
useScaddlglblopts |
boolean |
t |
amsDirect.simcntl |
useScaddltranopts |
boolean |
t |
amsDirect.simcntl |
useScic |
boolean |
t |
amsDirect.simcntl |
useScreadic |
boolean |
t |
amsDirect.simcntl |
useScreadns |
boolean |
t |
amsDirect.simcntl |
useScscfincfile |
boolean |
t |
amsDirect.simcntl |
useScwrite |
boolean |
t |
April 2004 |
365 |
Product Version 5.3 |