sce_import allows to import all compoment models into a design that are necessary for a certain refinement step.
sce_import reads the SIR file for a given design, imports all the component model SIR files requested through each action on the command line and writes out the resulting modified SIR (if any). An output SIR file is only written if modifications to the design have been made through the actions. If no action is specified, no operations are performed, no output is produced and the specified design is left unchanged.
On successful completion, the exit value 0 is returned. In case of errors, a diagnostic message is written to standard error and the program execution is aborted with a non-zero exit value. In this case, no output is produced.
specifies the design to work with; if no -i or -o options are specificed, the suffix '.sir' will be appended to this name in order to obtain the default SIR file to read and write, respectively.
specifies the action to perform on the design; actions include operations to import all component model SIR files necessary for a given step in the design flow in preparation for refinement; based on the set of components allocated in the specified design, required component models are collected and imported into the design; if necessary, any missing parametrized component models not found in the component cache are (re-)generated before import;
-h
prints a short usage and version information and then quits;
-i input file
specifies the name of the input file explicitly; the name '-' can be used to specify reading from standard input;
-n
suppresses the creation of new log information when generating the output SIR file; by default, log information in the main design file is updated automatically (see also section ANNOTATIONS below);
-o output file
specifies the name of the output design file explicitly; the name '-' can be used to specify writing to standard output;
-v
set the verbosity level so that progress reports about actions performed are logged to standard error (default: be silent);
-a
import all component models in preparation and necessary for architecture refinement;
-c
import all component models in preparation and necessary for communication refinement;
-e
import all component models in preparation and necessary for network refinement;
-s
import all component models in preparation and necessary for scheduling refinement;
-r
import all component models in preparation and necessary for RTL refinement;
-t behavior
specify the top-level behavior to operate on for all actions following on the command line (default: use top-level behavior specified in the design); the top-level behavior determines the location of the allocation information of the components to import (see -t option of sce_allocate(l) for allocation location);
-x iss index
import all component models in preparation and necessary for ISS reintegration;
HOME
determines the location of the user's home directory and consequently the default path to the file with user-specific application preferences ($HOME/.sce/scerc);
determines the list of directories where files "scerc" with user-specific application preferences are stored; multiple directories can be provided, separated by colons (":"); directories are searched for and preference files are read in the given order, i.e. preference files in later directories override settings in earlier ones; if SCERC_PATH is not set, the location (directory) of the user-specific "scerc" file defaults to $HOME/.sce;
determines the license file (path and file name) to be used by the SIR tool set; if undefined, the environment variable SPECC is used as the path to the license file called "license.sir"; if neither SPECC_LICENSE_FILE nor SPECC exist, the file "license.sir" is searched in the current directory;
File with system-wide default settings for application preferences; system-wide settings are read on startup before user-specific settings;
File(s) with user-specific settings for application preferences; user-specific settings are read on startup after system-wide settings, i.e. user-specific settings override system-wide settings;
Default directory for cache of parametrized PE model SIR files generated through sir_gen(l); when importing parametrized components, sce_import searches the cache for corresponding SIR files and missing component files are first (re-)generated and stored in the cache; default cache location can be overwritten through settings in "scerc" application preferences;
Default directory for cache of parametrized CE model SIR files generated through sir_gen(l); when importing parametrized components, sce_import searches the cache for corresponding SIR files and missing component files are first (re-)generated and stored in the cache; default cache location can be overwritten through settings in "scerc" application preferences;
Default directory for cache of parametrized bus model SIR files generated through sir_gen(l); when importing parametrized components, sce_import searches the cache for corresponding SIR files and missing component files are first (re-)generated and stored in the cache; default cache location can be overwritten through settings in "scerc" application preferences;
The following SpecC annotations are recognized by sce_import:
contains the log information of the SIR file; this global annotation is created and maintained automatically by the SpecC compiler and the SCE tool set and can be used to determine the origin and the operations performed on the design model; _SCE_LOG is a composite annotation consisting of a list of log entries, ordered by time of creation; each log entry consists of a time stamp, command line, source file, version info, and an optional comment;