Skip to content

Commit f47a975

Browse files
authored
Update README.md
* Clarified some language in the installation section re: the folder hierarchy * Removed the "IMPORTANT" tag under upload warning (it unfortunately didn't help) * Changed reset instructions to single press (double tap isn't important if you're resetting while uploading) * Changed 'reflash bootloader' note because it wasn't entirely accurate. The XInput programming in no way affects the bootloader and it doesn't need to be reflashed, but most of the instructions for how to hook up an external programmer for novices are provided in "how to reflash a bootloader" tutorials so it was a convenient scapegoat. Now this is more accurate but potentially less helpful.
1 parent 3da98ae commit f47a975

File tree

1 file changed

+5
-7
lines changed

1 file changed

+5
-7
lines changed

README.md

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -26,16 +26,14 @@ This is meant to be used in conjunction with the [ArduinoXInput library](https:/
2626
└───tools-builder
2727
</pre>
2828

29-
To install, 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' folder with an 'avr' folder inside of it, containing the files from this repository (see the tree view above).
29+
To install, [download the latest release](../../releases/latest) to your PC and navigate to the directory containing your Arduino installation. Open up the 'hardware' folder and extract the contents of the .zip file into this directory. You should have a new 'xinput' folder with an 'avr' folder inside of it containing the files from this repository. This should match the tree view above. If you clone the repository, you must create these parent folders yourself.
3030

31-
Restart the Arduino IDE. If the XInput AVR core is installed correctly, you should see a new collection of "XInput AVR Boards" in the `Tools -> Boards` menu.
31+
After you have copied the files restart the Arduino IDE. If the XInput AVR core is installed correctly, you should see a new collection of "XInput AVR Boards" in the `Tools -> Boards` menu.
3232

3333
To uninstall, delete the 'xinput' folder in the 'hardware' directory, and then restart the Arduino IDE.
3434

3535
## Upload Warning and Instructions
3636

37-
**!!!!!!! IMPORTANT !!!!!!!**
38-
3937
Due to the nature of how the XInput USB mode works, Arduinos that have XInput sketches on them will ***not*** automatically reset when programmed by the IDE! You will need to reset the board by hand every time you upload new code.
4038

4139
You can ignore this section if you're using an external programmer.
@@ -49,13 +47,13 @@ Lastly, you need to know where the 'reset' button is on your Arduino. If your bo
4947
To upload to the board:
5048
* Press the 'Upload' button in the IDE
5149
* Wait until the status bar says "Uploading..."
52-
* Press the reset button twice, quickly
50+
* Press the reset button
5351

54-
If you did these steps properly, the board should reset to the bootloader and the upload should begin. AVRDUDE will do its thing and you should see `avrdude done. Thank you.` near the bottom of the output window.
52+
If you timed it properly, the board should reset to the bootloader and the upload should begin. AVRDUDE will do its thing and you should see `avrdude done. Thank you.` near the bottom of the output window.
5553

5654
Note that the IDE may say that it "Couldn't find a Board on the selected port" even if the upload succeeded. This is why it's important to turn on the verbose uploading output - look for the `avrdude` message.
5755

58-
**Do *not* upload XInput sketches to your Arduino unless you know how to reset it!** Otherwise you will not be able to program it anymore and you'll have to [reflash the bootloader](https://learn.sparkfun.com/tutorials/installing-an-arduino-bootloader/all) with an external programmer.
56+
**Do *not* upload XInput sketches to your Arduino unless you know how to reset it!** Otherwise you will not be able to program it anymore and you'll have to remove the XInput sketch by flashing the board with an external programmer.
5957

6058
## Supported Boards
6159

0 commit comments

Comments
 (0)