Branches – Open source

Branches is open-source. The code and hardware 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.

Firmware hacking

Toolchain

To build and upload 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

Sending the firmware to the module

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

Hardware hacking

Schematics, board layout and panel files can be found in the branches/hardware_design directory of the github repository.

The hardware description files are released under a cc-by-sa-3.0 license. The source code is released under a GPL 3.0 license.

Olivier Gillet, Mutable instruments SARL 2011-2017. Except where otherwise noted, content on this site is licensed under a cc-by-sa 3.0 license.