jsdf / ctag-tbd

CTAG TBD >>to be determined<< an extendible open source Eurorack sound module

CTAG TBD >>to be determined<<

Documentation (in the works):

Documentation on TBD usage can be found here (Google Docs) Tutorial videos in YouTube playlist

Update procedure

Easiest way to update is to use the ready made releases from github. Flash the ctag-tbd.bin and storage.bin from the TBD web ui (within the configuration menu). Alternatively you can connect a USB cable to the TBD and use the serial flasher from esp idf (see how to flash below). In order to use the sample rom, you can upload from the edit sample rom page factory sample data (sample-rom.tbd).

What it is:

• The eierlegende Wollmilchsau (German for swiss army) audio processing module.
• Offering already more than 30 high quality audio generators and effects.
• Open source Eurorack sound module based on the ESP32.
• With an easy to extend audio plugin architecture.
• What you make it.

Why it is:

• A group of audio enthusiasts enjoying coding and hardware making.
• Build a platform to learn, build and practise skills, and engage students.
• To allow anyone to understand technology by offering open access.
• To squeeze and optimize code so that it can work on a small embedded system.
• Because we can.
• To fight boredom and despair of Corona Virus!

Features:

• More than 30 high quality audio generators and effects.
• Easy DSP plugin development.
• NEW!!! Sample ROM playback and wavetable oscillator with user wavetables from sample ROM details here
• NEW!!! Simulator for cross platform plugin development without hardware module (speeds up plugin development, better code verification).
  • Check description here
• With web UI user interface by wireless browser access.
• Through a REST-API.

Version log

See here...

Potential new features / current limitations / work to be done:

• More plugins.
• VULT support.
• Bug identification and fixing.
• Code refactoring to make things more beautiful.
• More user friendly interaction.
• Documentation / tutorials.
• Your ideas?

How to engage yourself:

• Join the enthusiastic developer team on Github.
• Help build and spread the hardware module (and the word).
• Help documenting.
• More ideas?

How to build

You need C/C++ skills. You may want to check the TBD simulator for easy plugin development without TBD hardware.

NEW!!! you can build the firmware using a Github action. Just fork the ctag-tbd repo to your Github account and enable the supplied Github action. Each time you will push your edits into your fork's master branch, Github will cut a draft release for you automatically. No need for a toolchain on your own system.

If you prefer to have a dev environment on your own, install espressif esp-idf, instructions are here. Use git to checkout esp-idf release/v4.1 (TBD may build also with newer versions, you can try), do this within the esp-idf folder:

git checkout release/v4.1
git submodule update
sudo ./install.sh

You may need to upgrade CMake to version 3.16 or higher. Then follow these steps to create the firmware image:

git clone https://github.com/ctag-fh-kiel/ctag-tbd.git
cd ctag-tbd
git submodule update --init --recursive
idf.py build

How to flash

Either use the binaries available from the releases at github to flash through the TBD's web ui.

Or use ESP Tool to flash through a USB connection with your PC (check this script).

If you have ESP IDF installed (the whole development environment), use:

idf.py flash monitor