Difference between revisions of "Advantech Robotic Suite/Installation"

From ESS-WIKI
Jump to: navigation, search
(→‎Package List)
 
(55 intermediate revisions by 4 users not shown)
Line 1: Line 1:
  
−
<span style="font-size:larger;">Advantech ROS 2 Suite Install provides a consistent experience for Advantch edge platforms ( eg. Intel, ARM - NXP iMX8 and NVIDIA Jetson ). User can easy to install and set up your ROS 2 environment and quick to start your devlopment ros application ( example: AMR, AGV, Fleet Management ... ).</span>
+
<span style="font-size:larger;">Advantech Robotic Suite provides a consistent installation experience for Advantch platforms ( eg. Intel, ARM - NXP i.MX 8M and NVIDIA Jetson ). User can easily install and set up the ROS2 environment to quickly start developing your Robot applications. ( example: AMR, AGV, Fleet Management ... ).</span>
  
 
&nbsp; &nbsp;
 
&nbsp; &nbsp;
  
−
[[File:ROS2 Suite Smart Installer-1.1.jpg|center|600x350px|ROS2 Suite Smart Installer-1.1.jpg]]
+
[[File:ROS2 Suite Smart Installer-1.1.jpg|center|600x350px|Robotic Development SDK Smart Installer-1.1.jpg]]
  
−
&nbsp; &nbsp;
 
−
 
−
<span style="font-size:larger;">ROS 2 uses for communication is DDS. In DDS, the primary mechanism for having different logical networks share a physical network is known as the Domain ID. ROS 2 nodes on the same domain can freely discover and send messages to each other, while ROS 2 nodes on different domains cannot. All ROS 2 nodes use domain ID 0 by default. To avoid interference between different groups of computers running ROS 2 on the same network, a different domain ID should be set for each group.</span>
 
−
 
−
&nbsp;
 
−
&nbsp;
 
  
−
<span style="font-size: larger;">You'll have to set ROS domain ID while installation, for Advantech ROS2 Suite, you can choose a domain ID between 0 and 101.</span>
 
−
 
−
&nbsp;
 
−
 
−
&nbsp;
 
−
 
−
&nbsp;
 
  
 
= Install =
 
= Install =
Line 25: Line 12:
 
'''<span style="color:#e74c3c;"><span style="font-size:larger;">NOTE:</span></span>'''
 
'''<span style="color:#e74c3c;"><span style="font-size:larger;">NOTE:</span></span>'''
  
−
<span style="font-size:larger;">To make sure your Target system satisfy following conditions</span>
+
<span style="font-size:larger;">To make sure your Target system satisfy following conditions:</span>
  
−
<span style="font-size:larger;">1. Advantech platforms with certified Ubuntu Desktop 20.04 LTS or Ubuntu Desktop 22.04 LTS with SUSI driver and WISEAgent installer.<br/> 2. At least 8 GB hard drive free space<br/> 3. 8 GB RAM<br/> 4. An active Internet connection is required.<br/> 5. Use the english language environment in Ubuntu OS.</span>
+
<span style="font-size:larger;">* Advantech platforms with certified Ubuntu Desktop 20.04 LTS or Ubuntu Desktop 22.04 LTS with SUSI driver and WISEAgent installer('''WISEAgent v2.0.0 or higher is not supported''').<br/> * At least 8 GB hard drive free space<br/> * At least 8 GB RAM<br/> * An active Internet connection is required.<br/> * Use the english language environment in Ubuntu OS.</span>
  
 
&nbsp;
 
&nbsp;
  
−
<span style="font-size:larger;">Command for install the ROS2 Suite.</span>
+
<span style="font-size:larger;">Install the Advantech Robotic Suite.</span>
−
<pre>$ tar zxfv adv-ros2-suite-installer-<version>.tar.gz
+
<pre>$ tar zxfv adv-robotic-suite-installer-<version>.tar.gz
−
$ sudo ./adv-ros2-suite-installer.run
+
$ sudo ./adv-robotic-suite-installer.run
 
</pre>
 
</pre>
  
−
&nbsp;
+
<span style="font-size:larger;">Make sure you see a message on the last line that the installation is complete, then please restart your computer to complete the environment setup.</span> [[File:ROS2 Suite finished install.png|none|Robotic Development SDK finished install.png]] &nbsp;
  
−
<span style="font-size:larger;">To verify the ROS2 Suite has installed successful, first step is setup ROS2 environmant variables, please replace <ROS_DISTRIBUTION> with your ROS2 distribution (foxy, humble) to run this command:</span>
+
<span style="font-size:larger;">How to verify the Advantech Robotic Suite has installed successful.</span><br/> Step 1: Update ROS2 environment variables.
−
<pre>$ source /opt/ros/<ROS_DISTRIBUTION>/setup.bash
+
<pre>$ source ~/.bashrc
 
</pre>
 
</pre>
  
−
&nbsp;
+
Step 2: Print ROS2 environment variables
−
 
 
−
<span style="font-size:larger;">Senondly, print ROS2 environmant variables</span>
 
 
<pre>$ printenv | grep ROS
 
<pre>$ printenv | grep ROS
 
</pre>
 
</pre>
  
−
&nbsp;
+
Step 3: If the installation is successful, you can see below output. [[File:ROS2 Suite printenv.png|none|Robotic Development SDK printenv.png]] &nbsp;
−
 
 
−
<span style="font-size:larger;">If the installation is successful, you can see below output:</span>
 
−
<pre>ROS_VERSION=2
 
−
ROS_PYTHON_VERSION=3
 
−
ROS_DOMAIN_ID=0
 
−
ROS_LOCALHOST_ONLY=0
 
−
ROS_DISTRO=foxy
 
−
</pre>
 
−
 
 
−
&nbsp;
 
  
 
= Uninstall =
 
= Uninstall =
  
−
<span style="font-size:larger;">Command for uninstall the ROS2 Suite.</span>
+
<span style="font-size:larger;">Command for uninstall the Advantech Robotic Suite.</span>
 
<pre>$ cd /usr/local/Advantech/ros
 
<pre>$ cd /usr/local/Advantech/ros
 
$ ./uninstall.sh
 
$ ./uninstall.sh
Line 69: Line 44:
 
&nbsp;
 
&nbsp;
  
−
= Function =
 
−
 
−
<span style="font-size:larger;">Command for set ROS_DOMAIN_ID of the ROS2 Suite application.</span>
 
−
<pre>
 
−
$ cd /usr/local/Advantech/ros
 
−
$ bash -i change-ros-domain-id.sh
 
−
</pre>
 
−
 
−
<span style="font-size:larger;">It can also be manually set ROS_DOMAIN_ID in host or container by following steps.</span><br>
 
−
=== Set ROS_DOMAIN_ID in host ===
 
−
<pre>
 
−
$ echo "export ROS_DOMAIN_ID=<your_domain_id>" >> ~/.bashrc
 
−
</pre>
 
  
−
=== Set ROS_DOMAIN_ID in docker container ===
 
−
Step1: open docker-compose.yml
 
−
<pre>
 
−
$ cd /usr/local/Advantech/ros/container/edge-ros2-foxy/docker-compose/<docker_container_name>
 
−
$ vim docker-compose.yml
 
−
</pre>
 
−
Step2: set ROS_DOMAIN_ID=<your_domain_id>
 
−
.
 
−
.
 
−
.
 
−
    environment:
 
−
    - ROS_DOMAIN_ID=<span style="color:#e74c3c; font-weight:bold;"><your_domain_id></span>
 
−
.
 
−
.
 
−
.
 
−
Step3: restart container for update environment variables of docker container
 
−
<pre>
 
−
$ cd /usr/local/Advantech/ros/container/edge-ros2-foxy
 
−
$ ./stop.sh <docker_container_name>
 
−
$ ./launch.sh <docker_container_name>
 
−
</pre>
 
  
 
= Package List =
 
= Package List =
Line 110: Line 51:
 
|-
 
|-
 
! style="width: 79px;" | Version
 
! style="width: 79px;" | Version
−
! style="width: 142px;" | Date
+
! style="width: 126px;" | Date
−
! style="width: 438px;" | Functions
+
! style="width: 350px;" | Functions
−
! style="width: 335px;" | SOC / OS
+
! style="width: 345px;" | SOC / OS
−
! style="width: 369px;" | Note
+
! style="width: 151px;" | Product
 +
! style="width: 304px;" | Note
 
|-
 
|-
−
| style="width: 79px; text-align: center;" | 1.1.0
+
| style="width: 79px; text-align: center;" | 1.4.0
−
| style="width: 142px; text-align: center;" | 2022-12-31
+
| style="width: 126px; text-align: center;" | 2024-01-31
−
| style="width: 438px;" |  
+
| style="width: 350px;" |  
−
*ROS 2&nbsp;: Foxy Fitzroy  
+
*ROS 2&nbsp;: Foxy Fitzroy (Ubuntu 20.04)
 +
*ROS 2&nbsp;: Humble Hawksbill (Ubuntu 22.04)
 
*Fast - DDS&nbsp;  
 
*Fast - DDS&nbsp;  
 
*rqt_graph  
 
*rqt_graph  
Line 128: Line 71:
 
*OPCUAClinet Node  
 
*OPCUAClinet Node  
 
*DBMS/rosbag&nbsp;  
 
*DBMS/rosbag&nbsp;  
 +
*Docker Container Base SDK
 +
*'''(New) DeviceOn ROS2 plugin'''
  
−
| style="width: 335px;" |  
+
| style="width: 345px;" |  
−
*NXP iMX 8 Plus / Ubuntu 20.04  
+
*NXP i.MX 8M Plus / Ubuntu 20.04
 +
*Intel 11th Tiger Lake / Ubuntu 20.04
 +
*Intel 12th Alder Lake / Ubuntu 22.04
 +
*Intel 13th Raptor Lake / Ubuntu 22.04
 +
*Intel 14th Raptor Lake / Ubuntu 22.04
 +
*NVIDIA Jetson / Ubuntu 20.04  
  
−
| style="width: 369px;" | &nbsp;
+
| style="width: 151px;" |
 +
MIO-5375
 +
 
 +
AIR-030
 +
 
 +
AFE-R770
 +
&nbsp;
 +
 
 +
&nbsp;
 +
 
 +
| style="width: 304px; text-align: center;" | &nbsp;
 
|-
 
|-
−
| style="width: 79px; text-align: center;" | 1.1.1
+
| style="width: 79px; text-align: center;" | 1.3.0
−
| style="width: 142px; text-align: center;" | 2023-01-11
+
| style="width: 126px; text-align: center;" | 2023-06-21
−
| style="width: 438px;" |  
+
| style="width: 350px;" |  
−
*ROS 2&nbsp;: Foxy Fitzroy  
+
*ROS 2&nbsp;: Foxy Fitzroy (Ubuntu 20.04)
 +
*ROS 2&nbsp;: Humble Hawksbill (Ubuntu 22.04)
 
*Fast - DDS&nbsp;  
 
*Fast - DDS&nbsp;  
 
*rqt_graph  
 
*rqt_graph  
Line 147: Line 108:
 
*OPCUAClinet Node  
 
*OPCUAClinet Node  
 
*DBMS/rosbag&nbsp;  
 
*DBMS/rosbag&nbsp;  
 +
*'''(New) Docker Container Base SDK'''
 +
 +
| style="width: 345px;" |
 +
*NXP i.MX 8M Plus / Ubuntu 20.04
 +
*Intel 11th Tiger Lake / Ubuntu 20.04
 +
*NVIDIA Jetson / Ubuntu 20.04
 +
*Intel 12th Alder Lake / Ubuntu 22.04
 +
*Intel 13th Raptor Lake / Ubuntu 22.04
 +
 +
| style="width: 151px;" |
 +
EPC-R7300
 +
 +
MIO-4370
 +
 +
MIO-5375
 +
 +
AIMB-288E
  
−
| style="width: 335px;" |
+
AIMB-278
−
*NXP iMX 8 Plus / Ubuntu 20.04
 
−
*Intel 11th CPU Tiger Lake / Ubuntu 20.04
 
  
−
| style="width: 369px;" | &nbsp;
+
EI-53
 +
&nbsp;
 +
 
 +
&nbsp;
 +
 
 +
| style="width: 304px; text-align: center;" | [[Advantech_Robotic_Suite/Q&A#Docker_container_version_incompatible_issue|*Docker container version incompatible issue]]
 
|-
 
|-
 
| style="width: 79px; text-align: center;" | 1.2.0
 
| style="width: 79px; text-align: center;" | 1.2.0
−
| style="width: 142px; text-align: center;" | 2023-02-22
+
| style="width: 126px; text-align: center;" | 2023-02-22
−
| style="width: 438px;" |  
+
| style="width: 350px;" |  
 
*ROS 2&nbsp;: Foxy Fitzroy  
 
*ROS 2&nbsp;: Foxy Fitzroy  
 
*Fast - DDS&nbsp;  
 
*Fast - DDS&nbsp;  
Line 168: Line 149:
 
*DBMS/rosbag&nbsp;  
 
*DBMS/rosbag&nbsp;  
  
−
| style="width: 335px;" |  
+
| style="width: 345px;" |  
−
*NXP iMX 8 Plus / Ubuntu 20.04  
+
*NXP i.MX 8M Plus / Ubuntu 20.04  
 
*Intel 11th Tiger Lake / Ubuntu 20.04  
 
*Intel 11th Tiger Lake / Ubuntu 20.04  
−
*NVIDIA Jetson / Ubuntu 20.04  
+
*'''(New)&nbsp;NVIDIA Jetson / Ubuntu 20.04'''
 +
 
 +
| style="width: 151px;" |
 +
EPC-R7200
 +
 
 +
EI-52
 +
 
 +
| style="width: 304px; text-align: center;" | [[Advantech_Robotic_Suite/Q&A#Docker_container_version_incompatible_issue|*Docker container version incompatible issue]]
 +
|-
 +
| style="width: 79px; text-align: center;" | 1.1.1
 +
| style="width: 126px; text-align: center;" | 2023-01-11
 +
| style="width: 350px;" |
 +
*ROS 2&nbsp;: Foxy Fitzroy
 +
*Fast - DDS&nbsp;
 +
*rqt_graph
 +
*RViz
 +
*rosdep
 +
*MoveIt
 +
*SUSI Node
 +
*Modbus-Master Node
 +
*OPCUAClinet Node
 +
*DBMS/rosbag&nbsp;
 +
 
 +
| style="width: 345px;" |
 +
*NXP i.MX 8M Plus / Ubuntu 20.04
 +
*'''(New)&nbsp;Intel 11th Tiger Lake / Ubuntu 20.04&nbsp;'''
 +
 
 +
| style="width: 151px;" |
 +
ARK-1250L
 +
 
 +
MIO-2375
 +
 
 +
MIO-5375
 +
 
 +
&nbsp;
 +
 
 +
&nbsp;
  
−
| style="width: 369px;" | &nbsp;
+
| style="width: 304px;" | &nbsp;
 
|-
 
|-
−
| style="width: 79px; text-align: center;" | 1.3.0
+
| style="width: 79px; text-align: center;" | 1.1.0
−
| style="width: 142px; text-align: center;" | 2023-06-21
+
| style="width: 126px; text-align: center;" | 2022-12-31
−
| style="width: 438px;" |  
+
| style="width: 350px;" |  
−
*ROS 2&nbsp;: Foxy Fitzroy (Ubuntu 20.04)
+
*ROS 2&nbsp;: Foxy Fitzroy  
−
*ROS 2&nbsp;: Humble Hawksbill (Ubuntu 22.04)
 
 
*Fast - DDS&nbsp;  
 
*Fast - DDS&nbsp;  
 
*rqt_graph  
 
*rqt_graph  
Line 189: Line 205:
 
*OPCUAClinet Node  
 
*OPCUAClinet Node  
 
*DBMS/rosbag&nbsp;  
 
*DBMS/rosbag&nbsp;  
−
*Develop Ros2 Foxy Docker Container
 
  
−
| style="width: 335px;" |  
+
| style="width: 345px;" |  
−
*NXP iMX 8 Plus / Ubuntu 20.04  
+
*NXP i.MX 8M Plus / Ubuntu 20.04  
−
*Intel 11th Tiger Lake / Ubuntu 20.04
+
 
−
*Intel 12th Alder Lake / Ubuntu 22.04
+
| style="width: 151px;" |
−
*NVIDIA Jetson / Ubuntu 20.04
+
EPC-R3720
 +
 
 +
EI-52
 +
 
 +
&nbsp;
  
−
| style="width: 369px; text-align: center;" | &nbsp;
+
| style="width: 304px;" | &nbsp;
 
|}
 
|}

Latest revision as of 11:29, 3 July 2024

Advantech Robotic Suite provides a consistent installation experience for Advantch platforms ( eg. Intel, ARM - NXP i.MX 8M and NVIDIA Jetson ). User can easily install and set up the ROS2 environment to quickly start developing your Robot applications. ( example: AMR, AGV, Fleet Management ... ).

   

Robotic Development SDK Smart Installer-1.1.jpg


Install

NOTE:

To make sure your Target system satisfy following conditions:

* Advantech platforms with certified Ubuntu Desktop 20.04 LTS or Ubuntu Desktop 22.04 LTS with SUSI driver and WISEAgent installer(WISEAgent v2.0.0 or higher is not supported).
* At least 8 GB hard drive free space
* At least 8 GB RAM
* An active Internet connection is required.
* Use the english language environment in Ubuntu OS.

 

Install the Advantech Robotic Suite. 

$ tar zxfv adv-robotic-suite-installer-<version>.tar.gz
$ sudo ./adv-robotic-suite-installer.run
Make sure you see a message on the last line that the installation is complete, then please restart your computer to complete the environment setup.
Robotic Development SDK finished install.png
 

How to verify the Advantech Robotic Suite has installed successful.
Step 1: Update ROS2 environment variables. 

$ source ~/.bashrc

Step 2: Print ROS2 environment variables 

$ printenv | grep ROS
Step 3: If the installation is successful, you can see below output.
Robotic Development SDK printenv.png
 

Uninstall

Command for uninstall the Advantech Robotic Suite. 

$ cd /usr/local/Advantech/ros
$ ./uninstall.sh

 


Package List

Version Date Functions SOC / OS Product Note
1.4.0 2024-01-31
  • ROS 2 : Foxy Fitzroy (Ubuntu 20.04)
  • ROS 2 : Humble Hawksbill (Ubuntu 22.04)
  • Fast - DDS 
  • rqt_graph
  • RViz
  • rosdep
  • MoveIt
  • SUSI Node
  • Modbus-Master Node
  • OPCUAClinet Node
  • DBMS/rosbag 
  • Docker Container Base SDK
  • (New) DeviceOn ROS2 plugin
  • NXP i.MX 8M Plus / Ubuntu 20.04
  • Intel 11th Tiger Lake / Ubuntu 20.04
  • Intel 12th Alder Lake / Ubuntu 22.04
  • Intel 13th Raptor Lake / Ubuntu 22.04
  • Intel 14th Raptor Lake / Ubuntu 22.04
  • NVIDIA Jetson / Ubuntu 20.04

MIO-5375

AIR-030

AFE-R770  

 

 
1.3.0 2023-06-21
  • ROS 2 : Foxy Fitzroy (Ubuntu 20.04)
  • ROS 2 : Humble Hawksbill (Ubuntu 22.04)
  • Fast - DDS 
  • rqt_graph
  • RViz
  • rosdep
  • MoveIt
  • SUSI Node
  • Modbus-Master Node
  • OPCUAClinet Node
  • DBMS/rosbag 
  • (New) Docker Container Base SDK
  • NXP i.MX 8M Plus / Ubuntu 20.04
  • Intel 11th Tiger Lake / Ubuntu 20.04
  • NVIDIA Jetson / Ubuntu 20.04
  • Intel 12th Alder Lake / Ubuntu 22.04
  • Intel 13th Raptor Lake / Ubuntu 22.04

EPC-R7300

MIO-4370

MIO-5375

AIMB-288E

AIMB-278

EI-53  

 

*Docker container version incompatible issue
1.2.0 2023-02-22
  • ROS 2 : Foxy Fitzroy
  • Fast - DDS 
  • rqt_graph
  • RViz
  • rosdep
  • MoveIt
  • SUSI Node
  • Modbus-Master Node
  • OPCUAClinet Node
  • DBMS/rosbag 
  • NXP i.MX 8M Plus / Ubuntu 20.04
  • Intel 11th Tiger Lake / Ubuntu 20.04
  • (New) NVIDIA Jetson / Ubuntu 20.04

EPC-R7200

EI-52

*Docker container version incompatible issue
1.1.1 2023-01-11
  • ROS 2 : Foxy Fitzroy
  • Fast - DDS 
  • rqt_graph
  • RViz
  • rosdep
  • MoveIt
  • SUSI Node
  • Modbus-Master Node
  • OPCUAClinet Node
  • DBMS/rosbag 
  • NXP i.MX 8M Plus / Ubuntu 20.04
  • (New) Intel 11th Tiger Lake / Ubuntu 20.04 

ARK-1250L

MIO-2375

MIO-5375

 

 

 
1.1.0 2022-12-31
  • ROS 2 : Foxy Fitzroy
  • Fast - DDS 
  • rqt_graph
  • RViz
  • rosdep
  • MoveIt
  • SUSI Node
  • Modbus-Master Node
  • OPCUAClinet Node
  • DBMS/rosbag 
  • NXP i.MX 8M Plus / Ubuntu 20.04

EPC-R3720

EI-52

 

 
Retrieved from "https://ess-wiki.advantech.com.tw/wiki/index.php?title=Advantech_Robotic_Suite/Installation&oldid=36182"