• Advance preparation
  • Installation of Python
  • Download OpenRTM-aist
  • Installing OpenRTM-aist
  • Run VCVerChanger
  • Run the sample component
    • Advance preparation
  • Start Naming Service
  • Sample component
    • Use ConsoleInComp and ConsoleOutComp
    • Launch the sample component
  • Start OpenRTP
  • Using RTSystemEditor
    • Checking the operation on the component console screen
  • Use rtshell
  • Next...

The latest version OpenRTM-aist-2.0.1-RELEASE installs C++ version, Python version, Java version.
Also, rtshell will be installed at the same time.

Advance preparation

Installation of Python

If Python is not installed, OpenRTM-aist can not be installed.
Please install Python before installing OpenRTM - aist.
The Python version corresponds to "3.11", "3.10", "3.9", "3.8", "3.7".
To download Python please see Installation of OpenRTM-aist 2.0 series on Windows.

For Python , check [add python *** to PATH] at the bottom of the first screen.

The Python installation destination corresponds to the [Customize installation] selection made during installation.

Set the search path automatically by the following method. This will add the directory where python.exe is located and the Scripts directory to Path.
(Example: Path=C:\Python38;C:\ Python38\Scripts;...）

[Installing Python]

• Launch the Python installer. To install Python 3.7, 3.8, 3.9, 3.10, 3.11 check [add python *** to PATH] at the bottom of the first screen and select [Customize installation].
  

• There are no changes on the next Optional Features screen. Select [Next] to proceed.
  

• On the [Advanced Options] screen, check [Install for all users] and set the installation destination in [Customize install location]. (Example: Path=C:\Python38;C:\ Python38\Scripts;...)
  

• Select Install to complete the installation.

Download OpenRTM-aist

To download the installer please see Download.

If you are using Microsoft Edge and the following message appears and you cannot download, we will introduce the procedure.

• Click the "..." that appears when you over your mouse.
  

• Click "Save".
  

• Click "Details".
  

• Click "Save".
  

• This will complete the download, so click "Open File" to start the installer.
  

Installing OpenRTM-aist

[Installation procedure]

1. Launch the installer. When the [Windows protected your PC] screen is displayed, click [Details] to display the [Run] button, and then click [Run]. (This screen is displayed when installing an application that is not registered with Microsoft Corp. on a certain version of Windows or later, and this screen is displayed because this software is not registered.)

1. Then click Next.
   
   
   

1. This is the page of the license agreement. Accept the software license terms and click Next.
   
   
   

1. Select the installation type. Accept the default and click Next.
   
   
   
2. Select the Visual Studio version.
   • Set the version of Visual Studio used in the C++ version in the system environment variable.
   • Select the installed version of Visual Studio and click Next.
     • For downloading Visual Studio, see OpenRTM-aist 2.0 installation to Windows.
     • The version of Visual Studio can be changed with the tool VCVerChanger after installation is complete. (How to use VCVerChanger)
     • Since it is irrelevant for Python version and Java version, click [Next] with the default.
       
       
       
3. Select the setup type.
   When [Standard] is selected, OpenRTM-aist C++ version, Java version, Python version, OpenRTP, RTSystemEditorRCP, RTShell, OpenRTM-aist-C++ version Visual Studio 2015 to 2022 runtime library, OpenRTM-aist-1.0. The runtime libraries from 0 to 2.0.0 are installed. If you have no particular reason to change it, click Standard.
   
   
   
   
4. Click [Install] to start the installation.
   
   
   
   
   
   
5. The installation is complete. Click Finish to exit the installer.
   
   
   

Run VCVerChanger

The installer registers the system environment variables used by OpenRTM-aist in the registry. Some of these environment variables contain another environment variable, %RTM_VC_VERSION%. Such nested environment variables may not expand recursively.

To resolve, run VCVerChanger. Pressing the "Confirm" button expands the environment variables and writes them back to the registry. (How to use VCVerChanger)

Run the sample component

Advance preparation

• Although not required, start many applications registered in the start menu from here. It's hard to go from the start menu each time, so Display the start menu from the start button, right-click [OpenRTM-aist 2.0.0 x86_64]> [OpenRTP] and select [Open File Location].
  
  
  Open file location

• In this way, the Start Menu folder will be opened and you can easily access the applications registered in the menu.

Start Naming Service

• Double-click Start Naming Service. The following console screen will be displayed.
  
  Start Naming Service

Sample component

Use ConsoleInComp and ConsoleOutComp

ConsoleInComp and ConsoleOutComp are samples showing how to use DataInPort and DataOutPort. The number entered on the Console In side is displayed on the Console Out side. Here, use these two components to check the operation.

Launch the sample component

• Double-click ConsoleIn.bat and ConsoleOut.bat in the [OpenRTM-aist 2.0.0 x86_64]>[C++_Example] folder. If the [Important Windows Security Warning] screen is displayed, check [Private network (home network, corporate network, etc.)] and click [Allow access]. The following console screen will be displayed.
  
  ConsoleIn.bat and ConsoleOut.bat

Start OpenRTP

• Click the desktop shortcut to launch it. In the start menu, select [OpenRTM-aist 2.0.1 x86_64]> [OpenRTP]. You can also start it by double-clicking OpenRTP from the folder screen you opened earlier.
  • Please specify a suitable place for the workspace.
    
    Select Workspace

• Since the "Welcome" screen is not required, click the [x] button on the [Welcome] tab in the upper left to close the screen.
  
  Initial startup screen

Using RTSystemEditor

• Click [Open Perspective] at the top right of the screen. Select [RT System Editor] in the dialog that appears and click [Open] to start RT System Editor.
  
  Switching perspectives

• The component appears in the Name Service View. Initially it is not shown because it is collapsed, but if you click [>] to expand it, you can see the ConsoleIn and ConsoleOut components.
  
  Component startup confirmation

• If the name server is not displayed in NameServerView, add localhost manually. Click Add Name Server on the image to display the dialog. Type "localhost" and click OK to add it. If it still does not start, please close all console screens once and try the procedure from starting Naming Service again.
  
  Add Name Server

• Click Open New System Editor from the toolbar to display the System Diagram.
  
  Display System Diagram

• If you drag and drop the ConsoleIn and ConsoleOut components in the [NameServiceView] onto the [System Diagram], you can see the host context of the host name and the ConsoleIn and ConsoleOut components. Depending on the settings, the host context (the hierarchy of “hostname | host_cxt” such as “TPAD-RTM-NO13 | host_cxt” in the figure) may not be displayed and the component may be displayed directly.
  
  Drag and drop components

• Connect components by dragging and dropping between data ports. After that, a dialog box prompting you to enter the information required for connection will be displayed. Click [OK].
  
  Component connection

• It will be connected as shown in the image below.
  
  Connection completed

• Sets the component status to Active. Click [All Activate]. It is successful when the color of the component changes from blue to light green. It is also possible to individually activate each component by selecting it and right-clicking. (If [All Activate] is not displayed, try restarting Openrtp. Or you can activate each component individually.)
  
  
  
  
  Activate complete

Checking the operation on the component console screen

• Then check the operation on the console screen. After connecting with RTSystemEditor, "Please input number:" is displayed on the Console In screen.
  
  Displayed as「Please input number:」

• Enter an arbitrary value on the Console In screen and press [Enter] to display the value on the Console Out screen.
  
  Operation check

• If you enter a non-numeric value or enter a too large value, the operation may be strange. In that case, stop the operation of the batch file with the Cntrl-C key, and start the batch file again.
• If you want to exit the component, click All Deactivate from the toolbar. Then right-click the component and select [Exit].
  • If Deactivate takes a long time, it is stopped by entering a value in ConsoleIn. In that case, enter some value.
    
    ''Deactivate component'

• This is the end of the operation check using ConsoleIn and ConsoleOut.

Use rtshell

OpenRTM-aist installs rtshell as standard. By using rtshell, you can activate, deactivate, and terminate RTC from the command line.
Please see Install rtshell・Operation Check (On Windows)

Next...

Please see the link below.

• Try running more samples ： Sample component
• Try making a component ： Case study
• Learn from the basics of OpenRTM ： Developer's Guide
• Join the community ： community
• Look at the public components ： Project