Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Генерация собственных сообщений (rosduino_gen)

В библиотеку RosDuino уже встроены стандартные типы std_msgs, std_srvs, sensor_msgs и geometry_msgs. Но при разработке робота часто хочется объединить несколько показателей платы в одно собственное сообщение — например, передавать состояние обеих кнопок и показание датчика в одной структуре PanelState.msg. Для этого в репозиторий rosduino_ros входит пакет rosduino_gen, который автоматически переводит файлы .msg и .srv в C++-заголовки для Arduino.

Полная документация генератора на русском языке: rosduino_gen/README_RU.md.

Как работает rosduino-gen

Утилита rosduino-gen берёт описание сообщений из любого пакета ROS 2 и создаёт компактные заголовочные файлы .h на чистом C++11 (без динамического выделения памяти), которые работают на всех платах Arduino:

flowchart LR
    Msg["Файлы .msg и .srv<br/>в пакете ROS 2"] --> Gen["Утилита rosduino-gen"]
    Gen --> Header["C++-заголовки .h<br/>в папке libraries/RosDuino/src"]
    Header --> Sketch["#include в скетче Arduino"]

Шаг 1. Посмотрите список доступных типов

Выведите список всех сообщений и сервисов, которые видит генератор в вашей системе ROS 2:

ros2 run rosduino_gen rosduino-gen --list

Чтобы посмотреть типы только одного конкретного пакета (например, sensor_msgs), добавьте флаг --package:

ros2 run rosduino_gen rosduino-gen --list --package sensor_msgs

Шаг 2. Сгенерируйте заголовки для своего пакета сообщений

Допустим, в вашем рабочем пространстве ~/ros2_ws/src создан пакет интерфейсов turtlebro_custom_msgs с файлом msg/PanelStatus.msg:

bool button_start
bool button_stop
int32 analog_value

После сборки пакета командой colcon build и подключения окружения source install/setup.bash запустите генератор, указав имя пакета во флаге --package и путь к папке src библиотеки Arduino во флаге --out:

ros2 run rosduino_gen rosduino-gen \
  --package turtlebro_custom_msgs \
  --out "$HOME/Arduino/libraries/RosDuino/src"

(Если вы прошиваете плату со своего ноутбука, скопируйте сгенерированную папку turtlebro_custom_msgs в каталог Arduino/libraries/RosDuino/src на том компьютере, где запущена Arduino IDE).

Шаг 3. Подключите сгенерированный тип в скетче

Генератор положит файл по пути turtlebro_custom_msgs/msg/PanelStatus.h. В скетче он подключается и используется точно так же, как стандартные сообщения:

#include <RosDuino.h>
#include <turtlebro_custom_msgs/msg/PanelStatus.h>

turtlebro_custom_msgs::PanelStatus statusMsg;
rosduino::Timer timer(100);

void setup() {
  pinMode(28, INPUT);
  pinMode(15, INPUT);
  ros.begin(Serial1, "custom_panel_node");
}

void loop() {
  ros.update();

  if (timer.check()) {
    statusMsg.button_start = (digitalRead(28) == HIGH);
    statusMsg.button_stop = (digitalRead(15) == HIGH);
    statusMsg.analog_value = analogRead(A8);

    ros.publish("panel_status", statusMsg);
  }
}

Основные флаги rosduino-gen

ФлагНазначение
--listПоказать список доступных интерфейсов .msg и .srv
--package PKGСгенерировать заголовки для указанного пакета ROS 2 (можно указать несколько раз)
--out DIRПапка, куда сохраняются .h-файлы (например, ~/Arduino/libraries/RosDuino/src)
--allЗаново пересобрать весь базовый набор типов из файла arduino_types.txt
--default-seq-cap NМаксимальная длина динамического массива в сообщении (по умолчанию 8)

Назад: Управление роботом кнопками и launch-файл.
Дальше: Домашнее задание.