Диагностика и типовые проблемы
В этом разделе приведены основные проверки для Rover B7 с бортовым компьютером x86, Ubuntu Server 24.04 LTS и ROS 2 Jazzy. Инструкция относится к конфигурации, в которой x86-компьютер и модуль Ethernet-CAN подключены кабелями к роутеру KROKS RT-CSE G.
Перед проверкой двигателей и перезапуском управляющих служб остановите ровер, переведите органы управления в нейтральное положение и убедитесь, что он не может самопроизвольно поехать. Не выполняйте проверочные команды движения, если колёса находятся на земле рядом с людьми.
Быстрый выбор проблемы
| Проблема | Что проверить в первую очередь |
|---|---|
| Ровер не определяется в сети | Питание роутера, Ethernet-кабель x86, подключение к Wi-Fi нужного ровера, IP-адрес |
| Не удаётся подключиться по SSH | IP-адрес, пользователь 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/tcp | SSH |
8080/tcp | Веб-интерфейс ровера |
9090/tcp | rosbridge WebSocket |
9999/tcp | web_video_server |
Если команды 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 — номер ровера. Названия сетей на конкретном устройстве могут быть изменены при настройке.
- Убедитесь, что ровер и роутер включены и загрузка x86-компьютера завершилась.
- Подключите рабочий компьютер к Wi-Fi-сети нужного ровера.
- Проверьте Ethernet-кабель между x86-компьютером и роутером, а также индикаторы подключения на портах.
- Откройте веб-интерфейс роутера по адресу
http://192.168.20.1. - Найдите 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.1 | PowerBoard |
vcan1.3 | IO 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-топиков и последние сообщения журналов.