h1. Software Set Up

{{>toc}}

h2. TODO

* Update Arduino library installation instructions (Bounce2 and ArrduinoJSON are available from the Arduino IDE) - see Firmware README.txt

h2. Introduction

These instructions cover the software set up of a newly built Holoseat controller.  There are three pieces of software required to configure and use the Holoseat: the Arduino IDE, the Holoseat controller firmware, and the desktop configuration app.  

Note, these steps are for Windows (tested on Windows 7).  The process is similar on other platforms, but the desktop configuration app only runs on Windows for v0.3.  Future versions will support other platforms.

h2. 1. Download required Software

# Download the following files
## "Arduino IDE":https://www.arduino.cc/en/Main/Software (v1.6.4+)
## "Adafruit Windows Drivers":https://github.com/adafruit/Adafruit_Windows_Drivers/releases/download/1.0.0.0/adafruit_drivers.exe
## Firmware source code ("v0.3.0":http://opendesignengine.net/dmsf_files/624?download= | "v0.3.5":http://opendesignengine.net/dmsf_files/655?download=)
## Desktop configuration app executable("v0.3.0":http://opendesignengine.net/dmsf_files/623?download= | "v0.3.5":http://opendesignengine.net/dmsf_files/654?download=)
# Unzip Holoseat files (see figure)
## Create a new folder under Documents\ named Holoseat
## Unzip the firmware source code to Documents\Holoseat
## Unzip the desktop configuration app to Documents\Holoseat

!HoloseatDir.png!

h2. 2. Install Arduino IDE

# Run the Arduino IDE installer
# Configure the Arduino IDE to work with the Feather board
Complete details are available at learn.adafruit.com: "General details":https://learn.adafruit.com/adafruit-arduino-ide-setup/arduino-1-dot-6-x-ide | "Feather specific details":https://learn.adafruit.com/adafruit-feather-32u4-basic-proto/using-with-arduino-ide
## Launch the Arduino IDE 
## Open the Arduino IDE Preferences by selecting *File>Preferences* from the menu
## Add @https://adafruit.github.io/arduino-board-index/package_adafruit_index.json@ to the *Additional Boards Manager URLs* field
## Click the *OK* button to save the new preferences
## Launch the Boards Manager by selecting *Tools>Board>Board Manager* from the menu
## Select _Contributed_ from the *Type* select box
## Select _Adafruit AVR Boards by Adafruit_ in the list of contributed boards then click the *Install* button
## Click the *Close* button, then exit out of the Arduino IDE (you may optionally relaunch the Arduino IDE and verify the list of boards under *Tools>Board* includes the Adafruit Feather)
## *ON WINDOWS ONLY* Install the Windows Adafruit Drivers (optional: only select the _Feather 32u4_ to minimize the number of drivers installed)
!InstallFeatherDriver.png!
# Copy the Arduino libraries to the Holoseat libs directory
## Launch the Arduino IDE
## Open the Arduino IDE Preferences by selecting File>Preferences from the menu
## Note the Sketchbook location (typically Documents\Arduino)
## Close the Arduino IDE Preferences and exit the Arduino IDE
## Copy Documents\Holoseat\Firmware\libs\Bounce2 to the libraries folder in the sketchbook folder (typically Documents\Arduino\libraries)
!LibrariesFolder.png!

h2. 3. Install Firmware on Holoseat Controller

# Launch the Arduino IDE
# Plug the Holoseat controller into a USB port
# Set the board type to _Adafruit Feather 32u4_ by selecting *Tools>Board>Adafruit Feather 32u4* in the menu
# Set the port the Feather is connected to by selecting *Tools>Port>COM# (Adafruit Feather 32u4)* in the menu where # is an integer (see figure)
!SelectComPort.png!
# Open the Holoseat firmware in the Arduino by selecting *File>Open* and navigating to Documents\Holoseat\Firmware\holoseat_firmware\holoseat_firmware.ino
# Confirm the firmware compiles by clicking the *Verify* button (with the check mark icon)
# Flash the Holoseat controller with the firmware by clicking the *Upload* button (with the right facing arrow icon)

h2. 4. Install Desktop Configuration App

The desktop configuration app does not currently require any installation steps.  You can run it directly from Documents\Holoseat\HoloseatConfigurationUtility