Tonex Controller: An open-source controller and display interface for the IK Multimedia Tonex One, Tonex Pedal, and Valeton GP5

This project uses a low-cost embedded controller (Espressif ESP32-S3) to form a bridge to the IK Multimedia Tonex One (which does not have native Midi capability) or the bigger Tonex pedal (new in V2.0.0.2.) New in V2.0.2.2. is support for the Valeton GP5. <br>It allows selection of the 20 different presets in the pedal, by any or all of touch screen, WiFi, wired footswitches, bluetooth footswitches, bluetooth servers, and midi programs. <br>A variety of hardware is supported, from a $6 board with no display, up to a $44 board with a 4.3" touch screen LCD and a pretty graphical user interface.

Note: this project is not endorsed by IK Multimedia. Amplifier skin images copyright is owned by IK Multimedia. TONEX is a registered trademark of IK Multimedia Production Srl Valeton is a registered trademark of Changsha Hotone Audio Co., Ltd.

Code Use Notice

A number of people have taken significant portions of this project, undertaked minor modifications, and then released commercial products using it. Whilst commercial use of this open source is permitted, it is only permitted if the user provides "attribution", that is, publically states in literature that portions of their product are based on this project, and provide a link to it.<br> Those who refuse and try to claim this work as their own are violating the license terms and may be reported to Youtube or other entities that may take down your materials.<br> For example, the "GuerrilhaBox" Controller is clearly based on this project with no attribution, in violation of the license terms. Comments made to their Youtube videos to this effect are being deleted, as its clearly an embarrassment for them.

Table of Contents

1. Key Features
2. Demonstration Videos
3. Multiple Hardware Devices
4. Hardware Platforms and Wiring Diagrams
5. Pre-Built Controllers from Pirate Midi
6. Uploading/Programming Firmware Releases
7. Configuration and Settings
8. Usage Instructions
9. Firmware Development Information
10. Acknowledgements
11. Firmware Release Notes
12. Companion Projects
13. License
14. Donations

⭐ Key Features <a name="key_features"></a>

The supported features vary a little depending on the chosen hardware platform.

• LCD display with capactive touch screen
• Screen displays the name and number of the current preset (all models with displays)
• The User can select an amplifier or pedal skin and also add descriptive text ("4.3B" and "3.5" models)
• Use of simple dual footswitches to select next/previous preset (all platforms)
• Use of four buttons to select a preset via a banked system, or directly via binary inputs (all platforms except for the "4.3B")
• Bluetooth Client support. Use of the "M-Vave Chocolate" bluetooth Midi footswitch device to switch presets (4 buttons, bank up/down)
• Other Bluetooth Midi controllers should be also supported, via the "custom name" option. Refer to Web Configuration
• Bluetooth server support. Pair your phone/tablet with the controller, and send standard Midi program changes, bridged through to the Tonex One pedal (note Server and Client cannot be used simultaneously)
• USB host control of the Tonex pedal
• Wired/Serial Midi support
• New in V1.0.6: full control over all Tonex One parameters and effects, via LCD (4.3B and 3.5 only) and Midi (all platforms.)
• New in V1.0.8: support for up to 16 footswitches, with configurable preset switching layouts, and up to 5 effect/parameter toggle switches

Demonstration Videos <a name="demonstration_videos"></a>

Release Videos

<a href="https://www.youtube.com/watch?v=oZ8G2kJxw-A" target="_blank"><img width="454" height="248" alt="image" src="https://github.com/user-attachments/assets/ce313395-0995-4053-823d-7e84b632b3a1" /> <a href="https://youtu.be/j0I5G5-CXfg" target="_blank"><img width="455" height="247" alt="image" src="https://github.com/user-attachments/assets/3588465b-8f2e-4e99-a2db-18d2f3ade429" /> <a href="https://www.youtube.com/watch?v=_nemmhjvjcc" target="_blank"><img width="457" height="239" alt="image" src="https://github.com/user-attachments/assets/56fbd134-9518-4b0d-a50d-0e200f71aa5b" /> <a href="https://www.youtube.com/watch?v=ok4EuUgWt44" target="_blank"><img width="456" height="245" alt="image" src="https://github.com/user-attachments/assets/21eb8070-3402-4968-be52-9fb582fb6848" /> <a href="https://www.youtube.com/watch?v=r5wLnxQ4IZo" target="_blank"><img width="458" height="242" alt="image" src="https://github.com/user-attachments/assets/47747b43-f800-4fab-a444-c70403567c80" /> <a href="https://www.youtube.com/watch?v=WF8BB_EIKBo" target="_blank"><img width="452" height="245" alt="image" src="https://github.com/user-attachments/assets/cf955f2e-9ee0-4748-92e1-cd9e1719dc26" /> <a href="https://www.youtube.com/watch?v=hQ5NEcqaVeE" target="_blank"><img width="455" height="245" alt="image" src="https://github.com/user-attachments/assets/887427a8-481d-46b3-a4bf-5472e6e3cca0" /> <br><br>

Pirate Midi Videos

<a href="https://youtu.be/j0I5G5-CXfg" target="_blank"><img width="458" height="246" alt="image" src="https://github.com/user-attachments/assets/11de8a13-4865-4f64-8b6f-6f6f91a8495f" /> <a href="https://www.youtube.com/watch?v=dkUudtlyilI" target="_blank"><img width="456" height="244" alt="image" src="https://github.com/user-attachments/assets/3293f51a-4178-4156-9dbc-cd26233be540" /> <a href="https://www.youtube.com/watch?v=ygJXO1M7p0s" target="_blank"><img width="455" height="238" alt="image" src="https://github.com/user-attachments/assets/35692c87-0867-47c4-a936-dc5785ffab76" /> <a href="https://www.youtube.com/watch?v=fZ0MSDB0vW4" target="_blank"><img width="456" height="246" alt="image" src="https://github.com/user-attachments/assets/2e9e10d4-9aa1-4f4a-afb4-f66604fd4ae5" /> <br><br>

Review Videos (seach Youtube for more)

<a href="https://www.youtube.com/watch?v=dL7V-3_e7Gg" target="_blank"><img width="458" height="244" alt="image" src="https://github.com/user-attachments/assets/2a14750e-dee0-4431-a61f-9ea7b8657775" /> <a href="https://www.youtube.com/watch?v=TLoKdBpcDJA" target="_blank"><img width="459" height="248" alt="image" src="https://github.com/user-attachments/assets/84677209-2114-4c6c-875f-bc49a7c3bad4" /> <a href="https://www.youtube.com/watch?v=SztXfEDaUI8)" target="_blank"><img width="450" height="252" alt="image" src="https://github.com/user-attachments/assets/7620ed23-47ea-4a06-97d4-f0265c2d19b8" /> <br><br>

User Videos (search Youtube for more)

<a href="https://www.youtube.com/watch?v=qkOs5gk3bcQ" target="_blank"><img width="457" height="243" alt="image" src="https://github.com/user-attachments/assets/c5dda5a3-bb22-479d-9498-a1c81d499d80" /> <a href="https://www.youtube.com/watch?v=bNvzW3pwNeY" target="_blank"><img width="459" height="240" alt="image" src="https://github.com/user-attachments/assets/59beea9c-1c10-4e26-a5dd-bf60c0c727e6" /> <a href="https://www.youtube.com/watch?v=pgCZfFsZD_4" target="_blank"><img width="455" height="245" alt="image" src="https://github.com/user-attachments/assets/b91e90f2-6cd1-41f3-a7ae-9ce5d33ad94f" /> <a href="https://www.youtube.com/watch?v=E56C4G4_uKk" target="_blank"><img width="458" height="244" alt="image" src="https://github.com/user-attachments/assets/9c838478-5dcb-4b57-ba2b-74d2d99b77cd" /> <a href="https://www.youtube.com/watch?v=aJPtkqnd2sg" target="_blank"><img width="454" height="242" alt="image" src="https://github.com/user-attachments/assets/c2e260dd-3cb1-4357-a563-76871214ec00" /> <a href="https://www.youtube.com/watch?v=M2mpE5QMi7E" target="_blank"><img width="458" height="244" alt="image" src="https://github.com/user-attachments/assets/0a00d54e-cee2-47d5-800c-4ba8e69c6029" /> <a href="https://www.youtube.com/watch?v=mTD-6dyGXxc" target="_blank"><img width="454" height="241" alt="image" src="https://github.com/user-attachments/assets/07208ba8-67d7-4d6f-9393-5489ab415ccc" /> <br><br>

Articles/Tutorials written by others

<a href="https://gsus4.com.au/blogs/news-promo/what-if-there-was-a-screen-for-ik-tonex-one-step-by-step-guide" target="_blank"><img width="1338" height="853" alt="image" src="https://github.com/user-attachments/assets/cb3be685-4f83-420f-84f0-761e906978cb" /> <br><br>

Multiple Hardware Devices <a name="multiple_devices"></a>

This project can run on a variery of different hardware platforms, varying in size and cost. All of them are "off-the-shelf" development boards supplied either by the company "Waveshare", or Espressif. The code could be adapted to run on other brand ESP32-S3 boards, but to make things easy, pre-built releases are provided for the supported modules. <br>All platforms support Bluetooth, WiFi, wired footswitches, and wired Midi.

• 4.3" LCD board, supporting touch screen and advanced graphics including customisable amp/pedal skins and text
• 1.69" LCD boards (with or without Touch.) Similar to an Apple Watch, this small board displays the preset name and number
• "Zero" board with no display, is the smallest and cheapest option
• "DevKit-C" board with no display
• "Atom S3R" board with tiny LCD
• 1.9" board (with or without Touch.) Displays the preset name and number
• 3.5" LCD boards, supporting touch screen and advanced graphics including customisable amp/pedal skins and text <img width="803" height="868" alt="image" src="https://github.com/user-attachments/assets/73d09089-5a49-4c0c-afed-aa8eda7a0b0c" />

Hardware Platforms and Wiring <a name="hardware_platforms"></a>

For more information about the hardware platforms, refer to Hardware Platforms

Pre-Built Controllers