Программное обеспечение
Бортовой компьютер 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-репозиториях. Для получения последних изменений необходимо обновить два репозитория:
- brover, ветка bigrover — основные пакеты управления ровером;
- brover_web, ветка bigrover — веб-интерфейс управления.
Перед обновлением остановите ровер и убедитесь, что он не выполняет команды движения.
Если файлы программного обеспечения изменялись вручную, рекомендуется предварительно сохранить изменения. Команда 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:
| Параметр | Значение |
|---|---|
| Номинальная скорость CAN | 1 Мбит/с |
| Скорость передачи данных CAN FD | 8 Мбит/с |
Период period_ns | 10 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 и отображает большее из них. Это позволяет показывать напряжение подключённой батареи, когда второй канал выдаёт значение около нуля.
Для реле и фар предусмотрены отдельные сервисы:
| Сервис | Тип | Назначение |
|---|---|---|
/rele | std_srvs/srv/SetBool | Включение и выключение реле |
/light | std_srvs/srv/SetBool | Включение и выключение фар |
/rele_control/state | std_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