Генерация собственных сообщений (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-файл.
Дальше: Домашнее задание.