View source for OpenPLC-with-LDmicro/C2/Programming-OpenPLC/English


{| style="border-spacing:0;"
| style="border:1pt solid #000000;padding:0.176cm;"| <center>'''Visual Cue'''</center>
| style="border:1pt solid #000000;padding:0.176cm;"| <center>'''Narration'''</center>

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Slide 1: 
Welcome Slide
| style="border:1pt solid #000000;padding:0.176cm;"| Welcome to the spoken tutorial on '''Programming OpenPLC'''.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Slide 2: 

Learning Objectives

* How to program the OpenPLC Mainboard

| style="border:1pt solid #000000;padding:0.176cm;"| In this tutorial, we will learn how to '''program''' the '''OpenPLC Mainboard'''
|-
| style="border:1pt solid #000000;padding:0.176cm;"| Slide 3: 

System Requirements

* '''Ubuntu Linux 18.04''' operating system
* '''OpenPLC Mainboard'''
* 24V, 2A '''SMPS'''
* '''USBasp programmer'''

| style="border:1pt solid #000000;padding:0.176cm;"| To record this tutorial I am using:

* '''Ubuntu Linux''' 18.04 operating system
* '''OpenPLC Mainboard'''
* '''24V, 2A SMPS'''
* '''USBasp programmer'''

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Slide 4: 

Pre-requisites

* How to generate a '''hex file''' of a '''ladder''' diagram in '''LDmicro'''. 
* If not, please refer to the relevant tutorials from [https://spoken-tutorial.org/ Home | spoken-tutorial.org]

| style="border:1pt solid #000000;padding:0.176cm;"| To follow this tutorial, you should know

* How to generate '''hex file''' of a '''ladder''' diagram in '''LDmicro'''. 
* If not, please refer to the relevant tutorials in this series on this website.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| 
| style="border:1pt solid #000000;padding:0.176cm;"| Now, we’ll see how to upload a '''program''' to '''OpenPLC Mainboard'''.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Slide 5: Code file - sample.hex

* The files used in this tutorial are available in the '''Code Files''' link on this tutorial page
* Please download and extract them
* Make a copy and then use them while practising

| style="border:1pt solid #000000;padding:0.176cm;"| We will use the '''sample.hex '''file which was created earlier.

* The files used in this tutorial are available in the '''Code Files''' link on this tutorial page.
* Please download and extract them
* Make a copy and then use them while practising

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Slide6:

USBasp-programmer.jpg
| style="border:1pt solid #000000;padding:0.176cm;"| We are using a '''USBasp''', to '''program''' our '''Mainboard'''.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Slide 7: 

Mainboard-computer-connection.jpg
| style="border:1pt solid #000000;padding:0.176cm;"| Make the connections as shown in the picture.

Connect '''SMPS''' and '''USBasp''' to the '''Mainboard''' as shown here.

Recall that we have explained these connections in the earlier tutorials.

Turn on the '''power supply'''.

Make sure that one of the '''LEDs''' on '''USBasp''' is glowing.

This indicates that the '''programmer''' is connected properly.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| 
| style="border:1pt solid #000000;padding:0.176cm;"| Open the '''terminal''' by pressing '''CTRL+ALT+T''' keys simultaneously.

If you’re a '''Windows''' user open '''command prompt'''.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Type cd Desktop/LDmicro

Press ENTER
| style="border:1pt solid #000000;padding:0.176cm;"| Type '''cd Desktop/LDmicro''' and press '''Enter'''.

I have saved a file '''sample.hex '''in the above folder.

Go to the location where you’ve saved the '''hex file'''.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Type, 

'''avrdude -c usbasp -p m16 -U flash:w:sample.hex'''
| style="border:1pt solid #000000;padding:0.176cm;"| Now type the '''command''' as shown.

For uploading the '''program''' we are using a '''command line tool, AVRDUDE'''

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Highlight according to narration
| style="border:1pt solid #000000;padding:0.176cm;"| '''hyphen c''' indicates the '''programmer id''' of the '''programmer'''.

Since we are using an USBasp programmer, here the '''id''' is given as '''usbasp'''.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Highlight according to narration
| style="border:1pt solid #000000;padding:0.176cm;"| '''hyphen p''' indicates the part number of the '''microcontroller''' that we are using.

In our case it is '''ATMEGA16'''. 

So we have specified it as '''m16'''.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Highlight according to narration
| style="border:1pt solid #000000;padding:0.176cm;"| '''hyphen capital U''' handles all '''memory read''' and '''write''' operations.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Type flash
| style="border:1pt solid #000000;padding:0.176cm;"| '''flash '''indicates the '''flash memory''' and '''w '''indicates the '''write''' operations.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Highlight according to narration
| style="border:1pt solid #000000;padding:0.176cm;"| '''sample.hex''' is the file that we want to upload.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Press ENTER
| style="border:1pt solid #000000;padding:0.176cm;"| Press '''ENTER.'''

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Highlight red light
| style="border:1pt solid #000000;padding:0.176cm;"| We can see another '''LED''' on the '''USBasp''' is blinking.

This indicates that it is communicating with the '''Mainboard''' appropriately.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Highlight avrdude: 364 bytes of flash verified 
| style="border:1pt solid #000000;padding:0.176cm;"| In the '''terminal''', we get '''avrdude: 364 bytes of flash verified''' 

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Highlight the output
| style="border:1pt solid #000000;padding:0.176cm;"| Note that the number of '''bytes''' varies from '''program''' to '''program'''.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| 
| style="border:1pt solid #000000;padding:0.176cm;"| If you don’t get either of the indications, it means that '''programming''' isn’t done properly.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Slide 8:

Additional Reading Material
| style="border:1pt solid #000000;padding:0.176cm;"| Refer to the '''Additional reading material''' of this tutorial to know more about:

# Precautions that should be taken before '''programming'''.
# Ways of troubleshoot when the '''Mainboard''' is not '''programmed''' properly.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| 
| style="border:1pt solid #000000;padding:0.176cm;"| Let us see various part numbers for different '''controllers''' & '''programmers'''.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Slide 9: Controller’s part number list

List of part number for Controllers and Programmers is given in the below link:

[https://www.nongnu.org/avrdude/user-manual/avrdude_4.html#Option-Descriptions https://www.nongnu.org/avrdude/user-manual/avrdude_4.html#Option-Descriptions]


Highlight with box
| style="border:1pt solid #000000;padding:0.176cm;"| Go to the given link.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Highlight m16

Highlight usbasp
| style="border:1pt solid #000000;padding:0.176cm;"| In this tutorial, we have used '''ATmega16'''. 

We can observe that the part '''id''' is '''m16 '''according to the list.

The part '''id''' of '''USBasp programmer''' as '''‘usbasp’'''.

You can refer to this manual, if you are using a different '''microcontroller''' or '''programmer'''.

It also contains the information of the '''command line''' options to '''control AVRDUDE’s''' behavior.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| 
| style="border:1pt solid #000000;padding:0.176cm;"| This brings us to the end of this tutorial. 

Let us summarize.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Slide 10:

Summary

We have learnt how to

* Program the '''OpenPLC Mainboard'''

| style="border:1pt solid #000000;padding:0.176cm;"| In this tutorial, we learnt to '''program''' the '''OpenPLC Mainboard'''

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Slide 12:

About Spoken Tutorial project
| style="border:1pt solid #000000;padding:0.176cm;"| The video at the following link summarises the Spoken Tutorial project.

Please download and watch it.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Slide 13:

Spoken Tutorial workshops
| style="border:1pt solid #000000;padding:0.176cm;"| The''' Spoken Tutorial Project''' team:

* conducts workshops using spoken tutorials and
* gives certificates on passing online tests.

For more details, please write to us.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Slide 14:

Forum for specific questions:
| style="border:1pt solid #000000;padding:0.176cm;"| 
* Please post your timed queries in this forum.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Slide 15:

Forum for specific questions:
| style="border:1pt solid #000000;padding:0.176cm;"|
* Do you have any general / technical questions on '''OpenPLC'''?
* Please visit the '''FOSSEE''' forum and post your question.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Slide 16:

Acknowledgement
| style="border:0.5pt solid #000000;padding:0.176cm;"| Spoken Tutorial project is funded by MHRD, Government of India.

|-
| style="border:1pt solid #000000;padding:0.176cm;"| Slide 17:

Thank you slide
| style="border:1pt solid #000000;padding:0.176cm;"| 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.

|}