Bees in the Trees

Firmware Modified Braids Module

Bees-in-the-Trees is a modification to the "official" firmware as supplied by Mutable Instruments on the Braids modules it manufactures and sells.

The goals of these modifications are to:
* expand the internal, self-modulation facilities in Braids;
* expose a wider range of internal parameters to external voltage control;
* add a few additional features that may make Braids more useful or easier to integrate into a modular patch in some circumstances.

These enhancements are necessarily constrained by a number of factors:

• the hardware design of all existing Braids modules is obviously fixed, and thus the firmware must work with the hardware facilities available. For example, there are four CV inputs available in Braids. Firmware changes cannot create a fifth one.
• the computational power of the STM32F1 processor which powers Braids is finite, and thus there is a limit to the amount and complexity of additional code and computations that can be added to the firmware while still allowing the processor to keep the audio buffer filled, in real-time.
• the storage space for compiled program code in flash memory is limited to exactly 108 pages of 1024 bytes each - that is, 110,592 bytes. Thus there is a hard limit to the size and complexity of the firmware for Braids. In order to remain under this firmware size limit, some features have had to be removed from Braids to make space for the enhancements described below. See Anti-enhancements below for details of what has been removed.

Bees-in-the-TreesBees-in-the-Trees is based on the official Braids v1.7 source code, and has had the sync buffer and DAC timing bug fixes which were made to the v1.7 code in late January 2015 ported to it: thus the core oscillator code is identical to the current Braids v1.7 code. However, many changes to modulation options and other aspects have been made.

Why is it called Bees-in-the-Trees? Because Olivier Gillet named his alternative firmware for the Mutable Instruments Tides module "Sheep". That established la règle du jeu which demanded to be followed.

http://timchurches.github.io/Mutated-Mutables/#installation-and-de-installation