silveirago/OpenMIDIStomper

OpenMIDIStomper

Description

_openMIDIStomper is an Arduino-based MIDI foot controller that provides customizable MIDI message sending capabilities using buttons, potentiometers, and LEDs. It can control any DAW plugin since it's USB MIDI Class compliant. It features 8 stomp buttons and 8 LEDs, all housed in a Hammond aluminum enclosure. The pedalboard has 8 banks, and each button can send up to 5 different messages, configurable through a browser editor.

Features

• Button Control: Send MIDI messages using button presses.
• Potentiometer Control: Adjust MIDI parameters with potentiometers.
• LED Indicators: Visual feedback using LEDs.
• Customizable Messages: Define your own MIDI messages and configurations.

Watch the Youtube video here:

Link

Material

• 1x Arduino Pro Micro
• 1x Solderable Breadboard
• 8x Stomp Buttons
• 8x 5mm Leds
• 8x 5mm LED Holders
• 2x 1/4" Stereo Socket
• 1x Hammond Enclosure

Getting Started

Prerequisites

• Arduino IDE installed on your computer.
• Arduino board (compatible with the code).
• Necessary components:
  • Push buttons
  • Potentiometers
  • LEDs
  • Resistors
  • Breadboard and jumper wires

Installation

1. Clone the Repository:

   git clone https://github.com/yourusername/_openMIDIStomper.git

2. Open the Project: Open the _openMIDIStomper.ino file in the Arduino IDE.

Hardware Setup

Components and Connections

1. Buttons:

   • Connect one terminal of each button in the first row to pin 15.
   • Connect one terminal of each button in the second row to pin 14.
   • Connect the other terminal of the first button in each column to pin 21.
   • Connect the other terminal of the second button in each column to pin 20.
   • Connect the other terminal of the third button in each column to pin 19.
   • Connect the other terminal of the fourth button in each column to pin 16.

2. Potentiometers:

   • Connect the middle terminal of each potentiometer to an analog input pin on the Arduino.
   • Connect the other two terminals to 5V and ground, respectively.

3. LEDs:

   • Pins: 2, 3, 4, 5, 6, 7, 8, 9

Connecting LEDs

• LED 1 (D1): Connect the anode to pin 2 through a 220Ω resistor and the cathode to ground.
• LED 2 (D2): Connect the anode to pin 3 through a 220Ω resistor and the cathode to ground.
• LED 3 (D3): Connect the anode to pin 4 through a 220Ω resistor and the cathode to ground.
• LED 4 (D4): Connect the anode to pin 5 through a 220Ω resistor and the cathode to ground.
• LED 5 (D5): Connect the anode to pin 6 through a 220Ω resistor and the cathode to ground.
• LED 6 (D6): Connect the anode to pin 7 through a 220Ω resistor and the cathode to ground.
• LED 7 (D7): Connect the anode to pin 8 through a 220Ω resistor and the cathode to ground.
• LED 8 (D8): Connect the anode to pin 9 through a 220Ω resistor and the cathode to ground.

Button Matrix

Pins Used

• Rows: Pins 15 and 14
• Columns: Pins 21, 20, 19, and 16

Wiring Diagram

• Button 1 (B1): Connect one terminal to pin 15 (Row1) and the other terminal to pin 21 (Column1).

• Button 2 (B2): Connect one terminal to pin 15 (Row1) and the other terminal to pin 20 (Column2).

• Button 3 (B3): Connect one terminal to pin 15 (Row1) and the other terminal to pin 19 (Column3).

• Button 4 (B4): Connect one terminal to pin 15 (Row1) and the other terminal to pin 16 (Column4).

• Button 5 (B5): Connect one terminal to pin 14 (Row2) and the other terminal to pin 21 (Column1).

• Button 6 (B6): Connect one terminal to pin 14 (Row2) and the other terminal to pin 20 (Column2).

• Button 7 (B7): Connect one terminal to pin 14 (Row2) and the other terminal to pin 19 (Column3).

• Button 8 (B8): Connect one terminal to pin 14 (Row2) and the other terminal to pin 16 (Column4).

Software Configuration

1. Button Definitions:

   • Modify ButtonDefinitions.h to define the pins and settings for your buttons.

2. Button Logic:

   • Implement the logic for button presses in ButtonLogic.h.

3. LED Control:

   • Adjust the LED control logic in LEDControl.h.

4. MIDI Messages:

   • Configure the MIDI messages to be sent in MIDIMessages.h.

5. MIDI Out:

   • Set up the MIDI output in MIDIOut.h.

6. Potentiometer Control:

   • Define how potentiometer inputs affect MIDI messages in PotentiometerControl.h.

Usage

1. Upload the Code:

   • Connect your Arduino board to your computer.
   • Select the appropriate board and port in the Arduino IDE.
   • Upload the _openMIDIStomper.ino sketch to the board.

2. Connect to MIDI Device:

   • Use a MIDI interface to connect the Arduino to your MIDI device or computer.

3. Operate:

   • Press buttons, turn potentiometers, and observe the LED feedback to control your MIDI device.

Troubleshooting

• Ensure all connections are secure.
• Verify that the correct pins are defined in the header files.
• Check the Arduino IDE for any compilation errors.
• Consult the serial monitor for debugging messages.

Instructions to Use the MIDI Message Configuration Code Editor

Use the editor here: https://go.musiconerd.com/openmidistomper-editor

1. Configure the MIDI Messages:

   • The interface allows you to configure MIDI messages for up to 8 banks, each containing 8 buttons.
   • Each button can send up to 5 different MIDI messages.
   • For each message, you can specify the type (NN, CC, PC, T), the message number (0-127), and the MIDI channel (0-15).

2. Expand Sections:

   • Click on the "Bank" buttons to expand and configure each bank.
   • Click on the "Button" buttons within each bank to expand and configure each button's messages.

3. Pre-fill Values:

   • By default, the first message for each button is set to Note Number (NN), with the number equal to the button index and the channel equal to the bank index.
   • You can adjust these values as needed.

4. Copy Configuration:

   • Once you have configured the MIDI messages, click the "Copy Configuration to Clipboard" button.
   • A message will appear indicating that the configuration has been copied to your clipboard.

5. Paste into Arduino Sketch:

   • Open your Arduino sketch in the Arduino IDE.
   • Paste the copied configuration code into the appropriate section of your sketch.

6. Export and Import Bank Configurations:

   • To export a bank's configuration, click the "Export Bank Configuration" button for the desired bank. This will download a text file with the configuration.
   • To import a bank's configuration, click the "Import Bank Configuration" button for the desired bank and select the previously exported configuration file.

7. Save and Upload:

   • Save the changes in your Arduino sketch.
   • Upload the sketch to your Arduino board to use the configured MIDI messages.

This HTML code editor provides a user-friendly interface to configure and manage MIDI messages, making it easy to set up your MIDI controller.

How to Upload Your Presets

Method 1: Using GitHub Issues

1. Go to the Issues Tab: Navigate to the Issues tab of the repository.

2. Create a New Issue:

   • Click on the "New Issue" button.
   • Provide a descriptive title for your issue, such as "New Preset: [Preset Name]".
   • In the description, provide any relevant details about your preset.

3. Attach Your Preset File:

   • Drag and drop your preset file into the issue description area or click the "Attach files by dragging & dropping, selecting or pasting them." link.
   • Ensure the file uploads successfully.

4. Submit the Issue:

   • Click the "Submit new issue" button to create the issue.

Thank you! We will review your preset and integrate it into the repository.

Method 2: Using Pull Requests (Advanced Users)

1. Fork the Repository:

   • Click the "Fork" button at the top right of the repository page to create a copy of the repository under your GitHub account.

2. Clone the Repository:

   • Clone your forked repository to your local machine using the following command:

     git clone https://github.com/YOUR-USERNAME/REPOSITORY-NAME.git

   • Replace `YOUR-USERNAME` with your GitHub username and `REPOSITORY-NAME` with the name of the repository.

3. Create a New Branch:

   • Navigate to the repository directory on your local machine:

     cd REPOSITORY-NAME

   • Create a new branch for your changes:

     git checkout -b new-preset-branch

4. Add Your Preset File:

   • Add your preset file to the appropriate directory (e.g., `presets/`):

     cp /path/to/your/preset/file presets/

5. Commit Your Changes:

   • Stage your changes:

     git add presets/your-preset-file

   • Commit your changes with a descriptive message:

     git commit -m "Add new preset: [Preset Name]"

6. Push Your Changes:

   • Push your changes to your forked repository:

     git push origin new-preset-branch

7. Create a Pull Request:

   • Navigate to your forked repository on GitHub.
   • Click the "Compare & pull request" button next to your new branch.
   • Provide a descriptive title and description for your pull request.
   • Click "Create pull request".

We will review your pull request and merge it if everything looks good. Thank you for your contribution!

Feel free to reach out via the [Discussions] https://github.com/silveirago/OpenMIDIStomper/discussions tab if you have any questions or need further assistance. Happy contributing!

Contributing

Feel free to contribute to this project by submitting issues or pull requests. Any improvements or bug fixes are welcome.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Acknowledgements

Thank you to the open-source community for providing valuable resources and inspiration for this project.

Support this Project

This project was created by me, Gustavo Silveira, a.k.a. the Nerd Musician, for the community.

If you want to support me, so I can keep doing projects like this, consider buying one of my DIY MIDI Controller courses: https://go.musiconerd.com/nerd-musician-pro

Or PayPal me any ammount here: https://www.paypal.com/paypalme/nerdmusician