Virtual Lab Setup

This page will guide you through the installation process of the Lab:

Install Ubuntu 18.04.3 LTS.

https://releases.ubuntu.com/18.04/ or
https://tutorials.ubuntu.com/tutorial/tutorial-create-a-usb-stick-on-ubuntu or
https://tutorials.ubuntu.com/tutorial/tutorial-create-a-usb-stick-on-windows

Clone our cpm software repository with:

git clone https://github.com/embedded-software-laboratory/cpm_lab software

Prepare to run our installation script by getting a license.dat-file for the RTI DDS Connext Service (ask your supervisor if you are a student or get into contact with RTI)

Run our script to install all necessary components. In the software folder you have just cloned you find install.sh.

todo	full installation	simulation setup only
run	cd software/ sudo bash install.sh	cd software/ sudo bash install.sh --simulation
What will it install?	Unbuntu packages	Unbuntu packages
	Joystick/ Gamepad	Joystick/ Gamepad
	RTI DDS Connext	RTI DDS Connext
	RTI ARM
	OpenCV 4.0 for the Indoor Positioning System
	Basler Pylon 5 for the Indoor Positioning System and lab camera

Change DDS Domain

If you want to change the DDS Domain later, change the corresponding variable DDS_DOMAIN in /etc/profile.d/rti_connext_dds.sh.

The following domain IDs are used in the CPM Lab:

Domain ID	Purpose
21	Lab (main computer, NUCs, vehicles)
61-66	Student computers

Change RTI license file

If you want to update your license file, change the file at: /opt/rti_connext_dds-6.0.0/rti_license.dat

Reboot your PC.
Optional:
Setup MATLAB. As a student from RWTH, you can do this with a MathWorks account following these instructions.
Download the DDS Support Package for MATLAB and install the toolbox. The native DDS addon that ships with MATLAB versions from 2021a only supports Simulink. If you are going to code in MATLAB, install the corresponding package from the link.

Make sure to create a symbolic link to the MATLAB binary during or after the setup!
Run the build script.
full setup only simulation setup
./build_all.bash

./build_all.bash --simulation

Troubleshooting

If you have problems during the building process, try starting over again with
```
cd ~/dev/software/
git pull 
git clean -xdf 
./build_all.bash
```
If you ever run build_all.bash as root , you might run into a lot of permission denied errors. You need to delete all files and folders that were created and rerun as your usual user.
If you recieve an error like "dds/someheader.h" not found, run the command "rtiddsgen", which should build the neccesarry cpp-files
If you recieve an error regarding timing issues of unittests, run
```
git clean -xdf
./build_all.bash
```
again. This error occurs often in VM.