SCHOOL OF COMPUTING (SOC)

ST0324 Internet of Things

IOT CA2 McSausage Step-by-step Tutorial

Table of Contents

• Section 1 Introduction
• Section 2 Hardware Requirements
• Section 3 Hardware Setup
• Section 4 Software Requirements
• Section 5 Software Setup Requirements
• Section 6 Project Architecture
• Section 7 Web Interface
• Section 8 How it should work
• Section 9 Bonus Feature
• Section 10 References

Section 1 Introduction

What is McSausage about?

This application is a smart classroom setup. With this application, more energy will be saved as the lights in a classroom will be turned off automatically once there is no one detected in the room. In addition to that, our attendance taking system will also be more secured as students would not be able to ask their friends to help them take attendance. This is because each student needs to use their own NFIC card to tap in and pass the facial recognition, in order for the system to record their attendance. If the student is early or on time, a green light will be turned on, with an attendance of on time. If they are late, a yellow light will be turned on, with an attendance of late. However, if they turn up after the class has ended, a red light will appear and their attendance will be marked as absent. If they tap their card for a wrong classroom, the red light will appear as well as a text saying ‘You don’t belong in this class!’ will appear on the LCD. A live stream video of the classroom is also available for the lecturers to double check if there is anyone in the classroom remotely.

How it should looks like?

Section 2 Hardware Requirements

Hardware Checklist?

Component	Number of Items
NFC Card Reader	1
NFC Card	Minimum 1
Buzzer	1
Resistor	5
LED	4
Light Sensor w/MCP3008 ADC	1
PiCamera	1
Wire	At least 33

Section 3 Hardware Setup

Please do ensure that all the items is present and setup properly.

Classroom 1 to 3
LCD Screen Light Sensor w/MCP3008 ADC RPi PiCamera Buzzer RFID Card Reader RFID Card Green LED Yellow LED x2 Red LED Wire x35 Buzzer Resistor x5

Section 4 Software Requirements

Below is a list of which library is imported to ensure that it will work properly:

Classroom 1 to 3
telegrambot.py	read_rfid.py	web_streaming.py	lightval.py	blynk.py
import telepot from gpiozero import LED time import sleep from gpiozero import Buzzer from rpi_lcd import LCD	import RPi.GPIO as GPIO import MFRC522 import signal from rpi_lcd import LCD from time import sleep from gpiozero import Buzzer, LED from picamera import PiCamera from twilio.rest import Client	import picamera import io import logging import SocketServer from threading import Condition from BaseHTTPServer import BaseHTTPRequestHandler, HTTPServer	import RPi.GPIO as GPIO from AWSIoTPythonSDK.MQTTLib import AWSIoTMQTTClient time import sleep from gpiozero import MCP3008	import time from gpiozero import MCP3008, LED from blynkapi import Blynk from time import sleep from rpi_lcd import LCD

Section 5 Software Setup Requirements

First, to deploy the web application, the Flask library is needed to installed. The command is

sudo pip install flask

Next, since we are using PiCam. We will need to enable the camera inside raspberry pi configuration. Below are the steps to enable the camera:

• Go to Menu
• Preferences
• Raspberry Pi Configuration
• Ensure the Camera under the interface tab is enable
• Lastly, reboot it

Next, to implement the LCD screen, rpi_lcd library need to be installed. The command to installed is:

sudo pip install rpi-lcd

Next, to implement NFC Card Reader, LCD, LDR and other basic functions to work. You will first need to ensure SPI under Raspberry Pi Configuration. In which you can follow the step from the PiCam. Which is enabled under the same place. Afterwards, you will need to install a few libraries. Which are:

<< Install RPI LCD >>

sudo apt-get install rpi-lcd

<< Install Python-dev >>

sudo apt-get install python-dev

<< Install SPI-Py Library >>

git clone https://github.com/lthiery/SPI-Py.git
cd ~/SPI-Py
sudo python setup.py install 

<< Install MFRC522 Python Library >>

git clone https://github.com/pimylifeup/MFRC522-python.git
cd to the main folder and enter the follow to paste the clone files
sudo cp `/MFRC522-python/mfrc522/*.py~/(type in the main folder name)'

<< Install AWS Client >>

sudo pip install awscli

<< Install Botocore >>

sudo pip install botocore

<< Install Boto3 >>

sudo pip install boto3 -upgrade

Lastly, is the additional features software requirement. Which are Twilio(To send SMS to users), Blynk (Control sensors with mobile phone) and Telegram Bot(Control sensors through Telegram). The commands are:

<< Twilio >> After signing up an account

sudo pip install twilio

<< Blynk >> Download and sign up an account

Save the auth token
sudo pip install blynkapi --upgrade

<< Telegram Bot >>

sudo pip install telebot

Section 6 Project Architecture

Section 7 Web Interface

Login Page

In order for the audience to login to the app to view the classes. You will need the username and password that we created by default. Therefore, please enter the following to enter the web application.

• Username: pi
• Password: robots1234

Main Page (Classroom 1 to 3)

There will not be image of other classes as the interface is exactly the same as Classroom 1.

Section 8 How it should work

1. When the student tapped their card, there will be a buzzer sounding off.
2. If the Red LED light up, it means that the student doesn't belong to the class.
3. However, if the student were to belong in the class the student were have to face the PiCam to allow the facial recognition to check if it matches the correct student.
4. If there is a student that had tapped in, the Yellow LED light that is not placed together with the other LED will light up to represent classroom light being turn on.
5. If the Yellow LED among the three LED were to light up, it means that student is late. Red LED represent absent as the student tapped in later than the class end time. Green LED represent early for class.

Section 9 Bonus Feature

• Telegram Bot that allows users to on and off lights remotely
• Blynk moblie application that allows users to on and off light remotely
• Twilio SMS to alert users who entered/left the classroom
• AWS SNS Notification(Email) to alert who entered and left the classroom
• Login Page
• AWS Facial Recognition
• Video live stream to show who's in each of the classroom

Section 10 References

All IOT Practicals

Rita Łyczywek. [2018]. How to write a good README for your GitHub project?. [ONLINE] Available at: https://bulldogjob.com/news/449-how-to-write-a-good-readme-for-your-github-project [Accessed 21 Aug 2019]