Введение
Этот курс учит работать с платой робота TurtleBro: управлять её светодиодами, кнопками и сервоприводом, а также обмениваться командами и данными с ROS 2 через библиотеку RosDuino. Сначала плата подключена к компьютеру по USB и выполняет обычные скетчи Arduino. Затем вы запустите агент RosDuino на компьютере, а в последнем уроке тот же агент будет работать уже на бортовом компьютере робота.
Курс построен вокруг практики. Результат каждого урока можно проверить: светодиод мигает, кнопки включают светодиоды по очереди, сервопривод поворачивается, а команда из ROS 2 меняет состояние платы.
Если вы уже знакомы с Arduino и ROS 2 и хотите сразу посмотреть примеры кода и команды запуска без пошаговой теории, перейдите в раздел «Быстрый старт».
Для кого этот курс
Опыт работы с Arduino и C++ для прохождения курса не требуется: устройство скетча и нужные конструкции языка подробно разбираются по ходу уроков. Однако вам понадобятся базовые знания в робототехнике и представления о работе с ROS.
Уроки 1–3 можно пройти на компьютере с Windows или Ubuntu: нужна Arduino IDE 2. С урока 4, когда начинается работа с агентом, нужен компьютер с Ubuntu и установленной ROS 2. Минимальные требования, ссылки на установку ROS 2 и инструкция по установке rosduino_agent приведены в уроке 4.
Те же приёмы можно повторить на обычной плате Arduino. Курс этот путь не разбирает: все примеры показаны на TurtleBro, а перенос на другую плату остаётся самостоятельной работой.
Разные версии плат TurtleBro
Примеры написаны для жёлтой платы TurtleBro (версия 2) с Arduino Due. В Arduino IDE выбирайте Arduino Due (Programming Port). Номера пинов в уроках относятся только к этой плате.
Если у вас синяя плата с Arduino Mega (версия 1), изучите страницу «Платы v1 и v2» и дальше подставляйте пины самостоятельно, исходя из задания. Обычно достаточно поменять номера пинов в константах в начале скетча.
Проекты и инструменты
В курсе используются:
- плата TurtleBro и Arduino IDE 2;
- ROS 2 на компьютере с Ubuntu, а в последнем уроке — на компьютере робота;
rosduino_arduino(инструкция на русском) — библиотека RosDuino для микроконтроллера;rosduino_ros(инструкция на русском) — агентrosduino_agentи инструменты RosDuino на стороне ROS 2.
Траектория курса
Восемь уроков идут от первого скетча до работы на роботе.
Этап 1. Плата TurtleBro по USB
- Подготовка рабочего места. Arduino IDE 2 в Windows или Ubuntu, выбор Arduino Due, установка библиотеки RosDuino и первый скетч на
LED_BUILTIN. - Светодиоды, кнопки и сервопривод. Светодиоды и кнопки платы, очередь включения светодиодов и сервопривод на штатных пинах подключения.
- Чтение данных, работа с Serial портом. Чтение аналогового сигнала, утилита мониторинга порта, плоттер графиков и замена блокирующего
delay()неблокирующей логикой.
На этом этапе ROS 2 не нужен. Плата TurtleBro работает как обычная плата Arduino, подключённая по USB.
Этап 2. Агент на компьютере с Ubuntu
- Первый узел RosDuino. Установка
rosduino_agentна компьютер с Ubuntu и связь с платой по USB. - Топики в RosDuino. Публикация данных и приём команд без блокировки основного цикла.
- Сервисы в RosDuino. Работа платы в роли сервера сервиса (
ros.service()) и клиента сервиса (ros.call()). - Диагностика, время и узлы на Python. Журнал
/rosout, синхронизация времениros.now(), управляющий узел на Python и запуск через launch-файл.
Плата по-прежнему подключена к компьютеру кабелем USB. Агент работает на этом компьютере, а не на роботе.
Этап 3. Агент на роботе
- TurtleBro. Установка
rosduino_agentна Raspberry Pi робота и совместная работа со штатными топиками. Справочные материалы по платформе приведены в документации TurtleBro.
Как устроены уроки
Каждый урок содержит:
- описание задания и список того, что нужно подготовить;
- теорию, которая нужна для практики;
- таблицу пинов, если пример использует контакты платы;
- полный скетч, который можно собрать и запустить;
- пошаговую проверку результата;
- вопросы для самопроверки;
- самостоятельное задание и ссылку на разбор решения.
В уроке 1 установка для Windows и Linux вынесена на отдельные страницы. Сначала прочитайте общую часть, затем выберите свою операционную систему. После настройки платы установите библиотеку RosDuino и перейдите к первому скетчу.
Как работать с курсом
Проверяйте результат каждого урока
Переходите к следующему уроку только после успешной проверки текущего результата. Если скетч не загружается в уроке 1, следующие примеры только усложнят поиск причины. Если связь с агентом нестабильна, сначала восстановите её и только затем запускайте управляющий узел.
Изменяйте по одному параметру
Сначала соберите и проверьте приведённый пример без изменений. После успешного запуска меняйте только один параметр за раз: номер пина, длительность паузы или порог. Так проще понять, какое изменение привело к новому результату.
Проверяйте систему по уровням
Когда в курсе появляется агент, проверяйте каждый уровень по очереди:
- Скетч компилируется и работает на плате.
- Последовательный порт доступен.
- Агент
rosduino_agentустановил соединение. - Узел и топики видны командами ROS 2.
- Управляющая программа получает данные и отправляет команды.
Если плата ещё не видна в ROS 2, не ищите причину в Python-узле: сначала убедитесь, что предыдущие уровни работают.
Фиксируйте ошибки
Сообщения компилятора, имя порта и журнал агента помогают найти причину. Запишите, на каком шаге возникла ошибка и какое сообщение вывел инструмент.
Для этого полезно вести короткий журнал:
- версия платы TurtleBro и выбранный пункт в Arduino IDE;
- имя порта;
- версии пакета плат и библиотеки;
- ожидаемый результат;
- фактический результат;
- полный текст ошибки.
Сначала решайте самостоятельно
Готовое решение помогает сравнить подходы, но не заменяет практику. Сначала составьте алгоритм и попробуйте написать скетч самостоятельно. Если решение не получается, сравните отдельный фрагмент с разбором, исправьте свою версию и снова проверьте плату.
Обозначения в командах
В уроках с ROS 2 несколько процессов работают одновременно:
- Терминал 1 — агент
rosduino_agent; - Терминал 2 — команды ROS 2 для просмотра топиков, публикации сообщений и вызова сервисов.
Команды приводятся без символа $, чтобы их можно было скопировать целиком.
Пока вы проверяете топики и сервисы в Терминале 2, агент rosduino_agent должен продолжать работать в Терминале 1.
Безопасность
Перед тем как подключить или отключить сервопривод от разъёма на плате, остановите скетч и отключите USB. Сверьте маркировку −, +, S с цветами проводов и только затем подавайте питание.
Соблюдайте четыре правила:
- Не подавайте
5 Вна цифровые и аналоговые входы: Arduino Due рассчитана на3,3 В. - Не соединяйте линию
5 Вразъёма сервопривода с пинами питания сигнальной части платы. - Подключайте сервопривод только к штатному разъёму сервопривода и проверяйте порядок
−,+,S. - Перед загрузкой скетча остановите процесс, который занимает тот же последовательный порт. В уроках с RosDuino это
rosduino_agent.
Если плата, провод или сервопривод заметно нагрелись, сразу отключите питание и проверьте подключение сервопривода.
Результат курса
После прохождения курса вы сможете:
- поручать плате TurtleBro работу с кнопками, светодиодами, аналоговыми сигналами и сервоприводом, а ROS 2 — обработку данных и принятие решений;
- подключать плату через RosDuino и проверять её топики и сервисы;
- разрабатывать управляющий узел на Python;
- перенести агент на Raspberry Pi робота TurtleBro.
Готовы начать?
Подготовьте плату TurtleBro и USB-кабель. Для уроков 2 и 3 понадобится сервопривод с тремя проводами (потенциометр или аналоговый датчик для разъёма GPIO A8 в уроке 3 желателен, но не обязателен — чтение аналогового сигнала через analogRead() будет работать и на неподключённом разъёме).
Дальше: Быстрый старт, Платы v1 и v2 или Урок 1. Подготовка рабочего места.