A 2 day tutorial with hands-on exercises

held during AFNOG 2018 in Dakar, Sénégal

Uli Raich (uli.raich@gmail.com)

Typical applications where:

• Email
• Remote login
• File transfers

With cheaper and more powerful micro-controllers devices can communicate with each other

or with centralized servers over the network and they can observe their environment

with dedicated sensors.

This is what we call the Internet of Things (IoT)

containing just a single CPU and address and data lines + a few control lines to interface

to external memory and I/O interfaces, typically : a serial and a parallel port.



The price for the chip was 176 US $.

The development board was sold for 300 US $.

You got 256 bytes of RAM, 2kBytes of EPROM and the serial and parallel port.

Programming was done in assembly language or even straight machine code.

No Internet!

The user community is huge and is now increased by another 15 users!

An enormous wealth of information on all sorts of subjects using the Raspberry Pi

can be found on the WEB.

The official site is

https://www.raspberrypi.org

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:

https://afnog.iotworkshop.africa/do/view

And this is what you get:

• a serial interface
• I2C
• SPI

On the micro SD card (or a memory stick on one of the USB slots) you can install

a full-blown Linux operating system

(for the Windows gurus: there is also a Windows version)

All you need to have a stand alone computer is

• an HDMI screen
• a USB keyboard and mouse

• in C or C++
• Python
• or any language that Linux supports … and there are many!

keyboard and mouse and use it in stand-alone mode

but we can also make use of the PC resources and access it remotely

There are several ways to access the RPI remotely:

Using the VNC server on the Pi you can access it with a remote desktop from the PC

The secure shell (ssh) allows you to get a remote terminal in the Pi

With scp you can copy files back and forth between the Pi and the PC

With nfs you can mount part of the Pi file system into the PC file system tree

and access the PI SD card as if it was a local PC disk.

connected to the RPI and the keyboard by this computer's keyboard. The connected computer

acts like a graphics terminal for the RPI.

You see on the computer exactly what you would see on a directly connected screen.

The command is:

ssh userOnPi@piIPaddress

Where piIPaddress can be the Pi’s IP address or host name.

If you specify the -X option you can run X-11 based programs where

the X protocol is run over the ssh connection.

For Windows computers you need PuTTY in conjunction with

an X server (e.g. Xming) to connect to the RPi

started an emacs session on the Pi

We use a flat cable and a “cobbler” to bring these signals onto a bread board

where we can build our own electronic circuits for acquisition or control by the Rpi.

Libraries in C/C++, Java and Python are available easing software access to these signals.

a large number of programming languages.

One of the most fashionable languages is Python.

Python is an interpreted language and code can be entered into a Python interpreter

which executes it immediately. Like this, Python can e.g. be used as a calculator.

It is however also possible to write whole programs (scripts) which the interpreter executes

Want to learn Python? Try the Python tutorial!

We will attempt to learn the language in 2 h!

The quit() function exits the interpreter

an Integrated Development Environment (IDE) created specifically for Python instead.

Try idle

The same thing as a script in idle

Here you see the 2 idle windows.

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

python scriptName

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

any compiled C program or any bash script:

However, in Python you do not need to declare the variables.

The interpreter finds the right type by itself.

Here an example:

As you can see, there are no braces around the conditional block but it is indented
# indicates an comment
In addition to the if statement above we have elif and else

Here is the example of a while loop which calculates the Fibonnaci series:

This program uses multiple assignments a,b are assigned in the same line
Again you can see that the block starts with “:” and is indented.

Lists may contain different data types but usually all members of lists have the same type.

Lists have similar properties as strings:

• define sub-lists
• get the length of lists
• concatenate lists

Append, extend, remove, pop, index, count, sort … Have a look at the tutorial for details

The are also further complex data structures which we don’t have the time to go into:

• tuples
• sets
• dictionaries

Using the range function you can create the same type of for loops we know from C.

Keywords like continue and break have the same meaning.

pass does nothing and is used only where a statement is syntactically needed

... and the result:

and call them later in your program

and use these definitions in several main programs.

In our example of the Fibonacci numbers we can save the definitions in a file called fibo.py

In order to use the definitions we must import them with

import fibo

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

fibo.fib(20)

or if we we want to import a single function:

from fibo import fib

fib(20)

The module name is found in the variable __name__