toilmodular / braids

A Mutable Instruments Braids clone with the use of the STM32F103 Blue Pill Board.

Braids - Macro Oscillator for Eurorack

A clone of the Mutable Instruments Braids module with the use of the STM32F103 Blue Pill board.

Module Build and PCBs

If you want to build the module yourself, I uploaded firmware, schematic, BOM and Gerber files for the PCB.

NOTE: Firmware and schematic differ from the original design due to restrictions on the Blue Pill board. More details are given below in section Firmware.

There are two different versions for the control board, an "original" and a "Thonk" version. Reason is that for my own module, I am using specific potentiometers - 16K4 series from Supertech Electronics - and 3.5mm jack sockets - MJ-355 from Marushin - available at my local electronics shop.

However, since most DIY projects for Eurorack modules out there are using potentiometers from ALPHA and so-called THONKICONN jacks, as they are provided by Thonk in the UK, I also created a version with footprints for those components. Choose the one you need.

The layout of the main PCB is the same for both versions.

I created the Gerber files with the online tool EasyEDA and ordered it at JLCPCB. I cannot guarantee, if this set of zipped Gerber files works also for other providers, like e.g. PCBWay. I have not tried that. But I saw online, that others did it.

If you want to know about my DIY building process, take a look at this YouTube video.

Panel Layout

I added the information about hole coordinates for the front panel in the folder PanelLayout, referring to the component layout in the PCB Gerber files.

In addition, there is another Gerber file for the panel, following the HP standard. My own modules do not follow that width standard, as I am only using sliding nuts in my racks.

You can use the panel Gerber file to have the panel built out of PCB material.

Additional Information about specific Components

I could not get the DAC8551 chip from the original design, not in stock. Instead, I tried the still available DAC8501, which turned out to work just fine, and which is also 16bit, like the original one.

Most of the components are through-hole, including the microchip part, thanks to the available Blue Pill board. However, there are a few components, which I did not find as THT version, or which I got used to due to frequent usage in other projects (like bypass caps for ICs and NPN transistors). The SMD components are:

• DAC8501 (DAC, 8-VSSOP package, the most challenging component due to its size)
• LM1117-3.3 (voltage regulator, SOT-223 package)
• LM4040B25 and LM4040B10 (voltage regulators, SOT-23-3 package)
• MMBT3904 (SMD version of the 2N3904 transistor, SOT-23-3 Package)
• 0.1uF bypass caps for ICs (1608 package)
• 24.9K resistors (1608 package)

Concerning the resistor size, I am usually using small-size resistors, about half the length of the usual size, so they need less space on the PCB. If you want to use my Gerber files, you have to consider that fact. You might still use normal size resistors and put them in a standing position on the boards. Should also work fine.

Firmware

I shared the .hex files for the STM32F103 chip (bootloader and main) in the folder Firmware. Those files and the schematic differ from the originals from Mutable Instruments. Reason is the use of the Blue Pill board, as the chip's pins C13, C14, and C15 are already occupied on the Blue Pill board. But the original design from Mutable Instruments is using them for the encoder.

Therefore, I changed the coding in two source code files, so that instead pins A0, A1, and A2 are used, which are not in use in the original design. I got the idea for that from Nicolas Toussaint (SoundForce), who published another Braids version on his website. That version is entirely through-hole, as it is using a different DAC.

In my version here, the following original source code files have been adjusted:

• encoder.cc (in subfolder /drivers)
• encoder.h (in subfolder /drivers)

If you want to compile your own .hex files, you need to search the texts in the below table and replace them in the entire file, as stated.

File name	Original	Replace with
encoder.cc	Pin_13	Pin_2
encoder.cc	Pin_14	Pin_0
encoder.cc	Pin_15	Pin_1
encoder.cc	GPIOC	GPIOA
encoder.h	Pin_13	Pin_2
encoder.h	GPIOC	GPIOA

Alternative Firmware (Mutated Mutables)

Besides the adjusted original firmware from Mutable Instruments, I also added an alternative firmware from Tim Churches in the folder Firmware, called "Mutated Mutables". The .hex files are also adjusted to work with the Blue Pill board and my schematics.

You find detailed information about the alternative firmware and functions on Tim Churches' website: http://timchurches.github.io/Mutated-Mutables/

STM32F103 Version

CAUTION! There are three different versions of the Blue Pill board available. The difference is the version of the ST32F103 microchip on the board. The versions differ in the flash memory size:

• STM32F103C6T6: 32kB flash memory
• STM32F103C8T6: 64kB flash memory
• STM32F103CBT6: 128kB flash memory

The code size requires the 128kB version. However, that version is currently (Feb2023) difficult to find, if available at all.

I gave it a try and bought the 64kB version. Surprisingly, the programmer showed 128kB available flash memory, and the code could be loaded. I tried it with several boards. So it seems STM3F103C8T6 is ok for this module.

If you want to see more about the chip programming process, you can check out my YouTube video.

Calibration

The calibration procedure is the same, as the one for the original module from Mutable Instruments.

1. Disconnect any signal from the FM input,
2. Connect the pitch CV output of a well-calibrated keyboard interface or MIDI-CV converter to the 1V/O input.
3. Set the COARSE and FINE knobs to 12 o'clock position.
4. Go to CAL. in the options list.
5. Push the encoder for 1s. The screen displays >C2.
6. Send a voltage of 1V to the 1V/O input.
7. Click on the encoder. The screen displays >C4.
8. Send a voltage of 3V to the 1V/O input.
9. Click on the encoder to finish calibration.