(r8) IntroductionToNopIoTAndPython < AFNOG

Tags: view all tags
---+ %SLIDESHOWSTART%
---+ Introduction to Internet of Things (!IoT)
<h2 align="center">Session 1: Introduction to !IoT and Python<br /> <br />Isaac Armah-Mensah<br /> <br />University of Cape Coast, Ghana</h2>
---+ Introduction of Lecturers
   1 *Uli Raich -- Formally CERN, Geneva, Switzerland*
   1 *Isaac Armah-Mensah -- University of Cape Coast Ghana*
---++ 
---+ The TWiki server

All information about this tutorial is available on a TWiki server.

TWiki uses the same documentation format as Wikipedia.

This makes it very simple for the lecturer to provide on-line documentation,

which can be extended by students.

This is our Twiki server:

<a href="iotworkshop.africa" target="_blank">https://afnog.iotworkshop.africa/do/view</a>

Other pages for class resources

Micropython Demos:

https://github.com/uraich/MicroPython_IoTDemos and <br /> https://github.com/uraich/MicropythonCayenneMQTTClient <br /><br /> C++ version:<br /> https://github.com/uraich/C-IoTDemos <br /><br />
---++ 
---+ Workshop Page

<img align="text-bottom" alt="workshop.png" height="552" src="%ATTACHURL%/workshop.png" title="workshop.png" width="700" />
---++ 
---+ What is the “I” in !IoT ?

The “I” stands for Internet. This means:<br /><br />We need a processor (!IoT node) that can connect to the Internet. <br /><br />It must be powerful enough to run Internet protocols and<br /><br />it needs an interface to the Internet.<br /><br />
   * Ethernet interface<br /><br />
   * !WiFi interface<br /><br />
   * GSM
   * … connection to a gateway with access to the internet
---++ 
---+ Standard way to access the Internet

Usually the Internet is used by humans<br /><br />Typical applications are <br /><br />
   * WEB browsing<br /><br />
   * Email<br /><br />
   * Social media<br /><br />
   * Telephone and chats
Human to machine or human to human communication.<br /><br />!IoT: “Things” communicate also without human intervention.<br /><br />

---++ 
---+ Things, Sensors, Actuators
   * Coffee machines, dish washer, washing machine, …
   * Burglar alarm system
   * Intelligent farming
   * Weather station
   * Scientific measurements
   * Industrial factory control
   * Car electronics, ignition system, ABS,…
   * You name it!
The processor reads the state of “things” though sensors and controls them through actuators.

Our processor needs interfaces to these sensors and actuators.<br /><br />

---++ 
---+ The !IoT system

We need a system with a number of processors

that read out sensors and/or control actuators<br /><br />These processors communicate with each other

over the Internet with or without human intervention.

Design decisions:<br /><br />
   * Which processors?
   * Which communication protocol
   * Which GUI to be able to see what is going on?
   * Which programming language?
---++ 
---+ The Raspberry Pi
| The Raspberry Pi is a small computer powerful enough to run a full blown Linux operating system:<br /><br />A quad core 1.2 GHz Broadcom 64 bit ARM CPU<br /><br /> <ul> <li>1 Gbytes of Ram</li> </ul><ul> <li>Ethernet and wireless networks</li> </ul><ul> <li>4 USB2 ports</li> </ul><ul> <li>Micro SD connector</li> </ul><ul> <li>40 pin extended GPIO connector with</li> </ul><ul> <li>GPIO pins</li> </ul><ul> <li>SPI and !I2C bus interface</li> </ul><ul> <li>Cost ~ 80-100 US $</li> </ul><ul> <li>No ADC</li> </ul> | <img alt="rpiBoard.png" height="303" src="%PUBURL%/AFNOG/Slides:WhatIsNopIoT/rpiBoard.png" title="rpiBoard.png" width="214" /> |
---++ 
---+ Arduino + !WiFi shield

<img alt="arduinoSpecs.png" height="355" src="%PUBURL%/AFNOG/Slides:WhatIsNopIoT/arduinoSpecs.png" title="arduinoSpecs.png" width="1005" />
| <img alt="mega.png" src="%PUBURL%/AFNOG/Slides:WhatIsNopIoT/mega.png" title="mega.png" /> | <img alt="wifishield.png" src="%PUBURL%/AFNOG/Slides:WhatIsNopIoT/wifishield.png" title="wifishield.png" /> |
Total cost: ~12-15 US $

---++ 
---+ The ideal !IoT solution?
| ESP8266 or ESP32 processor board<br /><br />ESP8266 specs:<br /><br /> <ul> <li>WiFi on chip</li> </ul><ul> <li>10 bit ADC on chip</li> </ul><ul> <li>80 kByte RAM</li> </ul><ul> <li>4 Mbyte flash</li> </ul><ul> <li>Can run a Micropython interpreter</li> </ul><ul> <li>Can be programmed through the Arduino IDE</li> </ul><ul> <li>SPI, !I2C interfaces</li> </ul><ul> <li>11 GPIO pins</li> </ul><ul> <li>Many sensor and actuator boards</li> </ul><ul> <li>Can be plugged together without bread board or soldering</li> </ul><ul> <li>Cost of processor board: ~ 2.5 US$</li> </ul><br />ESP32 is even more powerful<br />Cost: ~ 4.5 US$ | <img alt="shields.png" src="%PUBURL%/AFNOG/Slides:WhatIsNopIoT/shields.png" title="shields.png" /> |
---++ 
---+ Communication

MQTT (Message Queuing Telemetry Transport: a publish-subscribe based<br /><br />Message protocol running of top of TCP.<br /><br />A processor can subscribe to messages of a certain “topic” and/or it can push its<br /><br />results on a certain topic

<img alt="mqttPostOfffice.png" height="267" src="%PUBURL%/AFNOG/Slides:WhatIsNopIoT/mqttPostOfffice.png" title="mqttPostOfffice.png" width="722" />

---++ 
---+ Programming language
   * Only the data recovered from the communication protocol is seen
   * Any programming language will do
   * Cayenne/MQTT libraries are available for <br /><br />
      * C, C++<br /><br />
      * Python<br /><br />
      * Java<br /><br />
      * Java Script
---++ 
---+ 
---+ Introduction to Python

The python programming language is a high level programming language that is very interactive and object oriented.

Python is an interpreted language which means that the statements which make up the python program is processed at run-time but not compiled first.

Python also supports object oriented programming style which employs the use of encapsulating codes within objects.

What can python be used for?
   * <p>Used to create web applications.</p>
   * <p>Used to connect to database systems.</p>
   * <p>It can be used to perform complex mathematics</p>
   * <p>It can be used in data analysis.</p>
If you want to learn Python, Try the Python tutorial!

For Python beginners: https://docs.python.org/3/tutorial/index.html <br /><br />and for everybody the Python docs: https://docs.python.org/3/index.html

---++ 
---+ Writing Python Programs

Python is a programming language that lets you work more quickly and integrate your systems more effectively.
   * <p>Python is powerful... and fast;</p>
   * <p>plays well with others;</p>
   * <p>runs everywhere;</p>
   * <p>is friendly & easy to learn;</p>
   * <p>is Open.</p>
Python programs can either be written using any standard editor like nano, emacs as a script or can be written from the python command line.

---++ 
---+ Using the Command Line (Interactive mode)

Simply type python in your terminal and press the enter key to start the interactive python mode.

Type print(“Hello world”). Hit enter and it prints Hello world on the screen.

<img alt="commandline.png" height="369" src="%ATTACHURL%/commandline.png" title="commandline.png" width="736" />

To exit from the interactive mode, type quit().
---++ 
---+ Using the script mode

<font face="Times New Roman, serif"><font size="3">Using the interactive mode doesn’t keep </font></font><font face="Times New Roman, serif"><font size="3">the</font></font><font face="Times New Roman, serif"><font size="3"> statements of code we wrote </font></font><font face="Times New Roman, serif"><font size="3">permanently </font></font><font face="Times New Roman, serif"><font size="3">. </font></font>

<font face="Times New Roman, serif"><font size="3">But in an ideal situation we might want to keep the codes for future reference. </font></font>

<font face="Times New Roman, serif"><font size="3">Hence we make use of an editor like the nano, emacs, </font></font><font face="Times New Roman, serif"><font size="3">etc</font></font><font face="Times New Roman, serif"><font size="3">. </font></font>

<img align="text-bottom" alt="helloworld.png" height="55" src="%ATTACHURL%/helloworld.png" title="helloworld.png" width="246" />

<img alt="helloworld2.png" height="100" src="%ATTACHURL%/helloworld2.png" title="helloworld2.png" width="709" />
---++ 
---+ Using Thonny

Instead of running a standard editor like nano or emacs you may want to run

an<b> I</b>ntegrated<b> D</b>evelopment <b>E</b>nvironment (IDE) created specifically for Python instead.

*Thonny is Easy to get started.* Thonny comes with Python 3.7 built in, <br />so just one simple installer is needed and you're ready to learn programming.

It is very suitable for beginners and programming micro-controllers

For basic description of Thonny check https://thonny.org/ and https://realpython.com/python-thonny/

Lets try _thonny_
---++ 
---+ Thonny Python Shell and Editor

Here you see the 2 idle windows.

The top one contains the editor, the second the Python shell

<img alt="thonny.png" height="628" src="%ATTACHURL%/thonny.png" title="thonny.png" width="700" />
---++ 
---+ Running a python script

Script in python can be run from the Linux command shell with:

_python3 scriptName_

or we can make it executable and run it like we would run

any compiled C program or any bash script:

<img alt="runpython.png" src="%ATTACHURL%/runpython.png" title="runpython.png" />
---++ 
---+ Command Line Arguments

<font face="Times New Roman, serif"><font size="3">Programs can be called with arguments.</font></font>

<font face="Times New Roman, serif"><font size="3">Python has a module that helps users parse command-line options and arguments. </font></font>

<font face="Times New Roman, serif"><font size="3">Many programs can be run to provide basic information about how they <br />should be run and it employs the use of command line arguments. </font></font>

<font face="Times New Roman, serif"><font size="3">The Python </font></font><font face="Times New Roman, serif"><font size="3"> *sys* </font></font><font face="Times New Roman, serif"><font size="3"> module provides access to any command-line arguments via the </font></font><font face="Times New Roman, serif"><font size="3"> *sys.argv* </font></font><font face="Times New Roman, serif"><font size="3">.</font></font>

<img alt="argscript.png" src="%ATTACHURL%/argscript.png" />

<img alt="runcmdlineArg.png" src="%ATTACHURL%/runcmdlineArg.png" title="runcmdlineArg.png" />
---++ 
---+ Variables

<font face="Times New Roman, serif"><font size="3">Variables are just memory allocations for storing values. </font></font>

<font face="Times New Roman, serif"><font size="3">Every variable created has a space in memory allocated for it.</font></font>

<font face="Times New Roman, serif"><font size="3">Based on the data type of a variable, the interpreter allocates memory and <br />decides what can be stored in the reserved memory. </font></font>

<font face="Times New Roman, serif"><font size="3">Python variables do not need explicit declaration to reserve memory space. </font></font>

<font face="Times New Roman, serif"><font size="3">The declaration happens automatically when you assign a value to a variable. </font></font>

<font face="Times New Roman, serif"><font size="3">The equal sign *(=)* is used to assign values to variables. </font></font>

<font face="Times New Roman, serif"><font size="3">The operand to the left of the = operator is the name of the variable and <br />the operand to the right of the = operator is the value stored in the variable. <br /></font></font>

<img alt="variable.png" height="483" src="%ATTACHURL%/variable.png" title="variable.png" width="700" />
---++ 
---+ Data Types in Python

Programs store data in one form or the other and must be of a certain type.

We discuss the following data types
   * Strings
   * Lists
   * Tuple
   * Dictionary
   * !ByteArray
---++ 
---+ Strings in Python

Strings in Python are identified as a contiguous set of characters represented in the quotation marks.

Python accepts either pair of single, double quotes and triples(single/double) quotes.

<img alt="string.png" height="532" src="%ATTACHURL%/string.png" title="string.png" width="700" />
---++ 
---+ List in Python

The list is a most versatile datatype available in Python.

It can be written as a list of comma-separated values (items) between square __[]__ brackets.

A list need not be of the same type.

The values present in a list are indexed starting from zero.

The values stored in a list can be accessed using the slice operator ([ ] and [:]) with <br />indexes starting at 0 in the beginning of the list and working their way to end -1.

<img alt="list.png" height="554" src="%ATTACHURL%/list.png" title="list.png" width="700" />
---++ 
---+ Tuple in Python

Tuples are much more like a list.

They are enclosed in brackets().

Their content cannot be changed unlike the list whose content can be changed.

Thus tuples are read only.

<img alt="tuples.png" height="371" src="%ATTACHURL%/tuples.png" title="tuples.png" width="700" />
---++ 
---+ Dictionary in Python

A dictionary is a collection which is unordered, changeable and indexed.

In Python dictionaries are written with curly brackets, and they have keys and values.

Python's dictionaries allow you to connect pieces of related information.

Each piece of information in a dictionary is stored as a key-value pair.

When you provide a key, Python returns the value associated with that key.

You can loop through all the key-value pairs, all the keys, or all the values.

<img alt="dict.png" height="453" src="%ATTACHURL%/dict.png" title="dict.png" width="700" />
---++ 
---+ Basic Operators

Python supports multiple operators including
   * arithmetic,
   * comparison,
   * assignment,
   * logical,
   * bitwise,
   * membership and
   * identity operators.
---++ 
---+ Arithmetic Operators:

The arithmetic operators supported by python is addition(+) , subtraction(-), <br />multiplication(!* *), division(/), modulus(%), exponent(!***)

<img alt="operators.png" height="257" src="%ATTACHURL%/operators.png" title="operators.png" width="700" />
---++ 
---+ Python Bitwise Operators

Bitwise operator works on bits and performs bit-by-bit operation

<img alt="binaryops.png" height="188" src="%ATTACHURL%/binaryops.png" title="binaryops.png" width="700" />
---++ 
---+ Conditional Statements

We have seen conditions already in the very first example

<img alt="if.png" height="141" src="%ATTACHURL%/if.png" title="if.png" width="300" />
---++ 
---+ Loops

A loop statement allows us to execute a statement or group of statements multiple times.

Python has two primitive loop commands:
   * while loop
   * for loops
<img alt="loops.png" height="537" src="%ATTACHURL%/loops.png" title="loops.png" width="600" />
---++ 
---+ Functions

Programs are written in blocks of codes which are reusable but performs similar actions.

Python comes with builtin functions such as *print().*

Users can define and use their own functions in the code.

User defined functions begin with the keyword <b>def </b>followed by the name of the function.

A function may take parameters

<img alt="function.png" height="375" src="%ATTACHURL%/function.png" title="function.png" width="600" />
---++ 
---+ Modules

Modules in a python are file with <i><b>.py </b></i>extensions containing <br /><br />definitions of functions or variables.

We may want to keep function definitions in separate files

and use these definitions in several main programs.

In our example of the functions we can save the definitions in a file called function.py

In order to use the definitions we must import them with

_import function_

In order to call the functions we have to use the module name:

_function.sum(20,30)_

or if we we want to import a single function:

_from function import sum_

_sum(20,30)_

The module name is found in the variable __name__
---++ 
---+ Modules Examples

<img alt="modules.png" height="316" src="%ATTACHURL%/modules.png" title="modules.png" width="500" />
---++ 
---+ Executing Modules

Often modules contain only function or class (see later) definitions

However it is also possible to include the function calls (the main routine)

into the module e.g. to demonstrate how the functions are to be used.

In this case the name of the module changes to<i> __main__<b><br /></b></i>

We can therefore find out if the module is imported or executed by checking the name variable:

_if <b> _name__ </b> == "__main__"

this executes the main code only if not imported into a main program
---++ 
---+ Packages

Packages simple group of modules under one name.

Each package is a directory which <b>MUST </b>contain a a specific file calle

*__init__.py* which indicating the directory is a package.

the __init__.py file may be empty.

Package can be imported the same way as module.

Suppose we have several modules prime.py, fibonacci.py, factorial.py

in a directory, we may group them in a package called priff.

<img alt="package.png" height="136" src="%ATTACHURL%/package.png" title="package.png" width="250" />
---++ 
---+ Classes<b><br /></b>

Almost everything in Python is an object, with its properties and methods.

A class defines the behavior of an object and the kind of information an object can store.

The information in a class is stored in attributes, and functions that belong to a class are called methods.

A child class inherits the attributes and methods from its parent class.
---++ 
---+ Creating Classes

The syntax for creation of classes is similar to functions<br /><br />

<img alt="class.png" height="128" src="%ATTACHURL%/class.png" title="class.png" width="300" />

You may define a method with name <i>__init__</i>which is called when

the instance object of the class is created (in the above example: mc = !&lt;a href="https://afnog.iotworkshop.africa/do/edit/AFNOG/MyClass?topicparent=AFNOG.IntroductionToPython;nowysiwyg=0" rel="nofollow" title="MyClass (this topic does not yet exist; you can create it)"&gt; MyClass &lt;/a&gt; ()

The short description of the class can be found in the instance variable <i>_ _doc__</i>
---++ 
---+ Classes Example

<img alt="classes.png" height="679" src="%ATTACHURL%/classes.png" title="classes.png" width="600" />
---++ 
---+ Libraries

Libraries are a collection python packages that are found in different that gives a package hierarchy.

The only difference is python libraries or packages have a __init__.py file present in its directories.

A very typical example of a python library is matplotlib for plotting<b>. </b>

<img alt="plot.png" height="371" src="%ATTACHURL%/plot.png" title="plot.png" width="500" />
---++ 
---+ Callbacks

<img alt="callback.png" height="195" src="%ATTACHURL%/callback.png" title="callback.png" width="500" />

<br />%SLIDESHOWEND%

-- %USERSIG{IsaacArmahMensah - 2019-05-30}%

---++ Comments

<br />%COMMENT%
Attachments
Topic attachments
I	Attachment	History	Action	Size	Date	Who
png	argscript.png	r1	manage	29.7 K	2019-06-09 - 03:30	IsaacArmahMensah
png	binaryops.png	r1	manage	130.0 K	2019-06-10 - 20:46	IsaacArmahMensah
png	callback.png	r1	manage	57.3 K	2019-06-11 - 01:24	IsaacArmahMensah
png	class.png	r1	manage	45.2 K	2019-06-11 - 00:54	IsaacArmahMensah
png	classes.png	r1	manage	160.5 K	2019-06-11 - 00:54	IsaacArmahMensah
png	commandline.png	r2 r1	manage	61.2 K	2019-06-09 - 02:44	IsaacArmahMensah
png	commandlinearg.png	r1	manage	15.5 K	2019-06-09 - 03:21	IsaacArmahMensah
png	dict.png	r1	manage	193.5 K	2019-06-10 - 20:24	IsaacArmahMensah
png	function.png	r1	manage	160.2 K	2019-06-10 - 22:50	IsaacArmahMensah
png	helloworld.png	r2 r1	manage	5.8 K	2019-06-09 - 02:24	IsaacArmahMensah
png	helloworld2.png	r2 r1	manage	22.0 K	2019-06-09 - 02:25	IsaacArmahMensah
png	idle.png	r1	manage	105.5 K	2019-06-09 - 02:57	IsaacArmahMensah
png	idlescript.png	r1	manage	39.8 K	2019-06-09 - 03:03	IsaacArmahMensah
png	idleshell.png	r1	manage	33.7 K	2019-06-09 - 03:03	IsaacArmahMensah
png	if.png	r1	manage	45.2 K	2019-06-10 - 21:19	IsaacArmahMensah
png	list.png	r2 r1	manage	198.2 K	2019-06-10 - 20:28	IsaacArmahMensah
png	loops.png	r1	manage	150.9 K	2019-06-10 - 21:19	IsaacArmahMensah
png	modules.png	r1	manage	85.7 K	2019-06-10 - 22:50	IsaacArmahMensah
png	operators.png	r1	manage	113.4 K	2019-06-10 - 20:47	IsaacArmahMensah
png	package.png	r1	manage	33.5 K	2019-06-10 - 22:52	IsaacArmahMensah
png	plot.png	r1	manage	96.1 K	2019-06-11 - 01:00	IsaacArmahMensah
png	runcmdlineArg.png	r1	manage	26.0 K	2019-06-09 - 03:30	IsaacArmahMensah
png	runpython.png	r1	manage	102.6 K	2019-06-09 - 03:14	IsaacArmahMensah
png	string.png	r3 r2 r1	manage	231.9 K	2019-06-10 - 20:28	IsaacArmahMensah
png	thonny.png	r1	manage	121.5 K	2019-06-09 - 21:02	IsaacArmahMensah
png	tuples.png	r1	manage	170.7 K	2019-06-10 - 20:24	IsaacArmahMensah
png	variable.png	r4 r3 r2 r1	manage	217.1 K	2019-06-10 - 22:59	IsaacArmahMensah
png	workshop.png	r1	manage	250.4 K	2019-05-30 - 06:02	IsaacArmahMensah
Topic revision: r8 - 2019-06-11 - IsaacArmahMensah