0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 3 years have passed since last update.

ROS2独自メッセージの作成 before Foxy Fitzroy

Posted at

ROS2関係トップページへ
ROS2レクチャー:初級 -ROS1 style-
ROS2レクチャー:初級 -class style-

【前:ROS2の最小構成publisher:初級 -ROS1 style-
【前:ROS2の最小構成publisher:初級 -class style-
【次:独自メッセージを用いたROS2 publisher/subscriber:初級 -ROS1 style-
【次:独自メッセージを用いたROS2 publisher/subscriber:初級 -class style-

ROSには沢山の種類のメッセージが用意されている.しかし勿論自分独自のメッセージを作りたくなる.C言語でいうstructのように.
ROS(ROS1)では実行ファイル=nodeでありnodeがメッセージを使用するため,nodeのパッケージの中に独自メッセージが付属的に作成された.
ROS2ではメッセージも独立性を持つようで,それ自体がパッケージとして成り立ち,他のパッケージがメッセージに関するパッケージを利用する形となる.
詳しくは当ページの最後の「参考」を参照のこと.

dashingからの変更?[ROS2インストール・初期設定(for dashing用)](https://qiita.com/NeK/items/d2bdd8798de7cdea1932)の「上記ガイド以外でインストールしたもの」に追加したが,lark-parserとnumpyをちゃんとインストールしないとエラーが出るようになった(2019/6)

作成物

データの基本型はAbout ROS 2 Interfacesに一覧がある.
独自メッセージはtopic用とService用がある.ここでは
両方つくる.

topic用メッセージ

int64型のデータを二つ.

service用メッセージ

service用メッセージは送信と受信がある.送信として二つのfloat64型のデータ,送信し処理した結果受信するデータとして二つのfloat64型のデータ.

準備

topic用のメッセージのためにmsgディレクトリをservice用のメッセージのためにsrvディレクトリを作成する.

terminal
$ cd ~/ros2_studies_ws/
$ ros2 pkg create my_messages
$ cd my_messages
$ mkdir msg
$ mkdir srv

メッセージ作成

作成物:github.com

topic用メッセージの作成

msgディレクトリ以下に以下のファイルを作成

  • TwoInts.msg
msg/TwoInts.msg
int64 a
int64 b

service用メッセージの作成

srvディレクトリ以下に以下のファイルを作成

  • CalcTwoFloats.srv
srv/CalcTwoFloats.srv
float64 a
float64 b
---
float64 sum
float64 diff

メッセージに関する注意点

メッセージを表すファイル名(***.msgや***.srv)にはいくつかの制限がある.

メッセージファイル名に関する制限

  • 最初の文字が大文字でなければならない
  • _(アンダースコア)を使ってはいけない
  • 単語の区切り(意味の区切り)は大文字で行う

OKな例

  • Test.msg
  • TEST.msg
  • TestMessage.msg

NGな例

  • test.msg
  • test_message.msg

制限の理由とメッセージの利用方法

メッセージファイルはcolcon buildによって他のパッケージで利用できるようにビルドされる.この時,***.msgはコンパイルされてクラスになる.この時,二個目の大文字の前に_(アンダースコア)が挿入され全て小文字のヘッダファイルが作成されて,これをインクルードすることで利用できるようにしている.

  • msgファイル
    • TestMessage.msg
  • コンパイル後に作成されるメッセージ利用のためのクラスヘッダファイル
    • test_message.hpp

この変換をスムーズに行うために上記のような制限が行われる.

このように他のパッケージで利用するためには,メッセージファイル名から上記のように変換したヘッダファイルを読み込むことを覚えておくこと.

package.xmlとCMakeLists.txt

idl(interface description language)という名前を持つライブラリを使用している.interface,つまり他のnodeから使ってもらえるようにするためのもの.

package.xml

package.xml
<package format="3">
  <buildtool_depend>rosidl_default_generators</buildtool_depend>
  <exec_depend>rosidl_default_runtime</exec_depend>
  <member_of_group>rosidl_interface_packages</member_of_group>

1行目:これまでformat="2"であったが,タグを利用するためには"3"にしなければならない.
2~4行目:メッセージをビルドするために必要.特に2行目は<build_depend>ではなく<buildtool_depend>なので注意が必要である.

CMakeLists.txt

CMakeLists.txt
find_package(rosidl_default_generators REQUIRED)

set(msg_files
  "msg/TwoInts.msg"
)
set(srv_files
  "srv/CalcTwoFloats.srv"
)
rosidl_generate_interfaces(${PROJECT_NAME}
  ${msg_files}
  ${srv_files}
)
ament_export_dependencies(rosidl_default_runtime)

ビルト・動作確認

terminal
$ cd ~/ros2_studies_ws/
$ colcon build --symlink-install --packages-select my_messages
$ . install/setup.bash
$ ros2 msg list # 全メッセージのリストが表示される.作成したメッセージが存在するか確認
$ ros2 msg show my_messages/TwoInts # [パッケージ名]/[メッセージ]で中身が見えるので確認
$ ros2 srv show my_messages/CalcTwoFloats # [パッケージ名]/[メッセージ]で中身が見えるので確認

参考

メッセージについて詳しくは以下のページに詳しい

公式の使用例は以下のとおり.

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?