> For the complete documentation index, see [llms.txt](https://lahmeneffa.gitbook.io/docs-tkuik/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lahmeneffa.gitbook.io/docs-tkuik/programmirovanie-poletov/bystraya-nastroika-dlya-avtonomnogo-poleta.md).

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

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

**Установка и подключение 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 %}
