Repository Setup

In order to work on the robot, you will need to setup the repository on your local machine eventually so we will have you do it before startingt the intro project. You will just complete the intro project on a seperate personal branch on your local machine

  1. Make a lunabot_ws folder

  2. Change directory into lunabot_ws in the terminal

  3. Clone the repository into a folder called source by running: git clone https://github.com/vanderbiltrobotics/lunabot-ros2.git src

  4. Change directory back to lunabot_ws in the terminal

  5. Build the code by running colcon build (you will likely get errors if you are on macOS or Windows since not all the packages are fully supported on those platforms)

    • Use colcon build --packages-select <package-1> <package-2> to only build selected packages

  6. To be able to use any nodes built, you must run . install/local_setup.bash (ubuntu terminal), . install/local_setup.zsh (macOS terminal), or . install/local_setup.ps1 (powershell)

  7. Now you can run any nodes/launch files

Note

Your lunabot_ws folder should look like this when you are finished:

../_images/ros-ws.png

Note

Before starting the intro projects, switch from the main branch to your own local branch for the project by running: git checkout -b intro/<name> Also, you can make commits to this branch but do not push it to the github repository since then everyone else will be deprived of figuring out the projects themselves :)