You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+32-24Lines changed: 32 additions & 24 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,36 +5,44 @@ This repository contains support for the SparkFun Arduino-compatible development
5
5
6
6
These boards are meant to be used in conjunction with the [ArduinoXInput library](https://github.com/dmadison/ArduinoXInput).
7
7
8
-
## Installation
8
+
## Automated Installation
9
+
10
+
Follow the official instructions for [adding third party boards](https://support.arduino.cc/hc/en-us/articles/360016466340-Add-or-remove-third-party-boards-in-Boards-Manager) and [adding boards to the Arduino IDE](https://support.arduino.cc/hc/en-us/articles/360016119519-Add-boards-to-Arduino-IDE).
11
+
12
+
Add the following line to the "Additional Boards Manager URLs" list:
If you've done this correctly, the XInput boards packages will be available within the Boards Manager. Install the "XInput AVR Boards" package as well as the "XInput SparkFun Boards" package. Note that the core "XInput AVR Boards" package is required for the SparkFun boards to work.
18
+
19
+
## Manual Installation
9
20
<pre>
10
-
└───Arduino Installation
11
-
├───drivers
12
-
├───examples
13
-
├───hardware
14
-
│ ├───arduino
15
-
│ ├───tools
16
-
│ ├───<b>xinput</b>
17
-
│ └───<b>xinput_sparkfun
18
-
│ └───avr
19
-
│ ├───bootloaders
20
-
│ ├───cores
21
-
│ ├───libraries
22
-
│ └───variants</b>
23
-
├───java
24
-
├───lib
25
-
├───libraries
26
-
├───reference
27
-
├───tools
28
-
└───tools-builder
21
+
└───Arduino App Data Folder
22
+
├───cache
23
+
├───logs
24
+
├───staging
25
+
└───packages
26
+
├───arduino
27
+
└───<b>xinput</b>
28
+
└───<b>xinput_sparkfun
29
+
└───hardware
30
+
└───avr
31
+
└───{version}
32
+
├───bootloaders
33
+
├───libraries
34
+
└───variants</b>
29
35
</pre>
30
36
31
-
To install, you first need to install the latest version of the Arduino XInput AVR Core, [which can be found here](https://github.com/dmadison/ArduinoXInput_AVR). Follow [the installation instructions](https://github.com/dmadison/ArduinoXInput_AVR/#installation) provided in that repository and verify that those boards are installed correctly before proceeding.
37
+
To install manually you will need to find the Arduino IDE's application data folder. On Windows this is located in `%APPDATA%\..\Local\Arduino15`.
38
+
39
+
You will need to create the necessary folders in the "packages" directory: `xinput_sparkfun/hardware/avr/{version}`, where `{version}` is the current [semantic version number](https://en.wikipedia.org/wiki/Software_versioning) of the repository (e.g. "1.0.0"). The subfolder of this repository containing the boards files should then be copied into this folder. See the tree view above for reference.
32
40
33
-
This boards package uses the same process for installation. Download [the latest version](../../releases/latest) of this repository to your PC. Navigate to the directory containing your Arduino installation, and then open up the 'hardware' folder. Extract the contents of the .zip file into this directory. You should have a new 'xinput_sparkfun' folder with an 'avr' folder inside of it, containing the files from this repository (see the tree view above).
41
+
You will also need to copy the boards files from the [Arduino XInput AVR core](https://github.com/dmadison/ArduinoXInput_AVR). Follow the instructions in the README. The two folders, `xinput` and `xinput_sparkfun`, should live next to each-other in the "packages" directory.
34
42
35
-
Restart the Arduino IDE. If the SparkFun boards are installed correctly, you should see a new collection of "SparkFun AVR Boards w/ XInput" in the `Tools -> Boards` menu.
43
+
After you have copied the files, restart the Arduino IDE. If the SparkFun boards files are installed correctly, you should see a new collection of "SparkFun AVR Boards w/ XInput" in the `Tools -> Boards` menu. If you get an error while compiling, make sure the XInput AVR core is installed properly.
36
44
37
-
To uninstall, delete the 'xinput_sparkfun' folder in the 'hardware' directory, and then restart the Arduino IDE.
45
+
To uninstall, delete both "xinput" folders and then restart the Arduino IDE.
0 commit comments