# Быстрая настройка для автономного полета

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

**Установка и подключение Raspberry Pi на квадрокоптере**

Установить Raspberry, таким образом, чтобы все основные разъемы у raspberry были со стороны хвоста, а камеру крепить у носа.

![](/files/-MdqZbAqed5Dh4-lsgJn)

Подключить к Raspberry питание 5 V и сигнальный провод от светодиодной ленты.

![](/files/-MdqZkJ2NSWCEa2ChEA3)

Подключить Raspberry и полетный контроллер кабелем microUSB

&#x20;Подробная установка raspberry pi на квадрокоптер можно посмотреть по ссылке: [https://clover.coex.tech/ru/assemble\_4\_2\_ws.html](https://vk.com/away.php?to=https%3A%2F%2Fclover.coex.tech%2Fru%2Fassemble_4_2_ws.html\&cc_key=)

## Образ для Raspberry Pi <a href="#obraz-dlya-raspberry-pi" id="obraz-dlya-raspberry-pi"></a>

**Образ RPi для Клевера** включает в себя все необходимое ПО для удобной работы с Клевером и [программирования автономных полетов](https://clover.coex.tech/ru/simple_offboard.html). Платформа Клевера основана на операционной системе [Raspbian](https://www.raspberrypi.org/downloads/raspbian/) и популярном робототехническом фреймворке [ROS](https://clover.coex.tech/ru/ros.html). Исходный код сборщика образа и всех дополнительных пакетов доступен [на GitHub](https://github.com/CopterExpress/clover).

### Использование <a href="#ispolzovanie" id="ispolzovanie"></a>

> Начиная с версии v0.22, образ основан на ROS Noetic и использует Python 3. Если вы хотите использовать ROS Melodic и Python 2, используйте версию [v0.21.2](https://github.com/CopterExpress/clover/releases/download/v0.21.2/clover_v0.21.2.img.zip).

1. Скачайте последний стабильный релиз образа — [**v0.22**](https://github.com/CopterExpress/clover/releases/download/v0.22/clover_v0.22.img.zip).
2. Скачайте и установите [программу для записи образов Etcher](https://www.balena.io/etcher/) (доступна для Windows/Linux/macOS).
3. Установите MicroSD-карту в компьютер (используйте адаптер при необходимости).
4. Запишите скачанный образ на карту, используя Etcher.
5. Установите карту в Raspberry Pi.

![](https://clover.coex.tech/assets/etcher.png)

После записи образа на SD-карту, вы можете подключаться к [Клеверу по Wi-Fi](https://clover.coex.tech/ru/wifi.html), использовать [беспроводное соединение в QGroundControl](https://clover.coex.tech/ru/gcs_bridge.html), получать [доступ по SSH](https://clover.coex.tech/ru/ssh.html) и использовать остальные функции. При необходимости узнать версию записанного на карту образа используйте [утилиту selfcheck.py](https://clover.coex.tech/ru/selfcheck.html).

## Подключение к Клеверу по Wi-Fi <a href="#podklyuchenie-k-kleveru-po-wi-fi" id="podklyuchenie-k-kleveru-po-wi-fi"></a>

> Документация для версий [образа](https://clover.coex.tech/ru/image.html), начиная с **0.20**. Для более ранних версий см. [документацию для версии **0.19**](https://github.com/CopterExpress/clover/blob/v0.19/docs/ru/wifi.md).

На [образе для RPi](https://clover.coex.tech/ru/image.html) преднастроена раздача Wi-Fi с SSID `clover-xxxx`, где xxxx – 4 случайных цифры, назначаемых при первом включении Raspberry Pi.

Подключитесь к Wi-Fi, используя пароль `cloverwifi`.

![](https://clover.coex.tech/assets/wifi-ssid.png)![](https://clover.coex.tech/assets/wifi-pass.png)

Для изменения настроек Wi-Fi или получения более детальной информации о устройстве сети на Raspberry Pi прочитайте статью "[Настройка Wi-Fi](https://clover.coex.tech/ru/network.html)".

### Веб-интерфейс <a href="#veb-interfeis" id="veb-interfeis"></a>

После подключения к Клеверу по адресу [http://192.168.11.1](http://192.168.11.1/) будет доступен веб-интерфейс. В нем доступны основные веб-инструменты Клевера: просмотр топиков с изображениями, веб-терминал (Butterfly) а также полная копия данной документации.

![Веб-интерфейс Клевера](https://clover.coex.tech/assets/web.png)

## Подключение Raspberry Pi к полетному контроллеру <a href="#podklyuchenie-raspberry-pi-k-poletnomu-kontrolleru" id="podklyuchenie-raspberry-pi-k-poletnomu-kontrolleru"></a>

Для программирования [автономных полетов](https://clover.coex.tech/ru/simple_offboard.html), [работы с Pixhawk (Pixracer) по Wi-Fi](https://clover.coex.tech/ru/gcs_bridge.html), использования [телефонного пульта](https://clover.coex.tech/ru/rc.html) и других функций необходимо соединение Raspberry Pi и полетного контроллера.

### Подключение по USB <a href="#podklyuchenie-po-usb" id="podklyuchenie-po-usb"></a>

Основным способом подключения является подключение по интерфейсу USB.

1. Соедините Raspberry Pi и полетный контроллер micro-USB to USB кабелем.
2. [Подключитесь в Raspberry Pi по SSH](https://clover.coex.tech/ru/ssh.html).
3. Убедитесь в работоспособности подключения, [выполнив на Raspberry Pi](https://clover.coex.tech/ru/ssh.html):

   ```bash
    rostopic echo /mavros/state
   ```

   Поле `connected` должно содержать значение `True`.

> Для корректной работы подключения Raspberry Pi и Pixhawk по USB необходимо установить значение [параметра](https://clover.coex.tech/ru/px4_parameters.html) `CBRK_USB_CHK` на 197848.

## Подключение QGroundControl по Wi-Fi <a href="#podklyuchenie-qgroundcontrol-po-wi-fi" id="podklyuchenie-qgroundcontrol-po-wi-fi"></a>

Возможны контроль, управление, калибровка и настройка полетного контроллера квадрокоптера с помощью программы QGroundControl по Wi-Fi. Для этого необходимо [подключиться к Wi-Fi](https://clover.coex.tech/ru/wifi.html) сети `clover-xxxx`.

### Подключение <a href="#podklyuchenie" id="podklyuchenie"></a>

По умолчанию на Клевере настроена возможность подключения QGroundControl по протоколу TCP.

1. На первой вкладке QGroundControl выберите меню *Comm Links*.
2. Нажмите кнопку *Add*, чтобы добавить новое подключение.
3. Введите параметры подключения:
   * Name: *Clover*.
   * Type: *TCP*.
   * Host Address: *192.168.11.1*.
   * TCP Port: *5760*.
4. Нажмите *OK* для сохранения параметров.
5. Выберите созданное подключение и нажмите *Connect*.

![Подключение QGroundControl к Клеверу через TCP](https://clover.coex.tech/assets/qgc-bridge-tcp.png)

После подключения к Клеверу по адресу <http://192.168.11.1> будет доступен веб-интерфейс. В нем доступны основные веб-инструменты Клевера: просмотр топиков с изображениями, веб-терминал (Butterfly) а также полная копия данной документации.

![](/files/-Mdqa-Cls5KAHZ3IYLk3)

|                                    |                                                                                                                                                                                                                                                                                                    |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *View documentation*               | <p>полная справка по сборке и настройке всех узлов квадрокоптера. Данной справкой можно пользоваться на соревнованиях. Точно такая же как и по этой ссылке: <a href="https://vk.com/away.php?to=https%3A%2F%2Fclover.coex.tech%2Fru%2F&#x26;cc_key="><https://clover.coex.tech/ru/></a></p><p></p> |
| *View image topics*                | <p> просмотр всех подключенных топиков. Это и просмотр картинки с камеры, просмотр карты Aruco и др.</p><p></p>                                                                                                                                                                                    |
| Open web terminal                  | <p>терминал, с помощью которого можно программировать квадрокоптер.</p><p></p>                                                                                                                                                                                                                     |
| *View 3D vizualization*            | <p>3-х мерное представление вашего квадрокоптера. Здесь можно посмотреть правильно ли ориентирована ваша камера. Для этого посмотрите на белый шлейф идущий к камере, его направление должно совпадать с 3-х мерной моделью.</p><p></p>                                                            |
| *3D visualization for markers map* | 3- х мерное представление вашего квадрокоптера, но уже с изображением карты Aruco меток. Здесь можно посмотреть правильно ли отображается квадрокоптер относительно карты меток.                                                                                                                   |

## &#x20;<a href="#komandnaya-stroka" id="komandnaya-stroka"></a>

## **Настройка параметров в QGroundControl**

1. Перейдите во вкладку Parameters:

![](/files/-MdqgPH9KviruieuR9rX)

&#x20;2\. Теперь вам необходимо перейти по ссылке и изменить ваши параметры на те, которые указаны по ссылке: [https://clover.coex.tech/ru/aruco\_map.html](https://vk.com/away.php?to=https%3A%2F%2Fclover.coex.tech%2Fru%2Faruco_map.html\&cc_key=).

Используйте поиск для поиска нужного параметра:

![](/files/-MdqggaqALLdLL48hY2l)

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

![](/files/-Mdqgp8V3CfJi4_r0f4X)

4\.  Теперь произведите тоже самое, но уже по другой ссылке: [https://clover.coex.tech/ru/optical\_flow.html](https://vk.com/away.php?to=https%3A%2F%2Fclover.coex.tech%2Fru%2Foptical_flow.html\&cc_key=)**.**

![](/files/-Mdqh5oiNaUWgFHE_2jK)

{% hint style="warning" %}
&#x20;Подробнее по выбор параметров можно ознакомиться по ссылке: [https://clover.coex.tech/ru/px4\_parameters.html](https://vk.com/away.php?to=https%3A%2F%2Fclover.coex.tech%2Fru%2Fpx4_parameters.html\&cc_key=)
{% endhint %}

После внесение изменений в параметры необходимо перезапустить устройство. Для этого выберите кнопку Tools и в сплывающем меню выберите «Reboot vehicle»**.**

![](/files/-MdqhITs1f1HP-F53tZn)

{% hint style="danger" %}
**P.S.** Не забудьте во вкладке FLight modes назначить режим полета и kill switch для вашего пульта управления. Как это сделать описано по ссылке: [https://clover.coex.tech/ru/modes.html](https://vk.com/away.php?to=https%3A%2F%2Fclover.coex.tech%2Fru%2Fmodes.html\&cc_key=)
{% endhint %}

## Командная строка <a href="#komandnaya-stroka" id="komandnaya-stroka"></a>

В Linux-системах, к семейству которых принадлежит используемая на Raspberry Pi ОС Raspbian, основным способом взаимодействия пользователя с системой является командная строка. Для работы с командной строкой [откройте SSH-соединение](https://clover.coex.tech/ru/ssh.html) с Raspberry Pi.

### Базовые команды <a href="#bazovye-komandy" id="bazovye-komandy"></a>

> Двойное нажатие клавиши `Tab ↹` позволяет автоматически дополнить вводимую команду или аргумент.

Показать содержимое текущей директории:

```bash
ls
```

Перейти в директорию:

```bash
cd catkin_ws/src/clover/clover/launch/
```

Перейти на директорию выше:

```bash
cd ..
```

Вывести путь к текущей директории:

```bash
pwd
```

Вывести содержимое файла `file.py`:

```bash
cat file.py
```

Запустить Python-скрипт `file.py`:

```bash
python3 file.py
```

Перезагрузить Raspberry Pi:

```bash
sudo reboot
```

Для завершения работающей программы нажмите комбинацию клавиш `Ctrl`+`C`.

Читайте больше о командах Linux в документации Raspberry Pi: <https://www.raspberrypi.org/documentation/linux/usage/commands.md>.

### Редактирование файлов <a href="#editing" id="editing"></a>

Используйте редактор **nano** для того, чтобы создавать или редактировать файлы на Raspberry Pi. Среди текстовых редакторов, доступных в терминале, он является наиболее простым и интуитивным.

1. Для редактирования файла введите команду:

   ```bash
   nano путь/к/файлу
   ```

   Например:

   ```bash
   nano ~/catkin_ws/src/clover/clover/launch/clover.launch
   ```

   <img src="https://clover.coex.tech/assets/nano.png" alt="Редактирование файла в nano" data-size="original">
2. Отредактируйте файл.
3. Для выхода с сохранением нажмите `Ctrl`+`X`, `Y`, `Enter`.
4. При изменении .launch-файлов необходимо перезапустить пакет `clover`:

   ```bash
   sudo systemctl restart clover
   ```

Для редактирования файлов также можно использовать и другие редакторы, например, **vim**.

### Сброс изменений <a href="#sbros-izmenenii" id="sbros-izmenenii"></a>

Для сброса изменений всех файлов, относящихся к пакету Клевера (`launch`-файлы) используйте git:

```bash
cd ~/catkin_ws/src/clover
git checkout .
sudo systemctl restart clover
```

## Настройка камеры <a href="#nastroika-kamery" id="nastroika-kamery"></a>

> Документация для версий [образа](https://clover.coex.tech/ru/image.html), начиная с **0.20**. Для более ранних версий см. [документацию для версии **0.19**](https://github.com/CopterExpress/clover/blob/v0.19/docs/ru/camera_frame.md).

Для корректной работы всех функций, связанных с компьютерным зрением (в том числе [полета по ArUco-маркерам](https://clover.coex.tech/ru/aruco.html) и [Optical Flow](https://clover.coex.tech/ru/optical_flow.html)) необходимо сфокусировать основную камеру, а также выставить ее расположение и ориентацию. Улучшить качество работы также может опциональная калибровка камеры.

### Настройка фокуса камеры <a href="#focus" id="focus"></a>

Для успешного осуществления полетов с использованием камеры, необходимо настроить фокус камеры.

![](https://clover.coex.tech/assets/cam_setup.png)

1. Откройте трансляцию изображения с камеры используя [web\_video\_server](https://clover.coex.tech/ru/web_video_server.html).
2. С помощью вращения объектива камеры добейтесь максимальной резкости деталей (предпочтительно на расстоянии предполагаемой высоты полета – 2–3 м).

| Расфокусированное изображение                      | Сфокусированное изображение                      |
| -------------------------------------------------- | ------------------------------------------------ |
| ![](https://clover.coex.tech/assets/unfocused.png) | ![](https://clover.coex.tech/assets/focused.png) |

### Настройка расположения камеры <a href="#frame" id="frame"></a>

Расположение и ориентация камеры [задается в файле](https://clover.coex.tech/ru/cli.html#editing) `~/catkin_ws/src/clover/clover/launch/main_camera.launch`:

```xml
<arg name="direction_z" default="down"/> <!-- direction the camera points: down, up -->
<arg name="direction_y" default="backward"/> <!-- direction the camera cable points: backward, forward -->
```

Для того, чтобы задать ориентацию, необходимо установить:

* направление обзора камеры `direction_z`: вниз (`down`) или вверх (`up`);
* направление, в которое указывает шлейф камеры `direction_y`: назад (`backward`) или вперед (`forward`).

#### Примеры <a href="#primery" id="primery"></a>

**Камера направлена вниз, шлейф назад**

```xml
<arg name="direction_z" default="down"/>
<arg name="direction_y" default="backward"/>
```

![](https://clover.coex.tech/assets/camera_option_1_rviz.png) ![](https://clover.coex.tech/assets/camera_option_1_clever.jpg)

**Камера направлена вниз, шлейф вперёд**

```xml
<arg name="direction_z" default="down"/>
<arg name="direction_y" default="forward"/>
```

![](https://clover.coex.tech/assets/camera_option_2_rviz.png) ![](https://clover.coex.tech/assets/camera_option_2_clever.jpg)

**Камера направлена вверх, шлейф назад**

```xml
<arg name="direction_z" default="up"/>
<arg name="direction_y" default="backward"/>
```

![](https://clover.coex.tech/assets/camera_option_3_rviz.png) ![](https://clover.coex.tech/assets/camera_option_3_clever.jpg)

**Камера направлена вверх, шлейф вперёд**

```xml
<arg name="direction_z" default="down"/>
<arg name="direction_y" default="forward"/>
```

![](https://clover.coex.tech/assets/camera_option_4_rviz.png) ![](https://clover.coex.tech/assets/camera_option_4_clever.jpg)

> [Утилита `selfcheck.py`](https://clover.coex.tech/ru/selfcheck.html) выдает словесное описание установленной в данной момент ориентации основной камеры.

{% content-ref url="/pages/-MdqaaqmcNSX8ajAtZeI" %}
[Настройки внутренних файлов образа ОС](/docs-tkuik/programmirovanie-poletov/programmirovanie-poleta/nastroiki-vnutrennikh-failov-obraza-os.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MdqhuyM6YgyGOVWl2aD" %}
[Создание Aruco карты](/docs-tkuik/programmirovanie-poletov/programmirovanie-poleta/sozdanie-aruco-karty.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MdqmX5zz1bXr4ucoBsN" %}
[Создание автономной программы программы](/docs-tkuik/programmirovanie-poletov/programmirovanie-poleta/sozdanie-avtonomnoi-programmy-programmy.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://lahmeneffa.gitbook.io/docs-tkuik/programmirovanie-poletov/bystraya-nastroika-dlya-avtonomnogo-poleta.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
