Difference between revisions of "ESim/C2/Getting-started-with-eSim-Linux-installation/English"

From Script | Spoken-Tutorial
Jump to: navigation, search
 
(One intermediate revision by one other user not shown)
Line 8: Line 8:
  
  
{| border="1"
+
{| border=1
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|| Visual Cue
 
|| Visual Cue
Line 24: Line 24:
 
* <div style="margin-left:1.27cm;margin-right:0cm;">Install''' eSim''' version 1.1.2 on '''Ubuntu Linux.'''</div>
 
* <div style="margin-left:1.27cm;margin-right:0cm;">Install''' eSim''' version 1.1.2 on '''Ubuntu Linux.'''</div>
 
* <div style="margin-left:1.27cm;margin-right:0cm;">Run''' eSim''' using an example.</div>
 
* <div style="margin-left:1.27cm;margin-right:0cm;">Run''' eSim''' using an example.</div>
 
  
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
Line 31: Line 30:
 
System Requirements
 
System Requirements
 
|| To install''' eSim''', we will use
 
|| To install''' eSim''', we will use
 
 
* <div style="margin-left:1.27cm;margin-right:0cm;">'''Ubuntu Linux''' 16.04.</div>
 
* <div style="margin-left:1.27cm;margin-right:0cm;">'''Ubuntu Linux''' 16.04.</div>
 +
  
  
Line 43: Line 42:
 
* <div style="margin-left:1.27cm;margin-right:0cm;">We require a working''' Internet connection.'''</div>
 
* <div style="margin-left:1.27cm;margin-right:0cm;">We require a working''' Internet connection.'''</div>
 
* <div style="margin-left:1.27cm;margin-right:0cm;">We also require to be a '''root user.'''</div>
 
* <div style="margin-left:1.27cm;margin-right:0cm;">We also require to be a '''root user.'''</div>
 
  
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
Line 51: Line 49:
 
|| To use''' eSim''', one should have basic knowledge of
 
|| To use''' eSim''', one should have basic knowledge of
 
* <div style="margin-left:1.27cm;margin-right:0cm;">'''Analog''' and''' Digital electronics.'''</div>
 
* <div style="margin-left:1.27cm;margin-right:0cm;">'''Analog''' and''' Digital electronics.'''</div>
 
  
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
Line 63: Line 60:
 
* <div style="margin-left:1.27cm;margin-right:0cm;">NgSpice</div>
 
* <div style="margin-left:1.27cm;margin-right:0cm;">NgSpice</div>
 
* <div style="margin-left:1.27cm;margin-right:0cm;">KiCad</div>
 
* <div style="margin-left:1.27cm;margin-right:0cm;">KiCad</div>
 
  
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
Line 75: Line 71:
 
* <div style="margin-left:1.27cm;margin-right:0cm;">perform''' simulation'''</div>
 
* <div style="margin-left:1.27cm;margin-right:0cm;">perform''' simulation'''</div>
 
* <div style="margin-left:1.27cm;margin-right:0cm;">and create''' PCB layout.'''</div>
 
* <div style="margin-left:1.27cm;margin-right:0cm;">and create''' PCB layout.'''</div>
 
  
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
Line 84: Line 79:
  
  
Go to the''' eSim website, as '''shown here.
+
Go to the''' eSim''' website, as shown here.
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|| Click on''' Downloads tab.'''  
 
|| Click on''' Downloads tab.'''  
Line 93: Line 88:
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|| Point to '''“OK” '''
 
|| Point to '''“OK” '''
|| Click on '''save'''to save the installer in your computer.  
+
|| Click on '''Save''' to save the '''installer''' in your computer.  
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|| Click on '''Cancel'''  
 
|| Click on '''Cancel'''  
Line 110: Line 105:
  
 
Changing the directory where eSim is Downloaded  
 
Changing the directory where eSim is Downloaded  
|| Go to the directory where we have saved our '''eSim installer folder.'''
+
|| Go to the directory where we have saved our '''eSim installer''' folder.
  
  
Line 122: Line 117:
  
 
This will take me to my '''installer '''folder.
 
This will take me to my '''installer '''folder.
|- style="background-color:#ffffff;border:1pt solid #000000;padding:0.176cm;"
 
|| <div style="color:#800000;">'''Terminal:'''</div>
 
 
<div style="color:#800000;">'''Type''' chmod +x install-linux.sh in terminal</div>
 
|| <div style="color:#800000;">Now type and Press Enter </div>
 
 
 
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|| '''Terminal :'''
 
|| '''Terminal :'''
Line 150: Line 138:
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|| '''Terminal:'''  
 
|| '''Terminal:'''  
|| If you are behind a ''' network proxy''', you should type''' Y.'''
+
|| If you are behind a''' network proxy''', you should type''' Y.'''
  
  
Line 194: Line 182:
  
 
Now let us open the project.
 
Now let us open the project.
 
+
|- style="border:1pt solid #000000;padding:0.176cm;"
 +
||
 +
|| To launch '''eSim''', go to '''Desktop''' and double click on the '''eSim''' icon.
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|| '''Desktop '''(shortcut created for eSim):
 
|| '''Desktop '''(shortcut created for eSim):
Line 201: Line 191:
 
||  
 
||  
  
To launch '''eSim''', goto '''Desktop''' and double click on the '''eSim''' icon.
+
To launch '''eSim''', go to '''Desktop''' and double click on the '''eSim''' icon.
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
||  
 
||  
 
|| The '''eSim '''window opens.
 
|| The '''eSim '''window opens.
 
+
|- style="border:1pt solid #000000;padding:0.176cm;"
 +
||
 +
|| <<PAUSE>>
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|| In the '''eSim startup '''window :
 
|| In the '''eSim startup '''window :
 
 
  
  
 
Click on “'''Ok'''”  
 
Click on “'''Ok'''”  
|| By default, the project files created, will be saved in the''' eSim-Workspace''' directory.
+
|| By default, the '''project''' files created, will be saved in the''' eSim-Workspace''' directory.
  
  
Line 221: Line 211:
  
 
Click on '''Open Project'''  
 
Click on '''Open Project'''  
|| To open the project, click on''' Open Project''' button on the top toolbar.  
+
|| To open the '''project''', click on''' Open Project''' button on the top toolbar.  
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|| '''eSim window:'''
 
|| '''eSim window:'''
Line 227: Line 217:
  
 
Selecting the project folder
 
Selecting the project folder
|| Locate the folder where''' eSim''' is''' '''downloaded.
+
|| Locate the folder where''' eSim''' is downloaded.
  
  
Line 244: Line 234:
  
  
Double-click to select the project.
+
Double-click to select the '''project'''.
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|| '''eSim window:'''
 
|| '''eSim window:'''
Line 250: Line 240:
 
Click''' Open Schematic'''  
 
Click''' Open Schematic'''  
 
|| Click''' Open Schematic''' button on the left toolbar.
 
|| Click''' Open Schematic''' button on the left toolbar.
|- style="background-color:#ffffff;border:1pt solid #000000;padding:0.176cm;"
+
 
|| Screengrab of the''' Project Rescue Helper''' window:
+
|| Click on Ok in the dialog box
+
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
||  
 
||  
|| You can now see the''' '''schematic of the '''half wave rectifier'''.
+
|| You can now see the '''schematic''' of the '''half wave rectifier'''.
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|| '''eSim Schematic Editor window:'''
 
|| '''eSim Schematic Editor window:'''
Line 271: Line 259:
  
  
Now come to the eSim window
+
Now come to the '''eSim''' window
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|| '''eSim window:'''
 
|| '''eSim window:'''
|| Let us simulate this project'''.'''  
+
|| Let us '''simulate''' this '''project'''.
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|| '''eSim window:'''
 
|| '''eSim window:'''
Line 281: Line 269:
 
||  
 
||  
  
Click on the ''' Simulation''' button, in the left toolbar.
+
Click on''' Simulation''' button, in the left toolbar.
  
  
This will simulate the circuit.
+
This will '''simulate''' the '''circuit'''.
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|| '''Terminal''' and''' Plot''' Windows''':'''
 
|| '''Terminal''' and''' Plot''' Windows''':'''
Line 294: Line 282:
 
* <div style="margin-left:1.27cm;margin-right:0cm;">the''' ngspice plot '''window</div>
 
* <div style="margin-left:1.27cm;margin-right:0cm;">the''' ngspice plot '''window</div>
 
* <div style="margin-left:1.27cm;margin-right:0cm;">and the '''python plot '''window.</div>
 
* <div style="margin-left:1.27cm;margin-right:0cm;">and the '''python plot '''window.</div>
 
  
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
Line 301: Line 288:
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|| '''Ngspice Plot '''window''':'''  
 
|| '''Ngspice Plot '''window''':'''  
|| This shows the simulated output.  
+
|| This shows the '''simulated''' output.  
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|| Switch to the '''Python plot '''window :
 
|| Switch to the '''Python plot '''window :
Line 307: Line 294:
  
 
Select as per narration  
 
Select as per narration  
 +
  
 
Click on '''Plot'''  
 
Click on '''Plot'''  
Line 312: Line 300:
  
  
Select the '''nodes '''('''for voltage''') and the '''branches '''('''for current'''), which need to be displayed.  
+
Select the '''nodes (for voltage)''' and the '''branches (for current)''', which need to be displayed.  
  
  
Line 321: Line 309:
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|| '''Python plot '''window and the '''schematic '''window  
 
|| '''Python plot '''window and the '''schematic '''window  
|| Click on the '''maximize button '''on the '''Python plot '''window to see the plot better.  
+
|| Click on the '''maximize''' button on the '''Python plot '''window to see the plot better.  
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|| '''Python plot window '''
 
|| '''Python plot window '''
Line 339: Line 327:
 
* <div style="margin-left:1.27cm;margin-right:0cm;">Install '''eSim version 1.1.2''' on '''Ubuntu Linux.'''</div>
 
* <div style="margin-left:1.27cm;margin-right:0cm;">Install '''eSim version 1.1.2''' on '''Ubuntu Linux.'''</div>
 
* <div style="margin-left:1.27cm;margin-right:0cm;">Run '''eSim''' using '''Half wave rectifier '''as an example.</div>
 
* <div style="margin-left:1.27cm;margin-right:0cm;">Run '''eSim''' using '''Half wave rectifier '''as an example.</div>
 
  
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"
Line 353: Line 340:
  
 
Spoken tutorial workshops
 
Spoken tutorial workshops
|| We conduct workshops using Spoken Tutorials and give Certificates.
+
|| We conduct workshops using Spoken Tutorials and give certificates.
  
  
Line 388: Line 375:
  
 
For more details, please visit this site.
 
For more details, please visit this site.
 
 
  
 
|- style="border:1pt solid #000000;padding:0.176cm;"
 
|- style="border:1pt solid #000000;padding:0.176cm;"

Latest revision as of 08:40, 4 September 2019

Getting started with eSim - Linux Installation


Author: Usha Viswanathan, Gaurav Supal

Keywords: video tutorial, Free and open source software, EDA tool, Simulation


Visual Cue Narration
Show Slide:

Title slide

Welcome to the Spoken Tutorial on “Getting started with eSim- Linux Installation.
Show Slide:

Learning Objectives

In this tutorial, we will learn how to:
  • Install eSim version 1.1.2 on Ubuntu Linux.
  • Run eSim using an example.
Show Slide:

System Requirements

To install eSim, we will use
  • Ubuntu Linux 16.04.


One can also use any version of Ubuntu Linux higher than 12.04.

Show Slide:

Installation Requirements

For the installation-
  • We require a working Internet connection.
  • We also require to be a root user.
Show Slide:

Prerequisites

To use eSim, one should have basic knowledge of
  • Analog and Digital electronics.
Show Slide:

Packages installed with eSim

The following packages will be installed along with eSim:
  • Python 2.7
  • PyQt4
  • Matplotlib
  • NgSpice
  • KiCad
Show Slide:

About eSim

eSim is a free and open source software alternative to OrCAD.

It can be used to:

  • create circuit schematic,
  • perform simulation
  • and create PCB layout.
Show slide:

eSim Installation

Let us first download the installer files from the eSim website.


Go to the eSim website, as shown here.

Click on Downloads tab. Click on Downloads tab.
Point to eSim Installer – Linux Click on eSim Installer – Linux
Point to “OK” Click on Save to save the installer in your computer.
Click on Cancel I will click on Cancel, as I have already downloaded this file earlier.
Go to Downloads folder Go to the folder where the installer file is downloaded.
Right-click >> click on Extract Here Right-click on it and click on Extract Here.
Open Terminal Now, open the terminal window by pressing the Ctrl, Alt and T keys together.
Terminal:

Changing the directory where eSim is Downloaded

Go to the directory where we have saved our eSim installer folder.


On my machine, I will type-

cd (space) eSim hyphen 1(point) 1(point)2


and press Enter.


This will take me to my installer folder.

Terminal : Now type-

(dot)(slash) install(hyphen) linux (dot) sh(space)(hyphen)(hyphen) install


and press Enter.

Terminal:


Proxy Connection

On my terminal a message appears-

Is your Internet connection behind proxy?


This message will appear if you are using a network proxy else it won't.

Terminal: If you are behind a network proxy, you should type Y.


If not, then type N.

As I am not behind a network proxy, let me type N and press Enter.

Terminal:

Asking for nghdl installation?

The next message displayed asks whether the user wants to install nghdl.


For basic simulations, nghdl is not required.


Also, since nghdl is in developing stage, we will type ‘N’ and press Enter.

Terminal:


If prompted, type the root password and press Enter.
Show eSim icon on Desktop We can see that the installation of eSim on Ubuntu Linux OS is now complete.
Show slide:


Running eSim

Now that we have installed eSim, let us do a test-run.
Show slide:


Example for test Run

Let us run an example using eSim.


We are using Half wave Rectifier example for the test-run.


Now let us open the project.

To launch eSim, go to Desktop and double click on the eSim icon.
Desktop (shortcut created for eSim):

Double-click on the eSim icon >> eSim window opens

To launch eSim, go to Desktop and double click on the eSim icon.

The eSim window opens.
<<PAUSE>>
In the eSim startup window :


Click on “Ok

By default, the project files created, will be saved in the eSim-Workspace directory.


Click on “Ok” in the dialog box.

eSim window :

Click on Open Project

To open the project, click on Open Project button on the top toolbar.
eSim window:


Selecting the project folder

Locate the folder where eSim is downloaded.


Open eSim folder and go to Examples folder.


Now, open the Half wave rectifier folder.

eSim window:

Point to Half wave rectifier under Projects.


Double-click on project file

Half wave rectifier will appear under Projects.


Double-click to select the project.

eSim window:

Click Open Schematic

Click Open Schematic button on the left toolbar.
You can now see the schematic of the half wave rectifier.
eSim Schematic Editor window:

Place cursor on schematic >> press F1 to zoom in >>

press F2 to zoom out


Close the Schematic window.

Press the cursor on the schematic and press F1 key to zoom in.


To zoom out, use the F2 key.


Now come to the eSim window

eSim window: Let us simulate this project.
eSim window:

Click on Simulation button

Click on Simulation button, in the left toolbar.


This will simulate the circuit.

Terminal and Plot Windows:


Highlight each window

You will see:
  • the ngspice terminal window,
  • the ngspice plot window
  • and the python plot window.
Ngspice Terminal Window: If you are familiar with ngspice commands, then use this window to plot various other waveforms.
Ngspice Plot window: This shows the simulated output.
Switch to the Python plot window :


Select as per narration


Click on Plot

Now, come to the Python plot window.


Select the nodes (for voltage) and the branches (for current), which need to be displayed.


Click on Plot.

Output Waveform Here, output voltage is rectified with respect to input.
Python plot window and the schematic window Click on the maximize button on the Python plot window to see the plot better.
Python plot window Click on the minimised schematic window.

You can now see the schematic and the plot together.

This brings us to the end of this tutorial.
Show Slide:

Summary

Let us summarize.

In this tutorial, we learnt how to

  • Install eSim version 1.1.2 on Ubuntu Linux.
  • Run eSim using Half wave rectifier as an example.
Show Slide:

Spoken tutorial workshops

This video summarises the Spoken Tutorial project.


Please download and watch it.

Show Slide:

Spoken tutorial workshops

We conduct workshops using Spoken Tutorials and give certificates.


Please contact us.

Show Slide:

Forum to answer questions

Do you have questions in this Spoken Tutorial?

Choose the minute and second where you have the question.

Explain your question briefly.

Someone from the FOSSEE team will answer them.

Please visit this site.

Show Slide:

Forum to answer questions

Do you have any general / technical questions on eSim?

Please visit the FOSSEE forum and post your question.

Show Slide:

Textbook Companion

The FOSSEE team coordinates coding of solved examples of popular books.


We give honorarium and certificates for those who do this.


For more details, please visit this site.

Show Slide:

Acknowledgment

The Spoken Tutorial project is funded by NMEICT, MHRD, Govt. of India
Show Slide:

Thank You

This is Usha from IIT Bombay signing off. Thanks for watching

Contributors and Content Editors

Nancyvarkey, PoojaMoolya, Saurabhbansode, Vineeta