Setting Up Your Environment

In order to use the Library Management System (LMS) Toolkits in both Mentor Graphics and Advanced Design System (ADS), there are certain environment and configuration variables that must be set. This chapter is broken down into two main areas:

Setting Up the LMS Toolkit Software for ADS.
Setting up the LMS Toolkit Software for Mentor Graphics.

After covering the information in this chapter, you should be ready to begin the process of transferring your LMS libraries from Mentor Graphics to ADS.

Setting Up the LMS Toolkit Software for ADS

The LMS toolkit software is an add-on capability to the standard ADS product. Since most customers are not using ADS in conjunction with Mentor Graphics LMS, the software is disabled by default. However, the code is delivered on the standard ADS product CDs.

Note
The LMS add-on product is not licensed and must be enabled to access the software.

Enabling the LMS Add-on

To enable the LMS add-on for all users, perform the following steps:

If you are changing a site installation, open the file $HPEESOF_DIR/custom/config/de_sim.cfg (on unix) for editing with your favorite text editor. If the de_sim.cfg file does not exist in this directory, create one.
If you want to change an installation for a specific user, open the file $HOME/hpeesof/config/de_sim.cfg (on unix) for editing with your favorite text editor. The de_sim.cfg file should already exist in this directory if you previously ran ADS.
Add in the line LMS_FILE_DIRECTORY={$HPEESOF_DIR}/lms. This line can be placed anywhere in the file. You must add this line, because the boot program for the LMS add-on uses this variable to load other files.
Search for the variable USER_AEL. If you do not have the variable USER_AEL, create a new variable with a value of USER_AEL={%LMS_FILE_DIRECTORY}/LMSStartup.
If the value already exists, add {%LMS_FILE_DIRECTORY}/LMSStartup to USER_AEL by placing a semicolon at the end of the line, and then adding {%LMS_FILE_DIRECTORY}/LMSStartup to the end of the line.
The USER_AEL variable designates AEL files that will be loaded during the ADS bootup process. Make sure that all the values for USER_AEL are on a single line - there is no continuation character.

Once the above steps have been completed, start Advanced Design System. ADS Main Window with LMS add-on shows the menus that you should now see in your ADS main window.

Note
You must restart ADS in order to view the new menu if ADS is currently running. The above procedure is the same for all platforms supported by ADS.

ADS Main Window with LMS add-on

What is Contained in the LMS Add-on?

The directory $HPEESOF_DIR/lms contains four files. Following is a description of what each file is for:

LMSStartup - This is the boot file for the LMS add on. It loads the other files contained in the LMS add-on, and adds the LMS Utilities menu to the ADS Main window.
LMSArtwork - This file contains all of the routines used by the special Artwork macro that is used by LMS components within ADS.
LMSIffFilters - This file contains routines that will filter out extraneous data from geometry files sent from Mentor Graphics. When Mentor Graphics sends a geometry file, it will contain one instance of a footprint for each part number. Unfortunately, this leads to many duplicate geometries being created. This file removes the duplicate geometry entries prior to import.
LMSSetup - This file contains the post processing routines that are responsible for doing specialized component setup after LMS IFF files have been imported. It also contains all of the dialog code.

Setting up the LMS Toolkit Software for Mentor Graphics

The following information can be found in Mentor Graphics RF Design Tools User's and Reference Manual , which is distributed with Mentor Graphics C.4 or greater.

The following environmental variables must be set and the listed information entered in the MGC location map. These settings are required to use the RF options and the userware features. Entering this information in the UNIX startup file (.profile for sh or ksh, .cshrc for csh) automatically loads the environmental variables needed and sets the path to the location map. Optionally, you can create a file containing these commands and use the UNIX source command, at the command line, for each individual session. The syntax shown in these examples refers specifically to using a C-shell. Use the same syntax as is entered in the example variable startup file. It is important to observe the upper- and lower-case conventions when entering this information.

Environment File variables

MGC_HOME - Set this to the location to the Mentor Graphics trees.
MGC_LOCATION_MAP - Set this to the path of your location map file.
HPEESOF_DIR - Set this to ADS installation directory.
MGC_RF_SYSTEM - Set this to ADS.
AMPLE_PATH - This is the colon delimited list of Ample userware that must be loaded. You must add in $MGC_HOME/pkgs/pcb_rf/userware/default to the existing Ample path.
MGLS_LICENSE_FILE - Set this to the Mentor Graphics license file or the port address of the license server.
LM_LICENSE_FILE - Set this so it includes the ADS license file as well as $MGLS_LICENSE_FILE. This is a colon delimited list of FlexLM license files.
PATH - The path must include $MGC_HOME/bin and $HPEESOF_DIR/bin.
$MGC_LOCATION_MAP entries

Location Map Entries

The following libraries should be added to your location map file:

$MGC_ADSLIB - MGC RF symbol library for ADS equivalent distributed line elements. The MGC RF symbol library for ADS equivalents is located at $MGC_HOME/pkgs/pcb_rf/data/lib/mgc_adslib.tar.Z. To set up this library, decompress and untar this file and set the MGC location map entry $MGC_ADSLIB to this directory.
$HPEESOF_LIBS - EEsof connector library
$MGC_RF_BLOCKS - MGC template symbols for hierarchical blocks. The MGC template symbols for the hierarchical blocks are located at $MGC_HOME/pkgs/pcb_rf/data/lib/mgc_rf_blocks.tar.Z. To set up these blocks, decompress and untar this file and place it into your company library. Add the $MGC_RF_BLOCKS entry into your $MGC_LOCATION_MAP with the pathname to the actual RF blocks library (.../pathname_to/mgc_rf_blocks).

Setting Up Mentor Graphics on Windows

All of the environment variables that are set up on Unix should be set up for Windows as well. Instead of using a profile or cshrc file, the control panel environment setting should be used. In the environment setup, anyplace you see a $variable, %variable% would be used instead. The location map entries are the same for Unix and Windows.