Difference between revisions of "Advantech Robotic Suite/Installation"

From ESS-WIKI
Jump to: navigation, search
 
(60 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 10:
 
'''<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, 22.04 or 24.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>
+
= Verify =
−
<pre>$ source /opt/ros/<ROS_DISTRIBUTION>/setup.bash
+
<span style="font-size:larger;">How to verify the Advantech Robotic Suite has installed successful in Ubuntu 20.04 or 22.04.</span><br/>  
 +
Step 1: Update ROS2 environment variables.
 +
<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>
+
<span style="font-size:larger;">How to verify the Advantech Robotic Suite has installed successful in Ubuntu 24.04.</span><br/>  
−
<pre>ROS_VERSION=2
+
Step 1: Check Advantech Robotic Suite container has been created. [[File:ROS2 Suite container list.png|none|Robotic Development SDK printenv.png]]
−
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
 
</pre>
 
</pre>
 +
&nbsp;
 +
 +
= Package List =
 +
 +
{| border="1" cellpadding="1" cellspacing="1" data-endline="54" data-startline="40" style="width: 1388px;"
 +
|-
 +
! style="width: 79px;" | Version
 +
! style="width: 115px;" | Date
 +
! style="width: 420px;" | Functions
 +
! style="width: 345px;" | SOC / OS
 +
! style="width: 140px;" | Product
 +
! style="width: 304px;" | Note
 +
|-
 +
| style="text-align: center;" | 1.5.0
 +
| style="text-align: center;" | 2025-01-15
 +
| |
 +
*'''(New) Ubuntu 24.04 ROS2 Develop and Utility Container'''
 +
*DeviceOn ROS2 plugin
 +
*Docker Container ROS2 SDK
 +
*ROS 2&nbsp;: Foxy Fitzroy (Ubuntu 20.04)
 +
*ROS 2&nbsp;: Humble Hawksbill (Ubuntu 22.04)
 +
*Fast - DDS&nbsp;
 +
*rqt_graph
 +
*RViz
 +
*rosdep
 +
*MoveIt
 +
*SUSI Node
 +
*Modbus-Master Node
 +
*OPCUAClinet Node
 +
*DBMS/rosbag
 +
 +
| |
 +
*'''(New) Intel 14th Meteor Lake / Ubuntu 24.04'''
 +
*Intel Raptor Lake Refresh / Ubuntu 22.04
 +
*Intel 12th Alder Lake / Ubuntu 22.04
 +
*Intel Raptor Lake / Ubuntu 22.04
 +
*NVIDIA Jetson / Ubuntu 20.04
 +
*Intel 11th Tiger Lake / Ubuntu 20.04
 +
*NXP i.MX 8M Plus / Ubuntu 20.04
 +
 +
| |
 +
AFE-R360
  
 
&nbsp;
 
&nbsp;
  
−
= Function =
+
&nbsp;
  
−
<span style="font-size:larger;">Command for set ROS_DOMAIN_ID of the ROS2 Suite application.</span>
+
| style="text-align: center;" |
−
<pre>
+
|-
−
$ cd /usr/local/Advantech/ros
+
| style="text-align: center;" | 1.4.0
−
$ bash -i change-ros-domain-id.sh
+
| style="text-align: center;" | 2024-01-31
−
</pre>
+
| |
 +
*'''(New) DeviceOn ROS2 plugin'''
 +
*Docker Container ROS2 SDK
 +
*ROS 2&nbsp;: Foxy Fitzroy (Ubuntu 20.04)
 +
*ROS 2&nbsp;: Humble Hawksbill (Ubuntu 22.04)
 +
*Fast - DDS&nbsp;
 +
*rqt_graph
 +
*RViz
 +
*rosdep
 +
*MoveIt
 +
*SUSI Node
 +
*Modbus-Master Node
 +
*OPCUAClinet Node
 +
*DBMS/rosbag&nbsp;
 +
 
 +
| |
 +
*'''(New) Intel Raptor Lake Refresh / Ubuntu 22.04'''
 +
*Intel 12th Alder Lake / Ubuntu 22.04
 +
*Intel Raptor Lake / Ubuntu 22.04
 +
*NVIDIA Jetson / Ubuntu 20.04
 +
*Intel 11th Tiger Lake / Ubuntu 20.04
 +
*NXP i.MX 8M Plus / Ubuntu 20.04
 +
 
 +
| |
 +
MIO-5375
  
−
<span style="font-size:larger;">It can also be manually set ROS_DOMAIN_ID in host or container by following steps.</span><br>
+
AIR-030
−
*Set ROS_DOMAIN_ID in host
 
−
<pre>
 
−
$ echo "export ROS_DOMAIN_ID=<your_domain_id>" >> ~/.bashrc
 
−
</pre>
 
  
−
*Set ROS_DOMAIN_ID in docker container
+
AFE-R770
−
Step1: open docker-compose.yml
+
&nbsp;
−
<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 =
+
&nbsp;
  
−
{| border="1" cellpadding="1" cellspacing="1" data-endline="54" data-startline="40" style="width: 1388px;"
+
| style="text-align: center;" | &nbsp;
−
|-
 
−
! style="width: 79px;" | Version
 
−
! style="width: 142px;" | Date
 
−
! style="width: 438px;" | Functions
 
−
! style="width: 335px;" | SOC / OS
 
−
! style="width: 369px;" | Note
 
 
|-
 
|-
−
| style="width: 79px; text-align: center;" | 1.1.0
+
| style="text-align: center;" | 1.3.0
−
| style="width: 142px; text-align: center;" | 2022-12-31
+
| style="text-align: center;" | 2023-06-21
−
| style="width: 438px;" |  
+
| |  
−
*ROS 2&nbsp;: Foxy Fitzroy  
+
*'''(New) Docker Container ROS2 SDK'''
 +
*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 129: Line 147:
 
*DBMS/rosbag&nbsp;  
 
*DBMS/rosbag&nbsp;  
  
−
| style="width: 335px;" |  
+
| |  
−
*NXP iMX 8 Plus / Ubuntu 20.04  
+
*'''(New) Intel 12th Alder Lake / Ubuntu 22.04'''
 +
*'''(New) Intel Raptor Lake / Ubuntu 22.04'''
 +
*NVIDIA Jetson / Ubuntu 20.04
 +
*Intel 11th Tiger Lake / Ubuntu 20.04
 +
*NXP i.MX 8M Plus / Ubuntu 20.04
 +
 
 +
| |
 +
EPC-R7300
 +
 
 +
MIO-4370
 +
 
 +
MIO-5375
 +
 
 +
AIMB-288E
  
−
| style="width: 369px;" | &nbsp;
+
AIMB-278
 +
 
 +
EI-53
 +
&nbsp;
 +
 
 +
&nbsp;
 +
 
 +
| style="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="text-align: center;" | 1.2.0
−
| style="width: 142px; text-align: center;" | 2023-01-11
+
| style="text-align: center;" | 2023-02-22
−
| style="width: 438px;" |  
+
| |  
 
*ROS 2&nbsp;: Foxy Fitzroy  
 
*ROS 2&nbsp;: Foxy Fitzroy  
 
*Fast - DDS&nbsp;  
 
*Fast - DDS&nbsp;  
Line 148: Line 186:
 
*DBMS/rosbag&nbsp;  
 
*DBMS/rosbag&nbsp;  
  
−
| style="width: 335px;" |  
+
| |  
−
*NXP iMX 8 Plus / Ubuntu 20.04  
+
*'''(New)&nbsp;NVIDIA Jetson / Ubuntu 20.04'''
−
*Intel 11th CPU Tiger Lake / Ubuntu 20.04  
+
*Intel 11th Tiger Lake / Ubuntu 20.04  
 +
*NXP i.MX 8M Plus / Ubuntu 20.04
 +
 
 +
| |
 +
EPC-R7200
 +
 
 +
EI-52
  
−
| style="width: 369px;" | &nbsp;
+
| style="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="text-align: center;" | 1.1.1
−
| style="width: 142px; text-align: center;" | 2023-02-22
+
| style="text-align: center;" | 2023-01-11
−
| style="width: 438px;" |  
+
| |  
 
*ROS 2&nbsp;: Foxy Fitzroy  
 
*ROS 2&nbsp;: Foxy Fitzroy  
 
*Fast - DDS&nbsp;  
 
*Fast - DDS&nbsp;  
Line 168: Line 212:
 
*DBMS/rosbag&nbsp;  
 
*DBMS/rosbag&nbsp;  
  
−
| style="width: 335px;" |  
+
| |  
−
*NXP iMX 8 Plus / Ubuntu 20.04
+
*'''(New)&nbsp;Intel 11th Tiger Lake / Ubuntu 20.04&nbsp;'''
−
*Intel 11th Tiger Lake / Ubuntu 20.04  
+
*NXP i.MX 8M Plus / Ubuntu 20.04  
−
*NVIDIA Jetson / Ubuntu 20.04  
+
 
 +
| |
 +
ARK-1250L
 +
 
 +
MIO-2375
 +
 
 +
MIO-5375
 +
 
 +
&nbsp;
 +
 
 +
&nbsp;
  
−
| style="width: 369px;" | &nbsp;
+
| | &nbsp;
 
|-
 
|-
−
| style="width: 79px; text-align: center;" | 1.3.0
+
| style="text-align: center;" | 1.1.0
−
| style="width: 142px; text-align: center;" | 2023-06-21
+
| style="text-align: center;" | 2022-12-31
−
| style="width: 438px;" |  
+
| |  
−
*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 242:
 
*OPCUAClinet Node  
 
*OPCUAClinet Node  
 
*DBMS/rosbag&nbsp;  
 
*DBMS/rosbag&nbsp;  
−
*Develop Ros2 Foxy Docker Container
 
  
−
| style="width: 335px;" |  
+
| |  
−
*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
+
| |
−
*NVIDIA Jetson / Ubuntu 20.04
+
EPC-R3720
 +
 
 +
EI-52
 +
 
 +
&nbsp;
  
−
| style="width: 369px; text-align: center;" | &nbsp;
+
| | &nbsp;
 
|}
 
|}

Latest revision as of 06:36, 24 January 2025

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, 22.04 or 24.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
 

Verify

How to verify the Advantech Robotic Suite has installed successful in Ubuntu 20.04 or 22.04.
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
 

How to verify the Advantech Robotic Suite has installed successful in Ubuntu 24.04.

Step 1: Check Advantech Robotic Suite container has been created.
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.5.0 2025-01-15
  • (New) Ubuntu 24.04 ROS2 Develop and Utility Container
  • DeviceOn ROS2 plugin
  • Docker Container ROS2 SDK
  • 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) Intel 14th Meteor Lake / Ubuntu 24.04
  • Intel Raptor Lake Refresh / Ubuntu 22.04
  • Intel 12th Alder Lake / Ubuntu 22.04
  • Intel Raptor Lake / Ubuntu 22.04
  • NVIDIA Jetson / Ubuntu 20.04
  • Intel 11th Tiger Lake / Ubuntu 20.04
  • NXP i.MX 8M Plus / Ubuntu 20.04

AFE-R360

 

 

1.4.0 2024-01-31
  • (New) DeviceOn ROS2 plugin
  • Docker Container ROS2 SDK
  • 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) Intel Raptor Lake Refresh / Ubuntu 22.04
  • Intel 12th Alder Lake / Ubuntu 22.04
  • Intel Raptor Lake / Ubuntu 22.04
  • NVIDIA Jetson / Ubuntu 20.04
  • Intel 11th Tiger Lake / Ubuntu 20.04
  • NXP i.MX 8M Plus / Ubuntu 20.04

MIO-5375

AIR-030

AFE-R770  

 

 
1.3.0 2023-06-21
  • (New) Docker Container ROS2 SDK
  • 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) Intel 12th Alder Lake / Ubuntu 22.04
  • (New) Intel Raptor Lake / Ubuntu 22.04
  • NVIDIA Jetson / Ubuntu 20.04
  • Intel 11th Tiger Lake / Ubuntu 20.04
  • NXP i.MX 8M Plus / Ubuntu 20.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 
  • (New) NVIDIA Jetson / Ubuntu 20.04
  • Intel 11th Tiger Lake / Ubuntu 20.04
  • NXP i.MX 8M Plus / 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 
  • (New) Intel 11th Tiger Lake / Ubuntu 20.04 
  • NXP i.MX 8M Plus / 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=38308"