You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
MicroDexed/doc/manuals/MicroDexed-User_Manual/MicroDexed-User_Manual.md

9.9 KiB

fontfamily fontsize geometry
dejavu 16pt a4paper,margin=2cm

MicroDexed User Manual

Version 1.0 (June 2020)

What it is

MicroDexed (also called MD) is a software which runs on a Teensy(-3.6/4.x) microcontroller. It simulates a well know 6 operator FM synthesizer with some additions (like effects) and is controlled and mostly programmed via MIDI. The sound engine is based on Dexed, a famous open-source VST plugin.

Requirements

To use MD, you need suitable hardware. For example TeensyMIDIAudo (TMA) was developed directly for MD. The schematics and layouts are open-source, so you can easily build a TMA board. You can also build it on a stripe grid board or use completely different variants - it's up to you how you build the hardware. Another option (with a few extensions) is the Teensy Guitar Audio Shield.

Basically your MD "board" needs the following:

  • I2C connector for connecting a LCD display (software is written for a 2*16 character display, but a bigger one should do also).
  • 2 Encoders (for each encoder one digital input for the button and two digital inputs for the encoder directions).
  • A DA converter supported by Teensy (something like a "audio shield", e.g. the Teeensy audio shield, or (the simplest way) you can use the 12bit DA output pins of the Teensy-3.6 (not possiblefor Teensy-4.x!)).
  • "A way to get MIDI into the Teensy", like the onboard USB port (will not work for USB-MIDI-keybords, because it is not a host port!), the USB-Host port (with soldering a header) or external IO-components for DIN-MIDI.
  • A small FAT32 formated SD card.
  • The Arduino-IDE and TeensyDuino for compiling and uploading the program code (tested with Arduino-1.8.12 and TeensyDuino-1.52).

The complete hardware build manual for the TMA-board can be found at [https://codeberg.org/dcoredump/TeensyMIDIAudio/src/branch/master/Rev-1.8/Build-Manual/TMA-Build-Manual.pdf]. So for now we expect that you have a running hardware with installed MD software.

Operating elements on the front

The normal controls for the user are arranged as follows:

If you decide to do the arrangement differently this is no problem. You only have to remember how the encoders are assigned to the function:

  • Left encoder is named VOLUME
  • Right encoder is named PRESET

Permament encoder functions

The VOLUME encoder always has the following functions - no matter where you are in the menus:

  • Turn left/right: Change the volume. The volume-change-screen appears when turing and disapears after a short time and you get back, where you left off.
  • Long-Press: A MIDI panic is triggered and all voices are muted.
  • Short-Press: Back (from the selected menu-item or up to the parrent menu)

The PRESET encoder has only one permanent function:

  • Long-Press: This takes you to the sound/bank selection.

Quick start

On a freshly installed MD the screen should greet you with the sound/bank selection. The volume is set to 80%.

Long-Press PRESET: Changes between voice and bank selection:

Turn PRESET left/right: Change voice or bank (voices: 1-32, banks: 0-99):

  • indicates that you are using timbre 1.
  • indicates that you currently use the monotimbral engine.
  • are showing which parameter do you currently edit with the PRESET encoder.
  • below the timbre symbol(s) indicates that there was an MIDI event (if using a Teensy -4.x different height bars (depending on velocity) are displayed per timbre).

Sound/Bank selection

The menu structure

  • Voice
    • Select
      • Audio
        • Voice Level
          • Panorama
          • Effects
            • Chorus
              • Waveform
                • Depth
                • Level
              • Delay
                • Time
                • Feedback
                • Level
              • Filter
                • Cutoff
                • Resonance
              • Reverb
                • Roomsize
                • Damping
                • Level
                • Reverb Send
              • EQ
                • Bass
                • Treble
      • Controller
        • Pitchbend
          • PB Range
          • PB Step
        • Mod Wheel
          • MW Range
          • MW Assign
          • MW Mode
        • Aftertouch
          • AT Range
          • AT Assign
          • AT Mode
        • Foot Ctrl
          • FC Range
          • FC Assign
          • FC Mode
        • Breath Ctrl
          • BC Range
          • BC Assign
          • BC Mode
      • MIDI
        • MIDI Channel
        • Lowest Note
        • Highest Note
        • Send Voice
      • Setup
        • Portamento
          • Port. Mode
          • Port. Gliss
          • Port. Time
        • Polyphony
          • Transpose
          • Fine Tune
          • Mono/Poly
      • Internal
        • Note Refresh
        • Velocity Lvl
        • Engine
      • Operator
      • Save Voice
  • Load/Save
    • Performance
      • Load Perf.
      • Save Perf.
    • Voice Config
      • Load Voice Cfg
      • Save Voice Cfg
    • Effects
      • Load Effects Cfg
      • Save Effects Cfg
    • MIDI
      • MIDI Recv Bank
      • MIDI Snd Bank
      • MIDI Snd Voice
  • System
    • Stereo/Mono
    • MIDI Soft THRU
    • EEPROM Reset
  • Info

encoder functions

Left encoder

push: open menu / go up one level in menu hierarchy

turn: change master volume

Right encoder

push:

  • in menu: open submenu
  • in preset selection: go to next option

turn:

  • in menu: pick menu entry / change value
  • in preset selection: change preset or bank

preset selection

This is the main MicroDexed screen you will use during operation. You can change the currently active preset by turning the right encoder. The preset's name appears in the bottom LCD row.
Presets are organised in banks. Each bank holds 32 presets. If you arrive at the last preset in the current bank and turn the right encoder even further, the first preset of the next bank will become active.
You can switch between preset and bank selection by pushing the right encoder. The active selection is marked by square brackets.
If you compiled MicroDexed to use two Dexed instances, each instance will use its own preset. Which instance you are selecting presets for can be seen in the LCD's top right corner. The active instance's number is displayed white-on-black.
A small lock in the place of instance number 2 means that MicroDexed was compiled to use a single Dexed instance.
A mirrored number in either place means that this instance is currently disabled (polyphony set to 0) and will not use CPU time.

configuration menu

A note on instances:
When setting parameters in this menu, pushing the right encoder switches between instance 1 or 2 if both are active.

1. Voice

1.1 Select

Selecting this entry opens the preset selection screen.

1.2 Audio

1.2.1 Voice Level
1.2.2 Panorama
1.2.3 Effects

Chorus

Chorus Frequency This value controls the LFO frequency that modulates the Chorus. It is given in Hz.
Chorus Waveform This sets the LFO modulator waveform for the Chorus. You can choose between sine and triangle wave.
Chorus Depth This value sets the Chorus LFO modulator's amplitude.
Chorus Level This value controls how much of the Chorus' output is added to the mix.

Delay

Delay Time The time between reflections (milliseconds).
Delay Feedback The amount of signal that is fed back to the Delay (percent).
Delay Level This value controls how much of the Delay's output is added to the mix.

Filter Lowpass? Freq is 0-100?

Reverb
Hint: Start by setting Roomsize to 30, Reverb Send to its maximum and Reverb Level to 50%. This should give you the smallest amount of noise. If the reverb sounds distorted when you play a loud preset, decrease Reverb Send until the distortion is gone, then adjust Reverb Level to your liking.
Reverb Roomsize This influences how long the reverb will sound.
Reverb Damping This controls how fast higher frequencies are filtered from the reverb sound.
Reverb Level This value controls how much of the Reverb's output is added to the mix.
Reverb Send This value controls how much of the Dexed's signal is fed to the reverb.

1.3 Controller

1.4 MIDI

1.5 Setup

1.6 Internal

1.7 Operator

1.8 Save Voice

2 Load/Save

3 System

4 Info

4.1 Tips and tricks

https://www.thisdx7cartdoesnotexist.com/ https://dx7.vstforx.de/ https://synthmata.com/volca-fm/