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

Введение

Этот курс учит работать с платой робота 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» и дальше подставляйте пины самостоятельно, исходя из задания. Обычно достаточно поменять номера пинов в константах в начале скетча.

Проекты и инструменты

В курсе используются:

Траектория курса

Восемь уроков идут от первого скетча до работы на роботе.

Этап 1. Плата TurtleBro по USB

  1. Подготовка рабочего места. Arduino IDE 2 в Windows или Ubuntu, выбор Arduino Due, установка библиотеки RosDuino и первый скетч на LED_BUILTIN.
  2. Светодиоды, кнопки и сервопривод. Светодиоды и кнопки платы, очередь включения светодиодов и сервопривод на штатных пинах подключения.
  3. Чтение данных, работа с Serial портом. Чтение аналогового сигнала, утилита мониторинга порта, плоттер графиков и замена блокирующего delay() неблокирующей логикой.

На этом этапе ROS 2 не нужен. Плата TurtleBro работает как обычная плата Arduino, подключённая по USB.

Этап 2. Агент на компьютере с Ubuntu

  1. Первый узел RosDuino. Установка rosduino_agent на компьютер с Ubuntu и связь с платой по USB.
  2. Топики в RosDuino. Публикация данных и приём команд без блокировки основного цикла.
  3. Сервисы в RosDuino. Работа платы в роли сервера сервиса (ros.service()) и клиента сервиса (ros.call()).
  4. Диагностика, время и узлы на Python. Журнал /rosout, синхронизация времени ros.now(), управляющий узел на Python и запуск через launch-файл.

Плата по-прежнему подключена к компьютеру кабелем USB. Агент работает на этом компьютере, а не на роботе.

Этап 3. Агент на роботе

  1. TurtleBro. Установка rosduino_agent на Raspberry Pi робота и совместная работа со штатными топиками. Справочные материалы по платформе приведены в документации TurtleBro.

Как устроены уроки

Каждый урок содержит:

  • описание задания и список того, что нужно подготовить;
  • теорию, которая нужна для практики;
  • таблицу пинов, если пример использует контакты платы;
  • полный скетч, который можно собрать и запустить;
  • пошаговую проверку результата;
  • вопросы для самопроверки;
  • самостоятельное задание и ссылку на разбор решения.

В уроке 1 установка для Windows и Linux вынесена на отдельные страницы. Сначала прочитайте общую часть, затем выберите свою операционную систему. После настройки платы установите библиотеку RosDuino и перейдите к первому скетчу.

Как работать с курсом

Проверяйте результат каждого урока

Переходите к следующему уроку только после успешной проверки текущего результата. Если скетч не загружается в уроке 1, следующие примеры только усложнят поиск причины. Если связь с агентом нестабильна, сначала восстановите её и только затем запускайте управляющий узел.

Изменяйте по одному параметру

Сначала соберите и проверьте приведённый пример без изменений. После успешного запуска меняйте только один параметр за раз: номер пина, длительность паузы или порог. Так проще понять, какое изменение привело к новому результату.

Проверяйте систему по уровням

Когда в курсе появляется агент, проверяйте каждый уровень по очереди:

  1. Скетч компилируется и работает на плате.
  2. Последовательный порт доступен.
  3. Агент rosduino_agent установил соединение.
  4. Узел и топики видны командами ROS 2.
  5. Управляющая программа получает данные и отправляет команды.

Если плата ещё не видна в ROS 2, не ищите причину в Python-узле: сначала убедитесь, что предыдущие уровни работают.

Фиксируйте ошибки

Сообщения компилятора, имя порта и журнал агента помогают найти причину. Запишите, на каком шаге возникла ошибка и какое сообщение вывел инструмент.

Для этого полезно вести короткий журнал:

  • версия платы TurtleBro и выбранный пункт в Arduino IDE;
  • имя порта;
  • версии пакета плат и библиотеки;
  • ожидаемый результат;
  • фактический результат;
  • полный текст ошибки.

Сначала решайте самостоятельно

Готовое решение помогает сравнить подходы, но не заменяет практику. Сначала составьте алгоритм и попробуйте написать скетч самостоятельно. Если решение не получается, сравните отдельный фрагмент с разбором, исправьте свою версию и снова проверьте плату.

Обозначения в командах

В уроках с ROS 2 несколько процессов работают одновременно:

  • Терминал 1 — агент rosduino_agent;
  • Терминал 2 — команды ROS 2 для просмотра топиков, публикации сообщений и вызова сервисов.

Команды приводятся без символа $, чтобы их можно было скопировать целиком.

Не закрывайте Терминал 1

Пока вы проверяете топики и сервисы в Терминале 2, агент rosduino_agent должен продолжать работать в Терминале 1.

Безопасность

Не перетыкайте сервопривод под нагрузкой

Перед тем как подключить или отключить сервопривод от разъёма на плате, остановите скетч и отключите USB. Сверьте маркировку −, +, S с цветами проводов и только затем подавайте питание.

Соблюдайте четыре правила:

  1. Не подавайте 5 В на цифровые и аналоговые входы: Arduino Due рассчитана на 3,3 В.
  2. Не соединяйте линию 5 В разъёма сервопривода с пинами питания сигнальной части платы.
  3. Подключайте сервопривод только к штатному разъёму сервопривода и проверяйте порядок −, +, S.
  4. Перед загрузкой скетча остановите процесс, который занимает тот же последовательный порт. В уроках с RosDuino это rosduino_agent.

Если плата, провод или сервопривод заметно нагрелись, сразу отключите питание и проверьте подключение сервопривода.

Результат курса

После прохождения курса вы сможете:

  • поручать плате TurtleBro работу с кнопками, светодиодами, аналоговыми сигналами и сервоприводом, а ROS 2 — обработку данных и принятие решений;
  • подключать плату через RosDuino и проверять её топики и сервисы;
  • разрабатывать управляющий узел на Python;
  • перенести агент на Raspberry Pi робота TurtleBro.

Готовы начать?

Подготовьте плату TurtleBro и USB-кабель. Для уроков 2 и 3 понадобится сервопривод с тремя проводами (потенциометр или аналоговый датчик для разъёма GPIO A8 в уроке 3 желателен, но не обязателен — чтение аналогового сигнала через analogRead() будет работать и на неподключённом разъёме).

Дальше: Быстрый старт, Платы v1 и v2 или Урок 1. Подготовка рабочего места.