VirtualBox Image

Download Link

You can get the VM here: TODO

Prerequisites

• Install VirtualBox (https://www.virtualbox.org/wiki/Downloads)

Importing

• You have to unzip the archive which is about 4 GB big.
• Double click the file with the extension .vbox. Virtual Box should load up automatically.

Initial Steps

• While the required software and libraries and also the recommended IDE (VSCode) is preinstalled in the image, the Codebase for the Emulator still has to be downloaded by you. Create a working directory like src, git or workspace inside the home directory (~) and clone your fork of https://github.com/alxhoff/FreeRTOS-Emulator.git to a subdirectory.
• As you probably want to integrate changes made to the original Repository to your fork it is helpful to add another remote to the repository you have just cloned. To do so, execute

  git remote add upstream https://github.com/alxhoff/FreeRTOS-Emulator.git
  git fetch upstream
  

  inside the FreeRTOS-Emulator folder.

Details

• Lubuntu (16.04, 64 bit)
• As lightweight as the toolchain allows.
• Login should happen automatically but if you require f.e. a SSH connection the default password for the user rtos-sim is rtos-sim 😉
• Beside a few shortcuts to commonly used software you will find two scripts called ZOOM and RESET on the Guests Desktop. While ZOOM sets the screen resolution to 800x600 and hides the taskbar for a sort of "presentation mode", RESET should restore the configuration to the one recommended by VirtualBox (depending on the current window size). The scripts are automatically called when launching the emulator via a remote connectionRemote Connection so you can ignore them or use them to play a scaled up version of your game.

(Optional) Configuration

• Customize Number of CPUs/Amount of RAM to your needs.
• For accessing the VM (Guest) from your local machine (f. e. when performing remove Development via VSCode) a "Host-only Network“ is established. As the a static IP address should be used you have to disable the DHCP Server (TDO: LINK to explanations per OS) for vboxnet1 inside the VirtualBox Settings. After this you can reach the VM via 192.168.57.106. (See https://gist.github.com/pjdietz/5768124 for details about static IP in Host-Only Networks)
• The default keyboard layout inside the prepared VM should be "Englisch (US)", but you can it to "German (QWERTZ)" easily by clicking the flag icon in right part of the task bar. You can also add other layouts if required, by launching the panel's settings via da right click.