Add Vagrant configuration for creating a development VM

Vagrant is an application that automates creation and provisioning of a virtual
machine for development. The config here creates an Ubuntu 16.04 LTS machine,
updates it, downloads and installs the toolchains for sh, m68k and arm,
mingw-w64, SDL (for Windows simulators) and other packages needed for building
Rockbox.

It works fine for building a Windows simulator and compiling iPod classic
binaries. It should be possible to make the other build types, too.

MIPS toolchain fails to build, ARM-APP is not tested because the files download
very slow on my connection. Please test if it works for you, and let me know.

Quick start: download and install Vagrant and VirtualBox for your operating
system, make sure VT-x / AMD-V is enabled in your BIOS/EFI setup, open a
shell in rockbox/tools and input the command "vagrant up"

Change-Id: Ief5476ab066663a4db7e85404b25d2d781d90532

.gitignore

@@ -94,6 +94,8 @@
 /tools/mkzenboot
 /tools/iaudio_bl_flash.c
 /tools/iaudio_bl_flash.h
+/tools/.vagrant
+/tools/*-console.log
 
 # /tools/database/
 /tools/database/database

tools/Vagrantfile

@@ -0,0 +1,90 @@
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+# All Vagrant configuration is done below. The "2" in Vagrant.configure
+# configures the configuration version (we support older styles for
+# backwards compatibility). Please don't change it unless you know what
+# you're doing.
+Vagrant.configure("2") do |config|
+  # The most common configuration options are documented and commented below.
+  # For a complete reference, please see the online documentation at
+  # https://docs.vagrantup.com.
+
+  # Every Vagrant development environment requires a box. You can search for
+  # boxes at https://atlas.hashicorp.com/search.
+  config.vm.box = "ubuntu/xenial64"
+
+  # Disable automatic box update checking. If you disable this, then
+  # boxes will only be checked for updates when the user runs
+  # `vagrant box outdated`. This is not recommended.
+  # config.vm.box_check_update = false
+
+  # Create a forwarded port mapping which allows access to a specific port
+  # within the machine from a port on the host machine. In the example below,
+  # accessing "localhost:8080" will access port 80 on the guest machine.
+  # config.vm.network "forwarded_port", guest: 80, host: 8080
+
+  # Create a private network, which allows host-only access to the machine
+  # using a specific IP.
+  # config.vm.network "private_network", ip: "192.168.33.10"
+
+  # Create a public network, which generally matched to bridged network.
+  # Bridged networks make the machine appear as another physical device on
+  # your network.
+  # config.vm.network "public_network"
+
+  # Share an additional folder to the guest VM. The first argument is
+  # the path on the host to the actual folder. The second argument is
+  # the path on the guest to mount the folder. And the optional third
+  # argument is a set of non-required options.
+  # config.vm.synced_folder "../data", "/vagrant_data"
+  config.vm.synced_folder "..", "/rockbox"
+
+  # Provider-specific configuration so you can fine-tune various
+  # backing providers for Vagrant. These expose provider-specific options.
+  # Example for VirtualBox:
+  #
+  config.vm.provider "virtualbox" do |vb|
+  #   # Display the VirtualBox GUI when booting the machine
+  #   vb.gui = true
+  #
+  #   # Customize the amount of memory on the VM:
+  #   vb.memory = "1024"
+      vb.name = "rockbox-dev"
+  end
+  #
+  # View the documentation for the provider you are using for more
+  # information on available options.
+
+  # Define a Vagrant Push strategy for pushing to Atlas. Other push strategies
+  # such as FTP and Heroku are also available. See the documentation at
+  # https://docs.vagrantup.com/v2/push/atlas.html for more information.
+  # config.push.define "atlas" do |push|
+  #   push.app = "YOUR_ATLAS_USERNAME/YOUR_APPLICATION_NAME"
+  # end
+
+  # Enable provisioning with a shell script. Additional provisioners such as
+  # Puppet, Chef, Ansible, Salt, and Docker are also available. Please see the
+  # documentation for more information about their specific syntax and use.
+  # config.vm.provision "shell", inline: <<-SHELL
+  #   apt-get update
+  #   apt-get install -y apache2
+  # SHELL
+  config.vm.provision "shell" do |s|
+    s.name = "provision"
+    s.inline = "/rockbox/tools/vagrant/provision.sh"
+  end
+
+  config.vm.provision "shell", privileged: false do |s|
+    s.name = "provision-nonprivileged"
+    s.inline = "/rockbox/tools/vagrant/provision-nonprivileged.sh"
+  end
+
+  config.vm.provision "shell", run: "always" do |s|
+    s.name = "startup"
+    s.inline = "/rockbox/tools/vagrant/startup.sh"
+  end
+
+  # Other options
+  config.vm.hostname = "rockbox-dev"  
+end

tools/vagrant/provision-nonprivileged.sh

@@ -0,0 +1,21 @@
+#!/bin/bash -e
+
+# Compile and install the Rockbox toolchain
+# s   - sh       (Archos models)
+# m   - m68k     (iriver h1x0/h3x0, iaudio m3/m5/x5 and mpio hd200)
+# a   - arm      (ipods, iriver H10, Sansa, D2, Gigabeat, etc)
+# i   - mips     (Jz4740 and ATJ-based players)
+# r   - arm-app  (Samsung ypr0)
+
+# MIPS toolchain fails at installation: https://pastebin.com/raw/8SBhN58q
+# ARM-APP toolchain is not tested
+echo s m a | RBDEV_PREFIX="${HOME}/rbdev-toolchain" /rockbox/tools/rockboxdev.sh
+echo 'PATH="$HOME/rbdev-toolchain/bin:$PATH"' >> "${HOME}/.profile"
+
+# Download SDL-1.2.5 and compile it using MinGW32
+cd "${HOME}"
+wget --progress=bar:force http://www.libsdl.org/release/SDL-1.2.15.tar.gz
+tar -zxvf SDL-1.2.15.tar.gz
+cd SDL-1.2.15
+./configure --host=x86_64-w64-mingw32 --prefix="${HOME}/mingw32-sdl"
+make install

tools/vagrant/provision.sh

@@ -0,0 +1,6 @@
+#!/bin/bash -e
+
+# Update the OS and install all required packages
+apt-get update
+apt-get dist-upgrade -y
+apt-get install -y zip build-essential gcc-mingw-w64-i686 gcc-mingw-w64-x86-64 texinfo automake libtool-bin flex bison libncurses-dev

tools/vagrant/startup.sh

@@ -0,0 +1,3 @@
+#!/bin/bash -e
+
+# This script runs on every boot