View source for OpenPLC-version1-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: 
| 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 version 1 Mainboard

| style="border:1pt solid #000000;padding:0.176cm;"| In this tutorial, we will learn

* How to program the '''OpenPLC''' '''version 1 Mainboard'''
|-
| style="border:1pt solid #000000;padding:0.176cm;"| Slide 3: 

System Requirements

* Ubuntu Linux 18.04''' '''operating system
* OpenPLC version 1 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''' '''version 1''' '''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 version 1 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;"| -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;"| '''-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;"| '''-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 version 1 Mainboard

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

* Program the '''OpenPLC version 1 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.

|}