##################################################
Intrusion Detection on Shunya OS Demo using OpenCV
##################################################

Introduction
############

Intrusion Detection in a particular region of interest on a board with Shunya OS.

Intrusion Detection on a board with Shunya OS allows user to detect motion in a particular region of interest at any remote location. It also sends images back to the user if a motion is detected in that region of interest with the help of mqtt.

Hardware required:
------------------

-  A board with Shunya OS
-  USB Video Camera
-  PC

Pre-requisites for a board with Shunya OS:
-------------------------------------------

-  paho-mqtt
-  python3
-  python3-pip
-  imutils
-  OpenCV on python3

Except for OpenCV on python3 all the other pre-requisites can be installed by running these commands

::

   sudo apt-get update
   sudo apt install python3-dev python3-pip git
   pip3 install imutils paho-mqtt

Pre-requisites for PC/Laptop:
-----------------------------

This project has these software pre-requisites to run on PC/Laptop.

-  paho-mqtt
-  python3
-  python3-pip

::

   sudo apt-get update
   sudo apt install python3-dev python3-pip git
   pip3 install paho-mqtt

Steps for the Intrusion Detection Demo:
#######################################

To run a demo of this project please follow these steps. We assume that you have already installed the pre-requisites before following these
steps

Step 1 : Cloning the Project
----------------------------

On PC/Laptop run command to clone this project

::

   $ git clone https://github.com/shunyaos/intrusion_detection_hikey960_demo.git

On a board with Shunya OS run command to clone this project

::

   $ git clone https://github.com/shunyaos/intrusion_detection_hikey960_demo.git

Step 2: Starting MQTT on PC/Laptop
----------------------------------

Run the mqtt_client_demo.py present in the pc folder

::

   $ cd intrusion_detection_hikey960_demo/pc
   $ python3 mqtt_client_demo.py

Step 3: Starting the Demo on a board with Shunya OS
---------------------------------------------------

::

   $ cd intrusion_detection_hikey960_demo
   $ python3 trial.py

As soon as you run the code the a ROI selector window will open. Select the Region of interest in which you want to detect any motion with the mouse and press Enter. As any motion is detected in the ROI, it captures.