Software Set Up¶

• Software Set Up
  • TODO
  • Introduction
  • 1. Download required Software
  • 2. Install Arduino IDE
  • 3. Install Firmware on Holoseat Controller
  • 4. Install Desktop Configuration App

TODO¶

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

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.

1. Download required Software¶

1. Download the following files
   1. Arduino IDE (v1.6.4+)
   2. Adafruit Windows Drivers
   3. Firmware source code (v0.3.0 | v0.3.5)
   4. Desktop configuration app executable(v0.3.0 | v0.3.5)
2. Unzip Holoseat files (see figure)
   1. Create a new folder under Documents\ named Holoseat
   2. Unzip the firmware source code to Documents\Holoseat
   3. Unzip the desktop configuration app to Documents\Holoseat

2. Install Arduino IDE¶

1. Run the Arduino IDE installer
2. Configure the Arduino IDE to work with the Feather board
   Complete details are available at learn.adafruit.com: General details | Feather specific details
   1. Launch the Arduino IDE
   2. Open the Arduino IDE Preferences by selecting File>Preferences from the menu
   3. Add https://adafruit.github.io/arduino-board-index/package_adafruit_index.json to the Additional Boards Manager URLs field
   4. Click the OK button to save the new preferences
   5. Launch the Boards Manager by selecting Tools>Board>Board Manager from the menu
   6. Select Contributed from the Type select box
   7. Select Adafruit AVR Boards by Adafruit in the list of contributed boards then click the Install button
   8. 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)
   9. ON WINDOWS ONLY Install the Windows Adafruit Drivers (optional: only select the Feather 32u4 to minimize the number of drivers installed)
      
3. Copy the Arduino libraries to the Holoseat libs directory
   1. Launch the Arduino IDE
   2. Open the Arduino IDE Preferences by selecting File>Preferences from the menu
   3. Note the Sketchbook location (typically Documents\Arduino)
   4. Close the Arduino IDE Preferences and exit the Arduino IDE
   5. Copy Documents\Holoseat\Firmware\libs\Bounce2 to the libraries folder in the sketchbook folder (typically Documents\Arduino\libraries)
      

3. Install Firmware on Holoseat Controller¶

1. Launch the Arduino IDE
2. Plug the Holoseat controller into a USB port
3. Set the board type to Adafruit Feather 32u4 by selecting Tools>Board>Adafruit Feather 32u4 in the menu
4. 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)
   
5. Open the Holoseat firmware in the Arduino by selecting File>Open and navigating to Documents\Holoseat\Firmware\holoseat_firmware\holoseat_firmware.ino
6. Confirm the firmware compiles by clicking the Verify button (with the check mark icon)
7. Flash the Holoseat controller with the firmware by clicking the Upload button (with the right facing arrow icon)

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