Stats

Locked Locked
Replies 2
Subscribers 125
Views 11433
Members are here 0

This discussion has been locked.

You can no longer post new replies to this discussion. If you have a question you can start a new discussion

psf utility

Hello

I am trying to understand the use model of the psf command line.

I can extract data from the psf database and export them text files, but can't really understand how to interpret the output format.

Does anybody have ressources/documentation on this tool ?

Any help is appreciated.

Thank you in advance

Cedric.

Andrew Beckett over 3 years ago

Cedric,

I'm not sure the "psfascii" format is published; the "psf" tool is mostly there for debug purposes and its use and output is not documented (as far as I know; I don't think it's been added while I wasn't looking).

Andrew
Cancel
Vote Up 0 Vote Down

Cancel

ShawnLogan over 3 years ago in reply to Andrew Beckett

Dear Cedric,

Driss said:
I am trying to understand the use model of the psf command line.

I can extract data from the psf database and export them text files, but can't really understand how to interpret the output format.

Does anybody have ressources/documentation on this tool ?

You might consider a few things:

1. There is a Forum post discussing the use of the command a number of years ago at URL:

https://community.cadence.com/cadence_technology_forums/f/custom-ic-design/31155/no-waveform-data-when-using-psf-command

2. Secondly, the psf utility (as noted in [1]) will only work with the psf formatted data bases - not, for example, psfxl. Hence, you will need to force the output format to "psf".

3. The help menu for psf is still available with the UNIX command "psf -h" when invoked from your Cadence session.

4. More modern means of creating an ASCII waveform exist through the srrutil utility and the use of the SKILL proceedure

"rdbWriteToFormat" SKILL function described at URL:

https://support.cadence.com/apex/ArticleAttachmentPortal?id=a1Od0000000nWAEEA2&pageName=ArticleContent

The srrutil utility is located in your Cadence directory at:

$CDSHOME/tools.lnx86/dfII/bin/64bit/srrutil

and its help menu is invoked by srrutil -h. A copy of the resultant command to access the help function and the help contents are shown for my installation in the text file below.

Hope this helps Cedric!

Shawn

Fullscreen srrutil_help.txt Download

$  /tools/virtuoso/20.1.ISR23.EHF020722/Linux/tools.lnx86/dfII/bin/64bit/srrutil -h

usage: srrutil [options...]

COMMANDS

	# Prints version
	srrutil -v

	# Prints this help
	srrutil -h

	#######################################################################
	#Prints information about data base using SRR driver
	srrutil -info -dbase <psfDir> -print-signal -print-value [-max-nb-signal <nb>] [-dataset <dataset>] [-print-wfibute] -read-only -read-hier [-no-print-datset-info]

	#Prints type/version of dataset in the current psf directory
	srrutil -dataset-type -dbase <datadir> [-dataset <dataset>]

	# Exports transient signals into individual dataset (in psfxl)
	srrutil -export -dbase <psfDir> -dataset <dataset> -signal <signalName> [-raw outdir] [-o outfname]  [-format vcsv json canvasjs] [-range min max] [-V]
	     Extra Options(psfxl only): -monotonic -x-duplicate

	#Prints hierarchical tree (uses the low level srr hier tree)
	srrutil -print-hier-tree -dbase <psfDir>  -dataset <dataset>

	#Prints hierarchical tree (uses the srrDb tree (viva call))
	srrutil -print-db-tree  -dbase <psfDir> [-o outfile] 

	#Prints dataset name list for a given database
	srrutil -print-dataset-name -dbase <psfDir>

	#Prints signal name list of a given data base (dataset is optional)
	srrutil -print-signal-name -dbase <psfDir> [ -dataset <dataset> ] [-signal-type <typeName>] [-add-schematic-name]

	#Prints signal list, grouped by type
	srrutil -print-signal-type -dbase <psfDir> [ -dataset <dataset> ] [-print-signal]

	#Prints signal type list (name, dataType, and number of instances
	srrutil -print-signal-type-list -dbase <psfDir> [ -dataset <dataset> ]

	#Prints dataset attributes
	srrutil -print-dataset-attribute  -dbase <psfDir> [ -dataset <dataset> ]

	#Prints datasets with contains a given  attribute
	srrutil -print-dataset-attribute-value -name <attrName>  -dbase <psfDir> [ -dataset <dataset> ]

	#Prints database attribute value (based on logFiles)
	srrutil -print-database-attribute-value -dbase <dbase>  -key <attributeName>

	Prints analysis information of a given database
	srrutil -print-analysis-info -dbase <psfDir> 

	#Search signals on a given database
	srrutil -search -dbase <psfDir>  [-dataset <dataset>] -mask <search mask>

	#Search signals on a given database
	srrutil -search -dbase <psfDir>  [-dataset <dataset>] -mask-file <file containing masks (1 perline)>

	#Compute statistics on signal namespace
	srrutil -signal-stat -dbase <psfDir>  -dataset <dataset>

	Compute statistics on signal waveforms
	srrutil -signal-wf-stat -dbase <psfDir> -dataset< dataset>

	#Prints statistics on dataset
	srrutil -print-stats -dbase <psfDir>

	#Prints the current list of readers
	srrutil -print-result-type-list

	#Prints parametric (sweep) information on a given signal.
	srrutil -print-param-properties -db <psfDir> -ds <dataset> -signal <signalName>

	#Gets dataset information
	srrutil -get-format-type -db <psfDir> -ds <datasetName>
	srrutil -get-analysis-type -db <psfDir> -ds <datasetName>

	#Secundary help pages
	srrutil -h 
	   util           | extra        | amap        | cdnDebug
	   logFile        | runObjFile   | stitchFile  | aliasTable 
	   compressString | compressData |             | ot
	   sds            | psf          | spar        | fsdb      | noise
	   compareDS

GLOBAL FLAGS
	-set-optimize-info-data      # internal SRR flag, used by DRL layer
	-set-nb-print-sample <nb>    # max nb. of samples for printing WFs (5)
	-hook                        # adds the malloc hook function.
	-hookBreak <index>           # Stop code in a given index. To allow attaching the debugger.
	-V                           # runs on verbose mode
	-print-memory-usage          # Prints memory usage at the end
	-strace                      # starts strace before opening dataset (for debug)
	-nb-thread <value>           # Forces assync mode, on multi-thread (for debug)
	-check-optical               # Sets the bit on SRR to read optical signals
	-no-stitch-table             # Turns off stitch table
	-simvision                   # Reads data on simivision mode client

ENV VARIABLES

VERSIONS
	CDN Current build             : ICADVM20.1-64b.500.23 ICADVM20.1-64b 01/25/2022

Community Guidelines

The Cadence Design Communities support Cadence users and technologists interacting to exchange ideas, news, technical information, and best practices to solve problems and get the most from Cadence technology. The community is open to everyone, and to provide the most value, we require participants to follow our Community Guidelines that facilitate a quality exchange of ideas and information. By accessing, contributing, using or downloading any materials from the site, you agree to be bound by the full Community Guidelines.