ECE-3872

This is the class repository for ECE3872, Fundamentals of Design. Below are the instructions and details to get you up and running with Wonderland project 😃

Getting Started

For Students

Clone this repo into desired working directory on the Raspberry Pi

git clone https://github.gatech.edu/tbrothers3/ECE-3872.git
cd Projects/Wonderland

You will be editing the robot.py file to code in your robot's corresponding logic. Please follow the comments for guidance.

For deployment into actual environment, obtain the director IP and edit the script. Then on bootup, you must run the robot.py script.

For Director

Clone this repo into desired working directory on the Linux machine.

git clone https://github.gatech.edu/tbrothers3/ECE-3872.git
cd Projects/Wonderland

Install the necessary dependencies

sudo pip3 install -r requirements.txt
sudo pip3 install keyboard

Create or edit an appropriate CSV file to define the robot order, latency, and command. Then use the following to run the director.

sudo python3 director.py <path to csv file>

For Student Robots

Clone this repo into desired working directory on the Linux machine.

git clone https://github.gatech.edu/tbrothers3/ECE-3872.git
cd Projects/Wonderland

Edit the robot.py file to make sure that DIRECTOR_HOST and PORT point to the director server IP and exposed port.

ROBOT_NAME = "<ENTER ROBOT NAME MATCHING THE CSV FILE FOR DIRECTOR>"
DIRECTOR_HOST = "<ENTER DIRECTOR IP ADDR ON GTother"
PORT = # Enter Director port

Edit the rest of the file with your appropriate robot logic and then run.

python3 robot.py

Note that for deployment, you'll need to run this script on bootup

For Demo Run

Clone this repo into desired working directory on the Linux machine.

git clone https://github.gatech.edu/tbrothers3/ECE-3872.git
cd Projects/Wonderland

Install the necessary dependencies

pip3 install -r requirements.txt

You can either get two ssh or shell sessions on the Pi and run the commands for director and robot above. If you can't do the following below. Create a separate screen sessions for the robot

sudo apt update
sudo apt install screen

Run the director in one session.

screen -d -m sudo python3 director.py <path to csv file>

Run the robot in a separate terminal.

screen -d -m sudo python3 demo_robot.py

View all the screen sessions

screen -ls

Attach to the director screen session to enter q to continue the demo

screen -r <director screen session name> 

Workflows

Director Workflow

Robot Workflow