Firmware for the OWL programmable effects pedal.

All code licensed under the Gnu GPL unless otherwise stated.

See http://hoxtonowl.com for more details.

First you need to get the OwlWare source code into a directory of your choice (let's call it "OwlWare"). We will refer to this as the project directory.

If you have or create a github.com account then you can always get the latest version of the software with git. Clone this github repository with git clone git@github.com:pingdynasty/OwlWare.git. Open a terminal or command window in the cloned repository OwlWare (the project directory). Do a git submodule init and git submodule update to get the required submodules.

If you are not familiar with git, you can also download the source code as a zip file. You will then also have to manually download OwlPatches and unzip in the Libraries subfolder.

Download the GNU ARM toolchain for your operating system. Unzip in the OwlWare/Tools directory. If you want to install it elsewhere, edit Makefile.common (located in the project directory) to point to the right TOOLROOT directory.

Download the STM32F4-Discovery Firmware Package and unzip the file stsw-stm32068.zip in the OwlWare/Libraries directory. If you have installed the software elsewhere, edit Makefile.f4 (located in the project directory) to point to the right LIBROOT directory.

To upload firmware over USB (recommended for most users), you will also need dfu-util. Download and install from here.

For those who want to upload firmware using an STLINKv1 or STLINKv2 programmer (such as those on the ST Discovery boards), download and install stlink from here. For most users, this will not be required.

To build and deploy the project using the provided Makefiles you will need some version of the make utility, for example GNU make. For Windows users, we recommend installing Cygwin.

Open a terminal or command window in the project directory and type in:

• make to build Builds/OwlWare.elf
• make bin to build Builds/OwlWare.bin
• make clean all to rebuild all intermediary files

In the project directory, type in:

• make dfu to build the bin file and upload to an OWL device in DFU mode, connected by USB
• make debug to build the elf file and upload to an OWL device connected with st-util using an stlink programmer