Tried translating simulator articles (#259)

* Translation + fix broken links

* Fix broken links

* Changes

* Fixed some typos

* Fixed header

* docs/simulation_native: Stylistic changes, fix typo (ru)

* docs: Add old simulation_vm article (ru)

* docs: Update SUMMARY.md (ru)

* docs/simulation_native: Use main branch for simulation (ru)

* Fixed some stuff

* Update docs/ru/simulation_native.md

Co-authored-by: Ilya Petrov <38784273+copterspace@users.noreply.github.com>

* Fixed some stuff

* Removed extra spaces

Co-authored-by: Oleg Kalachev <okalachev@gmail.com>

* Fixed typo

Co-authored-by: Oleg Kalachev <okalachev@gmail.com>

* Fixed typo

Co-authored-by: Oleg Kalachev <okalachev@gmail.com>

* Update docs/ru/simulation_vm.md

Co-authored-by: Oleg Kalachev <okalachev@gmail.com>

* Removed extra spaces

Co-authored-by: Oleg Kalachev <okalachev@gmail.com>

* Fixed typo

Co-authored-by: Alexey Rogachevskiy <sfalexrog@gmail.com>
Co-authored-by: Ilya Petrov <38784273+copterspace@users.noreply.github.com>
Co-authored-by: Oleg Kalachev <okalachev@gmail.com>
This commit is contained in:
Dmitrii Okoneshnikov
2020-07-29 17:08:19 +07:00
committed by GitHub
parent 585af026d4
commit 32d27f3f66
5 changed files with 250 additions and 0 deletions

66
docs/ru/simulation_vm.md Normal file
View File

@@ -0,0 +1,66 @@
# Установка виртуальной машины
Для работы с платформой Клевер рекомендуется иметь [установленное окружение ROS](ros.md) на своём компьютере. К сожалению, [установка ROS](ros-install.md) сопряжена с рядом трудностей: требуется использовать операционную систему Ubuntu 18.04, процесс установки длительный и требует выполнения большого количества команд в терминале.
Для облегчения процесса настройки окружения мы предлагаем использовать виртуальную машину со всем необходимым для работы с платформой Клевер. В состав виртуальной машины входят:
* операционная система Ubuntu 18.04 с легковесной графической оболочкой XFCE;
* предустановленные пакеты ROS для работы с Клевером;
* QGroundControl;
* предварительно настроенный симулятор Gazebo;
* среда разработки Visual Studio Code с плагинами для разработки на Python и C++.
Виртуальная машина может использоваться как для запуска симуляторов, так и для работы с настоящим дроном.
Скачать текущую версию виртуальной машины можно [в релизах репозитория виртуальной машины](https://github.com/CopterExpress/clover_vm/releases)
> **Warning** Виртуальную машину следует использовать только в тех случаях, когда по каким-то причинам использование Ubuntu 18.04 напрямую невозможно. Производительность всех программ, особенно тех, которые используют 3D-графику - jMAVSim, Gazebo, rviz - будет существенно ниже; кроме того, в ряде случаев будут возникать графические ошибки, приводящие к частичной или полной неработоспособности указанных программ.
## Установка виртуальной машины
Для запуска виртуальной машины разработчика требуется использовать одну из совместимых сред виртуализации: [VirtualBox](https://www.virtualbox.org/wiki/Downloads), [VMware Player](https://www.vmware.com/products/workstation-player.html), [VMware Workstation](https://www.vmware.com/products/workstation-pro.html).
> **Note** На момент написания данной статьи VirtualBox не обеспечивал достаточный уровень совместимости с виртуальной машиной. Рекомендуется по возможности использовать VMware Player или VMware Workstation; дальнейшая инструкция будет преимущественно написана для VMware Player.
Убедитесь, что поддержка аппаратной виртуализации включена в настройках BIOS/UEFI вашего компьютера. Шаги для включения аппаратной виртуализации, как правило, описаны в руководстве пользователя компьютера. Проконсультируйтесь с производителем компьютера, если включить виртуализацию не получается.
1. Импортируйте архив виртуальной машины в среду виртуализации. Для VMware Player используйте опцию **Open a Virtual Machine**:
![Open dialog with clever-devel.ova selected](../assets/simulation_setup_vm/01_import_vm.png)
> **Note** При импорте архива, скорее всего, появится окно с предупреждением о формате виртуальной машины:
![Import failure dialog](../assets/simulation_setup_vm/02_import_failure.png)
Это предупреждение можно игнорировать и нажать кнопку **Retry**.
2. Откройте окно настроек виртуальной машины и измените параметры для наилучшего соответствия основной системе:
* увеличьте объём оперативной памяти, отводимый для виртуальной машины:
![Increasing avaliable memory](../assets/simulation_setup_vm/03_max_memory.png)
* увеличьте количество доступных процессорных ядер:
![Increasing cpu cores](../assets/simulation_setup_vm/04_core_count.png)
* включите 3D-ускорение:
![Enabling 3D acceleration](../assets/simulation_setup_vm/05_3d_acceleration.png)
* включите использование USB 2.0/3.0:
![USB 3.0 controller](../assets/simulation_setup_vm/06_usb_3_0.png)
* опционально включите режим "мост" для виртуального сетевого адаптера:
![Enabling bridge networking](../assets/simulation_setup_vm/07_bridge_networking.png)
> **Note** Режим "мост" может некорректно работать с некоторыми сетевыми адаптерами. Если в режиме "мост" вы не можете подключиться к дрону, используйте USB Wi-Fi-адаптеры, "проброшенные" в виртуальную машину.
3. Запустите виртуальную машину. Возможно, при первом запуске справа появятся сообщения об отсутствии поддержки 3D-ускорения со стороны основной системы:
![No 3D support from host](../assets/simulation_setup_vm/08_no_3d_acceleration.png)
В этом случае убедитесь, что у вас установлены самые последние драйверы для видеокарты в основной системе. Если сообщения появляются при повторных запусках виртуальной машины, добавьте строку
```
mks.gl.allowBlacklistedDrivers = "TRUE"
```
в файл `clever-devel.vmx`, находящийся в папке, в которую был импортирован архив в п. 1.
4. Настройте режим моста через настройки виртуальной машины (если используется VMware Player для Windows) или с помощью утилиты `vmware-netcfg` (если используется версия для Linux-дистрибутивов):
![vmware-netcfg interface](../assets/simulation_setup_vm/09_netcfg.png)
В списке сетей выберите `vmnet0`, ниже - режим *Bridged*, в выпадающем списке *Bridged to* - название беспроводного адаптера, с помощью которого будет производиться подключение к дрону.