https://github.com/vincenzomarotta/potholes
Respository for project assigned during Laboratory of Operating Systems course @ Università di Napoli Federico II.
https://github.com/vincenzomarotta/potholes
android c client java server threadpool threads unix
Last synced: about 2 months ago
JSON representation
Respository for project assigned during Laboratory of Operating Systems course @ Università di Napoli Federico II.
- Host: GitHub
- URL: https://github.com/vincenzomarotta/potholes
- Owner: vincenzomarotta
- Created: 2025-04-10T21:28:50.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-15T21:05:35.000Z (about 1 year ago)
- Last Synced: 2025-04-15T21:37:28.991Z (about 1 year ago)
- Topics: android, c, client, java, server, threadpool, threads, unix
- Language: Java
- Homepage:
- Size: 1.56 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🚗 PotHoles
## 🤔 What is PotHoles?
PotHoles is a project assigned during Laboratory of Operating Systems course at Università di Napoli Federico II.
PotHoles is a client-server system designed to manage pothole detection.
This project is divided into a client (an Android app) and a server, written in _C_ and running in a UNIX environment.
### 📱 Client
As mentioned before, the client is an android app written in Java (as specifically required).\
The user can start a recording session where the app detects potholes using the smartphone’s accelerometer along the y-axis.\
If the accelerometer exceeds a certain threshold, a new pothole is detected.
The user can also check whether there are new events (potholes) within a specific range.
### 💻 Server
The server is written in C language and was hosted on _Microsoft Azure_ (as specifically required).\
A simple communication protocol called **ECM** (_Enhanced Coordinate Messaging Protocol_)Its structure is as follows:
HEADER -> PACKET_SIZE -> COMMAND -> OTHER_DATA_ACCORDING_TO_THE_COMMAND
The server is a multi-thred where instead of assign a new connection to a new thread, a thread pool has been developed; this choice was made to design something closer to real-world servers, rather than a purely academic solution.
For data managment was used a simple databse in **PostegreSQL**.
For more detailed info you can check the [documentation](LSO_2122_Doc.pdf).
## 🚀 Server Installation
The server needs to be used in a UNIX enviroment.\
To compile it:
```bash
gcc -Wall -Wextra -g -pthread -o main.run main.c ecmprotocol.c ecmdb.c threadpool.c -I/usr/include/postgresql/ -L/usr/lib/postgresql/14/lib/ -lpq
```
To start the program:
```bash
./main.run [argument] ...
```
where the possible arguments are:
- -t: thread number assigned to the pool (default is 4)
- -q: queue length for the thread pool (default is 20)
- -a: threshold value for the accelerometer (default is 10.0)
An possible run could be:
```bash
./main.run -t 4 -q 20 -a 10,0
```
or
```bash
./main.run -t 10 -q 30 -a 5,0
```
## 🖼️ Screenshots
### 📍 Real-time Pothole Detection
In this screen, you can see a live recording session during which a new pothole has been detected.
A red marker appears on the map to indicate danger, making it visible to all users within a certain radius.
---
### 📋 List of Nearby Potholes
This screen displays a list of potholes detected within the user's proximity, allowing quick and organized access to critical road hazard information.
## 🧑🏻💻 Authors
This project was made in collaboration with:
- https://github.com/matthyzza
- https://github.com/emanuele989
## 📫 Support
For any questions feel free to reach me anytime; my contacts are available in my homepage.