Difference between revisions of "OpenPLC-version1-with-LDmicro/C2/Installation-of-LDmicro-on-Linux/English"

From Script | Spoken-Tutorial
Jump to: navigation, search
 
Line 24: Line 24:
 
System Requirements
 
System Requirements
 
|| To record this tutorial I am using:
 
|| To record this tutorial I am using:
* Ubuntu Linux''' '''18.04 operating system
+
* '''Ubuntu Linux''' 18.04 operating system
* USBasp programmer
+
* '''USBasp programmer'''
  
 
|-  
 
|-  
Line 33: Line 33:
 
|| OpenPLC website
 
|| OpenPLC website
  
|| To download the installation files, open the web browser of your choice.
+
|| To download the '''installation files''', open the '''web browser''' of your choice.
  
I’m using Firefox.
+
I’m using '''Firefox'''.
  
 
Go to the website [https://openplc.fossee.in/ https://openplc.fossee.in]
 
Go to the website [https://openplc.fossee.in/ https://openplc.fossee.in]
  
Make sure you’ve an active internet connection.
+
Make sure you’ve an active '''internet connection'''.
 
|-  
 
|-  
 
|| OpenPLC website
 
|| OpenPLC website
|| In the top menu bar, click on the '''Downloads''' link.
+
|| In the top menu bar, click on the '''Downloads link'''.
 
|-  
 
|-  
 
|| OpenPLC website
 
|| OpenPLC website
  
 
<point to various links>
 
<point to various links>
|| Here we will find the links to download '''LDmicro''' installation files.
+
|| Here we will find the '''links''' to download '''LDmicro installation files'''.
  
The installation files are available for '''Windows''' and '''Ubuntu Linux''' OS.
+
The '''installation files''' are available for '''Windows''' and '''Ubuntu Linux''' OS.
  
 
'''Ubuntu '''has two columns as''' Linux Ubuntu using Gtk '''and''' Linux Ubuntu using Qt.'''
 
'''Ubuntu '''has two columns as''' Linux Ubuntu using Gtk '''and''' Linux Ubuntu using Qt.'''
 
|-  
 
|-  
 
||  
 
||  
|| We will download the installation files of '''LDmicro''' developed using''' Qt toolkit.'''
+
|| We will download the '''installation files''' of '''LDmicro''' developed using''' Qt toolkit.'''
 
|-  
 
|-  
 
|| OpenPLC website
 
|| OpenPLC website
  
 
Click LDmicro for Linux(deb)''' '''>> Click Save File''' '''>> Click OK
 
Click LDmicro for Linux(deb)''' '''>> Click Save File''' '''>> Click OK
|| Click on the appropriate link depending on your operating system’s version.
+
|| Click on the appropriate '''link''' depending on your '''operating system'''’s version.
  
I will click on '''LDmicro for Ubuntu 18.04(deb) '''link.
+
I will click on '''LDmicro for Ubuntu 18.04(deb) link'''.
  
 
A dialog box opens.
 
A dialog box opens.
  
Click on '''Save File, '''and then click the '''OK '''button'''.'''
+
Click on '''Save File, '''and then click the '''OK '''button.
 
|-  
 
|-  
 
|| Point to the .deb file in the downloads folder
 
|| Point to the .deb file in the downloads folder
Line 73: Line 73:
  
 
Press CTRL+ALT+T
 
Press CTRL+ALT+T
|| Now let us open the '''Terminal '''by pressing
+
|| Now let us open the '''Terminal '''by pressing '''CTRL +ALT + T''' keys simultaneously.
 
+
'''CTRL +ALT + T''' keys simultaneously.
+
 
|-  
 
|-  
 
|| Terminal
 
|| Terminal
  
 
Type >> cd Downloads
 
Type >> cd Downloads
|| Go to the '''Downloads '''folder''' '''by typing '''cd <space>Downloads '''and press ‘'''Enter'''’.
+
|| Go to the '''Downloads '''folder by typing '''cd <space>Downloads '''and press ‘'''Enter'''’.
 
|-  
 
|-  
 
|| Terminal  
 
|| Terminal  
  
 
Type >> ls
 
Type >> ls
|| Type '''ls '''to see the '''LDmicro''' package name.
+
|| Type '''ls '''to see the '''LDmicro package''' name.
  
 
Press''' Enter'''.
 
Press''' Enter'''.
Line 97: Line 95:
  
 
>> '''sudo dpkg -i LDMicro_Qt-2.3.2-Linux-bionic.deb'''
 
>> '''sudo dpkg -i LDMicro_Qt-2.3.2-Linux-bionic.deb'''
|| To do the installation, type the command '''sudo dpkg -i LDMicro_Qt-2.3.2-Linux-bionic.deb '''and press '''ENTER.'''
+
|| To do the '''installation''', type the '''command sudo dpkg -i LDMicro_Qt-2.3.2-Linux-bionic.deb '''and press '''ENTER.'''
 
|-  
 
|-  
 
|| Type >> <''password''>
 
|| Type >> <''password''>
|| Type the admin password if prompted and press '''ENTER'''.
+
|| Type the '''admin password''' if prompted and press '''ENTER'''.
 
|-  
 
|-  
 
||  
 
||  
|| We can see LDmicro is installed successfully.
+
|| We can see '''LDmicro''' is '''installed''' successfully.
 
|-  
 
|-  
 
|| Slide 4: Installation error
 
|| Slide 4: Installation error
Line 111: Line 109:
 
“dpkg: dependency problems prevent configuration of ldmicro”.
 
“dpkg: dependency problems prevent configuration of ldmicro”.
  
Solution:
 
  
sudo apt install qt5-default
 
 
|| You might receive an error saying '''“dpkg: dependency problems prevent configuration of ldmicro”.'''
 
|| You might receive an error saying '''“dpkg: dependency problems prevent configuration of ldmicro”.'''
  
This is because LDmicro is dependent on some '''Qt libraries'''.
+
This is because '''LDmicro''' is dependent on some '''Qt libraries'''.
  
This is the command to install those libraries.
+
This is the '''command''' to '''install''' those '''libraries'''.
 
|-  
 
|-  
 
|| Highlight the error in the terminal
 
|| Highlight the error in the terminal
|| Switch back to terminal.
+
|| Switch back to '''terminal'''.
  
 
Please follow the steps as shown here only if you get the error as shown.
 
Please follow the steps as shown here only if you get the error as shown.
 
|-  
 
|-  
||  
+
|| Solution:
|| We will now install a Qt package which has the required basic libraries.
+
  
For that type '''‘sudo apt install qt5-default’ '''and press ENTER.
+
sudo apt install qt5-default
 +
|| We will now '''install''' a '''Qt package''' which has the required basic '''libraries'''.
  
After that it’ll ask your permission again to install these libraries.
+
For that type '''‘sudo apt install qt5-default’ '''and press '''ENTER'''.
  
Type Y and press ENTER.
+
|-
 +
||Permission prompt will appear >> press Y
  
We have now installed required qt5 libraries.
 
  
Now again type the command as shown here to do the installation.
+
 
 +
 
 +
 
 +
Type
 +
 
 +
>> '''sudo dpkg -i LDMicro_Qt-2.3.2-Linux-bionic.deb'''
 +
 
 +
 
 +
 
 +
||After that it’ll ask your '''permission''' again to '''install''' these '''libraries'''.
 +
 
 +
Type '''Y''' and press '''ENTER'''.
 +
 
 +
We have now '''installed''' required '''qt5 libraries'''.
 +
 
 +
Now again type the '''command''' as shown here to do the '''installation'''.
 +
 
 +
Press '''Enter'''.
 
|-  
 
|-  
 
||  
 
||  
Line 143: Line 156:
 
|| Type >> '''ldmicro'''  
 
|| Type >> '''ldmicro'''  
  
|| To make sure, type '''‘ldmicro’ '''in the terminal and press '''ENTER.'''
+
|| To make sure, type '''‘ldmicro’ '''in the '''terminal''' and press '''ENTER.'''
 
|-  
 
|-  
 
|| '''LDmicro '''interface  
 
|| '''LDmicro '''interface  
Line 160: Line 173:
 
'''AVRDUDE '''stands for '''AVR Downloader Uploader'''.
 
'''AVRDUDE '''stands for '''AVR Downloader Uploader'''.
  
It is a tool for downloading or uploading the on-chip memories of AVR microcontrollers.
+
It is a tool for downloading or uploading the '''on-chip memories''' of '''AVR microcontrollers'''.
 
|-  
 
|-  
 
|| Switch back to terminal
 
|| Switch back to terminal
|| To install '''AVRDUDE''', switch back to terminal.
+
|| To install '''AVRDUDE''', switch back to '''terminal'''.
 
|-  
 
|-  
 
|| Type, sudo apt-get install avrdude
 
|| Type, sudo apt-get install avrdude
Line 169: Line 182:
 
|| Type, '''sudo apt<hyphen>get install avrdude''' and press '''ENTER'''.
 
|| Type, '''sudo apt<hyphen>get install avrdude''' and press '''ENTER'''.
  
Wait until the installation is completed.
+
Wait until the '''installation''' is completed.
 
|-  
 
|-  
 
|| Type avrdude
 
|| Type avrdude
Line 176: Line 189:
 
|| To check the installed version, type '''avrdude '''and press '''ENTER'''.
 
|| To check the installed version, type '''avrdude '''and press '''ENTER'''.
  
Here, you can find the version number at the bottom of the terminal.
+
Here, you can find the version number at the bottom of the '''terminal'''.
 
|-  
 
|-  
 
||  
 
||  
Line 186: Line 199:
 
||  
 
||  
  
This is a picture of a USBasp programmer
+
This is a picture of a '''USBasp programmer'''.
 
|-  
 
|-  
 
|| Slide 7: why USBasp drivers
 
|| Slide 7: why USBasp drivers
* '''USBasp programmer''' is used to program the controller on '''OpenPLC V1''' '''Mainboard'''.
+
* '''USBasp programmer''' is used to '''program''' the '''controller''' on '''OpenPLC V1 Mainboard'''.
* '''AVRDUDE''' will not recognize the '''USBasp''', if drivers are not installed.
+
* '''AVRDUDE''' will not recognize the '''USBasp''', if '''drivers''' are not '''installed'''.
  
 
|| Why USBasp drivers?
 
|| Why USBasp drivers?
* A '''USBasp programmer''' is used to program the controller on '''OpenPLC Mainboard'''.
+
* A '''USBasp programmer''' is used to '''program''' the '''controller''' on '''OpenPLC Mainboard'''.
* '''AVRDUDE''' will not recognize the '''USBasp''', if drivers are not installed.
+
* '''AVRDUDE''' will not recognize the '''USBasp''', if '''drivers''' are not '''installed'''.
 
|-  
 
|-  
 
||  
 
||  
 
|| Now, we’ll see how to install '''USBasp''' drivers.
 
|| Now, we’ll see how to install '''USBasp''' drivers.
  
In Linux OS, the '''USBasp''' drivers are pre-installed.
+
In '''Linux OS''', the '''USBasp drivers''' are pre-installed.
 
|-  
 
|-  
 
|| Switch back to the terminal
 
|| Switch back to the terminal
|| Switch back to the terminal.
+
|| Switch back to the '''terminal'''.
 
|-  
 
|-  
 
|| Terminal
 
|| Terminal
Line 209: Line 222:
 
|| Type''' lsusb '''and press '''Enter'''.
 
|| Type''' lsusb '''and press '''Enter'''.
  
This will give the information about '''USB buses''' in the system and the devices connected to them.  
+
This will give the information about '''USB buses''' in the system and the '''devices''' connected to them.  
 
|-  
 
|-  
 
||  
 
||  
|| The information you get on the terminal may not be the same as mine.
+
|| The information you get on the '''terminal''' may not be the same as mine.
 
|-  
 
|-  
 
|| Connect USBasp to a USB port of Computer
 
|| Connect USBasp to a USB port of Computer
|| Now, connect a '''USBasp programmer''' to one of the USB ports of your computer.
+
|| Now, connect a '''USBasp programmer''' to one of the '''USB ports''' of your computer.
 
|-  
 
|-  
 
|| Terminal
 
|| Terminal
  
 
Type >> '''‘'''lsusb’
 
Type >> '''‘'''lsusb’
|| Now again, in the terminal type '''‘lsusb’''' and press '''ENTER.'''
+
|| Now again, in the '''terminal''' type '''‘lsusb’''' and press '''ENTER.'''
 
|-  
 
|-  
 
|| Terminal
 
|| Terminal
  
  
|| We can observe there is an extra line of information of the bus and the device connected to it.
+
|| We can observe there is an extra line of information of the '''bus''' and the '''device''' connected to it.
  
 
We can find a keyword '''libusb '''in the new line which indicates that '''USBasp programmer''' is connected.  
 
We can find a keyword '''libusb '''in the new line which indicates that '''USBasp programmer''' is connected.  
  
This indicates that the drivers are installed successfully.
+
This indicates that the '''drivers''' are installed successfully.
 
|-  
 
|-  
 
||  
 
||  
Line 243: Line 256:
 
* Drivers for '''USBasp''' programmer
 
* Drivers for '''USBasp''' programmer
  
|| In this tutorial, we learnt to install* '''LDmicro'''
+
|| In this tutorial, we learnt to install
 +
* '''LDmicro'''
 
* '''AVRDUDE '''and
 
* '''AVRDUDE '''and
* Drivers for '''USBasp''' programmer
+
* '''Drivers''' for '''USBasp programmer'''
 
|-  
 
|-  
 
|| Slide 9:
 
|| Slide 9:
Line 266: Line 280:
  
 
Answers for THIS Spoken Tutorial
 
Answers for THIS Spoken Tutorial
|| * Do you have questions in THIS Spoken Tutorial?
+
||  
 +
* Do you have questions in THIS Spoken Tutorial?
 
* Please visit this site.
 
* Please visit this site.
 
* Choose the minute and second where you have the question.
 
* Choose the minute and second where you have the question.
Line 277: Line 292:
  
 
Forum for specific questions:
 
Forum for specific questions:
|| * The Spoken Tutorial forum is for specific questions on this tutorial.
+
||  
 +
* The Spoken Tutorial forum is for specific questions on this tutorial.
 
* Please do not post unrelated and general questions on them.
 
* Please do not post unrelated and general questions on them.
 
* This will help reduce the clutter.
 
* This will help reduce the clutter.
Line 286: Line 302:
  
 
Forum for specific questions:
 
Forum for specific questions:
|| * Do you have any general / technical questions on OpenPLC?
+
||  
 +
* Do you have any general / technical questions on OpenPLC?
 
* Please visit the FOSSEE forum and post your question.
 
* Please visit the FOSSEE forum and post your question.
 
|-  
 
|-  

Latest revision as of 11:35, 16 January 2021

VISUAL CUE NARRATION
Slide 1:

Welcome slide

Welcome to the spoken tutorial on Installation of LDmicro on Linux.
Slide 2:

Learning Objectives

In this tutorial, we will see how to install,
  • LDmicro
  • AVRDUDE
  • Drivers for USBasp programmer
Slide 3:

System Requirements

To record this tutorial I am using:
  • Ubuntu Linux 18.04 operating system
  • USBasp programmer
Now we’ll see how to install LDmicro.
OpenPLC website To download the installation files, open the web browser of your choice.

I’m using Firefox.

Go to the website https://openplc.fossee.in

Make sure you’ve an active internet connection.

OpenPLC website In the top menu bar, click on the Downloads link.
OpenPLC website

<point to various links>

Here we will find the links to download LDmicro installation files.

The installation files are available for Windows and Ubuntu Linux OS.

Ubuntu has two columns as Linux Ubuntu using Gtk and Linux Ubuntu using Qt.

We will download the installation files of LDmicro developed using Qt toolkit.
OpenPLC website

Click LDmicro for Linux(deb) >> Click Save File >> Click OK

Click on the appropriate link depending on your operating system’s version.

I will click on LDmicro for Ubuntu 18.04(deb) link.

A dialog box opens.

Click on Save File, and then click the OK button.

Point to the .deb file in the downloads folder In the Downloads folder, we can see that the downloaded .deb file is available.
Open the terminal.

Press CTRL+ALT+T

Now let us open the Terminal by pressing CTRL +ALT + T keys simultaneously.
Terminal

Type >> cd Downloads

Go to the Downloads folder by typing cd <space>Downloads and press ‘Enter’.
Terminal

Type >> ls

Type ls to see the LDmicro package name.

Press Enter.

Highlight the LDmicro version Here, in my system, it shows LDMicro_Qt-2.3.2-Linux-bionic.deb

The name may vary in future.

Type

>> sudo dpkg -i LDMicro_Qt-2.3.2-Linux-bionic.deb

To do the installation, type the command sudo dpkg -i LDMicro_Qt-2.3.2-Linux-bionic.deb and press ENTER.
Type >> <password> Type the admin password if prompted and press ENTER.
We can see LDmicro is installed successfully.
Slide 4: Installation error

Error:

“dpkg: dependency problems prevent configuration of ldmicro”.


You might receive an error saying “dpkg: dependency problems prevent configuration of ldmicro”.

This is because LDmicro is dependent on some Qt libraries.

This is the command to install those libraries.

Highlight the error in the terminal Switch back to terminal.

Please follow the steps as shown here only if you get the error as shown.

Solution:

sudo apt install qt5-default

We will now install a Qt package which has the required basic libraries.

For that type ‘sudo apt install qt5-default’ and press ENTER.

Permission prompt will appear >> press Y



Type

>> sudo dpkg -i LDMicro_Qt-2.3.2-Linux-bionic.deb


After that it’ll ask your permission again to install these libraries.

Type Y and press ENTER.

We have now installed required qt5 libraries.

Now again type the command as shown here to do the installation.

Press Enter.

Now, LDmicro software is installed.
Type >> ldmicro To make sure, type ‘ldmicro’ in the terminal and press ENTER.
LDmicro interface LDMicro interface opens.

This ensures that LDmicro is installed successfully.

Next we’ll see how to install AVRDUDE.
Slide 5:

What is AVRDUDE?

What is AVRDUDE?

AVRDUDE stands for AVR Downloader Uploader.

It is a tool for downloading or uploading the on-chip memories of AVR microcontrollers.

Switch back to terminal To install AVRDUDE, switch back to terminal.
Type, sudo apt-get install avrdude Type, sudo apt<hyphen>get install avrdude and press ENTER.

Wait until the installation is completed.

Type avrdude

Highlight the version

To check the installed version, type avrdude and press ENTER.

Here, you can find the version number at the bottom of the terminal.

Next, we will see about USBasp programmer
Slide 6:

(picture of USBasp programmer, USBasp_Programmer.jpg)

This is a picture of a USBasp programmer.

Slide 7: why USBasp drivers
  • USBasp programmer is used to program the controller on OpenPLC V1 Mainboard.
  • AVRDUDE will not recognize the USBasp, if drivers are not installed.
Why USBasp drivers?
  • A USBasp programmer is used to program the controller on OpenPLC Mainboard.
  • AVRDUDE will not recognize the USBasp, if drivers are not installed.
Now, we’ll see how to install USBasp drivers.

In Linux OS, the USBasp drivers are pre-installed.

Switch back to the terminal Switch back to the terminal.
Terminal

Type >>lsusb

Type lsusb and press Enter.

This will give the information about USB buses in the system and the devices connected to them.

The information you get on the terminal may not be the same as mine.
Connect USBasp to a USB port of Computer Now, connect a USBasp programmer to one of the USB ports of your computer.
Terminal

Type >> lsusb’

Now again, in the terminal type ‘lsusb’ and press ENTER.
Terminal


We can observe there is an extra line of information of the bus and the device connected to it.

We can find a keyword libusb in the new line which indicates that USBasp programmer is connected.

This indicates that the drivers are installed successfully.

This brings us to the end of this tutorial.

Let us summarize.

Slide 8: Summary

We learnt to install

  • LDmicro
  • AVRDUDE
  • Drivers for USBasp programmer
In this tutorial, we learnt to install
  • LDmicro
  • AVRDUDE and
  • Drivers for USBasp programmer
Slide 9:

About Spoken Tutorial project

The video at the following link summarizes the Spoken Tutorial project.

Please download and watch it

Slide 10:

Spoken Tutorial workshops

The Spoken Tutorial Project team:
  • conducts workshops using spoken tutorials and
  • gives certificates on passing online tests.

For more details, please write to us.

Slide 11 :

Answers for THIS Spoken Tutorial

  • Do you have questions in THIS Spoken Tutorial?
  • Please visit this site.
  • Choose the minute and second where you have the question.
  • Explain your question briefly.
  • The Spoken Tutorial project will ensure an answer.
  • You will have to register to ask questions.
Slide 12:

Forum for specific questions:

  • The Spoken Tutorial forum is for specific questions on this tutorial.
  • Please do not post unrelated and general questions on them.
  • This will help reduce the clutter.
  • With less clutter, we can use these discussions as instructional material.
Slide 12:

Forum for specific questions:

  • Do you have any general / technical questions on OpenPLC?
  • Please visit the FOSSEE forum and post your question.
Slide 13:

Acknowledgement

Spoken Tutorial Project is funded by MHRD, Government of India.
Slide 14:

Thank you slide

This tutorial has been contributed by FOSSEE and Spoken Tutorial Project, IIT Bombay.

And this is Harsha Priyanka from FOSSEE team, signing off.

Thanks for watching.

Contributors and Content Editors

Nancyvarkey, Nirmala Venkat, Priyanka.guntaka123