Перейти к основному содержимому

Программное обеспечение

Бортовой компьютер x86, установленный в Rover B7, работает под управлением Ubuntu Server 24.04 LTS. Операционная система и программное обеспечение ровера размещены на SSD.

Предустановленное программное обеспечение​

ROS 2 и рабочее окружение​

Основной пользователь системы — bigrover. Рабочее пространство ROS 2 расположено в каталоге:

/home/bigrover/ros2_ws/

Исходные коды находятся в подкаталоге src. Собранное окружение подключается из install/setup.bash.

В образе используется набор пакетов brover, ветка bigrover:

ПакетНазначение
brover_controlОбщий запуск и конфигурация ROS-нод ровера
brover_imu_nodeПолучение данных инерциального датчика
brover_move_controlУправление приводами
brover_odom_simpleРасчёт и публикация одометрии
brover_radiolink_controlУправление с радиопульта
brover_bat_monitorМониторинг напряжения батарей и управление световой индикацией

Дополнительно используются:

  • brover_web, ветка bigrover — веб-интерфейс управления, видеопоток и отображение телеметрии;
  • cyphal_ros2_bridge — обмен данными между ROS 2 и устройствами Cyphal;
  • brover_rele_control — управление реле и фарами через ROS-сервисы;
  • usb_cam — публикация изображения с USB-камеры;
  • rosbridge_server — связь веб-интерфейса с ROS;
  • joy — публикация данных джойстика.

В системе также установлены инструменты сборки, библиотека доступа к HID-устройствам libhidapi-dev, утилиты can-utils, а также PyCyphal и Yakut для диагностики Cyphal.

Проверка и установка обновлений​

Исходные коды основных компонентов Rover B7 хранятся в Git-репозиториях. Для получения последних изменений необходимо обновить два репозитория:

Перед обновлением

Перед обновлением остановите ровер и убедитесь, что он не выполняет команды движения.

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

1. Обновление brover​

Подключитесь к роверу по SSH и перейдите в каталог репозитория:

cd /home/bigrover/ros2_ws/src/brover

Проверьте текущую ветку и наличие локальных изменений:

git branch --show-current
git status

Для Rover B7 используется ветка bigrover.

Загрузите последние изменения:

git pull

Если обновлений нет, появится сообщение:

Already up to date.

2. Обновление brover_web​

Перейдите в каталог веб-интерфейса:

cd /home/bigrover/ros2_ws/src/brover_web

Проверьте ветку и состояние репозитория:

git branch --show-current
git status

Загрузите обновления:

git pull

3. Пересборка ROS 2​

После обновления исходных кодов необходимо пересобрать пакеты.

Вернитесь в рабочее пространство:

cd /home/bigrover/ros2_ws

Подключите окружение ROS 2:

source /opt/ros/jazzy/setup.bash

Выполните сборку:

colcon build --symlink-install

После успешной сборки подключите обновлённое окружение:

source /home/bigrover/ros2_ws/install/setup.bash
примечание

Команда git pull обновляет исходные файлы репозитория, но не пересобирает ROS 2-пакеты автоматически.

Чтобы обновления применились к работающим ROS 2-компонентам, необходимо выполнить сборку и перезапустить соответствующие программы.

4. Применение обновлений​

После успешной сборки рекомендуется перезагрузить сервис:

sudo systemctl restart ros_nodes.service

После перезагрузки проверьте состояние основных сервисов:

systemctl status ethernet-can.service ros_nodes.service camera.service --no-pager

Для проверки запущенных ROS 2-нод:

ros2 node list
Локальные изменения

Если команда git status показывает изменённые файлы, не удаляйте эти изменения без предварительной проверки.

Они могут содержать индивидуальные настройки конкретного ровера.

Если команда git pull сообщает о конфликте, необходимо разобраться с ним до дальнейшего обновления и сборки.

Параметры окружения​

Настройки ROS находятся в файле:

/home/bigrover/.ros_params

В базовой конфигурации используется:

ROS_DOMAIN_ID=10

Для работы с ROS-командами в новом терминале подключите окружение:

source /opt/ros/jazzy/setup.bash
source /home/bigrover/.ros_params
source /home/bigrover/ros2_ws/install/setup.bash

Сетевые настройки​

Компьютер подключается к Wi-Fi через USB-адаптер. Ethernet используется для связи с роутером ровера и бортовыми устройствами.

В базовой конфигурации:

  • сеть ровера — 192.168.20.0/24;
  • Wi-Fi имеет метрику маршрута 100 и используется как основной выход в интернет;
  • Ethernet имеет метрику 500 и может служить резервным выходом в интернет, если он доступен через роутер ровера.

Метрики задают приоритет маршрутов, но не проверяют доступность интернета за роутером. Если Wi-Fi остаётся подключённым без выхода в интернет, автоматическое переключение на Ethernet только за счёт метрик не гарантируется.

В исходной настройке добавлены, в частности, сети:

SSID: TurtleBro / TurtleBro5G
Пароль: turtlew001

Настройки Wi-Fi находятся в /etc/netplan/20-network-wifi.yaml. Перед подключением к другой сети измените параметры Netplan в соответствии с её настройками.

Имя устройства и доступ​

Для бортовых компьютеров используется схема имён bigroverNN, например bigrover01 или bigrover02. Номер можно найти на самом ровере.

При настроенном mDNS подключение возможно по имени:

ssh bigrover@bigrover02.local

Также можно подключиться по текущему IP-адресу. Пароль пользователя используйте из данных доступа, предоставленных для конкретного образа. Изменение hostname не меняет имя пользователя или пароль.

Ethernet-CAN и Cyphal​

Для подключения CAN-устройств используется Ethernet-CAN, соединённый с тем же роутером, что и бортовой компьютер. SD-карта в Ethernet-CAN в этой конфигурации не используется.

Клиент Ethernet-CAN установлен в каталоге:

/opt/voltbro/ethernet-can/

Его конфигурация находится в файле:

/opt/voltbro/ethernet-can/ethernetcan.json

В файле задаются адрес компьютера host_ip, адрес платы device_ip, соответствие шин и параметры CAN FD:

ПараметрЗначение
Номинальная скорость CAN1 Мбит/с
Скорость передачи данных CAN FD8 Мбит/с
Период period_ns10 000 000 нс (10 мс)

Физическим шинам платы соответствуют интерфейсы Linux:

bus0 → vcan1.0
bus1 → vcan1.1
bus2 → vcan1.2
bus3 → vcan1.3
bus4 → vcan1.4
bus5 → vcan1.5

Для просмотра кадров первой шины:

candump vcan1.0

Yakut​

Параметры окружения Yakut находятся в /home/bigrover/.yakut_params. Перед использованием утилиты подключите их:

source /home/bigrover/.yakut_params

В базовой настройке для Yakut выбран node-ID 103 и MTU 64. Список CAN-интерфейсов определяется переменной UAVCAN__CAN__IFACE в этом файле.

Уникальные идентификаторы

Каждый одновременно работающий узел Cyphal на одной шине должен иметь уникальный node-ID. Учитывайте это при запуске диагностических инструментов и подключении второго компьютера.

Cyphal–ROS 2 bridge​

Конфигурации моста расположены в каталоге:

/home/bigrover/ros2_ws/src/cyphal_ros2_bridge/examples/
  • test_node.json — обмен с шестью приводами через vcan1.0, node-ID моста 100;
  • power.json — обмен с PowerBoard через vcan1.1, node-ID моста 101.

Конфигурация приводов связывает команды /m_vel1–/m_vel6 и обратную связь /m_odom1–/m_odom6 с Cyphal. Конфигурация PowerBoard предоставляет топики /bat_1, /bat_2, /user_button и сервисы /hmi/led, /hmi/beep.

Веб-интерфейс сравнивает последние значения voltage из /bat_1 и /bat_2 и отображает большее из них. Это позволяет показывать напряжение подключённой батареи, когда второй канал выдаёт значение около нуля.

Для реле и фар предусмотрены отдельные сервисы:

СервисТипНазначение
/relestd_srvs/srv/SetBoolВключение и выключение реле
/lightstd_srvs/srv/SetBoolВключение и выключение фар
/rele_control/statestd_srvs/srv/TriggerЧтение регистра output.states с платы

Автоматический запуск​

Основные компоненты запускаются через systemd:

СервисНазначение
ethernet-can.serviceРабота клиента Ethernet-CAN
ros_nodes.serviceЗапуск основных ROS-нод и веб-интерфейса ровера
camera.serviceЗапуск USB-камеры

В текущем скрипте запуска ROS используются команды:

ros2 launch brover_control brover_control_launch.xml &
exec ros2 launch brover_web web_server.xml

Между ними могут находиться дополнительные вызовы сервисов индикации и звукового сигнала при запуске. Нода bat_monitor управляет цветом кнопки с interface: 1: зелёный при отсутствии тревоги, мигающий красный при низком напряжении всех отслеживаемых батарей. Для второй кнопки используется interface: 0.

Ручной запуск

Не запускайте второй экземпляр тех же нод, если они уже работают через systemd. Перед ручной отладкой проверьте активные сервисы и ROS-ноды.

Проверка состояния:

systemctl status ethernet-can.service ros_nodes.service camera.service --no-pager
ros2 node list

Просмотр журнала ROS-сервиса:

journalctl -u ros_nodes.service -b --no-pager -n 100

Чтобы узнать путь к действующему скрипту запуска, выполните:

systemctl cat ros_nodes.service

Путь указан в параметре ExecStart. Полный список сервисов конкретного образа можно проверить командой systemctl list-unit-files --type=service.

USB-устройства​

Доступ к IMU и джойстику настроен правилами udev в файле:

/etc/udev/rules.d/99-brover-usb.rules

Камера запускается скриптом /usr/local/bin/start_camera.sh. После замены камеры проверьте, что значение CAMERA_LINK соответствует подключённому устройству:

ls -l /dev/v4l/by-id/
grep CAMERA_LINK /usr/local/bin/start_camera.sh