🏎️ Line Follower

<div align="center"> <img width=450px src="https://github.com/Bar2-Banzin/linefollower/assets/71986226/0cc255df-21d9-463a-be87-6945817ff2a5" alt="logo">

God save Azza. 🏎️

</div> <p align="center"> <br> </p>

📝 Table of Contents

• <a href ="#about"> 📙 Overview</a>
• <a href ="#components"> :money_with_wings: Components & cost</a>
• <a href ="#parts"> ⚙️ Parts</a>
  • <a href ="#app"> 📱 App</a>
  • <a href ="#car"> 🚗 Car</a>
• <a href ="#integration">🤖 Integration</a>
• <a href ="#contributors"> ✨ Contributors</a>
• <a href ="#license"> 🔒 License</a>

<hr style="background-color: #4b4c60"></hr>

<a id = "about"></a>

📙 Overview

<ul> <li>Azza is a line follower robot and it's target is to finish track as fast as possible</li> <li>There is a mobile App that helps Azza to find straight lines to run with the max speed. The app communicates with Azza by bluetooth </li> <li>Azza can accomplish this by utilising a combination of closed-loop controllers such as PID and a variety of conditions</li> <li>🎉 This project ranked 1st place among 7 teams. </li> <li>This project is built using. </li> <ul> <li><a href="https://docs.arduino.cc/">Arduino</a></li> <li><a href="https://docs.flutter.dev/">Flutter</a></li> <li><a href="https://devdocs.io/cpp/">C++</a></li> </ul> <li> The Project have 2 parts </li> <ul> <li> <a href ="#app"> 📱 App</a></li> <li> <a href ="#car"> 🚗 Car</a></li> </ul> </ul> <hr style="background-color: #4b4c60"></hr> <a id = "Components"></a>

💸 Components & cost

| Name| Number | Market Cost per Part | | -------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------- | | Arduino Uno | 1 | 356 EGP | | l298 motor driver | 1 | 60 EGP | | DC Motor | 2 | 35 EGP | Car chassis | 1 | 65 EGP | Train sensor | 1 | 130 EGP | Wheel | 2 | 30 EGP | Caster Wheel | 1 | 35 EGP|

Total Budget = 776 EGP

Note: All prices are recorded in 2023

<hr style="background-color: #4b4c60"></hr>

<a id = "parts"></a>

🤖 Parts

<a id = "app"></a>

📱 APP

<ul> <li>App finds straight lines to help Azza drive with the highest speed</li> <li>App should be fixed while running </li> <li>App is built using flutter and uses Dart FFI to connect to image processing code </li> <li>Image processing code is built using C++ </li> <li>A red & yellow paper help us to know front and back od the car. Front of the car is red. Back of the car is yellow.</li> <li>Path of App </li> <br> <table> <thead> <th>Screen</th> <th>Description</th> </thead> <tr> <td><img height="300px" width="175px" src="https://github.com/Bar2-Banzin/linefollower/assets/71986226/37328444-a9c4-4be9-88f6-2b8c5022c0c6"></td> <td><ul><li>Start Screen</li> <li>Press start button to use app </li> </ul></td> </tr> <tr> <td><img height="300px" width="175px" src="https://github.com/Bar2-Banzin/linefollower/assets/71986226/99c76bc0-47ef-4cc3-b282-d5d9ff3b13e5"></td> <td><ul><li>Connect to the bluetooth </li> <li>Most of time it will HC-05 </li> </ul></td> </tr> <tr> <td><img height="300px" width="175px" src="https://github.com/Bar2-Banzin/linefollower/assets/71986226/568247a6-c5d7-4d90-baa9-d52ca39e3b93"></td> <td><ul><li>Take picture to the track when it is empty </li> <li>You can zoom in or zoom out</li> <li>Press on camera when you want to take picture</li> </ul></td> </tr> <tr> <td><img height="300px" width="175px" src="https://github.com/Bar2-Banzin/linefollower/assets/71986226/0660fc50-d9bb-487d-882b-43ccca614e08"></td> <td><ul><li>You can zoom in or zoom out</li> <li>When press on camera start streaming and detect car on straight road or not </li> <li>Output:</li> <ul> <li>0 => not in straight road</li> <li>1 => in straight road</li> <li>5 => can't find car</li> </ul> </ul></td> </tr> </table>

Note: Mobile should be fixed while running program

<li>Result of image processing</li> <br> <table> <thead> <th>Input</th> <th>Output</th> </thead> <tr> <td width="50%"><img src="https://github.com/Bar2-Banzin/linefollower/assets/71986226/6d917e1c-f362-44ae-a1b7-ec417c82741e"></td> <td><img src="https://github.com/Bar2-Banzin/linefollower/assets/71986226/a02276af-8b1e-4439-b7a7-1c4c78338df1"></td> </tr> </table> </ul> <hr style="background-color: #4b4c60"></hr> <a id = "car"></a>

🚙 Car

<ul> <li>Azza receive output from app if found 1 drive with the fastest speed if 0 drive with original speed</li> <li> Azza is able to tackle the line following problem using an array of sensors </li> <li>Azza can accomplish this by utilizing a combination of closed-loop controllers such as PID and a variety of conditions</li> </ul> <div align ="center"> <video width="350px" src="https://github.com/Bar2-Banzin/linefollower/assets/71986226/b71331c5-189a-4f39-86bb-f209fcff77cb"> </div> <hr style="background-color: #4b4c60"></hr>

<a id = "Integration"></a>

🧠 Integration

<div align ="center"> <video width="350px" src="https://github.com/Bar2-Banzin/linefollower/assets/71986226/0e0dd67e-f8e9-46fc-9794-ab4788cc34c9"> </div> <hr style="background-color: #4b4c60"></hr>

<a id ="Contributors"></a>

👑 Contributors

<table align="center"> <thead > <th style="text-align: center;"> Project Manager</th> </thead> <tr> <td align="center"><a href="https://github.com/Mohabz-911"><img src="https://avatars.githubusercontent.com/u/68201932?v=4" width="150px;" alt=""/><br />_{<b>Mohab Zaghloul</b>}</a><br /></td> </tr> </table> <br> <table align="center"> <tr> <td align="center"><a href="https://github.com/MahmoudAbdelhamidAli"><img src="https://avatars.githubusercontent.com/u/87570209?v=4" width="150px;" alt=""/><br />_{<b>Mahmoud Abdlhamid</b>}</a><br /></td> <td align="center"><a href="https://github.com/nouralmulhem"><img src="https://avatars.githubusercontent.com/u/76218033?v=4" width="150px;" alt=""/><br />_{<b>Nour Ziad Almulhem</b>}</a><br /></td> <td align="center"><a href="https://github.com/BasmaElhoseny01"><img src="https://avatars.githubusercontent.com/u/72309546?v=4" width="150px;" alt=""/><br />_{<b>Basma Elhoseny</b>}</a><br /></td> <td align="center"><a href="https://github.com/AhmedHosny2024"><img src="https://avatars.githubusercontent.com/u/76389601?v=4" width="150px;" alt=""/><br />_{<b>Ahmed Hosny</b>}</a><br /></td> <td align="center"><a href="https://github.com/ahmedmadbouly186"><img src="https://avatars.githubusercontent.com/u/66012617?v=4" width="150px;" alt=""/><br />_{<b>Ahmed Madbouly </b>}</a><br /></td> </tr> <tr> <td align="center"><a href="https://github.com/emanshahda" ><img src="https://avatars.githubusercontent.com/u/89708797?v=4" width="150px;" alt=""/><br />_{<b>Eman Shahda</b>}</a><br /> </td> <td align="center"><a href="https://github.com/Fathi79"><img src="https://avatars.githubusercontent.com/u/96377553?v=4" width="150px;" alt=""/><br />_{<b>Abd Elrhman Fathi</b>}</a><br /></td> <td align="center"><a href="https://github.com/zeinabmoawad" ><img src="https://avatars.githubusercontent.com/u/92188433?v=4" width="150px;" alt=""/><br />_{<b>Zeinab Moawad</b>}</a><br /> </td> <td align="center"><a href="https://github.com/doaa281" ><img src="https://avatars.githubusercontent.com/u/65799105?v=4" width="150px;" alt=""/><br />_{<b>Doaa ElSherif</b>}</a><br /> </td> <td align="center"><a href="https://github.com/EslamAsHhraf"><img src="https://avatars.githubusercontent.com/u/71986226?v=4" width="150px;" alt=""/><br />_{<b>Eslam Ashraf</b>}</a><br /></td> </tr> </table> <hr style="background-color: #4b4c60"></hr>

<a id ="License"></a>

🔒 License

Note: This software is licensed under MIT License, See License for more information ©Lightning McQueen.