OpenRTM-aistを10分で始めよう!

最新バージョンOpenRTM-aist-1.2.1-RELEASEではC++版、Python版、Java版、OpenRTPがインストールされます。また、rtshellも同時にインストールされます。

事前準備

Pythonのインストール

Pythonをインストールしていない場合は、OpenRTM-aistをインストールできません。 OpenRTM-aistをインストールする前に、Pythonをインストールしてください。バージョンは、"3.7"、"3.6"、"2.7"に対応しています。

PythonのダウンロードはOpenRTM-aist-1.2.1-RELEASEをご覧ください。

Pythonのインストール先は、3.6または3.7の場合はインストール時の選択[Install Now] [Customize installation]のどちらにも対応しています。 2.7の場合はデフォルトの[Install for all users]設定のみに対応しています。

サーチパスは、以下の方法で自動で設定されるようにしてください。こうすると、python.exeが置いてあるディレクトリとScriptsディレクトリがPathに追加されます。
(例: Path=C:\Python27;C:\Python27\Scripts;...)

  • Python 3.6または3.7のインストールでは、最初の画面の下部にある[add python *** to PATH]にチェックを入れてください。
  • Python 2.7のインストールを実行した際は、以下の画面で[Add python.exe to Path]を[Will be installed on local hard drive]に設定してください。
    Python-install001.png

OpenRTM-aistのインストール

ここではWindows 10で64bit用インストーラーOpenRTM-aist-1.2.1-RELEASE_x86_64.msiを使ったインストール手順を紹介します。

インストーラーのダウンロードはOpenRTM-aist-1.2.1-RELEASEをご覧ください。

[インストール手順]
  1. インストーラーを起動します。[WindowsによってPCが保護されました]の画面が表示されたら[詳細情報]をクリックして[実行]ボタンを表示させて、[実行]をクリックします。(この画面はWindowsのあるバージョン以降でMicrosoft Corp.に登録されていないアプリケーションのインストール時に表示される画面で、本ソフトウエアは登録をしていないため、この画面が表示されます。)
  2. [次へ]をクリックします。
    Openrtm121-Install001.png

  3. 使用承諾契約書のページです。ソフトウェアライセンス条項に同意して[次へ]をクリックします。
    Openrtm121-Install002.png

  4. インストールの種類を選択します。デフォルトのまま[次へ]をクリックします。
    Openrtm121-Install003.png

  5. Visual Studioのバージョンを選択します。
    • C++版で使用するVisual Studioのバージョンをシステム環境変数に設定します。
    • インストールされている Visual Studioのバージョンを選択して[次へ]をクリックします。
      • Visual StudioのダウンロードはOpenRTM-aist-1.2.1-RELEASEをご覧ください。
      • Visual Studioのバージョンは、インストール終了後にツールのVCVerChangerで変更できます。(VCVerChangerの使い方)
      • Python版、Java版では無関係ですのでデフォルトのまま[次へ]をクリックしてください。
        Openrtm121-Install004.png

  6. セットアップの種類を選択します。 [標準]を選択した場合、OpenRTM-aistのC++版、Java版、Python版、OpenRTP、RTSystemEditorRCP、RTShell、OpenRTM-aist-C++版のVisual Studio 20010から2019までのランタイムライブラリ、OpenRTM-aist-1.0.0から1.2.1までのランタイムライブラリがインストールされます。特に変更理由がないようであれば[標準]をクリックします。
    Openrtm121-Install005.png

  7. [インストール]をクリックするとインストールが開始されます。
    Openrtm121-Install006.png

    Openrtm121-Install007.png

  8. インストールが終了しました。[完了]をクリックしてインストーラーを終了します。
    Openrtm121-Install008.png

サンプルコンポーネントを実行する

事前準備

  • 必須ではありませんが、ここからはスタートメニューに登録されたアプリケーションを多数起動します。毎回スタートメニューから順番にたどるのは大変ですので、 スタートボタンからスタートメニューを表示させ[OpenRTM-aist 1.2.1 x86_64]>[OpenRTP]を右クリックして[ファイルの場所を開く]を選択してください。
    Startmenu001.png
    ファイルの場所を開く


Startmenu002.png

スタートメニューフォルダー


    • このように、スタートメニューのフォルダーが開かれ、メニューに登録されているアプリケーションにアクセスしやすくなります。

Naming Serviceの起動

  • Start Naming Serviceをダブルクリックします。以下のようなコンソール画面が表示されます。
    StartNameService001.png
    Start Naming Service

サンプルコンポーネント

ConsoleInComp、ConsoleOutCompを使用する

ConsoleInComp、ConsoleOutCompはDataInPort、DataOutPortの使用方法を示したサンプルです。ConsoleIn側で入力した数字が,ConsoleOut側に表示されます。ここではこの二つのコンポーネントを使用し、動作確認を行います。

サンプルコンポーネントの起動

  • [OpenRTM-aist 1.2.1 x86_64]>[C++_Example]フォルダー内のConsoleIn.batとConsoleOut.batをダブルクリックします。もし[Windows セキュリティのの重要な警告]画面が表示されたら[プライベートネットワーク(ホームネットワーク社内ネットワークなど)(R)]にチェックマークをつけて[アクセスを許可する(A)]をクリックしてください。以下のようなコンソール画面が表示されます。
    ConsoleIn001.pngConsoleOut001.png
    ConsoleIn.batとConsoleOut.bat


OpenRTP起動

  • デスクトップのショートカットをクリックして起動します。スタートメニューでは、[OpenRTM-aist 1.2.1 x86_64]>[OpenRTP]と選択してください。先ほど開いたフォルダー画面からOpenRTPをダブルクリックすることによっても起動できます。
    • ワークスペースは適当な場所を指定してください。
      OpenRTP001.png
      ワークスペースの選択

  • 「ようこそ」画面は必要ないので左上の[ようこそ]タブの[×]ボタンをクリックして画面を閉じてください。
    OpenRTP002.png
    初期起動時の画面

RTSystemEditorの使用

  • 画面右上の[パースペクティブを開く]をクリックします。表示されるダイアログで[RT System Editor]を選択して[開く]をクリックするとRTSystemEditorが起動します。
    OpenRTP003.png OpenRTP004.png
    パースペクティブの切り替え

  • [NameServiceView]にコンポーネントが表示されます。最初は折りたたまれているため表示されていませんが、[>]をクリックし展開すると、ConsoleIn、ConsoleOutコンポーネントが確認できます。
    OpenRTP005.png
    コンポーネント起動確認

    • NameServerViewにネームサーバーが表示されない時は、手動でlocalhostを追加します。画像の[ネームサーバを追加]をクリックしてダイアログを表示します。「localhost」と入力し[OK]をクリックして追加します。それでも起動されなかった場合は、一度すべてのコンソール画面を閉じてNaming Serviceの起動からの手順をやり直してみてください。
      OpenRTP006.png OpenRTP007.png
      ネームサーバの追加

  • ツールバーから [Open New System Editor]をクリックして、[System Diagram]を表示します。
    OpenRTP008.png
    System Diagramを表示

  • [NameServiceView]にあるConsoleIn、ConsoleOutのコンポーネントを[System Diagram]上にドラッグ&ドロップすると、以下の画像のように表示されます。
    OpenRTP009.png
    コンポーネントをドラッグ&ドロップ

  • データポート間でドラッグ&ドロップしてコンポーネントを接続します。その後、接続に必要な情報の入力を促すダイアログが表示されるので[OK]をクリックします。
    OpenRTP010.png OpenRTP011.png
    コンポーネント接続

    • 以下の画像のように接続されます。
      OpenRTP012.png
      接続完了

  • コンポーネントの状態をActiveにします。[All Activate]クリックしてください。コンポーネントの色が青から明るい緑に変わったら成功です。コンポーネントは個別に選択して右クリックをすることに個別にActiveにすることも可能です。([All Activate]が表示されていない場合は、Openrtpを再起動してみてください。または、コンポーネントを個別にActiveにしても良いです。)
    OpenRTP013.png

    OpenRTP014.png
    Activate完了

コンポーネントのコンソール画面での動作確認

  • 次にコンソール画面で動作確認します。RTSystemEditorで接続後、ConsoleIn画面に「Please input number:」と表示されます。
    Console001.png
    「Please input number:」と表示

  • ConsoleIn画面で任意の数値を入力し[Enter]を押すと、ConsoleOut画面に数値が表示されます。
    Console002.png Console003.png
    動作確認

    • 数値以外の入力や、大きすぎる数値を入力すると動作がおかしくなることがあります。その場合はCntrl-Cキーでバッチファイルの動作を停止させ、再度バッチファイルの起動からやり直してください。
  • コンポーネントを終了する場合は、ツールバーから[All Deactivate]をクリックします。その後、コンポーネントを右クリックして[Exit]してください。
    • Deactivateに時間がかかる場合はConsoleInの数値入力で止まっているので、その場合は何か数値を入力してください。
      Console004.png
      コンポーネントのDeactivate


Console005.png
コンポーネントの終了


  • 以上でConsoleInとConsoleOutを使用した動作確認は終了です。

rtshellを利用する

OpenRTM-aist-1.2.1ではrtshellが標準でインストールされます。 rtshellを利用することでコマンドラインからRTCのActivate、Deactivate、終了等ができるようになります。
  • 64bit版をインストールした場合にdllの不足により正常動作しない場合があります。その場合はWindows Updateを実行してください。

    RTCの操作

サンプルコンポーネントを起動し、rtshellによりコマンドラインからデータポートの接続、RTCのActivate、Deactivate、終了を行います。

rtm-namingを起動

  • [OpenRTM-aist 1.2.1 x86_64]フォルダー内のStart Naming Serviceをダブルクリックして起動します。

    サンプルコンポーネントの起動

まずはサンプルコンポーネントを起動して、起動したコンポーネントをrtshellで操作します。
  • [OpenRTM-aist 1.2.1 x86_64]>[Python_Examples]フォルダー内のConsoleIn.batとConsoleOut.batをクリックするとコンソール画面が起動します。もし[Windows セキュリティのの重要な警告]画面が表示されたら[プライベートネットワーク(ホームネットワーク社内ネットワークなど)(R)]にチェックマークをつけて[アクセスを許可する(A)]をクリックしてください。この時点ではコンソール画面上は起動時のpyプログラムの起動コマンドが表示されるだけで、先に実行したC++ Exampleの場合とは画面が出力が異なります。

    コマンドプロンプトからの操作

  • 次にスタートメニューから[Windows システム ツール]>[コマンドプロンプト]を起動してください。
    Console006.png
    コマンドプロンプトの起動

  • C:\Python27\Scriptsをパスを設定していない場合は以下のコマンドでパスを設定してください。
     # Python 2.7がC:\の直下 Python27 ディレクトリにインストールされている場合
     set PATH=C:\Python27\Scripts;%PATH%
     # Python 3.7がC:\Program Filesの下 Python37 ディレクトリにインストールされている場合
     set PATH=C:\Program Files\Python37\Scripts;%PATH%

※ Python をインストールする場合できるだけ管理者権限でデフォルトのパスにインストールしてください。 ※ アカウントのローカルディレクトリやVisual Studio と一緒にインストールしている場合は、C:\Users\<ユーザ名>\AppData\Local\Programs\Python といった場所にインストールされている場合もありますので注意してください。

  • 次に以下のコマンドでデータポートを接続します。
     rtcon /localhost/ConsoleIn0.rtc:out /localhost/ConsoleOut0.rtc:in
    • すると ConsoleIn.py、ConsoleOut.pyコンソールに以下のような文字列が表示されます。
       ------------------------------
       Listener:        ON_CONNECT
       Profile::name:   outin
       Profile::id:     4d622f80-135f-11e6-b923-001c4231a7a3
       ------------------------------
  • 念のためRTSystemEditorで確認します。
    • [NameServiceView]のコンポーネントをSystem Diagramにドラッグ&ドロップすると、データポートが接続されたことが確認できます。
      Console007.png
      データポート接続の確認

  • 次に、以下のコマンドでRTCをActivateします。
     rtact /localhost/ConsoleIn0.rtc /localhost/ConsoleOut0.rtc
    • Activateに成功するとConsoleIn.pyコンソールに「Please input number:」と表示されます。RTSystemEditorを見ると、RTCがActivateされたことが確認できます。
      Console008.png
      Activateの確認

  • そしてConsoleIn.py画面で数値を入力し[Enter]を押すと、ConsoleOut.py画面に数値が表示されます。
    Console009.png Console010.png
    ConsoleIn.pyとConsoleOut.py

  • 以下のコマンドでRTCをDeactivateしてください。
     rtdeact /localhost/ConsoleIn0.rtc /localhost/ConsoleOut0.rtc
    • ConsoleInがDeactivateできない場合、数値入力で止まっているので何か数値を入力してください。
  • 最後に以下のコマンドでRTCを終了させてください。
     rtexit /localhost/ConsoleIn0.rtc
     rtexit /localhost/ConsoleOut0.rtc

    次は...

下記リンク先をご覧ください。

ダウンロード

最新バージョン : 2.0.1-RELESE

統計

Webサイト統計
ユーザ数:2159
プロジェクト統計
RTコンポーネント307
RTミドルウエア35
ツール22
文書・仕様書2

Choreonoid

モーションエディタ/シミュレータ

OpenHRP3

動力学シミュレータ

OpenRTP

統合開発プラットフォーム

産総研RTC集

産総研が提供するRTC集

TORK

東京オープンソースロボティクス協会

DAQ-Middleware

ネットワーク分散環境でデータ収集用ソフトウェアを容易に構築するためのソフトウェア・フレームワーク