diff --git a/docs/assets/raspberry-vl53l1x.png b/docs/assets/raspberry-vl53l1x.png new file mode 100644 index 00000000..89089849 Binary files /dev/null and b/docs/assets/raspberry-vl53l1x.png differ diff --git a/docs/assets/rviz-range.png b/docs/assets/rviz-range.png new file mode 100644 index 00000000..ac3aa1d0 Binary files /dev/null and b/docs/assets/rviz-range.png differ diff --git a/docs/ru/SUMMARY.md b/docs/ru/SUMMARY.md index fb003eb7..c4626905 100644 --- a/docs/ru/SUMMARY.md +++ b/docs/ru/SUMMARY.md @@ -44,6 +44,7 @@ * [Светодиодная лента](leds.md) * [Визуализация с помощью rviz](rviz.md) * [Ультразвуковой дальномер](sonar.md) + * [Лазерный дальномер](laser.md) * [Работа с SITL](sitl.md) * [Автозапуск ПО](autolaunch.md) * [Взаимодействие с Arduino](arduino.md) diff --git a/docs/ru/laser.md b/docs/ru/laser.md new file mode 100644 index 00000000..0ae2b3f9 --- /dev/null +++ b/docs/ru/laser.md @@ -0,0 +1,65 @@ +# Работа с лазерным дальномером + +## Дальномер VL53L1X + +Рекомендуемая для Клевера модель дальномера – STM VL53L1X. Это дальномер может измерять расстояния от 0 до 4 м, при этом обеспечивая высокую точность измерений. + +На [образе для Raspberry Pi](microsd_images.md) предустановен соответствующий ROS-драйвер. + +### Подключение к Raspberry Pi + +Подключите дальномер по интерфейсу I²C к пинам 5V, GND, SCL и SDA: + +Подключение VL53L1X + +> **Hint** По интерфейсу I²C возможно подключать несколько периферийных устройств одновременно. Используйте для этого параллельное подключение. + +### Включение + +[Подключитесь по SSH](ssh.md) и отредактируйте файл `~/catkin_ws/src/clever/clever/launch/clever.launch` так, чтобы драйвер VL53L1X был включен: + +```xml + +``` + +По умолчания драйер дальномера передает данные в Pixhawk (через топик `/mavros/distance_sensor/rangefinder_3_sub`). Для просмотра данных из топика используйте команду: + +```bash +rostopic echo mavros/distance_sensor/rangefinder_3_sub +``` + +### Настройки PX4 + +TODO + +### Получение данных из Python + +Для получения данных из топика создайте подписчика: + +```python +from sensor_msgs.msg import Range + +# ... + +def range_callback(msg): + # Обработка новых данных с дальномера + print 'Rangefinder distance:', msg.range + +rospy.Subscriber('mavros/distance_sensor/rangefinder_3_sub', Range, range_callback) +``` + +### Визуализация данных + +Для посмотроения графика по данным с дальномера может быть использован rqt_multiplot. + +Для визуализации данных может быть использован rviz. Для этого необходимо добавить топик типа `sensor_msgs/Range` в визуализацию: + +Range в rviz + +См. [подробнее об rviz и rqt](rviz.md). + +