hakoniwa-ros2pdu

C++版箱庭コア機能上で動作するアセット同士はPDUというデータ単位で通信します。 PDUデータのデータ型は、C言語の構造体であり、ROS2メッセージの定義データ(msgファイル)を入力にして自動生成されます。 PDUデータ型を自動生成するための環境として、docker 環境を用意しています。

インストール手順

git clone https://github.com/toppers/hakoniwa-ros2pdu.git

bash docker/pull_image.bash

前準備

以下の２ファイルの設定をします。

• config/ros_msgs.txt
  • 生成したいPDUのデータ型の名前(ROSメッセージデータ型名を指定する)
• search_path.txt
  • ROSメッセージデータ型が配置されているファイルパスを指定

設定例(config/ros_msgs.txt)

can_msgs/HakoCan
ev3_msgs/EV3PduSensor
ev3_msgs/EV3PduActuator

設定例(config/search_path.txt)

/opt/ros/foxy/share
/root/workspace/hakoniwa-ros2pdu/workspace/src

PDUデータ型作成方法

bash docker/run.bash

bash create_all_pdus.bash 

成功すると以下のメッセージが出力されます。

#### Creating can_msgs/HakoCan ####
#### Creating can_msgs/HakoCanBody ####
#### Creating can_msgs/HakoCanHead ####
#### Creating ev3_msgs/EV3PduSensor ####
#### Creating ev3_msgs/Ev3PduColorSensor ####
#### Creating ev3_msgs/Ev3PduSensorHeader ####
#### Creating ev3_msgs/Ev3PduTouchSensor ####
#### Creating ev3_msgs/EV3PduActuator ####
#### Creating ev3_msgs/Ev3PduActuatorHeader ####
#### Creating ev3_msgs/Ev3PduMotor ####

構造体は、pdu/types配下に生成されます。

pdu/types
├── can_msgs
│   ├── pdu_ctype_HakoCan.h
│   ├── pdu_ctype_HakoCanBody.h
│   └── pdu_ctype_HakoCanHead.h
├── ev3_msgs
│   ├── pdu_ctype_EV3PduActuator.h
│   ├── pdu_ctype_EV3PduSensor.h
│   ├── pdu_ctype_Ev3PduActuatorHeader.h
│   ├── pdu_ctype_Ev3PduColorSensor.h
│   ├── pdu_ctype_Ev3PduMotor.h
│   ├── pdu_ctype_Ev3PduSensorHeader.h
│   └── pdu_ctype_Ev3PduTouchSensor.h
└── pdu_primitive_ctypes.h

ROSメッセージの作成方法

dockerコンテナを起動します。

bash docker/run.bash

ROSメッセージを作成するワークスペースに移動します。

cd hakoniwa-ros2pdu/workspace

ROS2メッセージの作成方法は、こちらを参照ください。

https://docs.ros.org/en/crystal/Tutorials/Custom-ROS2-Interfaces.html

作成したROSメッセージをビルドします。(例：hako_msgsの場合)

colcon build --packages-select hako_msgs

補足：箱庭PDUを作成するだけならビルドは不要ですが、整合性確認のためにもビルドすることをお勧めします。

設計情報

offset

• 0列目:配列有無
  • single：配列ではない
  • array：固定長配列
  • varray：可変長配列
• 1列目：データ型の種類
  • primitive：プリミティブデータ型
  • struct：構造体
• 2列目：メンバ名
• 3列目：データ型名
• 4列目：メンバ・オフセット（単位：バイト）
• 5列目：メンバ・サイズ（単位：バイト）
  • 固定長配列の場合：データ型のサイズ✖️配列長
  • 可変長配列の場合：データ型のサイズ（実行時まで配列長がわからないので配列長はかけられない）
• 6列目：配列長
  • 固定長配列の場合：配列長
  • 可変長配列の場合：8固定（参照データ）
    • 0バイト目：配列長
    • 4バイト目：ヒープ領域のオフセット（単位：バイト）