Github repository

Schematics

Firmware hacking

Branches' source code is available under the GPL licence.

The code (along with the hardware description files) can be found in the branches directory in our Eurorack modules git repository.

After having cloned the repository, don't forget to run git submodule init && git submodule update to make sure the sub-projects referenced in the code are also pulled.

Toolchain

If you don't mind installing Vagrant and VirtualBox a cozy environment for firmware hacking is available.

If you want to set up your own environment to build Branches' code, avr-gcc and avrdude must be installed. These are standard packages on Linux. On OS X, Crosspack can be installed.

The path to the toolchain can be edited in the AVRLIB_TOOLS_PATH variable in avrlib/makefile.mk directory. It might also be necessary to change the ISP programmer name in the PROGRAMMER variable.

To build the code, use the following command:

make -f branches/makefile

Firmware programming

Programming must be done with an AVR ISP programmer. These are very common and can be found for a few dollars - however, the most reliable units are Atmel's own AVR ISP mkII.

The ISP programmer must be connected on the back of the module - red stripe of the cable on the same side as the ISP text on the board. To upload the code:

make -f branches/makefile bootstrap_all