HX-Rd / Raise-Firmware

Dygma Raise Firmware

The default firmware for the Dygma Raise.

Download and install

Set up the Arduino IDE

Setup the Arduino IDE on your system. Make sure you install at least version 1.8.10, since older version may not support all required features.

macOS

On macOS, install the Arduino IDE using homebrew cask with brew cask install arduino or download the application from the official website 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.8.10 or so, you'll need to install the Arduino IDE following the instructions on the wiki.

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

mkdir -p $HOME/Documents/Arduino
cd $HOME/Documents/Arduino

Linux

mkdir -p $HOME/Arduino
cd $HOME/Arduino

Download hardware platform, including library source code

arduino --install-boards arduino:samd

mkdir -p hardware/dygma

## then clone the hardware definitions to make them available to the arduino environment
git clone --recursive https://github.com/Dygmalab/Kaleidoscope-Bundle-Dygma.git hardware/dygma/samd

Download the Raise Firmware

git clone https://github.com/Dygmalab/Raise-Firmware.git

Build and flash the firmware

Before you begin, make sure your Raise is connected to your computer.

Option 1: From the command line

cd Raise-Firmware
make flash

Option 2: From the Arduino IDE

Open the sketch you wish to flash (for example, Raise-Firmware.ino).

Click the Upload button or press Ctrl-U.

Hold down the key in the top left corner of your keyboard (Esc by default), until the compile finishes and the upload begins.