Vagrant-based VirtualBox environment for STM32 ARM Development using Ubuntu 14.04 Server

Attention!

This project requires a relatively recent computer that supports Hardware Virtualization. You MUST make sure you have AMD-V or VT-x extensions enabled in your computer's BIOS otherwise the Virtual Machine will not boot!

If you encounter other problems, check out the Gotchas section below

Host OS Requirements

• Windows 7 or higher, or Mac OS X Mountain Lion or higher
• About 15GB of Free Space on OS hard drive

Prerequisites before you begin building the virtual machine

• Install VirtualBox v5.0.0 https://www.virtualbox.org/wiki/Downloads
• Install VirtualBox Extension Pack v5.0.0 https://www.virtualbox.org/wiki/Downloads
• Install Vagrant v1.7.4 https://www.vagrantup.com/downloads.html
• If you haven't already installed the above items, you will most likely be asked to reboot your computer, please do so before continuing...

Building the environment for the first time

• Download a copy of this repository as a zip file
• Unzip on your local system
• Open a terminal/command prompt, navigate to the unzipped folder, execute vagrant up
• If you have never used Vagrant before, Vagrant will try to install some required plugins the first time you execute vagrant up. Vagrant will install them first, prompt for you to restart vagrant up, then exit the program. Execute vagrant up to continue building the Virtual Machine after the plugins install.
• Go get something to drink, eat, or otherwise occupy your time as it will take a while to download the 2.1+GB base box from the Atlas cloud.
• Eventually you will have an Ubuntu Desktop that is prompting you to log in. The password is contextual

Installed Tools

• Eclipse 4.4 (Luna)
• Eclipse CDT for C/C++
• EmbSysRegViewer for Eclipse
• TCF Terminal View for Eclipse
• GNU ARM Plugin for Eclipse
• ATOM Text Editor
• Evince PDF Reader
• Vim Text Editor
• ack-grep
• Git
• stlink command line tools
• OpenOCD 0.9.0 2015-05-19 Release
• GNU ARM Tools 2015-Q2 Release
• Firefox web browser
• KiCAD EDA Software Suite

Removing the Dev Environment Image from your hard drive

• Open a terminal, navigate to the unzipped folder, execute vagrant destroy This will delete the VM from your system.

Gotchas

If you are using Windows and receive an error that the Vagrant Home Directory can't have spaces in it due to a bug in Ruby, your User home directory probably has a space in it.

• Create a folder "home" within C:\Hashicorp\Vagrant - C:\Hashicorp\Vagrant\home ( This assumes you used the default install directory for Vagrant )
• Add the environment variable VAGRANT_HOME to Windows, see http://www.computerhope.com/issues/ch000549.htm if you don't know how.
• Reboot your system for the new environment variable to take effect.
• Try again...