Files
clover/docs/ru/simulation_vm.md
Dmitrii Okoneshnikov 32d27f3f66 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>
2020-07-29 13:08:19 +03:00

7.7 KiB
Raw Blame History

Установка виртуальной машины

Для работы с платформой Клевер рекомендуется иметь установленное окружение ROS на своём компьютере. К сожалению, установка ROS сопряжена с рядом трудностей: требуется использовать операционную систему Ubuntu 18.04, процесс установки длительный и требует выполнения большого количества команд в терминале.

Для облегчения процесса настройки окружения мы предлагаем использовать виртуальную машину со всем необходимым для работы с платформой Клевер. В состав виртуальной машины входят:

  • операционная система Ubuntu 18.04 с легковесной графической оболочкой XFCE;
  • предустановленные пакеты ROS для работы с Клевером;
  • QGroundControl;
  • предварительно настроенный симулятор Gazebo;
  • среда разработки Visual Studio Code с плагинами для разработки на Python и C++.

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

Скачать текущую версию виртуальной машины можно в релизах репозитория виртуальной машины

Warning

Виртуальную машину следует использовать только в тех случаях, когда по каким-то причинам использование Ubuntu 18.04 напрямую невозможно. Производительность всех программ, особенно тех, которые используют 3D-графику - jMAVSim, Gazebo, rviz - будет существенно ниже; кроме того, в ряде случаев будут возникать графические ошибки, приводящие к частичной или полной неработоспособности указанных программ.

Установка виртуальной машины

Для запуска виртуальной машины разработчика требуется использовать одну из совместимых сред виртуализации: VirtualBox, VMware Player, VMware Workstation.

Note

На момент написания данной статьи VirtualBox не обеспечивал достаточный уровень совместимости с виртуальной машиной. Рекомендуется по возможности использовать VMware Player или VMware Workstation; дальнейшая инструкция будет преимущественно написана для VMware Player.

Убедитесь, что поддержка аппаратной виртуализации включена в настройках BIOS/UEFI вашего компьютера. Шаги для включения аппаратной виртуализации, как правило, описаны в руководстве пользователя компьютера. Проконсультируйтесь с производителем компьютера, если включить виртуализацию не получается.

  1. Импортируйте архив виртуальной машины в среду виртуализации. Для VMware Player используйте опцию Open a Virtual Machine:

    Open dialog with clever-devel.ova selected

    Note

    При импорте архива, скорее всего, появится окно с предупреждением о формате виртуальной машины: Import failure dialog Это предупреждение можно игнорировать и нажать кнопку Retry.

  2. Откройте окно настроек виртуальной машины и измените параметры для наилучшего соответствия основной системе:

    • увеличьте объём оперативной памяти, отводимый для виртуальной машины: Increasing avaliable memory
    • увеличьте количество доступных процессорных ядер: Increasing cpu cores
    • включите 3D-ускорение: Enabling 3D acceleration
    • включите использование USB 2.0/3.0: USB 3.0 controller
    • опционально включите режим "мост" для виртуального сетевого адаптера: Enabling bridge networking

    Note

    Режим "мост" может некорректно работать с некоторыми сетевыми адаптерами. Если в режиме "мост" вы не можете подключиться к дрону, используйте USB Wi-Fi-адаптеры, "проброшенные" в виртуальную машину.

  3. Запустите виртуальную машину. Возможно, при первом запуске справа появятся сообщения об отсутствии поддержки 3D-ускорения со стороны основной системы:

    No 3D support from host

    В этом случае убедитесь, что у вас установлены самые последние драйверы для видеокарты в основной системе. Если сообщения появляются при повторных запусках виртуальной машины, добавьте строку

    mks.gl.allowBlacklistedDrivers = "TRUE"
    

    в файл clever-devel.vmx, находящийся в папке, в которую был импортирован архив в п. 1.

  4. Настройте режим моста через настройки виртуальной машины (если используется VMware Player для Windows) или с помощью утилиты vmware-netcfg (если используется версия для Linux-дистрибутивов):

    vmware-netcfg interface

    В списке сетей выберите vmnet0, ниже - режим Bridged, в выпадающем списке Bridged to - название беспроводного адаптера, с помощью которого будет производиться подключение к дрону.