Universal Robot ROS2 Driver

Configurer le réseau pour que les VMs communiquent

• Créer un réseau NAT dans les outils réseau
  

  

• Laisser la config par défaut
  

  

  
  

• Configurer chaque VM qui doit communiquer en Réseau NAT, par défaut elles seront en DHCP sur le réseau 10.0.2.0/24
  

  

• Récupérer l'adresse IP de la VM URSim avec ip a, ici 10.0.2.15
  

  

• Tester la communication de la VM ROS vers la VM URSim avec ping 10.0.2.15
  

  

• Tester la communication de la VM URSim vers la VM ROS avec ping 10.0.2.4
• Tester la communication entre ROS et URSim, voir la section dédiée

Démarrage et configuration URSim

• démarrer le robot

• Configuer l'IP de la VM ROS pour l'autoriser à prendre le contrôle externe
  

  

Programmation hors-ligne avec URSim et MoveIt2/RViz

• Réaliser l'installation de ROS2.
  

• Installer rosdep pour installer automatiquement les paquets Debian dont dépendent les paquets ROS

sudo apt install python3-rosdep

• Si vous avez plusieurs versions de ROS2 installées, vérifiez que vous avez "sourcé" la bonne version de ROS2
• Mettre à jour les paquets dont ROS2 dépend

sudo rosdep init
rosdep update
sudo apt update
sudo apt dist-upgrade

• Installer colcon qui est le système de compilation de ROS2 avec mixin.

sudo apt install python3-colcon-common-extensions
sudo apt install python3-colcon-mixin
colcon mixin add default https://raw.githubusercontent.com/colcon/colcon-mixin-repository/master/index.yaml
colcon mixin update default

NOTES IMPORTANTES

• si vous utilisez Linux Mint 21.1 VERA (Mate ou Cinammon, basée sur Ubuntu 22 Jammy), il faudra toujours préciser la version d'Ubuntu `--os=ubuntu:jammy` dont on veut récupérer les paquets avec la commande `rosdep` :

sudo apt update && rosdep install -r --from-paths . --ignore-src --rosdistro $ROS_DISTRO -y --os=ubuntu:jammy

• Si vous travaillez dans une VM d'un ordinateur ayant moins de 20GO de RAM (WSL par exemple). Ou sur un ordinateur Ubuntu ayant moins de 10GO de RAM, il faudra lancer la compilation `colcon` sans parallélisation des tâches (1 paquet compilé à la fois) `--parallel-workers 1` :

colcon build --mixin release --parallel-workers 1

Déploiement du code source des Tutoriels de MoveIt

• Créer un répertoire de travail "workspace" pour la compilation du projet avec colcon
  

mkdir -p ~/ws_moveit2/src

• Se déplacer dans le workspace colcon et récupérer le code source des tutoriels MoveIt :

cd ~/ws_moveit2/src
git clone https://github.com/ros-planning/moveit2_tutorials -b humble --depth 1

Optionnel : Installation d'un environnement de développement MoveIt2 avec les dernières améliorations et résolutions de bug

Installation de MoveIt2 Humble sur Ubuntu 22.04 :

• Installer vcstool qui est un outil Python pour gérer les dépôts git composant un paquet ROS.

sudo apt install python3-vcstool

• Récupérer les autres dépôts git de MoveIt2 dont dépend moveit2_tutorials 
  

cd ~/ws_moveit2/src
vcs import < moveit2_tutorials/moveit2_tutorials.repos

Note : si `vcs import` vous demande vos identifiants GitHub, tapez Entrer jusqu'à ce que ça continue. Pas besoin d'identifiant pour récupérer un dépôt GitHub public.

Installation des dépendances et compilation

• Installer les dépendances ROS2 Humble (paquets debian stables).

sudo apt update && rosdep install -r --from-paths . --ignore-src --rosdistro $ROS_DISTRO -y

• Compiler MoveIt Tutorials (20+ minutes si vous avez choisi de déployer l'environnement de développement)
  

cd ~/ws_moveit2
colcon build --mixin release

• Sourcer les paquets compilés :

cd ~/ws_moveit2
source ~/ws_moveit2/install/setup.bash

• Optionnel, si vous utilisez principalement ce workspace : Sourcer automatiquement le workspace colcon au lancement d'un Terminal

echo 'source ~/ws_moveit2/install/setup.bash' >> ~/.bashrc

Tester la communication entre ROS et URSim

https://docs.ros.org/en/ros2_packages/rolling/api/ur_robot_driver/usage.html#usage-with-official-ur-simulator

• Lancer URSim, par exemple avec un UR5e

ros2 run ur_robot_driver start_ursim.sh -m ur5e

• Ouvrir l'interface URSim dans le navigateur : http://192.168.56.101:6080/vnc.html --> cliquer sur Connect
  
• Faire tourner le driver UR ROS2

ros2 launch ur_robot_driver ur_control.launch.py ur_type:=ur5e robot_ip:=192.168.56.101

• Si vous bougez le robot dans URSim vous le verrez bouger dans RViz.

https://docs.ros.org/en/ros2_packages/rolling/api/ur_robot_driver/usage.html#example-commands-for-testing-the-driver

Envoyer des commandes au contrôleur

Avant d'envoyer des commandes, vérifier l'état des contrôleurs en utilisant ros2 control list_controllers

• Envoyer un objectif (goal) au contrôleur de trajectoire articulaire (Joint Trajectory Controller) en utilisant le noeud de démonstration du paquet ros2_control_demos. Dans nouveau Terminal (sans oublier de sourcer) : 
  

  ros2 launch ur_robot_driver test_scaled_joint_trajectory_controller.launch.py

  Après quelques secondes le robot devrait bouger.

• Pour tester un autre contrôleur, il suffit de l'ajouter en argument de la commande initial_joint_controller, par exemple en utilisant joint_trajectory_controller :
  

  ros2 launch ur_robot_driver ur_control.launch.py ur_type:=ur5e robot_ip:=192.168.56.101 initial_joint_controller:=joint_trajectory_controller launch_rviz:=true

   

• Et envoyer la commande avec le noeud de démo :

  ros2 launch ur_robot_driver test_joint_trajectory_controller.launch.py

  Après quelques secondes le robot devrait bouger (ou sauter si la simulation est utilisée).

-----

Auteur: Gauthier Hentz, sur le wiki de l'innovation de l'IUT de Haguenau

 Attribution-NonCommercial-PartageMemeConditions 4.0 International (CC BY-NC-SA 4.0)