CG4002 Computer Engineering Capstone Project

Group B14 Internal Communications

This is part of a project to implement a 2-player laser tag system. The scripts in this repository provide an API for the internal communications between the Bluno Beetles and a relay laptop. The full project can be found here.

This project uses the bluepy library by Ian Harvey as a Python interface for Bluetooth LE on Linux. The source code can be found here.

At present, the scripts only run on Linux. The scripts have been tested to work on Ubuntu Desktop 22.04 LTS with Python 3.10. (Using WSL or a VM does not work for this particular implementation.)

Setup

1. Clone the repository.
2. Download the bluepy library by following the installation instructions provided here.
3. Download the multipledispatch library using the following command.

pip3 install multipledispatch

4. Change the "FILEPATH" variable within main.py to the directory containing this repository.
5. Update the MAC addresses of the Bluno Beetles that are being used.

Navigate to the following lines in ./helper/constant.py

# MAC addresses of Bluno Beetles
# Player 1
P1_IR_TRANSMITTER = "xx:xx:xx:xx:xx:xx"
P1_IR_RECEIVER = "xx:xx:xx:xx:xx:xx"
P1_IMU_SENSOR = "xx:xx:xx:xx:xx:xx"

# Player 2
P2_IR_TRANSMITTER = "xx:xx:xx:xx:xx:xx"
P2_IR_RECEIVER = "xx:xx:xx:xx:xx:xx"
P2_IMU_SENSOR = "xx:xx:xx:xx:xx:xx"

Replace each of the "xx:xx:xx:xx:xx:xx" strings with the string representation of the MAC address of the Bluno Beetle connected to the corresponding hardware component as stated in the variable name. The string should only contain lowercase alphabets and numbers.

Running the program

Run the program using the following command.

sudo python3 main.py