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

• Relatively recent computer that supports Hardware Virtualization. Make sure you have AMD-V or VT-x extensions enabled in your computer's BIOS!
• Windows 7 or higher, or Mac OS X Mountain Lion or higher
• About 15GB of Free Space on OS hard drive
• 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

Starting the first time

• Download a copy of this repository as a zip file
• Unzip on your local system
• Open a terminal, navigate to the unzipped folder, execute vagrant up
• Most likely your system will not have the necessary Vagrant plugins installed, so Vagrant will install them first and prompt for you to restart vagrant up
• 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...