Add more toolchain setup documentation

pull/859/head
Jesse Vincent 5 years ago
parent e72f7d434f
commit d7bcb68214
No known key found for this signature in database
GPG Key ID: CC228463465E40BC

@ -187,7 +187,7 @@ Next step: [Add keyboard support to Arduino](#Add-keyboard-support-to-Arduino)
![](images/arduino-setup/boards-manager-close.png) ![](images/arduino-setup/boards-manager-close.png)
9. Open the 'Tools' menu, click on 'Board' and then click on 'Keyboardio Model 01'. (You may have to scroll through a long list of other boards to get there.) 9. Open the 'Tools' menu, click on 'Board' and then click on the name of your keyboard. In the screenshot, we picked 'Keyboardio Model 01'. (You may have to scroll through a long list of other boards to get there.)
![](images/arduino-setup/select-board-in-menu.png) ![](images/arduino-setup/select-board-in-menu.png)
@ -198,4 +198,53 @@ Next step: [Add keyboard support to Arduino](#Add-keyboard-support-to-Arduino)
Next step: [Install the latest firmware on your keyboard](Install-latest-firmware) Next step: [Install the latest firmware on your keyboard](Install-latest-firmware)
# <a name="Install-latest-firmware" />Install the latest firmware on your keyboard
# Load the example (default) firmware source code sketch
To load the firmware, open the Arduino IDE's "File" menu, and click on the "Examples" submenu.
If you're using a Keyboardio Model 01, Scroll down to 'Model01-Firmware':
![](images/arduino-setup/select-model-01-firmware.png)
If you're using another keyboard, you should find it under Examples -> Kaleidoscope -> Devices -> (Your keyboard maker) -> (Your keyboard)
After you pick your example sketch, Arduino wil open a new window showing the sketch's source code above a black message log section and a green status message bar at the bottom. The message log displays detailed information about what Arduino is doing.
_**Note:** We recommend that you install the default firmware at least once before you start to make changes. This gives you a chance to ensure that the firmware update process works._
# Build the firmware
Click the check mark icon below "File" to build your firmware.
![](images/arduino-setup/verify-model-01-firmware.png)
If the firmware builds successfully, Arduino reports "Done Compiling" in the green status bar.
![](images/arduino-setup/verify-ok.png)
If something goes wrong, the status bar turns orange and displays an error message. Additionally, there may be text in the black message log with more details about the error. At this point, it may be helpful to expand the message log so that you can see a bit more about what's going on.
![](images/arduino-setup/verify-failed.png)
If you see errors, refer to [Getting help](Getting-help) for troubleshooting tips and useful resources.
# Install the firmware
If your keyboard has a programming interlock key, you'll need to hold it down now. On the Keyboardio Model 01, this is the `Prog` key. On the Keyboardio Atreus, this is the `Esc` key.
Without releasing that key, click on the "right arrow" button in the sketch window menu bar. This starts the firmware installation process.
![](images/arduino-setup/press-prog.png)
![](images/arduino-setup/upload-sketch.png)
If the process is successful, Arduino will tell you that in the status area. Some keyboards may also use LEDs to report their results. For example, the Model 01's LED's flash red across the board as the firmware is installed, and then the "LED" key glows blue.
On Windows, you may also see the message "the device Model 01 is undergoing additional configuration."
If you have any trouble flashing your keyboard's firmware, check to see if the issue is addressed on the [Troubleshooting Firmware Upload Issues](https://github.com/keyboardio/Kaleidoscope/wiki/Troubleshooting-Firmware-Upload-Issues)

Loading…
Cancel
Save