Difference between revisions of "Advantech Robotic Suite/Installation"

From ESS-WIKI
Jump to: navigation, search
 
(87 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, NVIDIA Jetson and Qualcomm ). 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 Suite SDK Smart Installer-1.1.jpg]]
  
−
&nbsp; &nbsp;
+
= Download =
−
 
 
−
<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;
+
<span style="font-size:larger;">[https://www.advantech.com/en/form/11905901-d135-4dc1-a72d-0450b233d62e?callback=2af806b3-06a3-4f48-9edb-555899ff4da6 Download Advantech Robotic Suite]</span>
  
 
= Install =
 
= Install =
Line 25: Line 14:
 
'''<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;">Install the Advantech Robotic Suite.</span>
 +
<pre>$ tar zxfv adv-robotic-suite-installer-<version>.tar.gz
 +
$ sudo ./adv-robotic-suite-installer.run
 +
</pre>
  
−
<span style="font-size:larger;">Command for install the ROS2 Suite.</span>
+
<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 Suite SDK finished install.png]] &nbsp; If you encounter any issues during the installation process, please refer to [[Advantech_Robotic_Suite/Q&A#Installation|Q&A]]
−
<pre>$ tar zxfv adv-ros2-suite-installer-<version>.tar.gz
 
−
$ sudo ./adv-ros2-suite-installer.run
 
−
</pre>
 
  
−
&nbsp;
+
= Verify =
  
−
<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 in Ubuntu 20.04 or 22.04.</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 Suite 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/> Step 1: Check Advantech Robotic Suite container has been created. [[File:ROS2 Suite container list.png|none|Robotic Suite SDK printenv.png]]
−
<pre>ROS_VERSION=2
 
−
ROS_PYTHON_VERSION=3
 
−
ROS_LOCALHOST_ONLY=0
 
−
ROS_DISTRO=foxy
 
−
</pre>
 
  
 
&nbsp;
 
&nbsp;
Line 61: Line 43:
 
= 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 68: Line 50:
 
&nbsp;
 
&nbsp;
  
−
= Function =
+
&nbsp;
  
−
<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>
+
= Package List =
−
*Set ROS_DOMAIN_ID in host
+
 
−
<pre>
+
{| border="1" cellpadding="1" cellspacing="1" data-endline="54" data-startline="40"
−
$ echo "export ROS_DOMAIN_ID=<your_domain_id>" >> ~/.bashrc
+
|-
−
</pre>
+
! style="width: 80px;" | Version
 +
! style="width: 110px;" | Date
 +
! style="width: 380px;" | Functions
 +
! style="width: 310px;" | SOC / OS
 +
! style="width: 160px;" | Product
 +
! style="width: 300px;" | Note
 +
|-
 +
| style="text-align: center;" | 1.6.0
 +
| style="text-align: center;" | 2025-08-13
 +
||
 +
*Web UI of Robotic
 +
*Time Sync Viewer
 +
*AMR Extension
 +
 
 +
||
 +
* Intel 14th Meteor Lake / Ubuntu 22.04
 +
* NVIDIA Jetson AGX / Ubuntu 22.04
 +
* Qualcomm QCS6490 / Yocto 4.0
  
−
*Set ROS_DOMAIN_ID in docker container
+
||
−
Step1: open docker-compose.yml
+
*AFE-R360
−
<pre>
+
*AIR-030
−
$ cd /usr/local/Advantech/ros/container/edge-ros2-foxy/docker-compose/<docker_container_name>
+
*AOM-2721
−
$ 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
 
−
<pre>
 
−
$ cd /usr/local/Advantech/ros/container/
 
−
$ ./stop.sh <docker_container_name>
 
−
$ ./launch.sh <docker_container_name>
 
−
</pre>
 
  
−
= Package List =
+
| style="text-align: left;" |
 +
*New functions are for AFE-R360, AFE-R760 and AFE-R770
 +
*SUSI, DeviceOn, rqt, RViz, nodejs example are not supported on AOM-D2721 platform with Yocto
  
−
{| border="1" cellpadding="1" cellspacing="1" data-endline="54" data-startline="40" style="width: 1388px;"
 
 
|-
 
|-
−
! style="width: 79px;" | Version
+
| style="text-align: center;" | 1.5.0
−
! style="width: 142px;" | Date
+
| style="text-align: center;" | 2025-01-15
−
! style="width: 438px;" | Functions
+
||
−
! style="width: 335px;" | SOC / OS
+
*Ubuntu 24.04 ROS2 Develop and Utility Container
−
! style="width: 369px;" | Note
+
 
 +
||  
 +
* Intel 14th Meteor Lake / Ubuntu 24.04
 +
 
 +
||
 +
*AFE-R360
 +
 
 +
| style="text-align: center;" | &nbsp;
 
|-
 
|-
−
| style="width: 79px; text-align: center;" | 1.1.0
+
| style="text-align: center;" | 1.4.0
−
| style="width: 142px; text-align: center;" | 2022-12-31
+
| style="text-align: center;" | 2024-01-31
−
| style="width: 438px;" |  
+
||
−
*ROS 2&nbsp;: Foxy Fitzroy
+
*DeviceOn ROS2 plugin
−
*Fast - DDS&nbsp;  
+
 
−
*rqt_graph
+
||
−
*RViz
+
* Intel Raptor Lake Refresh / Ubuntu 22.04
−
*rosdep
+
* NVIDIA Jetson AGX / Ubuntu 20.04
−
*MoveIt
+
 
−
*SUSI Node
+
||
−
*Modbus-Master Node
+
*MIO-5375
−
*OPCUAClinet Node
+
*AIR-030
−
*DBMS/rosbag&nbsp;
+
 
 +
| style="text-align: center;" | &nbsp;
 +
|-
 +
| style="text-align: center;" | 1.3.0
 +
| style="text-align: center;" | 2023-06-21
 +
||
 +
*Docker Container ROS2 SDK
 +
*ROS 2&nbsp;: Humble Hawksbill (Ubuntu 22.04)
 +
 
 +
||
 +
* Intel 12th Alder Lake / Ubuntu 22.04
 +
* Intel Raptor Lake / Ubuntu 22.04
  
−
| style="width: 335px;" |  
+
||  
−
*NXP iMX 8 Plus / Ubuntu 20.04
+
*EPC-R7300
 +
*MIO-4370
 +
*MIO-5375
 +
*MIO-5377
 +
*AIMB-288E
 +
*AIMB-278
 +
*AIMB-522
 +
*AIMB-588
 +
*AIMB-592
 +
*ARK-3533
 +
*EI-53
  
−
| 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.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;" |  
+
|| &nbsp;
−
*ROS 2&nbsp;: Foxy Fitzroy
+
||
−
*Fast - DDS&nbsp;
+
* NVIDIA Jetson NX / Ubuntu 20.04
−
*rqt_graph
 
−
*RViz
 
−
*rosdep
 
−
*MoveIt
 
−
*SUSI Node
 
−
*Modbus-Master Node
 
−
*OPCUAClinet Node
 
−
*DBMS/rosbag&nbsp;
 
  
−
| style="width: 335px;" |  
+
||  
−
*NXP iMX 8 Plus / Ubuntu 20.04
+
*EPC-R7200
−
*Intel 11th CPU Tiger Lake / Ubuntu 20.04
+
*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;" |  
+
|| &nbsp;
−
*ROS 2&nbsp;: Foxy Fitzroy
+
||
−
*Fast - DDS&nbsp;
+
*Intel 11th Tiger Lake / Ubuntu 20.04
−
*rqt_graph
+
 
−
*RViz
+
||
−
*rosdep
 
−
*MoveIt
 
−
*SUSI Node
 
−
*Modbus-Master Node
 
−
*OPCUAClinet Node
 
−
*DBMS/rosbag&nbsp;
 
  
−
| style="width: 335px;" |
+
*MIO-2375
−
*NXP iMX 8 Plus / Ubuntu 20.04
+
*MIO-5375
−
*Intel 11th Tiger Lake / Ubuntu 20.04
 
−
*NVIDIA Jetson / Ubuntu 20.04
 
  
−
| 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;: Humble Hawksbill
+
*ROS 2&nbsp;: Foxy Fitzroy
 
*Fast - DDS&nbsp;  
 
*Fast - DDS&nbsp;  
 
*rqt_graph  
 
*rqt_graph  
Line 187: Line 177:
 
*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
  
−
| style="width: 369px; text-align: center;" | Coming Soon! &nbsp;
+
|| &nbsp;
 
|}
 
|}

Latest revision as of 10:56, 16 September 2025

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

   

Robotic Suite SDK Smart Installer-1.1.jpg

Download

Download Advantech Robotic Suite

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 Suite SDK finished install.png
  If you encounter any issues during the installation process, please refer to Q&A

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 Suite 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 Suite 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.6.0 2025-08-13
  • Web UI of Robotic
  • Time Sync Viewer
  • AMR Extension
  • Intel 14th Meteor Lake / Ubuntu 22.04
  • NVIDIA Jetson AGX / Ubuntu 22.04
  • Qualcomm QCS6490 / Yocto 4.0
  • AFE-R360
  • AIR-030
  • AOM-2721
  • New functions are for AFE-R360, AFE-R760 and AFE-R770
  • SUSI, DeviceOn, rqt, RViz, nodejs example are not supported on AOM-D2721 platform with Yocto
1.5.0 2025-01-15
  • Ubuntu 24.04 ROS2 Develop and Utility Container
  • Intel 14th Meteor Lake / Ubuntu 24.04
  • AFE-R360
  
1.4.0 2024-01-31
  • DeviceOn ROS2 plugin
  • Intel Raptor Lake Refresh / Ubuntu 22.04
  • NVIDIA Jetson AGX / Ubuntu 20.04
  • MIO-5375
  • AIR-030
  
1.3.0 2023-06-21
  • Docker Container ROS2 SDK
  • ROS 2 : Humble Hawksbill (Ubuntu 22.04)
  • Intel 12th Alder Lake / Ubuntu 22.04
  • Intel Raptor Lake / Ubuntu 22.04
  • EPC-R7300
  • MIO-4370
  • MIO-5375
  • MIO-5377
  • AIMB-288E
  • AIMB-278
  • AIMB-522
  • AIMB-588
  • AIMB-592
  • ARK-3533
  • EI-53
*Docker container version incompatible issue
1.2.0 2023-02-22  
  • NVIDIA Jetson NX / Ubuntu 20.04
  • EPC-R7200
  • EI-52
 *Docker container version incompatible issue
1.1.1 2023-01-11  
  • Intel 11th Tiger Lake / Ubuntu 20.04
  • 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
  
Retrieved from "https://ess-wiki.advantech.com.tw/wiki/index.php?title=Advantech_Robotic_Suite/Installation&oldid=40792"