Open source wireless MIDI foot controller for guitarists and more.
- Plug-and-play with any MIDI-compatible app on iOS 8 and above as well as OS X Yosemite and above.
- High customizable using iOS or Android app
- Bluetooth, WiFI, USB and legacy MIDI interfaces
- No extra drivers to connect Windows, macOS, iOS (iPad/iPhone) and Android
- Bluetooth LE MIDI (iOS and macOS compatible)
- Network MIDI (aka AppleMIDI or RTP-MIDI)
- ipMIDI
- Open Sound Control (OSC)
- IEEE 802.11 b/g/n Wi-Fi 2.4 GHZ with WPA/WPA2 authentication
- Bluetooth Low Energy 4.0
- DIN MIDI IN and MIDI OUT connectors
- MIDI routing
- MIDI clock master and slave
- MIDI Time Code (MTC) master and slave
- OSC to MIDI and vicecersa
- Any number of pedals of any type in any order
- Auto-sensing footswitches and expression pedals
- Support for digital foot switches (momentary or latch), analog expression pedals and jog wheels (rotary encoders)
- 10 banks of 6 controllers each
- 3 user configuration profiles
- 16 sequences of 10 steps each
- Each port can connect 1 expression pedal or up to 5 foot switches for a maximum of 30 foot switches.
- MIDI output via AppleMIDI (also known as RTP-MIDI) or ipMIDI via Wi-Fi
- Send almost every MIDI messages: Program Change, Control Code, Note On/Off, Channel Pressure, Pitch Bend, Bank Select, Start, Stop, Continue or a sequence of the previous messages
- MIDI channel, MIDI note, MIDI control code, MIDI program change can be configured by each pedal and by each bank
- Switch debouncing and analog noise suppression without decreasing responsiveness
- Invert polarity via software
- Individual automatic calibration of expression pedals. Manual fine tuning is not usually requested.
- Transform a linear expression pedal into log expression pedal and vice versa
- Responsive and mobile-first configuration web interface (http://pedalino.local)
- Smart Config technology to help users connect to a Wi-Fi network through simple app on a smartphone.
- Firmware update via HTTP (http://pedalino.local/update)
The app made with Blynk is delayed due to a Blynk bug.
The shortest bill of materials ever: an ESP32 board and a OLED display. That's it.
- Any ESP32 board supported by Arduino core for ESP32 WiFi chip
- Tested on DOIT ESP32 DevKit V1 4M dual-mode Wi-Fi and Bluetooth module
- OLED I2C 0.96"/1.3" display 128x64 pixels SSD1306/SH1106 based
Not enough short?
- An all-in-one TTGO T-Eight ESP32 with a bigger OLED display (1.3"), 4MB PSRAM and lithium battery interface
USB MIDI and DIN MIDI connection requires additional hardware.
Do not forget the add the pull-up resistors on PIN_A1 to PIN_A6 otherwise pins will be floating. A floating pin can trigger unexpected MIDI events. As alternative you can disable the not used pedals via web interface.
PlatformIO 4.0 is the recommended IDE for Pedalino build and upload.
- Install PlatformIO IDE for VSCode
- Run the following commands from View->Command Palette (Ctrl+Shift+P)
- Git: Clone
- You will be asked for the URL of the remote repository (https://github.com/alf45tar/PedalinoMini) and the parent directory under which to put the local repository.
- PlaftormIO: Build
- PlatformIO: Upload
- Run “Upload File System image” task in PlatformIO IDE or use PlatformIO Core (CLI) and 'platformio run --target uploadfs' command
That's all folks.
The cheapest and compact way to implement an USB MIDI connection is using an Arduino Pro Micro and the BlokasLabs/USBMIDI library. Upload the UsbMidiConverter example into the Arduino Pro Micro.
Serial1 of ESP32 (re-mapped to pin 18 RX and 19 TX) is connected to Serial1 (pin 1 TX0 and pin 2 RX1) of Arduino Pro Micro. Use a 3.3V Pro Micro board. A 5V Pro Micro board works too because the ESP32 is usually 5V tolerant.
Arduino Pro Micro is powered by the USB MIDI connection.
IMPORTANT: ESP32 board and Arduino Pro Micro must share GND.
Home screen | Device info | MIDI message |
---|---|---|
![]() |
![]() |
![]() |
MIDI Clock | MIDI Time Code |
---|---|
![]() |
![]() |
PedalinoMini™ supports IEEE 802.11 b/g/n WiFi with WPA/WPA2 authentication (only 2.4 GHz).
PedalinoMini™ implements Wi-Fi Protected Setup (WPS) and Smart Config technology (Espressif’s ESP-TOUCH protocol). WPS needs access to the WPS button on the WiFi router. Smart Config requires a smartphone with one the following apps:
- ESP8266 SmartConfig for Android
- Espressif Esptouch for iOS
If the WiFi network is not available, PedalinoMini™ will create a hotspot for you. Once connected to the PedalinoMini™ hotspot, you can use the web interface to set the SSID and password of an access point that you would like to connect to.
- On power on Pedalino will try to connect to the last know access point
- If it cannot connect to the last used access point within 15 seconds it enters into Smart Config mode
- Start one of the suggested apps to configure SSID and password
- If it doesn't receive any SSID and password during the next 15 seconds it enters into WPS mode
- Press WPS button on your WiFi router
- If it doesn't receive any SSID and password during the next 15 seconds it switch to AP mode
- In AP mode PedalinoMini™ create a WiFi network called 'Pedalino-XXXXXXXX' waiting connection from clients. The required password is XXXXXXXX (uppercase). XXXXXXXX is a variable string.
- Reboot Pedalino to restart the procedure.
void wifi_connect()
{
auto_reconnect(); // WIFI_CONNECT_TIMEOUT seconds to reconnect to last used access point
if (!WiFi.isConnected())
smart_config(); // SMART_CONFIG_TIMEOUT seconds to receive SmartConfig parameters and connect
if (!WiFi.isConnected())
wps_config(); // WPS_TIMEOUT seconds to receive WPS parameters and connect
if (!WiFi.isConnected())
ap_mode_start(); // switch to AP mode until next reboot
}
PedalinoMini™ has 7 booting modes:
- Normal
- Bluetooth Only
- WiFi Only
- Access Point with Bluetooth
- Access Point without Bluetooth
- Reset WiFi credentials
- Reset to factory default
The last booting mode (1-5) is selected if you don't press any button on boot.
To select a different mode:
- Press and release EN button (POWER button on TTGO T-Eight) and immediately after press and hold BOOT button (CENTER button on TTGO T-Eight)
- Follow the istructions on display. Keep it pressed until the progress bar reach the end to reset to factory default. If you release the button before the progress bar reach the end PedalinoMini™ will start in one of the supported boot mode.
On start the live performance display is selected. On live performace mode the current profile and the current bank is shown using a vintage 7 segment LED style. First digit is the profile, the others two are for bank.
Pressing BOOT button (CENTER button on TTGO T-Eight) you can switch to scrolling pages where configuration parameters (the device name, the IP address etc.) are displayed.
Press BOOT button (CENTER button on TTGO T-Eight) again to return in live performance display mode.
During normal operation
- Press navigation RIGHT button to move to the next profile
- Press navigation LEFT button to move to the previous profile
If you keep pressed the button for more than 500ms (half a second) a new profile change occurs on release.
All profiles has the same configuration.
Pedal | Type | Name | On Press | On Release | Midi Channel |
---|---|---|---|---|---|
1 | Momentary | A | Note On C3 (60) Velocity 100 |
Note Off | 1 |
2 | Momentary | B | Note On D3 (62) Velocity 100 |
Note Off | 1 |
3 | Momentary | C | Note On E3 (64) Velocity 100 |
Note Off | 1 |
4 | Momentary | D | Note On F3 (65) Velocity 100 |
Note Off | 1 |
5 | Analog | E | Control Change CC#12 Value 0-127 |
1 | |
6 | Analog | F | Control Change CC#13 Value 0-127 |
1 |
Pedal | Type | Name | On Press | On Release | Midi Channel |
---|---|---|---|---|---|
1 | Momentary | A | Control Change CC#20 Value 127 |
Control Change CC#20 Value 0 |
1 |
2 | Momentary | B | Control Change CC#21 Value 127 |
Control Change CC#21 Value 0 |
1 |
3 | Momentary | C | Control Change CC#22 Value 127 |
Control Change CC#22 Value 0 |
1 |
4 | Momentary | D | Control Change CC#23 Value 127 |
Control Change CC#23 Value 0 |
1 |
5 | Analog | E | Control Change CC#12 Value 0-127 |
1 | |
6 | Analog | F | Control Change CC#13 Value 0-127 |
1 |
Bank 3 is the same as bank 1 but on Midi channel 2
Bank 4 is the same as bank 2 but on Midi channel 2
Bank 5 is the same as bank 1 but on Midi channel 3
Bank 6 is the same as bank 2 but on Midi channel 3
Bank 7 is the same as bank 1 but on Midi channel 4
Bank 8 is the same as bank 2 but on Midi channel 4
Bank 9 is the same as bank 1 but on Midi channel 5
Bank 10 is the same as bank 2 but on Midi channel 5