Icfb setup

This tutorial was originally adapted from the first lab document in EE330 in January, 2010.

Setup

Once you have successfully logged into your account on a Linux machine, you need to take a few steps before you can start using the IC design tools.

• Set Bash Shell for the account
  • Login to http://www.asw.iastate.edu
  • Click on: Manage user “userid name”
  • Click on: Set your login shell
  • Select: “/bin/bash”
  • Click on: Update Shell
  • Click on: logout
  • Note: This will take some time to take effect, so for the first lab we will set our shell by typing bash on the command prompt. For bash setting to work properly, the ~/.bashrc should contain the 3 listed lines:

if [ -f /etc/bashrc ]; then
   ./etc/bashrc
fi

• After making sure that these lines are present in the ~/.bashrc, type bash on the prompt, this will set your shell to bash.

• Create a ~/.software file (Only once). The computer support group (CSG) has made a variety of software available for student use on the system. To enable the use of different software tools, every user needs to have a special file, .software (the “.” is required!) in their home directory customized for their use. Using a text editor of your choice, create a new file by that name in your home directory and enter the following lines in that file:

IUS
ASSURA
IC

These three entries enable the use of the IC design tools with analog and digital design flow capability. You will need to log out and log in for the new file to take effect. If other tools are needed for a future lab, you may have to edit this file and add appropriate entries as directed by your TA

• Create a ~/.bash_profile file (Only once) and enter the following lines in that file:

if [ -f ~/.bashrc ]; then
. ~/.bashrc
fi

PATH=$PATH:$HOME/bin
BASH_ENV=$HOME/.bashrc
USERNAME=""
export USERNAME BASH_ENV PATH DISPLAY

• Create a ~/cds.lib file (only once). The Library Manager (to be discussed in the next section) keeps information about system-wide libraries as well as your design libraries in a special file called cds.lib (the contents of cds.lib file are case-sensitive). For better organization purposes, you will create a cds.lib in your home directory. This file will include definitions of system wide libraries as well as any library that you would like to be available for all of your projects and classes. For starters, create the file with the following contents (remember to press enter at the end of second line):

INCLUDE $CDS_SITE/cdssetup/cds.lib
DEFINE analogLib $IC/tools/dfII/etc/cdslib/artist/analogLib

The first line includes a cds.lib file created by the system administrators from another location on the system. The second line defines a library “analogLib” supplied by Cadence which includes the basic circuit elements. Except for transistors, most of your schematic components will be

instantiated from this library. Cadence library names are case sensitive and spaces are not allowed. Avoid starting a library name with a number. Use underscores or mixed capitalization (e.g., analogLib is more readable than analoglib).

• Create a project directory and a cds.lib file (for every project). It is best to organize your work in multiple directories with each directory being dedicated to a specific class or to a research project. We will create a new directory where all of our libraries will be stored for this course. At the command line (in your home directory):

mkdir ee330
cd ee30

Now create a cds.lib file in the new directory with the following one line as its contents (remember to press enter at the end of the line).

INCLUDE ~/cds.lib

This line will include the contents of our ~/cds.lib file giving us access to the common libraries defined there. Whenever you launch Cadence IC tool from ~/ee434 and create any new libraries, this file will be automatically updated to include the definitions of the new libraries. The basic setup for running the Cadence Custom IC design tools is now complete. Refer to this section whenever you start a new project and need to set up a new directory. Please log off and log in again now.

• Type the command “bash” (You may skip this step on Lab 2). After making sure that your are in the ee330 directory you created earlier, type the command “icfb” as shown below.

icfb &

This will start the Cadence custom IC design tool in the background. After a brief delay, Cadence should open and you can proceed to tutorials on using Cadence.