Prerequisites
Installation
The idea is that Vagrant uses VirtualBox to provision a virtual machine for our pre-configured image, box. This virtual machine contains a fully integrated development environment, including everything you'll need to develop software for our team.
Be sure you have the prerequisites installed! Each link should bring you directly to the proper download page.
# Clone the repo git clone https://github.com/uw-midsun/box.git && cd box # Download and load the vagrant box vagrant up && vagrant reload # Access the box vagrant ssh
Congratulations! If you're now at a prompt that says something along the lines of vagrant@midsunbox, you're in our development environment.
We expose a shared folder between your host operating system and the virtual environment, located at box/shared to allow you to use your favorite text editor from your host operating system.
# You should still be ssh'd into the box # Access the shared folder - found at box/shared cd ~/shared # Clone the firmware repo git clone https://github.com/uw-midsun/firmware.git && cd firmware # Try to build the firmware make build_all
While we're at it, let's configure some settings:
# Configure git git config --global user.name "Your Name" git config --global user.email youremail@example.com git config --global push.default simple git config --global core.autocrlf input
Please use the email that's associated with your GitHub account.
Usage
# Bring up the virtual machine # This step is only necessary after a reboot vagrant up # Access the box vagrant ssh # Move to the firmware folder cd shared/firmware # See https://github.com/uw-midsun/firmware#usage for some common commands make [cmd] ...
You're done! From now on, we'll assume you're using our development environment.