# Algemene informatie

## Pre-requistions ROS2-Jazzy
Installeer ROS Jazzy, kies uit 1 van de twee volgende mogelijkheden:
* WSL Distributie onder Windows(voorkeur voor studenten M)
* Native Ubuntu

:::::{card} 
::::{tab-set}

:::{tab-item} WSL Distributie
Zie voor installatie: [Windows Subsystem for Linux Handleiding](https://avansmechatronica.github.io/WindowsSubsystemForLinuxHandleiding/)
* Volg instrucies voor ROS2 Jazzy
:::

:::{tab-item} Native Ubuntu
*Opmerking: je dient eerst Ubuntu 22 geinstallerd te hebben!!!*

Volg de instructies voor het [installeren ROS-Jazzy](https://docs.ros.org/en/jazzy/Installation/Ubuntu-Install-Debs.html)

Kies: ros-jazzy-desktop
:::

::::

:::::

## Cloning de ROS2 Industrial workspace
Voor het maken van de ROS Industrial workspace maak je gebruik van een Github clone die is voorbereid. Je kunt er voor keizen om deze clone onder een eigen account van Github te plaatsen(1e keuze hieronder). Je kunt daarna eenvoudig backup's van je werk maken naar je eigen Github account.

:::::{card} 

::::{tab-set}

:::{tab-item} Met GIT-repository support

* Maak een account aan bij [Github](https://github.com/) en login op dit account

* Open de [ROS2_Industrial](https://github.com/AvansMechatronica/ROS2_industrial) repository

* Maak een Fork van de repository naar je eigen Github account door op het **Fork icoon**  te klikken:

![image](../images/fork.jpg)

* Volg de instructies, maar wijzig de naam van de nieuwe repository niet. Bevestig met **Create Fork**  

* Nu kun je de workspace als volgt creëren

```bash
mkdir -p ~/ros2_industrial_ws/src
cd ~/ros2_industrial_ws/src
git clone https://github.com/<jouw_account_naam>/ROS2_industrial.git
```

*ps. Het gebruik van github (zoals add, commit & push commando's) valt  buiten de scope van deze workshop*

:::

:::{tab-item} Zonder GIT-repository support

* Je kunt de workspace als volgt creëren
```bash
mkdir -p ~/ros2_industrial_ws/src
cd ~/ros2_industrial_ws/src
git clone https://github.com/AvansMechatronica/ROS2_industrial.git
```

:::

::::

:::::

## Installeren van de benodigde ROS2 packages en software
```bash
cd ~/ros2_industrial_ws/src/ROS2_industrial/install
./install.bash
```

## Bouwen van de ROS2 Industrial workspace
```bash
cd ~/ros2_industrial_ws/
colcon build --symlink-install
source install/setup.bash
echo "source ~/ros2_industrial_ws/install/setup.bash" >> ~/.bashrc
```
Opmerking: *Gebruik de laatse regel slechts 1 maal.*

## Aantekening voor windows gebruikers
Opmerking: *Alleen als je geen gebruik maakt van de door Avans gemaakte WSL-Jazzy distributie*

Je kunt de WSL Ubuntu-22.04 distributie uit de Microsoft Store gebruiken. Gebruik als ontwikkelomgeving [Visual Studio Code] (https://code.visualstudio.com/download). Wijzig de installatie en voeg de WSL-plugin toe aan Visual Studio Code. Open de distributie met <F1>WSL: Connect to WSL. Vergeet niet ROS-Jazzy te installeren in de distributie. Cloon deze repositry naar de WSL distributie.

## Inleveren van opdrachten
Als je een opdracht dient in te leveren voor je opleiding dan vind je dat terug in de Elekronische Leeromgeving van je opleiding (bijvoorbeeld Brightspace). Zorg ervoor dat je bij elke opdracht de volgende informatie in het bestand invult:
* Naam Student
* Studentnummer
* Datum

Je gaat dan akkoord met onderstaande verklaring:
~~~
Door het inleveren van dit bestand verklaar ik dat 
ik deze opdracht zelfstandig heb uitgevoerd en
dat ik geen code van anderen heb gebruikt.
Tevens ga ik akkoord met de beoordeling van deze opdracht.
~~~


## Verantwoording

Deze workshop is geinspireerd op [hello real world ros robot operating system](https://ocw.tudelft.nl/courses/hello-real-world-ros-robot-operating-system/) van de Technische Universiteit Delft/Nederland(TUD)