diff --git a/docs/assets/simulation_setup_vm/01_vbox_import_ova.png b/docs/assets/simulation_setup_vm/01_vbox_import_ova.png
new file mode 100644
index 000000000..bb3ec654c
Binary files /dev/null and b/docs/assets/simulation_setup_vm/01_vbox_import_ova.png differ
diff --git a/docs/assets/simulation_setup_vm/02_vbox_setup_memory.png b/docs/assets/simulation_setup_vm/02_vbox_setup_memory.png
new file mode 100644
index 000000000..e5d0e3d66
Binary files /dev/null and b/docs/assets/simulation_setup_vm/02_vbox_setup_memory.png differ
diff --git a/docs/assets/simulation_setup_vm/03_vbox_setup_cpu.png b/docs/assets/simulation_setup_vm/03_vbox_setup_cpu.png
new file mode 100644
index 000000000..201236632
Binary files /dev/null and b/docs/assets/simulation_setup_vm/03_vbox_setup_cpu.png differ
diff --git a/docs/assets/simulation_setup_vm/04_vbox_setup_vtx.png b/docs/assets/simulation_setup_vm/04_vbox_setup_vtx.png
new file mode 100644
index 000000000..8e7df96d4
Binary files /dev/null and b/docs/assets/simulation_setup_vm/04_vbox_setup_vtx.png differ
diff --git a/docs/assets/simulation_setup_vm/05_vbox_setup_rdp.png b/docs/assets/simulation_setup_vm/05_vbox_setup_rdp.png
new file mode 100644
index 000000000..a02a2cff4
Binary files /dev/null and b/docs/assets/simulation_setup_vm/05_vbox_setup_rdp.png differ
diff --git a/docs/assets/simulation_setup_vm/06_vbox_setup_video.png b/docs/assets/simulation_setup_vm/06_vbox_setup_video.png
new file mode 100644
index 000000000..d3c653160
Binary files /dev/null and b/docs/assets/simulation_setup_vm/06_vbox_setup_video.png differ
diff --git a/docs/assets/simulation_setup_vm/07_vbox_setup_cdrom.png b/docs/assets/simulation_setup_vm/07_vbox_setup_cdrom.png
new file mode 100644
index 000000000..9da78a978
Binary files /dev/null and b/docs/assets/simulation_setup_vm/07_vbox_setup_cdrom.png differ
diff --git a/docs/assets/simulation_setup_vm/08_vbox_setup_cdrom_guestadds.png b/docs/assets/simulation_setup_vm/08_vbox_setup_cdrom_guestadds.png
new file mode 100644
index 000000000..4d74e50db
Binary files /dev/null and b/docs/assets/simulation_setup_vm/08_vbox_setup_cdrom_guestadds.png differ
diff --git a/docs/assets/simulation_setup_vm/09_vbox_setup_cdrom_attached.png b/docs/assets/simulation_setup_vm/09_vbox_setup_cdrom_attached.png
new file mode 100644
index 000000000..4d7a35cc9
Binary files /dev/null and b/docs/assets/simulation_setup_vm/09_vbox_setup_cdrom_attached.png differ
diff --git a/docs/assets/simulation_setup_vm/10_vbox_coex_guestadd_install.png b/docs/assets/simulation_setup_vm/10_vbox_coex_guestadd_install.png
new file mode 100644
index 000000000..592dcf2a8
Binary files /dev/null and b/docs/assets/simulation_setup_vm/10_vbox_coex_guestadd_install.png differ
diff --git a/docs/assets/simulation_setup_vm/11_vbox_coex_guestadd_build.png b/docs/assets/simulation_setup_vm/11_vbox_coex_guestadd_build.png
new file mode 100644
index 000000000..a18a5a4a9
Binary files /dev/null and b/docs/assets/simulation_setup_vm/11_vbox_coex_guestadd_build.png differ
diff --git a/docs/assets/simulation_setup_vm/12_vbox_coex_adduser_vboxsf.png b/docs/assets/simulation_setup_vm/12_vbox_coex_adduser_vboxsf.png
new file mode 100644
index 000000000..cce35ff3c
Binary files /dev/null and b/docs/assets/simulation_setup_vm/12_vbox_coex_adduser_vboxsf.png differ
diff --git a/docs/assets/simulation_setup_vm/13_vbox_setup_clipboard.png b/docs/assets/simulation_setup_vm/13_vbox_setup_clipboard.png
new file mode 100644
index 000000000..32dc9906f
Binary files /dev/null and b/docs/assets/simulation_setup_vm/13_vbox_setup_clipboard.png differ
diff --git a/docs/assets/simulation_setup_vm/14_vbox_setup_sharedfolder.png b/docs/assets/simulation_setup_vm/14_vbox_setup_sharedfolder.png
new file mode 100644
index 000000000..8205f94f1
Binary files /dev/null and b/docs/assets/simulation_setup_vm/14_vbox_setup_sharedfolder.png differ
diff --git a/docs/assets/simulation_setup_vm/15_vbox_setup_sharedfolder_test.png b/docs/assets/simulation_setup_vm/15_vbox_setup_sharedfolder_test.png
new file mode 100644
index 000000000..b8c177b25
Binary files /dev/null and b/docs/assets/simulation_setup_vm/15_vbox_setup_sharedfolder_test.png differ
diff --git a/docs/assets/simulation_setup_vm/16_vbox_network_bridge_wlan0.png b/docs/assets/simulation_setup_vm/16_vbox_network_bridge_wlan0.png
new file mode 100644
index 000000000..24e4c1261
Binary files /dev/null and b/docs/assets/simulation_setup_vm/16_vbox_network_bridge_wlan0.png differ
diff --git a/docs/assets/simulation_setup_vm/17_vbox_network_internet.png b/docs/assets/simulation_setup_vm/17_vbox_network_internet.png
new file mode 100644
index 000000000..ce24ce5a0
Binary files /dev/null and b/docs/assets/simulation_setup_vm/17_vbox_network_internet.png differ
diff --git a/docs/assets/simulation_setup_vm/18_vbox_network_clover.png b/docs/assets/simulation_setup_vm/18_vbox_network_clover.png
new file mode 100644
index 000000000..7f52addb7
Binary files /dev/null and b/docs/assets/simulation_setup_vm/18_vbox_network_clover.png differ
diff --git a/docs/assets/simulation_setup_vm/19_vbox_network_scan.png b/docs/assets/simulation_setup_vm/19_vbox_network_scan.png
new file mode 100644
index 000000000..24cd19c28
Binary files /dev/null and b/docs/assets/simulation_setup_vm/19_vbox_network_scan.png differ
diff --git a/docs/assets/simulation_setup_vm/bios-virtualization-option.jpg b/docs/assets/simulation_setup_vm/bios-virtualization-option.jpg
new file mode 100644
index 000000000..41144877c
Binary files /dev/null and b/docs/assets/simulation_setup_vm/bios-virtualization-option.jpg differ
diff --git a/docs/en/simulation_vm.md b/docs/en/simulation_vm.md
index 34b780ade..17fac8cf2 100644
--- a/docs/en/simulation_vm.md
+++ b/docs/en/simulation_vm.md
@@ -20,9 +20,13 @@ You can download the latest VM image [in the VM releases repository](https://git
You need to use a VM manager that supports OVF format, like [VirtualBox](https://www.virtualbox.org/wiki/Downloads), [VMware Player](https://www.vmware.com/products/workstation-player.html) or [VMware Workstation](https://www.vmware.com/products/workstation-pro.html).
-> **Note** At the time of writing VirtualBox had issues running the VM, particularly with 3D applications. We recommend using VMware Player or VMware Workstation if possible. The following steps assume you're using VMware Player.
+Make sure that you have hardware virtualization enabled in your BIOS/UEFI (it may be supported by your hardware but turned off by default).
-Make sure that you have hardware virtualization enabled in your BIOS/UEFI (it may be supported by your hardware but turned off by default). The steps to enable virtualization differ from manufacturer to manufacturer, but should be described in your system manual. Consult your system's manufacturer if you're having trouble turning virtualization on.
+
+
+The steps to enable virtualization differ from manufacturer to manufacturer, but should be described in your system manual. Consult your system's manufacturer if you're having trouble turning virtualization on.
+
+### Configuring virtual machine in the VMware Player environment
1. Import the OVA archive into your virtualization environment. Use the **Open a Virtual Machine** option in VMware Player:
@@ -64,3 +68,122 @@ Make sure that you have hardware virtualization enabled in your BIOS/UEFI (it ma
![vmware-netcfg interface](../assets/simulation_setup_vm/09_netcfg.png)
Select `vmnet0` in the networks list, set it to *Bridged*, and choose the adapter you are planning to use to connect to drone in the drop-down menu.
+
+### Configuring virtual machine in the VirtualBox environment
+
+Hereafter, a *laptop* will be understood as the *main system* in which the virtual machine is being created.
+
+1. Import the virtual machine archive into the virtualization environment.
+
+ * use the menu item **Open in VirtualBox** or double-click on the downloaded `clover-devel.ova` file:
+ ![Open dialog with clover-devel.ova selected](../assets/simulation_setup_vm/01_vbox_import_ova.png)
+ * wait for the virtual machine import procedure to complete;
+ * after the import is completed, the downloaded `clover-devel.ova` file can be deleted.
+
+2. Open the virtual machine settings window and change the settings to best match the capabilities of the laptop:
+
+ * increase the amount of RAM allocated to the virtual machine (recommended size is above 8GB):
+ ![Increasing avaliable memory](../assets/simulation_setup_vm/02_vbox_setup_memory.png)
+ * increase the number of available processor cores (it is recommended to allocate half of the processor cores from the available number in the laptop):
+ ![Increasing CPU cores](../assets/simulation_setup_vm/03_vbox_setup_cpu.png)
+ * enable all available additional hardware acceleration features supported by your laptop:
+ ![Enabling CPU virtualization](../assets/simulation_setup_vm/04_vbox_setup_vtx.png)
+ * disable remote access to the virtual machine if you plan to use it on a laptop and not on the server:
+ ![Disabling remote desktop access](../assets/simulation_setup_vm/05_vbox_setup_rdp.png)
+ * select the type of graphics controller `VMSVGA` (pay attention to the warning prompts at the bottom of the window, a different type of graphics controller may be recommended for use on your laptop):
+ ![Setup video subsystem](../assets/simulation_setup_vm/06_vbox_setup_video.png)
+ * disable "3D acceleration" in the same tab of the settings window (the lightweight XFCE graphical shell in the virtual machine does not use 3D acceleration, and when 3D acceleration is enabled, some laptops experience "slowness" in operation);
+ * add an optical disk drive, in the new window specify the path to `VBoxGuestAdditions.iso` to the file (in Windows, you can find this file in the directory `C:\Program files\Oracle\VirtualBox`, and on Linux, look for it in the directory `/usr/share/virtualbox`, if it is not there, then see the instructions below):
+ ![Setup CD-ROM drive](../assets/simulation_setup_vm/07_vbox_setup_cdrom.png)
+
+ ```bash
+ # installation VBoxGuestAdditions.iso on Linux
+ sudo apt install virtualbox-guest-additions-iso
+ # search for the location of the .iso file
+ # filepath is usually /usr/share/virtualbox/VBoxGuestAdditions.iso
+ dpkg -L virtualbox-guest-additions-iso | grep VBoxGuestAdditions.iso
+ ```
+
+ ![Choose VBoxGuestAdditions.iso](../assets/simulation_setup_vm/08_vbox_setup_cdrom_guestadds.png)
+ * confirm file path selection, make sure that the new CD drive is in the list of devices:
+ ![Attached VBoxGuestAdditions.iso](../assets/simulation_setup_vm/09_vbox_setup_cdrom_attached.png)
+ * for more information about contents of the add-on disc, see [this link](https://docs.oracle.com/en/virtualization/virtualbox/7.0/user/guestadditions.html);
+ * close the settings window by saving the changes using the "OK" button.
+
+3. Start the virtual machine. Install the extensions for VirtualBox so that you can use the *clipboard* and work with files using the *shared folder* mode.
+
+ * after starting the virtual machine, make sure that in the "Devices | Optical discs" check the box opposite `VBoxGuestAdditions.iso` installed;
+ * open the file manager in the virtual machine and find the "Devices" group on the top right, click on `VBox_GA_7.0.12`:
+ ![Install Guest Additions](../assets/simulation_setup_vm/10_vbox_coex_guestadd_install.png)
+ * in the list of files that appears, click on an empty space (not on the icon), select "Open terminal here", enter the command `sudo ./autorun.sh`:
+ ![Building Guest Additions](../assets/simulation_setup_vm/11_vbox_coex_guestadd_build.png)
+ * a new window will appear in which the necessary drivers and programs for working with the clipboard and shared folders will be builded;
+ * wait for the completion of the program' building, when the inscription "Press Return to close this window..." appears, press Enter, the window will close;
+ * add the Linux user of the virtual machine to the group that is allowed to share files, to do this, enter the command `sudo adduser $USER vboxsf`:
+ ![Building Guest Additions](../assets/simulation_setup_vm/12_vbox_coex_adduser_vboxsf.png)
+ * the changes will require restarting the virtual machine, turn it off using the `sudo shutdown now` command;
+ * after shutting down the virtual machine in the VirtualBox program window, go back to its settings and enable the shared clipboard and Drag'n'Drop function (optional):
+ ![Enabling clipboard and drag'n'drop](../assets/simulation_setup_vm/13_vbox_setup_clipboard.png)
+ * close the settings window by saving the changes using the "OK" button.
+
+4. Start the virtual machine. Make sure that the functions of the VirtualBox add-ons are working.
+
+ * in the "View" menu, the "Screen integration mode" will be available to you, when you change the size of the virtual machine window, its resolution will adjust to the size of the window, so that you can work in Gazebo with large display resolutions;
+ * check the functionality of the *clipboard* content sharing function both when copying text from a virtual machine and from a laptop to a virtual machine;
+ * check the functionality of the Drag'n'Drop function by dragging a file from the laptop to the desktop of the virtual machine (*attention! if you are using Windows on a laptop, dragging files may cause crashes in the virtual machine, in which case it is recommended to disable this feature*);
+ * in the virtual machine menu "Devices | Shared Folders | Configure Shared Folders" add a new folder by selecting the path on the laptop (*attention! it is recommended to use folders with only Latin characters, for example `/home/galina/Workspace` or `c:\Users\galina\Documents`*):
+ ![Setup shared folder](../assets/simulation_setup_vm/14_vbox_setup_sharedfolder.png)
+ * in the folder settings specify "Auto-connect" and "Create a permanent folder";
+ * close the settings window by saving the changes using the "OK" button.
+ * open the file manager, find a new folder in the upper Devices group, which will have a prefix `sf_`, for example `sf_galina`, create an empty file, make sure that the file appears in the laptop's file system:
+ ![Working in shared folder](../assets/simulation_setup_vm/15_vbox_setup_sharedfolder_test.png)
+ * if any of the listed items does not work, repeat the steps listed in section 3 by re-installing and configuring the VirtualBox extensions.
+
+5. Configure networking in the virtual machine. Changing the network mode in VirtualBox is possible in real time, you can choose any suitable option. See below for a list of options from which you can choose the one that will be most convenient for you in your work:
+
+ * **Connection type: NAT** - default mode. In this mode, your laptop creates a separate local network for the virtual machine, from which it can connect to the network (for example, download something from the Internet), but network nodes in the opposite direction will not be able to connect to the server on the virtual machine (for example, Raspberry Pi **will not be able** to connect to [clever-show](clever-show.md) server). The network IP address that the virtual machine will receive will be from the range generated by your laptop, for example `10.0.2.15`. This mode is identical to the conditions created by home routers, when your home computer can access the Internet, but computers from the Internet will not be able to access your computer on their own initiative (this feature must be configured and allowed).
+ * **Connection type: Network Bridge**. In this mode, the virtual machine connects to the network through your laptop *transparently*. Along with the choice of connection type, you are also asked to choose the name of the network interface related to the network of which the virtual machine will become a part. In this mode, the virtual machine will receive a network IP address related to your chosen network, for example, if your home router distributed addresses in the range `192.168.0.xxx`, then connecting the virtual machine to the router's network it would receive an address such as `192.168.0.100`. In this mode, inside the selected network, you are allowed to connect to any network node, and other nodes have the ability to connect to your virtual machine (for example, Raspberry Pi **will be able to** connect to [clever-show](clever-show.md) server).
+
+To change the network type, go to the "Devices | Network | Configure network" menu item. Select the connection option that suits you, if necessary, select the name of the network connection, confirm the change using the "OK" button. To make changes to the network, select the menu item "Devices | Network | Connect the network cable", wait for the "Disconnected" notification to appear in the VM. Then select the "Devices | Network | Connect the network cable" menu item again, wait for the "Connection Established" notification to appear in the VM.
+
+For example, switch the network to the "Network Bridge" mode by selecting the network interface corresponding to your WiFi adapter (by performing the above-recommended manipulation of reconnecting the "network cable"). Connect your laptop to a WiFi network with internet access.
+
+![VirtualBox bridging through wlan0](../assets/simulation_setup_vm/16_vbox_network_bridge_wlan0.png)
+
+Make sure that the address of the virtual machine is actually received inside a WiFi network with Internet access, and the Internet is available in the virtual machine.
+
+```bash
+ip a
+ping ya.ru
+```
+
+![VirtualBox bridging into internet](../assets/simulation_setup_vm/17_vbox_network_internet.png)
+
+In the screenshot above, the IP address of the virtual machine is the address `192.168.2.195` and it has Internet access because the server `ya.ru` is pinging.
+
+Then [connect to Raspberry Pi via Wi-Fi](wi fi.md), repeat the above recommended manipulation of switching the "network cable".
+
+```bash
+ip a
+ping 192.168.11.1
+ssh pi@192.168.11.1
+```
+
+![VirtualBox bridging into internet](../assets/simulation_setup_vm/18_vbox_network_clover.png)
+
+In the screenshot above, the IP address of the virtual machine is the address `192.168.11.160`, it pings the Raspberry Pi with the address `192.168.11.1`, and can login into the microcomputer [via SSH](ssh.md). *There will be no Internet access on this virtual machine, because both it and the laptop have disconnected from the WiFi network with Internet access*. Without disconnecting from the Clover WiFi network, scan the network nodes connected to the network:
+
+```bash
+sudo nmap -sP -PR -T3 192.168.11.0/24
+ip a
+```
+
+![Network scanning from VirtualBox](../assets/simulation_setup_vm/19_vbox_network_scan.png)
+
+In the screenshot above, nodes have been found on the network:
+
+* `192.168.11.1` - Raspberry Pi microcomputer;
+* `192.168.11.117` - laptop with an Intel network adapter;
+* `192.168.11.160` - the `clover-dev` virtual machine from which the scan was performed.
+
+If all the checks listed above have been passed, then your virtual machine running in the VirtualBox environment is ready to work.
diff --git a/docs/ru/simulation_vm.md b/docs/ru/simulation_vm.md
index 3ea08464f..d899ec792 100644
--- a/docs/ru/simulation_vm.md
+++ b/docs/ru/simulation_vm.md
@@ -22,9 +22,13 @@
Для запуска виртуальной машины разработчика требуется использовать одну из совместимых сред виртуализации: [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 вашего компьютера (виртуалиазция может поддерживаться, но может быть отключена по умолчанию).
-Убедитесь, что поддержка аппаратной виртуализации включена в настройках BIOS/UEFI вашего компьютера. Шаги для включения аппаратной виртуализации, как правило, описаны в руководстве пользователя компьютера. Проконсультируйтесь с производителем компьютера, если включить виртуализацию не получается.
+
+
+Шаги для включения аппаратной виртуализации, как правило, описаны в руководстве пользователя компьютера. Проконсультируйтесь с производителем компьютера, если включить виртуализацию не получается.
+
+### Настройка виртуальной машины в среде VMware Player
1. Импортируйте архив виртуальной машины в среду виртуализации. Для VMware Player используйте опцию **Open a Virtual Machine**:
@@ -66,3 +70,122 @@
![vmware-netcfg interface](../assets/simulation_setup_vm/09_netcfg.png)
В списке сетей выберите `vmnet0`, ниже - режим *Bridged*, в выпадающем списке *Bridged to* - название беспроводного адаптера, с помощью которого будет производиться подключение к дрону.
+
+### Настройка виртуальной машины в среде VirtualBox
+
+Здесь и далее под *ноутбуком* будет пониматься *основная система* в которой создаётся виртуальная машина.
+
+1. Импортируйте архив виртуальной машины в среду виртуализации.
+
+ * используйте пункт меню **Открыть в VirtualBox** или дважды щёлкните по скачанному `clover-devel.ova` файлу:
+ ![Open dialog with clover-devel.ova selected](../assets/simulation_setup_vm/01_vbox_import_ova.png)
+ * дождитесь завершения процедуры импорта виртуальной машины;
+ * после завершения импорта скачанный `clover-devel.ova` файл можно удалить.
+
+2. Откройте окно настроек виртуальной машины и измените параметры для наилучшего соответствия возможностям ноутбука:
+
+ * увеличьте объём оперативной памяти, отводимый для виртуальной машины (рекомендуемый объём от 8Гб):
+ ![Increasing avaliable memory](../assets/simulation_setup_vm/02_vbox_setup_memory.png)
+ * увеличьте количество доступных процессорных ядер (рекомендуется выделить половину процессорных ядер от имеющегося количества в ноутбуке):
+ ![Increasing CPU cores](../assets/simulation_setup_vm/03_vbox_setup_cpu.png)
+ * включите все доступные дополнительные возможности аппаратного ускорения, поддерживаемые вашим ноутбуком:
+ ![Enabling CPU virtualization](../assets/simulation_setup_vm/04_vbox_setup_vtx.png)
+ * отключите удалённый доступ к виртуальной машине, если её использование планируется на ноутбуке, а не на сервере:
+ ![Disabling remote desktop access](../assets/simulation_setup_vm/05_vbox_setup_rdp.png)
+ * выберите тип графического контроллера `VMSVGA` (обратите внимание на подсказки с предупреждениями в нижней части окна, на вашем ноутбуке может быть рекомендован к использованию иной тип графического контроллера):
+ ![Setup video subsystem](../assets/simulation_setup_vm/06_vbox_setup_video.png)
+ * отключите "3D-ускорение" в той же вкладе окна настроек (облегчённая графическая оболочка XFCE в виртуальной машине не использует 3D-ускорение, и при включении 3D-ускорения у некоторых ноутбуков наблюдается "заторможенность" в работе);
+ * добавьте привод оптических дисков, в появившемся окне укажите путь к `VBoxGuestAdditions.iso` файлу (в Windows этот файл вы можете найти в каталоге `C:\Program files\Oracle\VirtualBox`, а в Linux поищите его в директории `/usr/share/virtualbox`, если его там нет, то см. инструкцию ниже):
+ ![Setup CD-ROM drive](../assets/simulation_setup_vm/07_vbox_setup_cdrom.png)
+
+ ```bash
+ # установка VBoxGuestAdditions.iso в Linux
+ sudo apt install virtualbox-guest-additions-iso
+ # поиск места расположения .iso файла
+ # обычно это /usr/share/virtualbox/VBoxGuestAdditions.iso
+ dpkg -L virtualbox-guest-additions-iso | grep VBoxGuestAdditions.iso
+ ```
+
+ ![Choose VBoxGuestAdditions.iso](../assets/simulation_setup_vm/08_vbox_setup_cdrom_guestadds.png)
+ * подтвердите выбор пути к файлу, убедитесь что в списке устройств появился новый привод компакт-дисков:
+ ![Attached VBoxGuestAdditions.iso](../assets/simulation_setup_vm/09_vbox_setup_cdrom_attached.png)
+ * дополнительную информацию по содержимому диска с дополнениями см. по [этой ссылке](https://docs.oracle.com/en/virtualization/virtualbox/7.0/user/guestadditions.html);
+ * закройте окно с настройками, сохранив изменения с помощью кнопки "ОК".
+
+3. Запустите виртуальную машину. Установите расширения для VirtualBox для того, чтобы появилась возможность использовать буфер обмена (*clipboard*) и работать с файлами с использованием режима *общих папок*.
+
+ * после запуска виртуальной машины убедитесь, что в меню "Устройства | Оптические диски" галочка напротив `VBoxGuestAdditions.iso` установлена;
+ * откройте файловый менеджер в виртальной машине и сверху справа отыщите группу "Devices", щёлкните по `VBox_GA_7.0.12`:
+ ![Install Guest Additions](../assets/simulation_setup_vm/10_vbox_coex_guestadd_install.png)
+ * в появившемся списке файлов щёлкните по пустому месту (не по иконке), выберите пункт "Open terminal here", введите команду `sudo ./autorun.sh`:
+ ![Building Guest Additions](../assets/simulation_setup_vm/11_vbox_coex_guestadd_build.png)
+ * откроется новое окно, в котором выполнится сборка необходимых драйверов и программ для работы с буфером обмена и общими папками;
+ * дождитесь завершения сборки программ, когда появится надпись "Press Return to close this window..." нажмите Enter, окно закроется;
+ * добавьте Linux-пользователя виртуальной машины в группу, которой разрешён обмен общими файлами, для этого введите команду `sudo adduser $USER vboxsf`:
+ ![Building Guest Additions](../assets/simulation_setup_vm/12_vbox_coex_adduser_vboxsf.png)
+ * внесённые изменения потребуют перезапуск виртуальной машины, выключите её с помощью команды `sudo shutdown now`;
+ * после выключения виртуальной машины в окне программы VirtualBox вернитесь в её настройки и включите общий буфер обмена и функцию Drag'n'Drop (по желанию):
+ ![Enabling clipboard and drag'n'drop](../assets/simulation_setup_vm/13_vbox_setup_clipboard.png)
+ * закройте окно с настройками, сохранив изменения с помощью кнопки "ОК".
+
+4. Запустите виртуальную машину. Убедитесь, что функции дополнений VirtualBox работают.
+
+ * в меню "Вид" вам станет доступен "Режим интеграции экрана", при изменении размера окна виртуальной машины её разрешение будет подстраиваться под размер окна, так что вы сможете работать в Gazebo с крупными разрешениями дисплея;
+ * проверьте работоспособность функции обмена содержимым буфера обмена (*clipboard*) как при копировании текста из виртуальной машины, так и из ноутбука в виртуальную машину;
+ * проверьте работоспособность функции Drag'n'Drop, перетащив из ноутбука какой-нибудь файл на рабочий стол виртуальной машины (*внимание! если вы используете Windows на ноутбуке, то перетаскивание файлов может приводить к сбоям в виртуальной машине, если вы столкнулись с этой проблемой, тогда рекомендуется отключить эту функцию*);
+ * в меню виртуальной машины "Устройства | Общие папки | Настроить общие папки" добавьте новую папку, выбрав путь на ноутбуке (*внимание! рекомендуется использовать папки лишь только с латинскими символами, например `/home/galina/Workspace` или `c:\Users\galina\Documents`*):
+ ![Setup shared folder](../assets/simulation_setup_vm/14_vbox_setup_sharedfolder.png)
+ * в настройках папки укажите "Автоподключение" и "Создайте постоянную папку";
+ * закройте окно с настройками, сохранив изменения с помощью кнопки "ОК";
+ * откройте файловый менеджер, отыщите новую папку в верхней группе Devices, у которой будет приписка `sf_`, например `sf_galina`, создайте пустой файл, убедитесь что файл появился в файловой системе ноутбука:
+ ![Working in shared folder](../assets/simulation_setup_vm/15_vbox_setup_sharedfolder_test.png)
+ * если какой-то из перечисленных пунктов не работает, повторите действия перечисленные в разделе №3, повторно установив и настроив расширения VirtualBox.
+
+5. Настройте работу с сетью в виртуальной машине. Смена режима работы сети в VirtualBox возможна в реальном масштабе времени, вы можете выбрать любой подходящий вариант. См. ниже список вариантов из которых вы можете выбрать тот, который будет наиболее удобен для вас в работе:
+
+ * **Тип подключения: NAT** - режим по умолчанию. В этом режиме ваш ноутбук создаёт отдельную локальную сеть для виртуальной машины, из которой она сможет подключиться к сети (например что-либо скачать из интернета), но узлы сети в обратном направлении не смогут подключиться к серверу на виртуальной машине (например, Raspberry Pi **не сможет** подключиться к [clever-show](clever-show.md) серверу). Сетевой IP-адрес, который получит виртуальная машина, будет из диапазона сгенерированного вашим ноутбуком, например `10.0.2.15`. Этот режим идентичен тем условиям, которые создают домашние роутеры, когда ваш домашний компьютер может выйти в интернет, но компьютеры из интернета не смогут по своей инициативе попасть на ваш компьютер (эту возможность необходимо настроить и разрешить).
+ * **Тип подключения: Сетевой мост**. В этом режиме виртуальная машина подключается к сети через ваш ноутбук *прозрачно*. Вместе с выбором типа подключения вам предлагается выбрать ещё и название сетевого интерфейса, относящегося к той сети, частью которой станет виртуальная машина. В этом режиме виртуальная машина получит сетевой IP-адрес относящийся к выбранной вами сети, например, если бы ваш домашний роутер раздавал адреса в диапазоне `192.168.0.xxx`, то подключив виртуальную машину к сети роутера она получила бы адрес например `192.168.0.100`. В этом режиме внутри выбранной сети вам разрешено подключиться к любому сетевому узлу, так и у других узлов имеется возможность подключаться к вашей виртуальной машине (например, Raspberry Pi **сможет** подключиться к [clever-show](clever-show.md) серверу).
+
+Для того, чтобы сменить тип сети, перейдите к пункту меню "Устройства | Сеть | Настроить сеть". Выберите подходящий вам вариант подключения, при необходимости выберите имя сетевого подключения, подтвердите изменение с помощью кнопки "ОК". Для того, чтобы изменения в сети произошли, выберите пункт меню "Устройства | Сеть | Подключить сетевой кабель", дождитесь появления в виртуальной машине уведомления "Disconnected". После чего снова выберите пункт меню "Устройства | Сеть | Подключить сетевой кабель", дождитесь появления в виртуальной машине уведомления "Connection Established".
+
+Например, переведите сеть в режим "Сетевой мост" выбрав сетевой интерфейс соответствующий вашему WiFi адаптеру (выполнив рекомендованные выше манипуляцию по переподключению "сетевого кабеля"). Подключите ноутбук к WiFi-сети с выходом в интернет.
+
+![VirtualBox bridging through wlan0](../assets/simulation_setup_vm/16_vbox_network_bridge_wlan0.png)
+
+Убедитесь, что адрес виртуальной машины действительно получен внутри WiFi-сети с выходом в интернет, и интернет в виртуальной машине доступен.
+
+```bash
+ip a
+ping ya.ru
+```
+
+![VirtualBox bridging into internet](../assets/simulation_setup_vm/17_vbox_network_internet.png)
+
+На приведённом выше скриншоте IP-адресом виртуальной машины является адрес `192.168.2.195` и она имеет выход в интернет, т.к. пингует сервер `ya.ru`.
+
+После чего [подключитесь к Raspberry Pi по Wi-Fi](wifi.md), повторите рекомендованные выше манипуляцию по переключению "сетевого кабеля".
+
+```bash
+ip a
+ping 192.168.11.1
+ssh pi@192.168.11.1
+```
+
+![VirtualBox bridging into internet](../assets/simulation_setup_vm/18_vbox_network_clover.png)
+
+На приведённом выше скриншоте IP-адресом виртуальной машины является адрес `192.168.11.160`, она пигнует Raspberry Pi с адресом `192.168.11.1`, и может зайти на микрокомпьютер [по SSH](ssh.md). *Доступа к интернету на этой виртуальной машине не будет, т.к. как она и ноутбук отключились от WiFi сети с выходом в интернет*. Не отключаясь от WiFi-сети Клевера выполните сканирование сетевых узлов, поключенных к сети:
+
+```bash
+sudo nmap -sP -PR -T3 192.168.11.0/24
+ip a
+```
+
+![Network scanning from VirtualBox](../assets/simulation_setup_vm/19_vbox_network_scan.png)
+
+На приведённом выше скриншоте в сети найдены узлы:
+
+* `192.168.11.1` - микрокомпьютер Raspberry Pi;
+* `192.168.11.117` - ноутбук с сетевым адаптером Intel;
+* `192.168.11.160` - виртуальная машина `clover-dev` с которой выполнялось сканирование.
+
+Если все проверки перечисленные выше пройдены, то ваша виртуальная машина запущенная в среде VirtualBox готова к работе.