From 8228f7a4ec4119e6a350135e75c1be31970e1d51 Mon Sep 17 00:00:00 2001 From: Jesse Vincent Date: Mon, 8 Jun 2020 20:41:52 -0700 Subject: Point users at the Arduino and Kaleidoscope documentation on the wiki instead of reproducing an incomplete, obsolete version here. --- README.md | 65 +++------------------------------------------------------------ 1 file changed, 3 insertions(+), 62 deletions(-) diff --git a/README.md b/README.md index 84d0dbf..9b2b3e3 100644 --- a/README.md +++ b/README.md @@ -12,43 +12,9 @@ _The default firmware for the Keyboardio Model 01_ ## Set up the Arduino IDE -Setup the Arduino IDE on your system. Make sure you install at least version 1.6.10, since older version may not support all required features. - -### macOS - -On macOS, install the Arduino IDE using [homebrew](http://brew.sh/) [cask](https://caskroom.github.io/) with `brew cask install arduino` or download the application from [the official website](https://www.arduino.cc/en/Main/Software) and move it to your `/Applications` folder. - - -### Linux - -On Linux, your distribution's package manager probably includes the Arduino IDE, but it may be an out of date version. If your distribution installs a version of Arduino before 1.6.10, you'll need to install the Arduino IDE following the instructions [on the wiki](https://github.com/keyboardio/Kaleidoscope/wiki/Install-Arduino-support-on-Linux). - -If you install Arduino into some place that's /not/ `/usr/local/arduino`, you'll need to set the `$ARDUINO_PATH` environment variable to the directory containing the `arduino` and `arduino-builder` binaries. - -## Create and navigate to the Arduino Sketchbook directory - -### MacOS -```sh -mkdir -p $HOME/Documents/Arduino -cd $HOME/Documents/Arduino -``` - -### Linux - -```sh -mkdir -p $HOME/Arduino -cd $HOME/Arduino -``` - -## Download hardware platform, including library source code - -```sh -mkdir -p hardware - -## then clone the hardware definitions to make them available to the arduino environment -git clone --recursive https://github.com/keyboardio/Kaleidoscope-Bundle-Keyboardio.git hardware/keyboardio -```` +Setup the Arduino IDE on your system. Make sure you install at least version 1.8.11, since older version may not support all required features. +You can find Instructions for setting up the Arduino IDE and adding support for Kaleidoscope [on the Kaleidoscope wiki](https://github.com/keyboardio/Kaleidoscope/wiki/Install-Arduino) ## Download the Model 01 Firmware @@ -71,7 +37,6 @@ When the builder tells you to hit Enter to continue, hold down "Prog" in the top ### Option 2: From the Arduino IDE - Open the sketch you wish to flash (for example, `Model01-Firmware.ino`). Click the Upload button or press `Ctrl-U`. @@ -83,31 +48,7 @@ Hold down the "Prog" key in the top left corner of your keyboard, until the comp You can customize your keyboard's key layout and LED effects by modifying the `Model01-Firmware.ino` file in the same directory as this README. Model01-Firmware.ino is a computer program written in 'Arduino C'. You can find documentation about Arduino C at https://arduino.cc. - -# Updating the firmware and libraries - -From time to time, you may want to pull the latest version of this firmware from GitHub. To do that, navigate to the Model01-Firmware directory in your shell and pull the latest code. - -```sh -cd Model01-Firmware -git pull -``` - -After that, you'll want to update the Kaleidoscope libraries. - -### MacOS -```sh -cd $HOME/Documents/Arduino/hardware/keyboardio -make update-submodules -``` - -### Linux - -```sh -cd $HOME/Arduino/hardware/keyboardio -make update-submodules -``` - +You can also find Kaleidoscope-specific documentation [on our wiki](https://github.com/keyboardio/Kaleidoscope/wiki). # Getting help -- cgit v1.2.3