The Heex Agent also support ROS2 implementations, but please be aware of the following:

  • The services (or background processes) do not have access to the user’s environment variables, so we initially do not have access to variables like $ROS_DISTRO.
  • To address this issue, we have provided you with 2 options, both using the additionalAgentContent/AgentSetupHeader.sh mentionned in the previous page
    • If you have a ‘classic’ ROS2 installation (ie: only one ROS2 distribution is installed on your system, and it is located in /opt/ros/<YOUR_DISTRIBUTION>/), you can simply keep the default AgentSetupHeader.sh which has the DISABLE_AUTOMATIC_ROS_INSTALL_SEARCH variable set to 0. This means that before any ROS2 implementation installation, we will go and look for a setup.bash file inside any folder located in /opt/ros/ and source it before launching the implementation.
    • If you have a custom installation of ROS2 that is not located in /opt/ros, or you have several ROS2 distributions installed that are located in /opt/ros, you should set the DISABLE_AUTOMATIC_ROS_INSTALL_SEARCH to 1 so that we do not automatically search for your ROS2 installation, and instead you should point to your ROS2’s setup.bash file inside the FILES_TO_SOURCE_IN_SERVICES_ENV list, that way it shall be sourced before any of your implementation installation. As mentionned in the previous page, keep in mind that if the order of sourcing is important, the sourcing of each file in the FILES_TO_SOURCE_IN_SERVICES_ENV list is done by order of declaration.