Uncertainty

Firmware and scripts written for the Uncertainty eurorack module using TinyGo.

Note The Uncertainty package is under active develoment and does not guarantee backwards compatibity across commits.

Scripts

⚡ Voltage Gates

This one was taken directly from the main Uncertainty repo and rewritten in TinyGo. https://github.com/oamodular/uncertainty#coding-the-code

Demo video: https://youtu.be/PLs5O3ZkTm0

🎹 3 Voice Quantized Digital VCO

The script is using the tone package to create 3 configurable digital square wave oscillators. Each oscillator can be quantized to a melodic scale and can set a root note for stacking chords or creating sub oscillators.

Demo video: https://youtu.be/f9nFkzrO6-8

🌊 8 △ LFOs

Eight triangle LFOs, each roughly twice the period of the last. The cv input will nudge the LFO speed a little bit. The first output can reach a max frequency of about 1hz, while the last output will take about 4 minutes to complete a full cycle. The LFOs are not in sync and each will drift over time, creating a bit of... uncertainty.

Demo video: https://youtu.be/o0pNMU3wgn0

🌋 Burst Generator

Excite the digital input with an attenuated trigger to generate even pulse width bursts from each of the 8 outputs. One pulse per output, so output 1 will not repeat, but output 8 will produce 8 pulses. With a 5v trigger, you'll get 10ms duty cycle bursts, down to a minimum 1v trigger which produces around 500ms duty cycle bursts. Bursts are one-shot and will not retrigger until all bursts have completed.

Demo video: https://youtu.be/_MbU2uUmem0

Getting started

Install Go

https://go.dev/doc/install

Install TinyGo

https://tinygo.org/getting-started/install

Install the TinyGo VSCode plugin

https://marketplace.visualstudio.com/items?itemName=tinygo.vscode-tinygo

Build the example

From the root directory of the project, use the tinygo flash command while Uncertainty USB is connected to compile and flash the script.

tinygo flash --target xiao-rp2040 ./voltage_gates

Serial printing

When your Uncertainty is connected via USB you can view printed serial output in VSCode's Serial Monitoring tab or from the terminal using a tool like minicom.

For example, a line in your code like:

log.Printf("CV Input: %2.2f\n", ReadVoltage())

You can launch minicom to view the printed output:

minicom -b 115200 -o -D /dev/ttyACM0

VSCode build task

Add the TinyGo flash command as your default build task:

Ctrl + Shift + P > Tasks: Configure Default Build Task

Use the following example task configuration to set tinygo flash as your default build command, which will build and flash the package of the current open file:

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "tinygo flash",
            "type": "shell",
            "command": "tinygo flash --target xiao-rp2040 ${fileDirname}",
            "group": {
                "kind": "build",
                "isDefault": true
            },
        }
    ]
}

Now you can build and flash your project using Ctrl + Shift + B or search for the command:

Ctrl + Shift + P > Tasks: Run Build Task