The Big Race 🏎️

A multi-processing race simulation, written in C & OpenGL, using signals & named pipes.

this project is a part of the Real Time Applications & Embedded Systems (ENCS4330) course at BZU.

Demo 🔥

demo.mp4

Authors

• Ibraheem Alyan: 1201180
• Mohammad Mualla: 1180546

Installation

Prerequisites ✅

• Docker : to make the project portable, Docker containers were used as a runtime enviroment.

• VNC client

Setup ⚙️

the folowing commands are intended to be run in a bash shell

1. clone the repository

   git clone https://github.com/ibraheemalayan/first_project_the_big_race.git real_time_project
   cd real_time_project
   mkdir src/bin

2. setup the container

   • windows

     bash windows_setup.sh

   • unix/linux

     bash setup_container.sh

3. connect the VNC client to the url shown in the output of the setup script (password is headless)

4. inside the container shell, run the intended make command.

Note: before running the gui from an ssh session

export DISPLAY=:0

Usage ▶️

the makefile is inside the src directory

Available make commands:

• make run <num_of_rounds> - run the project in gui mode
• make run_gui - run the standalone gui code with default number of rounds and random speeds (for testing)
• make run_cli <num_of_rounds> - run the project in cli mode without gui (for testing)

Debugging (GDB)

• make debug <num_of_rounds> - run the project inside gdb
• make debug_cli <num_of_rounds> - run the project in cli mode without gui inside gdb (for testing)
• make debug_gui - run the project in gui mode inside gdb (for testing)

there other make commands, but they are not intended to be used directly.

Debugging in gdb

• to follow child in forks

set follow-fork-mode child

• to follow exec

set follow-exec-mode new

TODOs

• solve ui issue in ubuntu
• draw all players as different objects
• create pipes for communication between processes
• pass pipes to childs and ui
• create a function that will read the new speeds from the pipes instead of random
• let the timer function use the new speeds
• update styling (colors & fonts)
• document make available commands
• add contributors names/ids
• add a demo GIF in this README