Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/MattKuebrich/flounder

usb midi keyboard + controls + stereo audio
https://github.com/MattKuebrich/flounder

Last synced: 26 days ago
JSON representation

usb midi keyboard + controls + stereo audio

Awesome Lists containing this project

README 

        
![flounder](https://github.com/MattKuebrich/flounder/blob/main/images/flounder_v1_assembled.jpg)



# flounder

usb midi keyboard + controls + stereo audio



**Tech details:**

* 12 MIDI mappable potentiometers

* full octave touch keyboard

* 6 touch function buttons

* stereo audio output

* runs on Teensy 4.0 / fully reprogrammable

* conceived as a [friend of norns](https://llllllll.co/t/friends-of-norns-gear-accessories-etc/17150) but works with anything that supports MIDI over USB



**Programs:**



* **midictrl** is a basic midi controller with 12 MIDI-mappable knobs, a full-octave touch MIDI keyboard and octave control (using the 6 "function" buttons). 



*  **blipo_v2 / blipo_2018** are attempts to digitally emulate Rob Hordijk's Blippoo Box.



* **pitta** is a polysynth with an ADSR, oscmix, filter with LFO, delay, and reverb.



* **monoenv** is an single mono oscillator and ADSR envelope, to demonstrate how the touch keyboard works. This can be a basis for a more complicated synth. It also works as a midi controller.



*  **hardwaretest** helps verify that everything is working properly by sending knob/key values to the serial monitor.



**BOM:**



* https://docs.google.com/spreadsheets/d/1cLHydvrlG6ZNgeznXWJLk1cLfvSbNpC10iksKwk7y4E



**General parts / build notes:**



This PCB requires minimal parts, but there are a few tricky bits. A SMD header is used to access the 10 SMD pads on the bottom of the Teensy 4.0, which isn't easy to solder. [This helpful video from Befaco](https://www.youtube.com/watch?v=itzAFOCuFH4) shows how to solder the SMD header (and the other pin headers). 



This is how the headers should look after they are soldered on the Teensy and PCB:










When using [this SMD header](https://www.mouser.com/ProductDetail/Samtec/TSM-105-02-S-DV?qs=FZWyocRRknkkJe6o9Kq77Q%3D%3D&countrycode=US&currencycode=USD) from the BOM, its pins will need to be cut down a bit to match the length of the other pins. If anyone knows of a better part to use, let me know.



Flounder uses the PT8211 stereo DAC chip, which isn't widely available, but can be found either as part of [this low cost kit from PJRC](https://www.pjrc.com/store/pt8211_kit.html), on [AliExpress](https://www.aliexpress.com/wholesale?catId=0&initiative_id=SB_20220626100338&SearchText=PT8211&spm=a2g0o.home.1000002.0) or [this alternative](https://www.lcsc.com/product-detail/Digital-To-Analog-Converters-DACs_TM8211_C92003.html) from LCSC, which I haven't tried but should work. 



**Software installation:**



In order to program the Teensy 4.0, you'll need to install [TeensyDuino](https://www.pjrc.com/teensy/teensyduino.html). Once installed, under Tools->Board->TeensyDuino, select Teensy 4.0. You'll also need to install the [FastTouch library](https://github.com/adrianfreed/FastTouch), which is needed for the touch keyboard. Download FastTouch from Github and then in TeensyDuino, go to Sketch -> Include Library -> Add .ZIP Library and select the .ZIP file. 



Plug the [(USB Micro-B to standard USB) cable](https://www.pjrc.com/store/cable_usb_micro_b.html) from the Teensy to your computer. In TeensyDuino, under Tools->Port, you should see the Teensy 4.0 there. Also, Tools->USB Type should be set to "Serial + MIDI + Audio". 



The audio output uses both the on-board jack and USB audio. In code, the output can be adjusted to be suitable for headphones or line level.



**USB Audio notes:**



While testing code for flounder, I found it convenient to monitor the audio over USB, using [VCV Rack](https://vcvrack.com/) like this:






A few caveats on this method. When flashing new code, the “Teensy MIDI_Audio” input will need to be refreshed. I’ve found the easiest way to do this is to delete the Audio 8 module and then Undo to bring it back. There also seems to be a general issue with Teensy 4.0 and USB Audio where a clicking sound will develop after awhile. There’s is a [fix documented on the PJRC forum](https://forum.pjrc.com/threads/54239-USB-Audio-Clicking-Noise?p=306552&viewfull=1#post306552), which involves modifying the usb_audio.cpp file in the core Teensy library. 



**Power:**



flounder is usually powered via the USB connection to your computer or another MIDI host (like monome norns). When using it as an audio source, it can also be powered by a cellphone charger or portable power bank.



**Videos:**



* https://www.youtube.com/watch?v=Wfl-h9pgLO8

* https://www.youtube.com/watch?v=SwyNBVgNWY8

* https://www.youtube.com/watch?v=yABL9-HWeG8