README.md

Koic

Desciption

Koic is a connected scarecrow which is equipped with cameras that film the terrain in real time.
The filmed images are then analysed. Depending on the animal that is hit, the scarecrow will choose a suitable way to repel it in a natural way.

Summary

• Desciption
• Summary
• Install
  • 🚀 Clone repository
  • ⚠️ Requirement
  • 📱 The Expo Client App
  • 🍓 Raspi installation
    • Enabling the Camera
      • Using the desktop
      • Using the command line
    • Controlling the pi remotely
• Quick Start
• Detailed launch
  • Back-End / Consumer Kafka
  • Producer Kafka
  • Front-End / Mobile App
• Features
  • Application
  • Scarecrow connected
• Explain
• Authors

Install

🚀 Clone repository

You have to clone the repo on the Raspberry Pi and your computer.

git clone [email protected]:PoCInnovation/Koic.git

⚠️ Requirement

• Node
• Yarn
• Docker
• Docker-compose
• Have a Raspberry Pi and its camera module (PiCamera)

📱 The Expo Client App

The Expo App will load the build bundle of the Expo CLI and allow you to test our app without deploying it or building with Android Studio.

Download links:

• iOS
• Android

🍓 Raspi installation

Enabling the Camera

Using the desktop

If you are new to raspberry I advise you to follow this tutorial:

• Getting started with the Camera Module

Using the command line

Open the raspi-config tool from the terminal:

sudo raspi-config

Select Interfacing Options then Camera and press Enter. Choose Yes then Ok. Go to Finish and you’ll be prompted to reboot.

Controlling the pi remotely

Your raspberry pi and your computer must be on the same network.

Get your ip address like this:

hostname -I | cut -d' ' -f1

Once you have the address, establish the ssh connection with your raspberry pi:

ssh pi@<ip_address_raspberry_pi>

Quick Start

1. Run launch programm ./launch.sh
2. Create Kafka Cluster on http://localhost:9000/addCluster
3. Run Kafka Producer (raspberry pi or on your computer)
4. Run Mobile-App

Detailed launch

Back-End / Consumer Kafka

⚠️ Change variable REPLACE_BY_YOUR_IP by your computer address ip in:

• koic-app/.env
• RPIProducer/manager.py

./launch.sh

Create kafka cluster on your http://localhost:9000/addCluster

Like this:

And save.

Producer Kafka

Check that the above steps have been carried out.
If you would test without pi run his command:

./RPIProducer/tests/fake_producer.py

Run the kafka producer on raspberry pi:
Put the script on raspberry pi with this command:

./rpi.sh {ip_of_your_raspi}

The programm was copied in Dowloads folder

# Kafka Producer / on rasberry pi
python3 run.py

Front-End / Mobile App

In koic-app/.env change ip by your ip address.

cd koic-app/
npm install --global expo-cli
yarn install
yarn start

Scan the QR code displayed in your terminal with your phone

Features

Application

The application is divided by a tab that allows you to navigate between the different features like :

• Be able to view the activity on the field in real time thanks to the cameras placed on it.

• View and graph the data collected and analyse the behaviour of the pests.

• Make adjustments to the entire application and the cameras.

• Report a problem and able to contact support.

Scarecrow connected

• Cameras that can film the field in real time and send information that is processed by an API and sent to the application

Explain

1. Architecture Scheme
2. Back End custom

Authors

Thomas Michel	Inès Maaroufi	Coline Seguret

Organization

🚀 Don't hesitate to follow us on our different networks, and put a star 🌟 on PoC's repositories.