EE406

Required EDA software

1. Open the PowerShell and install WSL
   wsl --install -d Ubuntu-22.04
   You will be prompted to create a UNIX username and password.
   This UNIX username and password have no relationship to your Windows username and password.
   To avoid any confusion use a different username

2. Install Docker Desktop
   

3. Start Ubuntu (either by typing wsl into the Windows's PowerShell or selecting the Ubuntu app in the Window's Start Menu)
   Your unix user's home directory is:
   /home/<unix username>
   Your Windows user's home directory is:
   /mnt/c/Users/<windows username>

4. clone the iic-osic-tools container onto your computer (for example into your Windows user's folder)
   git clone --depth=1 https://github.com/iic-jku/iic-osic-tools.git
   Example
   Windows user's folder: C:\Users\claudio
   In Unix, the Windows user's folder is accessible as: /mnt/c/Users/claudio
   

5. Start Docker Desktop

6. Browse to the iic-osic-tools directory
   cd /mnt/c/Users/claudio/iic-osic-tools

7. Start the container using the script ./start_x.sh
   NOTE: in the script, all user data is persistently mounted in the directory pointed to by the environment variable DESIGNS
   The default is $HOME/eda/designs
   To change where the user data is mounted edit the ./start_x.sh script and modify the definition of the variable DESIGNS
   Example
   DESIGNS="/mnt/g/My Drive/eda/designs"

8. In the unfortunate event that .Xauthority does not exist in the user home directory, it will show the below error:
   

   xauth
   xauth:  file /root/.Xauthority does not exist
   Using authority file /root/.Xauthority
   

   Below are the steps to manually create .Xauthority under the user home directory:
   

   touch ~/.Xauthority
   # Generate the magic cookie with 128 bit hex encoding
   xauth add ${HOST}:0 . $(xxd -l 16 -p /dev/urandom)
   # Verify the result and it shouldn't show any error
   xauth list
   

9. If everything goes as it should, you will see a terminal with the prompt /foss/designs >.
   This is your working directory where all your design data goes.

10. The default PDK is the sky130A. However, the container supports also other PDKs.
    The available PDKs are:
    

    gf180mcuC
    sg13g2
    sky130A
    

    If you want to switch to the IHP PDK type:
    

    iic-pdk sg13g2
    

    To skip typing this command every time, create a .designinit text file in your design directory with the following lines:

    PDK_ROOT=/foss/pdks
    PDK=sg13g2
    PDKPATH=/foss/pdks/sg13g2
    

    For more information about the sg13g2 technology lookup the IHP github

Additional software to install on your computer

1. Matlab (or Octave) <-- required
2. Anaconda (link)
3. PyLTSpice version 3.1
   pip install PyLTSpice==3.1
   
4. HSPICE/ngspice Toolbox by M. Perrott <-- required