Установка и запуск агента RosDuino
В уроке 3 для передачи всего одного числа с компьютера на плату нам пришлось вручную разбирать символы из потока Serial и очищать переводы строк. Когда в системе появляются десятки датчиков, приводов и команд, такой самодельный текстовый обмен быстро становится ненадёжным. В этой части урока мы разберём, как библиотека RosDuino берёт передачу данных по кабелю на себя, и подготовим агент rosduino_agent на компьютере с Ubuntu.
Как устроена связь между платой и ROS 2
Система RosDuino состоит из двух частей, которые работают в паре:
- Библиотека
rosduino_arduinoна плате (#include <RosDuino.h>): упаковывает данные датчиков и принимает команды в компактном двоичном виде с проверкой контрольной суммы. Вы уже установили эту библиотеку в Arduino IDE в уроке 1 (документация на русском языке:rosduino_arduino/README_RU.md). - Узел-агент
rosduino_agentна компьютере с Ubuntu: подключается к плате по USB-кабелю и создаёт в графе ROS 2 обычные узлы, топики и сервисы (общая документация:rosduino_ros/README_RU.md, описание самого агента:rosduino_agent/README_RU.md).
flowchart LR
MCU["МК + RosDuino"] <-.-> SP(["Serial порт (USB)"])
SP <-.-> Agent
subgraph PC["Компьютер с Ubuntu"]
Agent["rosduino_agent"] <--> ROS2["Система ROS 2"]
end
style SP fill:#fef3c7,stroke:#d97706,stroke-width:2px,stroke-dasharray: 5 5,color:#78350f
style PC fill:#f8fafc,stroke:#64748b,stroke-width:1.5px,color:#0f172a
Когда плата включается и соединяется с агентом, она сама сообщает ему имя своего узла и перечень всех нужных ей топиков и сервисов. Поэтому при изменении скетча вам не нужно перенастраивать или пересобирать агент на компьютере — достаточно загрузить новый скетч в плату.
Три правила работы с Serial портом
Последовательный порт USB в каждый момент времени может занимать только одна программа. Чтобы загрузка скетчей и связь с ROS 2 не мешали друг другу, соблюдайте три правила:
- Не используйте
Serialи закрывайте утилиту мониторинга порта - Останавливайте
rosduino_agentперед загрузкой скетча - В функции
loop()вызывайтеros.update()безdelay()
Шаг 1. Проверьте библиотеку RosDuino в Arduino IDE
В уроке 1 вы уже устанавливали библиотеку RosDuino. Откройте Arduino IDE 2 и проверьте меню Файл → Примеры (File → Examples): в списке должен быть раздел RosDuino.
Если вы перешли на новый компьютер с Ubuntu и библиотеки ещё нет, установите её через Инструменты → Менеджер библиотек по запросу RosDuino (подробная инструкция приведена на странице «Установка библиотеки RosDuino»).
Шаг 2. Соберите rosduino_agent в рабочем пространстве ROS 2
Официальная инструкция по установке, параметрам запуска (--port, --baud, --namespace), диагностике и работе с несколькими платами приведена в репозитории пакета:
- Общее руководство
rosduino_rosи установка (на русском); - Подробная документация узла
rosduino_agent(на русском); - Генератор заголовков своих типов сообщений
rosduino_gen.
Откройте приложение «Терминал» в Ubuntu. Мы создадим рабочее пространство ~/ros2_ws, скачаем в него репозиторий rosduino_ros и соберём пакеты командой colcon build.
Создайте папку рабочего пространства и перейдите в каталог исходников src:
mkdir -p ~/ros2_ws/src
cd ~/ros2_ws/src
Скачайте репозиторий rosduino_ros:
git clone https://github.com/rosduino/rosduino_ros.git
Перейдите в корень рабочего пространства, активируйте окружение ROS 2 и соберите пакеты:
cd ~/ros2_ws
source /opt/ros/$ROS_DISTRO/setup.bash
colcon build
Переменная окружения $ROS_DISTRO содержит имя установленного дистрибутива ROS 2, например lyrical, jazzy или rolling. Рекомендуемый вариант для курса — ROS 2 Lyrical Luth. Переменную задаёт сценарий setup.bash при подключении окружения ROS 2. Если в текущем терминале она ещё не задана, выполните source /opt/ros/lyrical/setup.bash. После этого значение можно проверить командой echo $ROS_DISTRO.
Шаг 3. Проверьте запуск агента
Подключите собранное рабочее пространство в текущем терминале и вызовите справку агента:
source ~/ros2_ws/install/setup.bash
ros2 run rosduino_agent rosduino_agent --help
Команда ros2 run rosduino_agent rosduino_agent --help выводит список параметров запуска (--port, --baud и другие) без ошибок.
Чтобы не вводить source вручную в каждом новом окне терминала, можно один раз добавить автоподключение в конец файла ~/.bashrc:
echo "source /opt/ros/$ROS_DISTRO/setup.bash" >> ~/.bashrc
echo "source ~/ros2_ws/install/setup.bash" >> ~/.bashrc
Справочный материал: профили памяти плат в RosDuino
Этот раздел можно пропустить при первом прохождении. При компиляции скетча библиотека RosDuino автоматически определяет модель платы и выбирает подходящий профиль памяти:
| Профиль | Плата Arduino | Максимум топиков и сервисов | Максимальный размер пакета |
|---|---|---|---|
LARGE | Arduino Due (плата TurtleBro v2) | до 64 | 2040 байт |
MEDIUM | Arduino Mega 2560 (плата TurtleBro v1) | до 24 | 504 байта |
SMALL | Arduino Uno / Leonardo / Micro | до 8 | 152 байта |
LITE | Arduino Nano (ATmega328P) | до 3 | 88 байт |
На плате TurtleBro с микроконтроллером Arduino Due автоматически включается профиль LARGE, поэтому запаса памяти с избытком хватает для всех задач курса.
Назад: Урок 4. Первый узел RosDuino.
Дальше: Управление светодиодом из ROS.