1 3. MicroDexed Installation Manual (for Arduino IDE)
Holger Wirtz edited this page 2 years ago

MicroDexed Installation Manual

1) Install required software

  • Arduino IDE
  • Teensy Core for Arduino IDE

(tested with Arduino-1.8.13 and TeensyDuino-1.53)

2) Prepare third-party libraries

[HINT]
You can also use the libraries installed with the library manager from the Arduino-IDE, but than you have to edit files by yourself: 
   * <Arduino-IDE-Sketch-Folder>/libraries/LCDMenuLib2/src/LCDMenuLib2.h: #define _LCDML_cfg_use_ram // enable this!!!

Create a subfolder "libraries" in your Arduino sketch folder.
Copy all files and folders from "MicroDexed/third-party" to the folder "libraries".

3) Adjust some TeensyDuino preferences (only necessary for SYSEX bank up/download)

  1. Search for the files USBHost_t36.h and usb_midi.h inside your TeensyDuino installation path
  2. USBHost_t36.h: exchange SYSEX_MAX_LEN = 290 with SYSEX_MAX_LEN = 4104
  3. usb_midi.h: exchange USB_MIDI_SYSEX_MAX 290 with USB_MIDI_SYSEX_MAX 4104

For Linux this can be done with the following commands:

TEENSYDUINO_PATH=/usr/local/arduino-teensy-1.8.12 # CHANGE THIS TO YOUR INSTALLATION-PATH!
sed -i.orig 's/SYSEX_MAX_LEN = 290/SYSEX_MAX_LEN = 4104/' ${TEENSYDUINO_PATH}/hardware/teensy/avr/libraries/USBHost_t36/USBHost_t36.h

# For Teensy-3.6
sed -i.orig 's/^#define USB_MIDI_SYSEX_MAX 290/#define USB_MIDI_SYSEX_MAX 4104/' ${TEENSYDUINO_PATH}/hardware/teensy/avr/cores/teensy3/usb_midi.h

# For Teensy-4.x:
sed -i.orig 's/^#define USB_MIDI_SYSEX_MAX 290/#define USB_MIDI_SYSEX_MAX 4104/' ${TEENSYDUINO_PATH}/hardware/teensy/avr/cores/teensy4/usb_midi.h

4) Configure board settings

Check the settings in the "Tools" menu in the Arduino IDE:

For Teensy-3.6:

  • Board: Teensy 3.6
  • USB Type: "Serial + MIDI + Audio"
  • Optimize: "Fastest with LTO"
  • CPU Speed: "216 Mhz (overclock) - or more..."
    • 192 Mhz: 12 voices + effects or 16 voices without effects
    • 216 MHz: 16 voices + effects or 20 voices without effects
    • 240 MHz: 20 voices with/without effects
  • Port: "Teensy..."

For Teensy-4.x:

  • Board: Teensy 4.x
  • USB Type: "Serial + MIDI + Audio"
  • Optimize: "Fastest"
  • CPU Speed: "600 Mhz"
  • Port: "Teensy..."

5) Prepare microSD card

The microSD card is used to store voice presets and MicroDexed configurations, called performances.

  • Format the card to FAT32.
  • Copy the contents of "MicroDexed/addon/SD" to the card.
  • Insert SD card in Teensy or audio shield

6) Build & Upload

Once MicroDexed runs, check whether the encoders work. Before you start playing, please reset the EEPROM first.

7) Reset the EEPROM

The EEPROM stores the current performance and system settings. MicroDexed may not produce sound until you reset the EEPROM. To reset the EEPROM,

  • push the left encoder
  • select "System" by turning the right encoder
  • push the right encoder
  • select "EEPROM Reset" by turning the right encoder
  • push the right encoder
  • change the value in square brackets to "[YES]" by turning the right encoder
  • push the right encoder

Once the EEPROM is cleared, MicroDexed will be restarted.

8) Enjoy FM sounds!

Connect a MIDI cable to the MIDI IN port (or: connect a USB-Cable to the USB-A port (host-port for master-keyboards) / USB-B port (slave port for sending data from DAW)). Connect some RCA audio cables and a Line amp to the Audio Out port. You should hear sound if you play some notes now. Enjoy!

Read more about how to control MicroDexed in the MicroDexed Usage Manual.