umbrellas

a MIDI interface/router/host add-on for the Raspberry Pi 4

Features:

4 Hardware MIDI Ins - TRS/DIN (2 TRS, 2 are TRS or DIN)
Auto-sensing - Accepts either TRS Type-A or Type-B
4 Hardware MIDI Outs - TRS/DIN (2 TRS, 2 are TRS or DIN)
TRS are switchable between Type-A or Type-B
4 USBMIDI ports (and can support USB hubs for more)
1 USB Host adapter (USB-C with QtPy/XAIO add-on)*
Bluetooth MIDI capable
MIDI activity leds
On/Off safe shutdown switch for Pi
Web-based configuration tool for managing MIDI connections
Uses stock RasPiOS (Desktop or Lite) with some configuration

Demo video: https://www.instagram.com/tv/CYU_olaNODE/

* The USB Host adapter is used to connect to a "USB Host" like a computer, iPad, norns, organelle, etc.

Build

Youtube:
https://www.youtube.com/watch?v=L5gbAhstF64&list=PLYhX2rtncmtNOISmfAu80U1FvVtGJeNjO

See BUILD.md

FAQ:

Q: Will this work with a Raspberry Pi 2/3/3b/3b+?

A: Not entirely. It's designed for Pi4 because we can take advantage ot it's 5 UARTs for the hardware MIDI I/O. With Pi 2/3/3b/3b+ only 2 of the hardware MIDI ports will work as there's only 2 uarts.

Software Setup and install

See INSTALL.md

Web interface

Visit http://umbrellas.local/ from a computer on the same wifi network as umbrellas. Or you can use SSH and the aconnect command to make midi connections.

Bluetooth (work in progress - needs testing)

turn on discoverable on umbrellas 
	- with desktop, use the menubar icon 
	- commandline
		`bluetoothctl`
		`discoverable on`

		`scan on`

	turn on "Advertise MIDI Service" in your MIDI App if you want to transmit from the BT device. 
	you may only need to do this the first time.

	find your device MAC address
	
		`connect XX:XX:XX:XX:XX`
		`trust XX:XX:XX:XX:XX`
		`pair XX:XX:XX:XX:XX`

After this setup, the umbrellas Bluetooth device should show up to your MIDI App

Once your device is connected it should show up in the web application as a MIDI device.