Accessible E-Rickshaw Automation System (AERAS)

This project simulates an app-less, location-based e-rickshaw ride request system using physical game-matrix interfaces for elderly and special needs individuals. The system includes a user-side hardware unit, rickshaw-side hardware unit, and a backend server with real-time ride coordination.

---

Table of Contents

• Setup Requirements
• Installation
• Running the Project
• Configuration
• Accessing the Rickshaw Web App
• License

---

Setup Requirements

Before running the project, make sure you have:

1. Visual Studio Code installed.
2. PlatformIO extension for VS Code.
3. Wokwi Simulator extension for VS Code.

Video Tutorial:
Setting up VS Code for Wokwi & PlatformIO

---

Installation

Clone the project repository:

git clone https://github.com/rafio1020/RUET-Cirquix.git

Open the following folders in PlatformIO:

• user-side-hardware
• rickshaw-side-hardware

---

Running the Project

1. Open a terminal and navigate to the backend folder:

cd aeras-backend
node server.js

This will start the backend server.

2. In another terminal, run:

ipconfig

Copy your local IP address.

---

Configuration

1. In both hardware folders (user-side-hardware and rickshaw-side-hardware), open main.cpp and set the backend-url to your local IP address, e.g.:

const char* backendUrl = "http://YOUR_IP:3000";

2. Update the backend URL in the rickshaw web app:

aeras-backend/public/rickshaw-app/index.html

---

Accessing the Rickshaw Web App

Open a browser and go to:

http://YOUR_IP:3000/rickshaw/

---

Running Simulation

1. Build the main.cpp files for both user-side and rickshaw-side hardware in PlatformIO.
2. Open the Wokwi simulator and run the project to test the system.

---

License

This project uses Wokwi Simulator under its License Agreement.