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

Диагностика и типовые проблемы

В этом разделе приведены основные проверки для Rover B7 с бортовым компьютером x86, Ubuntu Server 24.04 LTS и ROS 2 Jazzy. Инструкция относится к конфигурации, в которой x86-компьютер и модуль Ethernet-CAN подключены кабелями к роутеру KROKS RT-CSE G.

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

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

Быстрый выбор проблемы​

ПроблемаЧто проверить в первую очередь
Ровер не определяется в сетиПитание роутера, Ethernet-кабель x86, подключение к Wi-Fi нужного ровера, IP-адрес
Не удаётся подключиться по SSHIP-адрес, пользователь bigrover, доступность порта 22
Не открывается веб-интерфейсАдрес ровера, порт 8080, ros_nodes.service
Веб-интерфейс открыт, но управление не работаетrosbridge на порту 9090, топик /cmd_vel, запущенные ROS-ноды
Нет изображения с камерыUSB-подключение, camera.service, ROS-топики изображения, порт 9999
Не открывается code-serverПорт 8090 и фактически установленная служба code-server
Не видны ROS 2-топикиОкружение ROS 2, ROS_DOMAIN_ID, параметры DDS
Не работает пультUSB-адаптер, топик /joy, условия разрешения движения
Нет обратной связи от двигателей или других CAN-устройствethernet-can.service, интерфейсы vcan1.*, Cyphal–ROS 2 bridge

Быстрая проверка состояния​

Подключитесь к роверу по SSH и проверьте службы:

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

Если служба не запущена или завершилась с ошибкой, подробности можно найти в журнале. Например:

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

Проверьте сетевые интерфейсы и адреса:

ip -br addr
ip route

Проверьте прослушиваемые TCP-порты:

ss -ltn
ПортНазначение
22/tcpSSH
8080/tcpВеб-интерфейс ровера
9090/tcprosbridge WebSocket
9999/tcpweb_video_server
Работа с командами ROS 2

Если команды ros2 не находят пакеты или ноды, сначала подключите окружение:

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

В стандартной конфигурации ровера используется ROS_DOMAIN_ID=10.

Ровер не находится в сети​

Бортовой x86-компьютер подключён Ethernet-кабелем к роутеру ровера. Сам роутер создаёт Wi-Fi-сеть для подключения рабочего компьютера или другого устройства оператора.

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

Rover-B7-NN
Rover-B7-NN_5G

Здесь NN — номер ровера. Названия сетей на конкретном устройстве могут быть изменены при настройке.

  1. Убедитесь, что ровер и роутер включены и загрузка x86-компьютера завершилась.
  2. Подключите рабочий компьютер к Wi-Fi-сети нужного ровера.
  3. Проверьте Ethernet-кабель между x86-компьютером и роутером, а также индикаторы подключения на портах.
  4. Откройте веб-интерфейс роутера по адресу http://192.168.20.1.
  5. Найдите IP-адрес бортового компьютера в списке подключённых устройств или проверьте назначенный ему статический адрес.

В стандартной конфигурации используется подсеть 192.168.20.0/24. Конкретный IP-адрес x86-компьютера может отличаться у разных роверов.

Отсутствие интернета

Локальная сеть ровера предназначена прежде всего для связи с роботом. Отсутствие доступа к интернету при подключении к его Wi-Fi само по себе не является неисправностью.

Не удаётся подключиться по SSH​

Если на рабочем компьютере работает mDNS, подключитесь по имени хоста, например:

ssh bigrover@bigrover02.local

В противном случае используйте IP-адрес, полученный из настроек роутера:

ssh bigrover@IP_РОВЕРА

Вместо IP_РОВЕРА подставьте реальный адрес бортового компьютера.

Проверьте, что:

  • компьютер подключён к локальной сети нужного ровера;
  • используется пользователь bigrover, а не pi;
  • hostname или IP-адрес указаны правильно;
  • если используются SSH-ключи, выбран нужный ключ;
  • служба SSH запущена на ровере.

Если к роверу есть доступ через локальный терминал, состояние SSH можно проверить командой:

systemctl status ssh --no-pager

Адрес вида bigrover02.local работает только при настроенном разрешении имён mDNS. Если имя не определяется, подключайтесь по IP-адресу.

Не открывается веб-интерфейс​

Откройте на рабочем компьютере:

http://IP_РОВЕРА:8080

Если SSH-доступ есть, проверьте на ровере:

ss -ltn | grep ':8080'
curl -I http://127.0.0.1:8080
systemctl status ros_nodes.service --no-pager

HTTP-ответ подтверждает доступность сервера; при этом конкретный код ответа может зависеть от обработчика запрошенного адреса.

Для просмотра последних сообщений службы:

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

Если требуется перезапуск, выполняйте его только после безопасной остановки ровера:

sudo systemctl restart ros_nodes.service

Веб-интерфейс открыт, но управление не работает​

Во-первых проверьте не заблокировано ли движение нажатием красной аварийной кнопкой.

Веб-интерфейс взаимодействует с ROS 2 через rosbridge_server. Даже если страница открылась, соединение с ROS может отсутствовать.

Проверьте WebSocket-порт:

ss -ltn | grep ':9090'

Посмотрите список ROS-нод и информацию о топике движения:

ros2 node list
ros2 topic info /cmd_vel

Проверьте журнал службы:

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

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

Нет изображения с камеры​

Камера подключена к x86-компьютеру по USB. Для её запуска используется camera.service, а для передачи изображения в браузер — программные средства ROS 2 и web_video_server.

Проверьте службу и наличие USB-устройства:

systemctl status camera.service --no-pager
lsusb
ls -l /dev/video*
ls -l /dev/v4l/by-id/

Проверьте, публикуются ли топики камеры:

ros2 topic list | grep -E 'camera|image'

Если в списке существует топик /camera1/image_raw, можно проверить сведения о нём:

ros2 topic info /camera1/image_raw

Проверьте порт видеосервера:

ss -ltn | grep ':9999'

Посмотрите сообщения службы камеры:

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

После замены USB-камеры также проверьте настройку скрипта запуска:

grep CAMERA_LINK /usr/local/bin/start_camera.sh

При необходимости, после безопасной остановки ровера, перезапустите службу:

sudo systemctl restart camera.service

Если камера отсутствует в lsusb и /dev/video*, сначала проверьте её физическое USB-подключение к x86-компьютеру.

Ровер не реагирует на радиопульт​

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

Проверьте появление данных от пульта:

ros2 topic list | grep joy
ros2 topic info /joy
ros2 topic echo /joy

Значения в /joy должны изменяться при движении органов управления пульта. Остановить просмотр можно сочетанием Ctrl+C.

Если сообщений нет, проверьте USB-подключение адаптера приёмника, запуск соответствующей ROS-ноды и журнал ros_nodes.service.

Если сообщения /joy приходят, но движение отсутствует, проверьте условия разрешения движения и состояние приводов. Не подавайте команды скорости для проверки, пока не обеспечены безопасные условия.

Ровер не реагирует на команды из веб-интерфейса​

Проверьте, что веб-интерфейс доступен, а rosbridge принимает соединения:

ss -ltn | grep ':9090'
ros2 topic info /cmd_vel
ros2 node list

Затем проверьте наличие топиков управления приводами:

ros2 topic list | grep -E '^/m_vel[1-6]$'

Если /cmd_vel доступен, но у него нет подписчиков, проверьте запуск ноды управления движением через ros_nodes.service. Если команды публикуются, но нет реакции двигателей, проверьте Ethernet-CAN и питание исполнительной части.

Также убедитесь, что не активирована аварийная остановка и исполнительная часть ровера готова к работе.

Проблемы с Ethernet-CAN и Cyphal​

В Rover B7 CAN-устройства подключены к модулю Ethernet-CAN, соединённому с роутером ровера по Ethernet.

Используются следующие интерфейсы Linux:

ИнтерфейсПодключённое оборудование
vcan1.0Шесть драйверов двигателей
vcan1.1PowerBoard
vcan1.3IO Board

Проверьте службу Ethernet-CAN:

systemctl status ethernet-can.service --no-pager
journalctl -u ethernet-can.service -b -n 100 --no-pager

Посмотрите доступные интерфейсы:

ip -br link | grep vcan

При подключённых и доступных CAN-устройствах можно просмотреть поступающие кадры:

candump vcan1.0

Для других плат используйте:

candump vcan1.1
candump vcan1.3

Каждая команда candump продолжает слушать интерфейс до остановки через Ctrl+C. Отсутствие сообщений само по себе не доказывает неисправность: некоторые устройства публикуют данные только при определённых условиях.

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

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

systemctl cat ethernet-can.service

В параметре ExecStart будет указан фактически используемый путь запуска и, при наличии, путь к файлу конфигурации. Не следует ориентироваться исключительно на предполагаемое имя JSON-файла.

Проверка обмена с двигателями​

В ROS 2 команды скорости передаются через топики /m_vel1–/m_vel6, а обратная связь приходит в /m_odom1–/m_odom6.

Проверьте наличие топиков:

ros2 topic list | grep -E '^/m_(vel|odom)[1-6]$'

Если топик /m_odom1 присутствует, можно получить одно сообщение обратной связи:

ros2 topic echo /m_odom1 --once

Если CAN-кадры на vcan1.0 видны, но топиков ROS 2 нет, проверьте запуск и конфигурацию cyphal_ros2_bridge.

Проверка PowerBoard и IO Board​

PowerBoard подключена через vcan1.1, а IO Board — через vcan1.3.

Проверьте наличие сообщений на соответствующих интерфейсах и доступные ROS 2-топики и сервисы:

ros2 topic list | grep -E '^/bat_1$|^/bat_2$'
ros2 service list | grep -E '^/rele$|^/light$|^/rele_control/state$'

Конкретный набор доступных топиков и сервисов зависит от версии запущенного ПО и конфигурации мостов Cyphal. Отсутствие ожидаемого интерфейса требует проверки запущенных нод и конфигурации, а не немедленной замены платы.

Перед перезапуском

Перезапуск ethernet-can.service или ros_nodes.service может прервать обмен командами с приводами и другой электроникой. Выполняйте его только после безопасной остановки ровера.

Просмотр журналов и дополнительных сведений​

Для поиска причин ошибки обычно достаточно следующих команд:

systemctl --failed
journalctl -u ros_nodes.service -b -n 100 --no-pager
journalctl -u ethernet-can.service -b -n 100 --no-pager
journalctl -u camera.service -b -n 100 --no-pager

Для проверки того, какие команды реально запускает системная служба:

systemctl cat ros_nodes.service

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