Preparing Your PC

On your Windows PC:

Create a GitHub account if you don’t have one. Apply for GitHub Global Campus to access GitHub Pro features such as Copilot and more.
Install Fusion 360
- Create an Autodesk account with your HVL email and verify your student status.
Install Bambu Studio
Install VMWare Player
- Download our Ubuntu 20.04 virtual machine for VMWare Player with pre-installed VSCode, ROS2, Robotics toolbox, Dynamixel Wizard and Dynamixel SDK.
- Unzip the virtual machine to a folder of your choice.
- In the VMWare Player, open the virtual machine ctrl+O by selecting the .vmx file in the folder you unzipped the virtual machine to.
- Start the virtual machine by clicking Play virtual machine.

On the Virtual Machine

The user password on the VM is student. Here are some things you should do on the VM to get started:

Configure Git and GitHub

Set your Git credentials by opening a terminal and typing
```
git config --global user.name "Your user name"
git config --global user.email "Your email address"
```
with your user name and email address you use on github.com.
Open VSCode (pre-installed) and install the GitHub Pull Requests and Issues extension.
- A new GitHub icon appears in the left sidebar. Click it and sign in with your GitHub account.

Install adatools

Install the adatools Python package by following the instructions in the ReadMe on GitHub.

RealSense Camera

The RealSense driver itself is already installed on the VM, but we noticed that some things are still missing:

Install the kernel drivers package

  sudo mkdir -p /etc/apt/keyrings
  curl -sSf https://librealsense.intel.com/Debian/librealsense.pgp | sudo tee /etc/apt/keyrings/librealsense.pgp > /dev/null

  sudo apt-get install apt-transport-https

  echo "deb [signed-by=/etc/apt/keyrings/librealsense.pgp] https://librealsense.intel.com/Debian/apt-repo `lsb_release -cs` main" | \
  sudo tee /etc/apt/sources.list.d/librealsense.list
  sudo apt-get update

  sudo apt-get install librealsense2-dkms

To do the “deprojection” of color image coordinates + depth to 3D coordinates we need the Python wrapper of the RealSense SDK. Install it with
```
  pip install pyrealsense2
```

Install the vision_opencv package

  cd ros2_ws/src
  git clone https://github.com/ros-perception/vision_opencv.git -b foxy
  cd ..
  colcon build --symlink-install

Install the machine vision toolbox for Python from Peter Corke
pip install machinevision-toolbox-python
For all plotting functions of the vision toolbox to work, you most likely need to upgrade matplotlib
pip install --upgrade matplotlib