This chapter will explain how to install a Virtual Machine on your PC. Please select the operating system you are u using:

Linux Linux Windows Windows Windows MacOS

A vitrual machine can be used to try out Motorcortex. Using a virtual machine you will need a .img file or a .vdi file. and VirtualBox installed on your machine. this chapter will show how to install VirtualBox and get your virtual machine up and going.

Installing VirtualBox (Windows)

To get VirtualBox you wil have to download it from the https://www.virtualbox.org/wiki/Downloads website. choose the operating system you are using. and download the .exe file.

  1. Double click the .exe file.

  2. The setup wizard will pop-up click next.

  1. Click Next unless you want to change the location for the VirtualBox.

  1. Click ‘Next’ unless you want to change some of the install options.

  1. A warning will tell you that network connections will be disconected temporarily. Click Yes.

  1. Click Install.

  1. The instalation will start. During the instalation a security warning will pop-up click Install.

  1. click Finish to complete the instalation.

Converting image

to use virtual box a .vdi file is needed. .img files or compressed .img.xz files have to be converted.

to uncompress a .img.xz file run the following command in the folder the file is located.

	unxz -k -v yourfile.xz

the compressed image will now be uncompressed. after this you can convert the .img file to a .vdi file. make sure you are in the correct folder where the file is located.

	VBoxManage convertfromraw yourfile.img yourfile.vdi		

Setting up virtal machine

Setting up the virtual machine has to be done using the folowing steps:

  1. Open VirtualBox and click on New.

  1. In the Create Virtual Machine pop-up the following settings have to be selected.
  • Name: desired name
  • Machine Folder: desired folder
  • Type: Linux
  • Version: Linux 2.6/3.x/4.x(64-bit)

  1. Click Next.

  2. Set the memory size to 8000 MB and click Next.

  1. select the Use an existing virtual hard disk file and click on the folder icon.

  1. Click the Add icon and browse to the desired .vdi file.

  1. Click Choose.

  1. Click Create.

A virtual machine is created. Now the Network has to be configured.

  1. Click File and go to Host Network Manager.

  1. In the Host Network Manager fill in the settings as following:
  • Disable the DHCP Server by unchecking the box
  • IPv4 Address: 192.168.2.1
  • Network Mask: 255.255.255.0

  1. Close the Host Network Manager.

The network manager is now configured. Now the system settings have to be checked.

  1. click on settings.

  1. In System under the Motherboard tab make sure the Enable EFI box is checked.

  1. In System under the Motherboard tab make sure that Processor(s) is set to 4 CPU’s.

  1. In Network under the Adapter1 tab set Attached to to Host-only Adapter.

  1. Click OK

The virtual machine has now been set up.

Using virtual machine

Starting your virtual machine has to be done using the folowing steps:

  1. In virtual box select the desired virtual machine and press Start.

  1. The virtual machine will boot now this can take up to 5 seconds or longer.

  1. Log in to the controller.
  • Login: Admin
  • Password: vectioneer

the command line should change like this.

	mcx-intel:~$

If no hardware is connected to the virtual machine make sure the simulation mode is activated. how to activate simulation mode is described in Sumulation Mode