Skip to the content
4 layers84 × 25.6 mmLittle Helper, the printed circuit board in 3D

A simple Bluthooth Midi DAW transport control unit based on an esp32 mc

Size
84 × 25.6 mm
Copper layers
4
Thickness
1.6 mm
Parts
41
Nets
56
Pads
190
Tracks, vias
276, 66
Pours
5
Routed
Yes
KiCad
KiCad 8.0 (file 20240108)
Created
16 May 2024
Updated
20 May 2025

Overview

Little Helper is an open-source printed circuit board by wolkstein, from the wolkstein/minimal-esp32-ble-midi-ctrl repository on GitHub, published under the GPL-3.0 licence. It is a 4-layer board of 84 × 25.6 mm with 41 parts on 56 nets, routed with 276 tracks and 66 vias.

It is built around the ESP32-S3-MINI-1-N8, AP2112K-3.3 and TS-1088-AR02016, with the WS2812B, BAS16,215-CN and DMG3415U among its other parts. Its parts include 12 resistors, 8 capacitors, 8 switches, 5 diodes and 3 ICs. It belongs with the audio and music boards and the ESP32 and NXP (LPC, Kinetis, i.MX RT) boards of this library.

Main components

8

README

README.md

Minimal ESP32 BLE Midi Control Interface

This project is a minimal ESP32 BLE MIDI controller. It allows you to control MIDI devices wirelessly using Bluetooth Low Energy (BLE) technology. The controller is designed to be compact and easy to use, making it ideal for musicians and performers.

PCB

Features

  • BLE MIDI connectivity
  • Compact and portable design
  • Easy-to-use interface
  • Easy-to-use Web UI to make settings
  • Online Firmware Update
  • With Ardour and Harrison Mixbus compatible midi_map file
  • as Platformio Project (esp32 arduino framework)

Parts

  • ESP32-S3-Mini
  • 5 momentary button switches
  • 5 10k resistors
  • breadboard
  • optional rgb led ws28xx

PCB Version with Lipo and Battery Charger

PCB:

PCB PCB - finished

Housing: Housing

Getting Started

To get started with the project, follow these steps:

  1. Clone the repository: $ git clone https://github.com/wolkstein/minimal-esp32-ble-midi-ctrl
  2. Open as Platformio Project for example with VSC Pio Extension
  3. Connect your ESP32 device to your computer via USB.
  4. Change the platformio.ini as you need
  5. Press PIO upload button
  6. Your ESP32 BLE MIDI controller is now ready to use!

Contributing

Contributions are welcome! If you have any ideas, suggestions, or bug reports, please open an issue or submit a pull request.

License

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for more information.

Linux howto BlueZ with MIDI over BLE Support

Nice Howto from Peter P:

https://tttapa.github.io/Pages/Ubuntu/Software-Installation/BlueZ.html

After compiling BlueZ, Little Helper shown in Catja App

Catja on Ubuntu 22.04

Ardour / Mixbus Midi Setup

  • For example copy the Midi Map file from this Repo like this:
bash
cp DAW_MIDI_MAPS/ArdourAndHarrisonMixbus/midi_mapsLittle_Helper.map ~/.config/ardour6/midi_maps
  • Now you can open the Edit-Preferences Window in Ardour, and under Control Surfaces, select Generic Midi
  • Press Show Protocol Settings
  • Now you can select "Little_Helper" in Midi Bindings dropdown
  • if Little Helper is already connected via bluetooth you can make connection in Incoming Midi Dropdown like in the Image below
  • Done

Ardour Mixbus Midi


Some more pictures of how it is used

All parts

All Parts

Guitar attachment

Guitar attachment cad Guitar attachment Guitar attachment Guitar attachment

Web interface

 Settings  Btn Tabs 1 - 5


Simple Manual

First Wi-Fi Connection and Settings

To connect to the built-in access point, follow these steps:
  1. Power on your ESP32 BLE MIDI controller while pressing Btn 4 and 5
  2. Wait til LED becomes Blue
  3. Once initialized, the controller will start broadcasting its own access point (AP) named "LittleHelperAP-xxx"
  4. On your computer or mobile device, go to the Wi-Fi settings and connect to the "LittleHelperAP-xxx" network.
  5. Open a web browser and enter the following URL: http://192.168.8.1.
  6. You will be redirected to the controller's web interface.
  7. In the web interface, navigate to the "Settings" Tab.

After completing the initial steps, the device is now capable of connecting to a local network. If the user desires, they can hold down buttons 4 and 5 while powering down the device. This will allow the device to connect to a local Wi-Fi network and start the web UI for making MIDI settings, if necessary.

Firmware Update over WiFi Connection

To update the firmware of your ESP32 BLE MIDI controller over a WiFi connection, follow these steps:

  1. Ensure that your ESP32 BLE MIDI controller is connected to your local WiFi network. You can do this by navigating to the "Settings" tab in the controller's web interface and entering your WiFi credentials.

  2. Once connected, go to the Settings Tab and check the label that displays the current firmware version (e.g., s3miniVx).

  3. Visit the GitHub project page for Little Helper and go to the "Binary" folder (https://github.com/wolkstein/minimal-esp32-ble-midi-ctrl/tree/main/bin) to check if there is a newer firmware available. Look for a firmware version number that is higher than the one displayed in the firmware label.

  4. If a newer firmware is available, you can proceed with the update.

  5. In the Settings Tab, click the "Try Update" button to request the firmware update.

  6. After clicking the button, you will see a message saying "Update Requested, need Reboot".

  7. Turn off the power to your ESP32 BLE MIDI controller by switching the power switch to the "off" position and removing the USB cable.

  8. Power on the device again either by switching the power switch back on or by connecting the USB cable.

  9. Wait for the LED on the device to turn yellow. This indicates that the device is in update mode and is connected to your local network.

  10. If the LED starts blinking purple, it means that the update process is running. Wait until the LED switches back to its normal red or green light. If the LED does not blink purple, it means that the device has rebooted without performing the update.

  11. If the update fails, you can simply try again. If something goes wrong during the update, the previous firmware will be automatically recovered.

  12. If the update is successful, you can reconnect to the web interface and check the firmware version label to confirm the update.


Button Combinations at Power up

This section describes the button combinations and their corresponding functions that can be used during power up. Btn 1 to btn 5 from left to right.

Button CombinationFunction
o o o x xConnect To Local Wifi Network and enable Web UI
o o x x xStart AP Mode and enable Web UI
x x o o oReset Midi Settings to Default
x o x o oReset Midi Settings and Wifi Settings to Default

x = pressed, o = released

Parts

41
QtyValueFootprintReferences
610kResistor_SMD:R_0805_2012MetricR1, R5, R6, R7, R8, R9
610uFCapacitor_SMD:C_0805_2012MetricC1, C3, C4, C5, C6, C8
5SW_PushButton_Switch_THT:SW_PUSH_6mm_H5mmSW1, SW2, SW3, SW4, SW5
2100kResistor_SMD:R_0805_2012MetricR3, R4
21uFCapacitor_SMD:C_0603_1608MetricC7, C9
25k1Resistor_SMD:R_0805_2012MetricR10, R11
2SOLDER_CON_5x2_TOPba_connector:solder_con_5x2_topJ2, J3
2SW_Tactile_SmallButton_Switch_SMD_JLCPCB:SW_SPST_TS-1088-AR02016SW7, SW8
2WS2812Bled_smd_JLCPCB:LED_WS2812B_JLCPCB_5.0x5.0mm_P3.2mmD3, D5
118Kba_res:r2012R13
147Kba_res:r2012R12
1AP2112K-3.3Package_TO_SOT_SMD:SOT-23-5U1
1BAS16ba_sot:sot_23D4
1DMG3415UPackage_TO_SOT_SMD:SOT-23Q1
1ESP32-S3-MINI-1RF_Module:ESP32-S2-MINI-1U2
1LEDLED_SMD:LED_0603_1608MetricD2
1MBR0540Diode_SMD:D_SOD-123D1
1MCP73831-2-OTPackage_TO_SOT_SMD:SOT-23-5U3
1SW_On_OnButton_Switch_SMD:SW_SPDT_PCM12SW6
1USB_B_Micro_Molex_1050171001_JLCPCB_C505111Connector_USB:USB_Micro-B_Molex-105017-0001J1
1fit_3_1ba_mechanic:fit_3_1MH1

Similar boards

  • 6 layers450 × 235 mmBaseline, the printed circuit board in 3D

    Baseline

    DeadlySIn777/Controller

    Unfinished CNC controller motherboard: native KiCad sources, rules, DSN and global routing review

    2,723 parts
  • 4 layers120 × 65 mmBms power-100a, the printed circuit board in 3D

    Bms power-100a

    kitspace-test-repos/kicad6-file-collection

    70 partsMIT
  • 2 layers100 × 56.8 mmJoyKey, the printed circuit board in 3D

    JoyKey

    techy-robot/JoyKey

    A small macropad that simultaneously acts as game controller and an entertainment device.

    64 parts1CERN-OHL-S-2.0
  • 4 layers70 × 50 mmFinalized bluetooth remote, the printed circuit board in 3D

    Finalized bluetooth remote

    3pnguyen/esp32-bluetooth-media-keyboard

    Electronic project that provides the same control as wireless earbuds.

    62 partsMIT
  • 2 layers54.9 × 23.5 mmStdc14 adapter, the printed circuit board in 3D

    Stdc14 adapter

    arvindsa/stlinkv3-adapter

    STVlink3 Adapter

    26 parts
  • 4 layers62.7 × 35.5 mmAudioplayer, the printed circuit board in 3D

    Audioplayer

    kscz/kitzune-hw

    Hardware files for the kitzune project

    79 parts
  • 2 layers81.3 × 99.8 mmGamePulse2040, the printed circuit board in 3D

    GamePulse2040

    MAHESH-THILAK-K/ADDITIONAL-PROJECT

    74 parts1Apache-2.0
  • 2 layers460.9 × 228.8 mmDC-34-Badge panel, the printed circuit board in 3D

    DC-34-Badge panel

    Cyber-Professionals-Enthusiast-Club/DC-34-Badge

    CPEC Badge Kicad design files for DEFCON 34

    276 parts3

Questions

How big is the Little Helper PCB?

It measures 84 × 25.6 mm and has 4 copper layers, 1.6 mm thick.

What parts does the Little Helper use?

41 parts, built around the ESP32-S3-MINI-1-N8, AP2112K-3.3, TS-1088-AR02016 and WS2812B. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Little Helper KiCad files?

From the wolkstein/minimal-esp32-ble-midi-ctrl repository on GitHub, at the commit this page was made from: the board is Hardware/KicadProject/Little_Helper/Little_Helper.kicad_pcb and its schematic Hardware/KicadProject/Little_Helper/Little_Helper.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Little Helper design in my own project?

Its repository publishes it under the GPL-3.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).