Edit History

Software Set Up

Version 7 (J. Simmons, 12/12/2016 06:54 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
    7
    J. Simmons
    
## *ON WINDOWS ONLY* Install the Windows Adafruit Drivers (optional: only select the )






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






    40
    2
    J. Simmons
    






    41
    2
    J. Simmons
    
must install and configure for Feather and libs






    42
    2
    J. Simmons
    






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






    44
    2
    J. Simmons
    






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






    46
    2
    J. Simmons
    






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






    48
    2
    J. Simmons
    






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