IC-CAP Configuration Files

This section describes the configuration variables found in the IC-CAP configuration files.

Variables in the File iccap.cfg

This configuration file is used to define several of the directory paths used by IC-CAP, such as paths for examples and model libraries, as well as other program features. The file is located in $ICCAP_ROOT/config.

The following table shows variables that exist by default in the iccap.cfg file.

An additional set of variables for customizing advanced features exist in the file iccap.adv. These variables are described in Table 14 and can be added to your iccap.cfg file as needed. The iccap.adv file is located in
$ICCAP_ROOT /iccap/lib/cust_advanced.

Table 13 Variables in the file iccap.cfg 

Variable name, description, and example	Value(s)
AEL_PATH Example: AEL_PATH={$ICCAP_ROOT}/ael/iccap:{$ICCAP_ROOT}/ael/icstat:{$ICCAP_ROOT}/ael/api	Directory
BUILTINSIMPATH Example: BUILTINSIMPATH={$ICCAP_ROOT}/bin	Directory
ICCAP_PC_UNIX_CMDS This is the directory IC-CAP uses to find UNIX style commands on the PC. Example: ICCAP_PC_UNIX_CMDS={$ICCAP_ROOT}/tools/bin	Directory
MARKER_FILE_NAME Search path and filename for plot marker file. Example: MARKER_FILE_NAME={$ICCAP_ROOT}/config/markers	Filename
FONT_FILE_NAME Search path and filename for plot font file. Example: FONT_FILE_NAME={$ICCAP_ROOT}/config/usascii	Filename
ICCAP_EXAMPLE_DIRECTORY Search path and directory for example files. Accessed by selecting File > Examples from the Main window. Example: ICCAP_EXAMPLE_DIRECTORY={$ICCAP_ROOT}/examples	Directory
ICSTAT_EXAMPLE_DIRECTORY Search path and directory for Statistics example files. Accessed by selecting File > Examples from the Statistics window Example: ICSTAT_EXAMPLE_DIRECTORY= {$ICCAP_ROOT}/examples/icstat	Directory
ICCAP_MODEL_DIRECTORY Search path and filename for model library files. Example: ICCAP_MODEL_DIRECTORY=%ICCAP_EXAMPLE_DIRECTORY	Directory
USERSIMFILE Search path and filename for user simulator files. Example: USERSIMFILE={$ICCAP_ROOT}/iccap/lib/usersimulators	Filename
INSTRALIASFILE Search path and filename for the instrument aliases file, instraliases Example: INSTRALIASFILE={$ICCAP_ROOT}/iccap/lib/instraliases	Filename
ABOUT_FILE Search path and filename for restricted rights and copyright file. Example: ABOUT_FILE={$ICCAP_ROOT}/config/about.txt	Filename
TECH_SUPPORT_FILE Search path and filename for technical support contact file. Example: TECH_SUPPORT_FILE={$ICCAP_ROOT}/config/support.txt	Filename
ICCAP_FUNCTION_BROWSE_DATA Search path and filename for help text displayed in Function Browser. Example: ICCAP_FUNCTION_BROWSE_DATA={$ICCAP_ROOT}/iccap/lib/functions.hlp	Filename
PULSECFG Search path and filename for pulse driver configuration. Example: PULSECFG={$ICCAP_ROOT}/iccap/lib/hp85124.cfg	Filename
PULSECAL Search path and filename for pulse driver calibration configuration. Example: PULSECAL={$ICCAP_ROOT}/iccap/lib/hp85124.cal	Filename
ICCAP_WHATS_NEW_FILE Search path and filename for what is new in IC-CAP file. Example: ICCAP_WHATS_NEW_FILE={$ICCAP_ROOT}/config/new.txt	Filename
TCPTRANSEXE Example: TCPTRANSEXE={$ICCAP_ROOT}/bin/tcptrans	Filename
ICCAP_IM_CONVERT Example: ICCAP_IM_CONVERT= {$ICCAP_ROOT}/bin/ImageMagick/convert	Filename
ICSTATUS_EXECUTABLE Example: ICSTATUS_EXECUTABLE={$ICCAP_ROOT}/bin/hpeesoficstatus	Filename
ICCAP_CPP_PATH Search path and filename for CPP. Example: ICCAP_CPP_PATH={$ICCAP_PLATFORM_DIR}/cpp	Filename
ICCAP_BUILTIN_GROUPS_TEXT Search path and filename for creating built-in groups Example: ICCAP_BUILTIN_GROUPS_TEXT= {$ICCAP_ROOT}/config/builtin_groups.txt	Filename
DRAW_PAGE_DEFAULT_MAGNIFICATION Control default magnification setting for drawing areas. (Smaller number means larger text.) Example: DRAW_PAGE_DEFAULT_MAGNIFICATION=1.8	Positive real number
DRAW_PAGE_DEFAULT_FONT Control default font type for drawing area. Example: DRAW_PAGE_DEFAULT_FONT=Arial For CAE	Font type
ICCAP_LICENSE_TIMEOUT Controls time until acquired licenses are automatically released. Reusing a license during time period resets timer. Disabling the auto-release requires manual release of license, or exit IC-CAP. Example: ICCAP_LICENSE_TIMEOUT=300 (Default)	Seconds 300 or higher 0 disables auto-release
API_DOUBLE_CLICKS_TIME_OUT Milliseconds before second click must occur. (Larger number is slower duration.) Example: API_DOUBLE_CLICKS_TIME_OUT=500	Milliseconds
ICCAP_NUM_RECENT_FILES Controls the number of files the system remembers from history. Example: ICCAP_NUM_RECENT_FILES=5 (Default)	Positive integer
ICCAP_MAX_RECENT_CHARS Controls the width of the menu pick(s) for recent files. Example: ICCAP_MAX_RECENT_CHARS=40 (Default)	Positive integer
ICCAP_MAX_VIS_TUNERS Sets the maximum number of parameters visible in a tuner window. A scroll bar appears if the number of parameters exceed this number. Example: ICCAP_MAX_VIS_TUNERS=8 (Default)	Positive integer
ICCAP_CPP_ARGS Extra argument to pass to cpp when performing simulations. This should rarely need to be reset. Example: ICCAP_CPP_ARGS=-H32000	Arguments

To use the variables listed in the following table, add them to the file iccap.cfg. For a graphical description of the color variables, see the figures following the table.

Table 14 Variables in file .iccap.adv

Variable name, description, and example	Value(s)
ICCAP_ICON_SIZE Size of toolbar icons. Example:  ICCAP_ICON_SIZE=LARGE	LARGE or SMALL
ICCAP_MAIN_PAGE_COLOR Background color of Main window. Example: ICCAP_MAIN_PAGE_COLOR=9	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_MEAS_PAGE_COLOR Background color of Measurement window. Example: ICCAP_MEAS_PAGE_COLOR=10	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_PLOT_PAGE_COLOR Background color of Plots window. Example: ICCAP_PLOT_PAGE_COLOR=11	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_ICON_BG_COLOR Background color of model symbol icons. Example: ICCAP_BG_COLOR=12	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_ICON_FG_COLOR Foreground color of model symbol icons. Example: ICCAP_ICON_FG_COLOR=16	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_ICON_EDIT_BG_COLOR Background color of editable label of model symbol icons in Main window Example: ICCAP_ICON_EDIT_BG_COLOR=29	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_ICON_EDIT_FG_COLOR Foreground color of editable label of model symbol icons in Main window Example: ICCAP_ICON_EDIT_FG_COLOR=30	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_ICON_EDIT_HI_COLOR Highlight color of editable label of model symbol icons in Main window Example: ICCAP_ICON_EDIT_HI_COLOR=31	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_INPUT_BG_COLOR Background color of input tiles. Example: ICCAP_INPUT_BG_COLOR=13	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_OUT_BG_COLOR Background color of output tiles. Example: ICCAP_OUT_BG_COLOR=14	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_PLOT_BG_COLOR Background color of Plots window. Example: ICCAP_PLOT_BG_COLOR=15	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_SELECT_COLOR Color of highlight box that surrounds Model window icons when they are selected Example: ICCAP_SELECT_COLOR=17	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_TILE_SELECT_COLOR Color of highlight of selected input, output, and plot tiles Example: ICCAP_TILE_SELECT_COLOR=18	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_TILE_BORDER_COLOR Border color of input, output, and plot tiles Example: ICCAP_TILE_BORDER_COLOR=19	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_TILE_TITLE_BG_COLOR Background color of input, output, and plot tile labels Example: ICCAP_TILE_TITLE_BG_COLOR=20	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_TILE_TITLE_FG_COLOR Foreground color of input, output, and plot tile labels Example: ICCAP_TILE_TITLE_FG_COLOR=21	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_TILE_TITLE_EDIT_BG_COLOR Background color of input, output, and plot names Example: ICCAP_TILE_EDIT_BG_COLOR=23	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_TILE_TITLE_EDIT_FG_COLOR Foreground color of input, output, and plot names Example: ICCAP_TILE_EDIT_FG_COLOR=22	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_TILE_TITLE_EDIT_HI_COLOR Highlight color of the input, output, or plot names when highlighted for editing Example: ICCAP_TILE_EDIT_HI_COLOR=24	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_TILE_LINE_FG_COLOR Foreground color of text of individual line items of inputs, outputs, and plots Example: ICCAP_TILE_LINE_FG_COLOR=25	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_TILE_LINE_EDIT_ FG_COLOR Foreground color of associated text of line item Example: ICCAP_TILE_LINE_EDIT_ FG_COLOR=26	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_TILE_LINE_EDIT_ BG_COLOR Background color of associated text of line item Example: ICCAP_TILE_LINE_EDIT_ BG_COLOR=27	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICCAP_TILE_LINE_EDIT_ HI_COLOR Highlight color of associated text of line item Example: ICCAP_TILE_LINE_EDIT_ HI_COLOR=28	Range allowed (1 to the number of colors specified in eecolor.cfg)
ICSTATUS_WINDOW_TO_TOP Sets the default behavior of the Status window, where On means the Status window pops to the front of the screen anytime new messages are displayed in it, and Off means it does not pop forward automatically. Example: ICSTATUS_WINDOW_TO_TOP=1	0=Off 1=On
BACKUP_FILES_WHEN_ASKED Controls prompt for file backup when using File > Save As. YES always creates backup of file without a prompt. NO saves file without creating backup or prompting for backup. ASK prompts to overwrite existing file, and create backup. Example: BACKUP_FILES_WHEN_ASKED=ASK	YES, NO, or ASK
OVERWRITE_FILES_WHEN_ASKED Controls prompt for overwriting files when saving. YES always overwrites files without a prompt. NO prevents overwrite of any file; you must save to a new name or remove existing file. ASK prompts to overwrite existing file. Example: OVERWRITE_FILES_WHEN_ASKED=ASK	YES, NO, or ASK
ICCAP_USER_FUNCTION_BROWSE_DATA Search path and filename for user defined help text displayed in Function Browser in addition to the functions.hlp file. The default is blank. Separate multiple filenames with a semicolon (;) on Windows and a colon (:) on UNIX. Example: ICCAP_FUNCTION_BROWSE_DATA= {$ICCAP_OPEN_DIR}/user_funcs.hlp: {$HOME}/myfuncs.hlp	Filename(s)

Customizing the Default Size and Location of Windows

This section lists additional variables that can be added to the configuration file iccap.cfg to customize the default size and location of many IC-CAP program windows. One or more of the following specifications can be added to the variables shown in Table 15.

Example:

 HARDWARE_WINDOW_X=75
HARDWARE_WINDOW_Y=5
HARDWARE_WINDOW_WIDTH=950
HARDWARE_WINDOW_HEIGHT=700
HARDWARE_WINDOW_MIN_WIDTH=690
HARDWARE_WINDOW_MIN_HEIGHT=540

Table 15 Default Window Size and Location Variables 

Variable	Description
HARDWARE_WINDOW	The Hardware Manager Window
MODEL_WINDOW	The window displaying any currently open model file
STATUS_WINDOW	The window that displays status, warning, and error messages
SIMDEB_WINDOW	Simulation Debugger Window
SYSVAR_WINDOW	System Variables Window
PLOT_OPTIMIZER	Plot Optimizer Window
DETACH_SETUP_WINDOW	The detachable window that appears when you select a setup from the DUT/Setup pane and click Detach
DETACH_MACRO_WINDOW	The detachable window that appears when you select a macro from the Select Macro list box (in the Macros folder) and click Detach
DETACH_VARIABLE_WINDOW	The detachable window that appears when you select Tools > System Variables and click Detach
DETACH_PARAM_WINDOW	The detachable window that appears when you click Detach in the Model Parameters folder
ICSTAT_MAIN_WINDOW	The main Statistics window (Statistical Analysis)
ICSTAT_ANALYSIS_WINDOW	The Statistics window that appears when you choose Analysis Data from the Analysis menu
ICSTAT_SUMMARY_WINDOW	The Statistics window that displays statistical data
ICSTAT_BOUNDARY_WINDOW	The Statistics window in which boundary analysis data is displayed
ICSTAT_RESIDUAL_WINDOW	The Statistics window in which residual correlation data is displayed
ICSTAT_FACTOR_WINDOW	The Statistics window that displays a summary table showing the dominant parameter for each factor and its value, as well as the factor group data (Analysis > Factor/Parameter Groups).

Variables in the File hpeesofhelp.cfg

This configuration file is used by the Help Server to locate the Online Help documents. The file is located in $ICCAP_ROOT/config.

Table 16 Variables in the file hpeesofhelp.cfg 

Variable, description, and example	Value(s)
TOPLEVEL_DOC Top level index document location. Example: TOPLEVEL_DOC = $ICCAP_ROOT/doc	Directory

Variables in the File hpeesof.cfg

All IC-CAP programs read the hpeesof configuration file, which includes a variety of important configuration variables. The file is located in $ICCAP_ROOT/config.

Table 17 Variables in the file hpeesof.cfg 

Variable, description, and example	Value(s)
HPEESOF_LM_LICENSE_FILE Complete path to FLEXnet license.lic file. Example: HPEESOF_LM_LICENSE_FILE = {$ICCAP_ROOT}/license/license.lic	Filename
HPEESOF_COLOR Complete path to system-wide iccolor configuration file. Example: HPEESOF_COLOR={$ICCAP_ROOT}/config/iccolor.cfg	Filename
HPEESOF_FILL Complete path to system-wide icfill configuration file. Example: HPEESOF_FILL={$ICCAP_ROOT}/config/icfill.cfg	Filename
HPEESOF_FONT_FILE Directory where font index files are located. Example: HPEESOF_FONT_FILE={$ICCAP_ROOT}/config	Directory
HPEESOF_OCCIDENTAL_FILE Complete path to specify European foreign language fonts. (For future use.) Example: HPEESOF_OCCIDENTAL_FILE= {$ICCAP_ROOT}/config/hersh.oc	Filename
HPEESOF_ORIENTAL_FILE Complete path to specify Asian foreign language fonts. (For future use.) Example: HPEESOF_ORIENTAL_FILE={$ICCAP_ROOT}/config/hersh.or	Filename
HPEESOF_LANGUAGE Specifies the default language. Example: HPEESOF_LANGUAGE=english	Language name
HPEESOF_BUFFER Size of graphics buffer. Example: EESOF_BUFFER=5000	Number of bytes (0 to 500K)
HPEESOF_EEHCOPY_FILE Specifies location where the hardcopy configuration file .eehcopy will be written to. Example: EESOF_EEHCOPY_FILE=home	Location of eehcopy: system home cwd (current working directory)
HPEESOF_EEHCOPY_SETUP File where you customize the printing of plot files, text files, and screen dump files for any system configuration. Example: EESOF_EEHCOPY_SETUP={$ICCAP_ROOT}/config/eehcopy.setup	Filename