はじめに
OpenRR は私(@OTL)が代表取締役社長をやっているスマイルロボティクス株式会社が中心となって開発しています。
（Qiita的にこういう宣伝はOKらしいですが念の為）
OpenRRとは
OpenRRはオープンソース（Apache-2)ライセンスのRust用のロボット開発フレームワークです。
Rustはロボットと相性のよい言語だと思います。ご参考：三年前のわたしのQiita記事
OpenRRは arci というロボット仮想化インタフェース(単なるtraitですが)を持っており、ロボットや外部フレームワークに直接依存することなくコードが書ける環境を用意します。
現状ではROS1とurdf-vizでの静的シミュレーション(ビューワー)に対応しています。ROS2への対応も予定しています。
特徴
特徴として、
- MacOS/Linux/Windows(WindowsのみROS非対応)で動く
- ROSがインストールされていなくてもROSが使える
なので、 ROSがインストールされていないMacOSからLinux上のROSで動くロボットを動かす ことが出来ます。これは世界初かもしれません。
ただ、これはrosrustがpure Rustで出来ていることに依るところが大きく、ROS2では無理かと思われます。
アーキテクチャ
アーキテクチャ的には↓のような感じで、とにかく arci を使ってプログラム書こうぜ、arci を使った便利ライブラリ、フレームワークが OpenRR本体、って感じです。
最終的なロボットとの通信の実装は仮想化されているのでROS1のプログラムを一瞬でROS2のプログラムに変更することが出来るようになる予定です。
発音
一応公式な発音は「オープナー」です。未来を切り開く的な思いが込められています。
開発状況
OpenRRは公開されているものの、まだまだ開発途中です。Rustのバージョンは通常0.1.0から始まるのですが、0.0.1くらいのバージョン番号をつけています。
ライブラリとして本格的に取り込むには変更が頻繁すぎてリスキーですが、いいものになるように （とくにarciのインタフェースについて） ご意見等頂ければありがたいです。
OpenRR Appsを試してみる
OpenRRを使って作ったアプリがあるので紹介します。
準備
Linuxの人はREADME.mdに従って依存ライブラリをインストールしておいてください。
Rustのインストール
https://rustup.rs/ にアクセスして、コマンドをターミナルにコピペしてrustをインストールしましょう。すでにインストールしてある人は念の為rustup updateしてください。
source ~/.cargo/env も忘れずに。
urdf-vizのインストール
必須ではないですが、ROSがないときのシミュレータ代わりのビューワーとしてurdf-vizをインストールしましょう。URDFファイルを可視化するには便利なツールです。同じくMacOS/Windowsでも動きます。(xacroやrospackが必要なurdf/xacroファイル(メッシュのパスが package:// のもの)はLinuxでしか表示出来ないので、もし表示したければxacroはLinuxで出力し、package://はurdfからの相対パスか絶対パスに編集しておく必要があります。)
cargo install urdf-viz
openrr-appsのインストール
cargo install openrr-apps --features ros
Windowsの場合はROSが使えないので
cargo install openrr-apps
としてください（ROSは使えません）
設定ファイルを用意
現在openrr-appsを使うには設定ファイルが必要です。ここにコンフィグとサンプルURDFを置いたのでこれを使いましょう。
git clone https://github.com/OTL/openrr-apps-config-sample
cd openrr-apps-config-sample
ちなみにコンフィグの中身は↓のような感じです。
[[urdf_viz_clients_configs]]
name = "arm"
joint_names = ["l_shoulder_yaw", "l_shoulder_pitch", "l_shoulder_roll", "l_elbow_pitch", "l_wrist_yaw", "l_wrist_pitch"]
[openrr_clients_config]
# relative from this file or absolute path
urdf_path = "../urdf/robot.urdf"
self_collision_check_pairs = [
"root:l_gripper_linear1",
"root:l_gripper_linear2",
"root:l_wrist_yaw",
"root:l_wrist_pitch",
"root:l_elbow_pitch",
"root:l_shoulder_roll"
]
[[openrr_clients_config.collision_check_clients_configs]]
name = "arm_collision_checked"
client_name = "arm"
[[openrr_clients_config.ik_clients_configs]]
name = "arm_ik"
client_name = "arm_collision_checked"
solver_name = "arm_ik_solver"
[[openrr_clients_config.joints_poses]]
pose_name = "zero"
client_name = "arm_collision_checked"
positions = [0.0, 0.0, 0.0, 0.0, 0.0, 0.0]
[[openrr_clients_config.joints_poses]]
pose_name = "pose1"
client_name = "arm_collision_checked"
positions = [0.0, 0.5, 0.0, -0.8, 0.0, 0.3]
[openrr_clients_config.ik_solvers_configs.arm_ik_solver]
ik_target = "l_tool_fixed"
openrr_apps_joint_position_sender
まずは urdf-vizを立ち上げます。
urdf-viz urdf/robot.urdf &
openrr_apps_joint_position_senderを立ち上げます。
openrr_apps_joint_position_sender config/robot.toml
どっかで見たことありそうなGUIですよね。
これはロボットの関節位置をロボットに送るGUIです。
armと表示されているところをarm_collision_checkedにすると、自己干渉チェックが行われてから姿勢がurdf-vizに送られます。
動作の様子
openrr_apps_robot_command
こっちはコマンドラインインタフェースです。
関節角度の取得
$ openrr_apps_robot_command -c ./config/robot_config.toml get_state arm
Joint positions : [-0.64, 0.0, 0.0, 0.0, -1.17, 0.0]
いろんなコマンドを逐次実行。詳細はcommand/commands.txtを見てみてください。
openrr_apps_robot_command -c ./config/robot_config.toml load_commands ./command/commands.txt
動作の様子
どんなコマンドがあるかは-hで調べてみてください。
$ openrr_apps_robot_command -h
openrr_apps_robot_command 0.0.1
An openrr command line tool.
USAGE:
openrr_apps_robot_command [OPTIONS] <SUBCOMMAND>
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
-c, --config-path <config-path>
SUBCOMMANDS:
cancel_navigation_goal Cancel navigation gaol
execute_command Execute an external command
get_navigation_current_pose Get navigation current pose
get_state Get joint positions and end pose if applicable
help Prints this message or the help of the given subcommand(s)
list List available clients
load_commands Load commands from file and execute them
move_ik Move with ik
send_base_velocity Send base velocity
send_joints Send joint positions
send_joints_pose Send predefined joint positions
send_navigation_goal Send navigation goal pose
speak Speak text message
他の例
Universal RobotのUR10を使った例や、PR2で動かす例などもopenrrのリポジトリにはありますのでもし興味持っていただいたら（ハードル高いと思いますが）試していただけるとめっちゃうれしいです。
ライブラリとして
ライブラリとして使うのが本当のOpenRRなのですが、まだサンプルと呼べるようなものはありません。openrr-apps自体が１つのサンプルではありますが、ちょっと複雑過ぎます。
Stay Tuned!
終わりに
以上でv0.0.1のOpenRRの紹介、解説は終わりです。興味を持って頂ければ幸いです。