Software Set Up
Version 8 (J. Simmons, 12/12/2016 06:56 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 | 2 | J. Simmons | |
42 | 2 | J. Simmons | must install and configure for Feather and libs |
43 | 2 | J. Simmons | |
44 | 2 | J. Simmons | h2. 3. Install Firmware on Holoseat Controller |
45 | 2 | J. Simmons | |
46 | 2 | J. Simmons | connect the controller, find the com port, load the project, compile, flash |
47 | 2 | J. Simmons | |
48 | 2 | J. Simmons | h2. 4. Install Desktop Configuration App |
49 | 2 | J. Simmons | |
50 | 1 | J. Simmons | unzip archive to <insert path here> |