Edit History

Software Set Up

Version 10 (J. Simmons, 12/12/2016 08:16 pm)

1 1 J. Simmons 
h1. Software Set Up
2 1 J. Simmons 






    3
    2
    J. Simmons
    
{{>toc}}






    4
    2
    J. Simmons
    






    5
    2
    J. Simmons
    
h2. Introduction






    6
    2
    J. Simmons
    






    7
    6
    J. Simmons
    
These instructions cover the software set up of a newly built Holoseat controllerThere are three pieces of software required to configure and use the Holoseat: the Arduino IDE, the Holoseat controller firmware, and the desktop configuration app.  The setup is presented in the following four major steps.






    8
    1
    J. Simmons
    






    9
    6
    J. Simmons
    
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.






    10
    6
    J. Simmons
    






    11
    3
    J. Simmons
    
h2. 1. Download required Software






    12
    1
    J. Simmons
    






    13
    5
    J. Simmons
    
# Download the following files






    14
    6
    J. Simmons
    
## "Arduino IDE":https://www.arduino.cc/en/Main/Software (v1.6.4+)






    15
    7
    J. Simmons
    
## "Adafruit Windows Drivers":https://github.com/adafruit/Adafruit_Windows_Drivers/releases/download/1.0.0.0/adafruit_drivers.exe






    16
    5
    J. Simmons
    
## Firmware source code - link to DMSF to be created as soon as we tag v0.3 in svn






    17
    5
    J. Simmons
    
## Desktop configuration app executable - link to DMSF to be created as soon as we tag v0.3 in svn






    18
    5
    J. Simmons
    
# Unzip Holoseat files (see figure)






    19
    5
    J. Simmons
    
## Create a new folder under Documents\ named Holoseat






    20
    5
    J. Simmons
    
## Unzip the firmware source code to Documents\Holoseat






    21
    5
    J. Simmons
    
## Unzip the desktop configuration app to Documents\Holoseat






    22
    2
    J. Simmons
    






    23
    5
    J. Simmons
    
!HoloseatDir.png!






    24
    1
    J. Simmons
    






    25
    1
    J. Simmons
    
h2. 2. Install Arduino IDE






    26
    6
    J. Simmons
    






    27
    6
    J. Simmons
    
# Run the Arduino IDE installer






    28
    6
    J. Simmons
    
# Configure the Arduino IDE to work with the Feather board






    29
    1
    J. Simmons
    
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






    30
    7
    J. Simmons
    
## Launch the Arduino IDE 






    31
    7
    J. Simmons
    
## Open the Arduino IDE Preferences by selecting File>Preferences from the menu






    32
    7
    J. Simmons
    
## Add @https://adafruit.github.io/arduino-board-index/package_adafruit_index.json@ to the *Additional Boards Manager URLs* field






    33
    7
    J. Simmons
    
## Click the *OK* button to save the new preferences






    34
    7
    J. Simmons
    
## Launch the Boards Manager by selecting *Tools>Board>Board Manager* from the menu






    35
    7
    J. Simmons
    
## Select _Contributed_ from the *Type* select box






    36
    7
    J. Simmons
    
## Select _Adafruit AVR Boards by Adafruit_ in the list of contributed boards then click the *Install* button






    37
    7
    J. Simmons
    
## 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)






    38
    8
    J. Simmons
    
## *ON WINDOWS ONLY* Install the Windows Adafruit Drivers (optional: only select the _Feather 32u4_ to minimize the number of drivers installed)






    39
    8
    J. Simmons
    
!InstallFeatherDriver.png!






    40
    6
    J. Simmons
    
# Set the Arduino libraries path to point at the Holoseat libs directory






    41
    9
    J. Simmons
    
## Launch the Arduino IDE






    42
    9
    J. Simmons
    
## Open the Arduino IDE Preferences by selecting File>Preferences from the menu






    43
    9
    J. Simmons
    
## Note the Sketchbook location (typically Documents\Arduino)






    44
    9
    J. Simmons
    
## Close the Arduino IDE Preferences and exit the Arduino IDE






    45
    9
    J. Simmons
    
## Copy Documents\Holoseat\Firmware\libs\Bounce2 to the libraries folder in the sketchbook folder (typically Documents\Arduino\libraries)






    46
    9
    J. Simmons
    
!LibrariesFolder.png!






    47
    2
    J. Simmons
    






    48
    2
    J. Simmons
    
h2. 3. Install Firmware on Holoseat Controller






    49
    2
    J. Simmons
    






    50
    10
    J. Simmons
    
# Launch the Arduino IDE






    51
    10
    J. Simmons
    
# Plug the Holoseat controller into a USB port






    52
    10
    J. Simmons
    
# Set the board type to _Adafruit Feather 32u4_ by selecting Tools>Board>Adafruit Feather 32u4 in the menu






    53
    10
    J. Simmons
    
# 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)






    54
    10
    J. Simmons
    
!SelectComPort.png!






    55
    10
    J. Simmons
    






    56
    2
    J. Simmons
    
connect the controller, find the com port, load the project, compile, flash






    57
    2
    J. Simmons
    






    58
    2
    J. Simmons
    
h2. 4. Install Desktop Configuration App






    59
    2
    J. Simmons
    






    60
    1
    J. Simmons
    
unzip archive to <insert path here>