Firmware for the OWL programmable effects pedal.
All code licensed under the Gnu GPL unless otherwise stated.
First you need to get the OwlWare source code into a directory of your choice. We will refer to this as the OwlWare 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 firstname.lastname@example.org:pingdynasty/OwlWare.git
- Open a terminal or command window in the cloned repository OwlWare (the OwlWare directory)
- Do a
git submodule initand
git submodule updateto 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 OwlWare/Libraries directory.
Download the GNU ARM toolchain for your operating system. Unzip in the OwlWare/Tools directory.
If you want to install it elsewhere, edit
common.mk in the OwlWare directory to point to the right
To upload firmware over USB, you will also need
dfu-util which you can download from here.
Unzip the binaries (or compile them) in the OwlWare/Tools/dfu-util directory.
Recommended for most users. OwlNest can also be used.
For those who want to upload firmware using an STLINKv1 or STLINKv2 programmer (such as those on the ST Discovery boards).
stlink from here and install it in the OwlWare/Tools/stlink directory..
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 OwlWare directory and type in:
make binto build
make clean allto rebuild all intermediary files
The default configuration builds an OWL Pedal debug build. To build the release version (no debug information, apprx 2x performance) add
CONFIG=Release. To build the OWL Modular version, add
PLATFORM=Modular. Make sure to do a
make clean after changing build options.
In the OwlWare directory, type in:
make dfuto build the bin file and upload to an OWL device in DFU mode, connected by USB
make debugto build the elf file and upload to an OWL device connected with
st-utilusing an stlink programmer