Skip to content

Latest commit

 

History

History
132 lines (101 loc) · 3.69 KB

README.md

File metadata and controls

132 lines (101 loc) · 3.69 KB
Raw

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バイト目：ヒープ領域のオフセット（単位：バイト）