Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Papyrus/customizations/robotics/installation"

(Created page with "== Installation instructions == === Binary installation === Papyrus for Robotics can be installed either in form of an RCP (a self contained Eclipse installation) or added t...")
 
m
(15 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Installation instructions ==
+
__NOTOC__
 +
= Installation instructions =
 +
== Installation through the Virtual Box Appliance ==
 +
We provide a [ftp://ftp.cea.fr/pub/lise/p4r/CEAPilot_VirtualMachine.ova virtual machine] that comes with everything needed pre-installed to develop ROS2 applications using Papyrus for Robotics.
  
 +
For this virtual machine, username is “user” and password is “p”. User “user” is allowed to use “sudo”. After logging in, you'll find a readme file with some additional links and videos on the desktop.
 +
 +
== Manual Installation ==
 
=== Binary installation ===
 
=== Binary installation ===
  
Papyrus for Robotics can be installed either in form of an RCP (a self contained Eclipse installation) or added to an existing Eclipse installation by using an update site. Both can be downloaded from [https://www.eclipse.org/papyrus/components/robotics eclipse.org/papyrus/components/robotics].
+
Alternatively, Papyrus for Robotics can be installed either in form of an RCP (a self contained Eclipse installation) or added to an existing Eclipse installation by using an update site. Both can be downloaded from [https://www.eclipse.org/papyrus/components/robotics eclipse.org/papyrus/components/robotics] referring to the current 0.8 release.
  
* If you use the RCP, make sure that a JRE is already installed in your system and contained in the system PATH.
+
* RCPs
 +
** [https://download.eclipse.org/modeling/mdt/papyrus/components/robotics/downloads/2020-06/rcps Release RCPs] for 2020-06
 +
** [https://ci.eclipse.org/papyrus/job/papyrus-robotics-2021-12/lastSuccessfulBuild/artifact/releng/org.eclipse.papyrus.robotics.product/target/products/ Nightly RCPs] for 2021-12.
  
* If want to extend an existing Eclipse, add the update-site via Help->Install New Software->Add (update-site)
+
 
 +
* If want to extend an existing Eclipse, add the update-site via Help->Install New Software->Add
 +
** [https://download.eclipse.org/modeling/mdt/papyrus/components/robotics/ Release update-site] (for 2020-06)
 +
** [https://ci.eclipse.org/papyrus/view/Robotics/job/papyrus-robotics-2021-12/lastSuccessfulBuild/artifact/releng/org.eclipse.papyrus.robotics.p2/target/repository/ Nightly update site] (for 2021-12)
  
 
=== Source code installation ===
 
=== Source code installation ===
  
* Install Papyrus SW designer (which in turn will install Papyrus itself and MARTE) using the following nightly [https://ci.eclipse.org/papyrus/job/papyrus-designer-2019-06/lastSuccessfulBuild/artifact/releng/org.eclipse.papyrus.designer.p2/target/repository/ update site] within a recent base Eclipse (2019-09 or soon 2019-12).
+
See [[Papyrus/customizations/robotics/devinstall|Developer installation]].
 +
 
 +
=== ROS2 Dependencies ===
 +
==== ROS2 Environment ====
 +
If you plan to use Papyrus for Robotics to design and deploy ROS2-based systems, you need to install ROS2. The current release 0.8 supports [https://index.ros.org/doc/ros2/Installation/Foxy/ ROS2 Foxy Fitzroy] and [https://index.ros.org/doc/ros2/Installation/Eloquent/ ROS2 Eloquent Elusor]
  
* Clone the Papyrus for Robotics [http://git.eclipse.org/c/papyrus/org.eclipse.papyrus-robotics.git git repository]
+
==== Behavior Tree Execution ====
 +
In addition to ROS2, if you plan to use Papyrus for Robotics to execute task specifications in form of behavior trees, you need to install:
  
* Import the plugins contained in the git repository (notably in the "plugins" sub-folder) into your Eclipse installation.
+
* the [https://github.com/ros-planning/navigation2/tree/foxy-devel/nav2_behavior_tree <code>nav2_behavior_tree</code>] package from Navigation2, including its dependencies ([https://github.com/ros-planning/navigation2/tree/foxy-devel/nav2_common <code>nav2_common</code>], [https://github.com/ros-planning/navigation2/tree/foxy-devel/nav2_msgs <code>nav2_msgs</code>], [https://github.com/ros-planning/navigation2/tree/foxy-devel/nav2_util <code>nav2_util</code>] and [https://github.com/BehaviorTree/BehaviorTree.CPP <code>behaviortree_cpp_v3</code>]). [https://navigation.ros.org/build_instructions/index.html# Build and Install Navigation2] explains how to get the complete framework on your machine.
  
* An Oomph setup is under preparations
+
* the [ftp://ftp.cea.fr/pub/lise/p4r/bt_sequencer.zip <code>bt_sequencer</code>] package. This package is a slightly modified version of [https://github.com/ros-planning/navigation2/tree/foxy-devel/nav2_bt_navigator <code>nav2_bt_navigator</code>] with the following changes:
 +
** commented default <code>plugin_libs</code>
 +
** added a ZMQ logger from [https://www.behaviortree.dev/ BehaviorTree.CPP]
 +
** forced the execution of BT at activation (and not as response to a <code>NavigateToPose</code> goal request)

Revision as of 13:25, 28 January 2023

Installation instructions

Installation through the Virtual Box Appliance

We provide a virtual machine that comes with everything needed pre-installed to develop ROS2 applications using Papyrus for Robotics.

For this virtual machine, username is “user” and password is “p”. User “user” is allowed to use “sudo”. After logging in, you'll find a readme file with some additional links and videos on the desktop.

Manual Installation

Binary installation

Alternatively, Papyrus for Robotics can be installed either in form of an RCP (a self contained Eclipse installation) or added to an existing Eclipse installation by using an update site. Both can be downloaded from eclipse.org/papyrus/components/robotics referring to the current 0.8 release.


Source code installation

See Developer installation.

ROS2 Dependencies

ROS2 Environment

If you plan to use Papyrus for Robotics to design and deploy ROS2-based systems, you need to install ROS2. The current release 0.8 supports ROS2 Foxy Fitzroy and ROS2 Eloquent Elusor

Behavior Tree Execution

In addition to ROS2, if you plan to use Papyrus for Robotics to execute task specifications in form of behavior trees, you need to install:

  • the bt_sequencer package. This package is a slightly modified version of nav2_bt_navigator with the following changes:
    • commented default plugin_libs
    • added a ZMQ logger from BehaviorTree.CPP
    • forced the execution of BT at activation (and not as response to a NavigateToPose goal request)

Back to the top