Skip to content

Latest commit

 

History

History
141 lines (117 loc) · 9.5 KB

HardwarePlatforms.md

File metadata and controls

141 lines (117 loc) · 9.5 KB
Raw

Tonex One Controller: An open-source controller and display interface for the IK Multimedia Tonex One guitar pedal

Hardware Platforms and Wiring Details

Table of Contents

  1. Hardware Platform 1 Waveshare 4.3B
  2. Hardware Platform 2 Waveshare Zero
  3. Hardware Platform 3 Waveshare 1.69
  4. Wired Footswitches
  5. Wired Midi
  6. Cases

Three hardware platforms are supported. Other ESP32-S3 platforms could be supported but would require code changes.
They would need to meet the minimum requirements:

  • Minimum SPI Flash size: 8 MB with display, 4 MB without
  • Minimum PSRAM size: 2 MB
  • USB OTG port

Hardware Platform 1: Waveshare 4.3" B LCD board (Display supported)

This hardware platform uses this Waveshare 4.3" B LCD board. https://www.waveshare.com/product/esp32-s3-touch-lcd-4.3b.htm?sku=28141

Important note: Waveshare have two very similar boards:

  • ESP32-S3-4.3: 2 USB-C ports. 5 volt power input. This board is NOT RECOMMENDED but can be made to work with a board modification (remove R19)
  • ESP32-S3-4.3B: 1 USB-C port and a terminal block for 9v power input. This is the recommended board and works without modification

This module provides the microcontroller, power input suitable for 9v DC pedal board use, LCD screen, capacitive touch screen, and dual isolated inputs suitable for momentary foot switches.

Connections

Note: the controller code relies on the Tonex One pedal being set to Stomp mode. Code is in place to do this automatically, but it seems it may have a bug. Manually enable Stomp mode on your pedal.

  • Connect the USB-C port on the Waveshare board to the ToneX One USB-C port
  • Optional: connect dual footswitches to the isolated inputs on the Waveshare board. GND to ground. DI0 for footswitch 1. DI1 for footwitch 2. Exact wiring depends on the footswitch but is usually a 6.5mm stereo jack
  • Connect 9V DC power supply to the terminals on the Waveshare board. The terminals are screw terminals, so most likely a DC jack to wires will be needed.
  • Switch on the power supply
  • The Waveshare board USB port will power the Tonex One. Do not connect 9 volts to it!
  • Optional: for the Bluetooth Client version of code, switch on a M-Vave Chocolate Midi pedal (https://www.cuvave.com/productinfo/724103.html). After a few seconds it should connect and the Bluetooth icon should change from gray to blue
  • Optional: for the Bluetooth Server version of code, the controller will be available as a peripheral for you to connect to via a Bluetooth Midi device. The Bluetooth icon should change from gray to blue when connected.

wiring_waveshare_display

Hardware Platform 2: Waveshare ESP32-S3 Zero (no Display support)

This hardware platform uses this Waveshare Zero board. https://www.waveshare.com/product/esp32-s3-zero.htm

Ensure its the ESP32-S3FH4R2 with USB-C port. There are some similar boards with no USB-C or slightly different processor This module is very low cost (around US$6) and does not support an LCD display. It requires a 5 volt DC power supply. Caution: do not connect a pedalboard 9v! If you do, you will probably blow up both the PCB and your Tonex One!

Connections

Note: the controller code relies on the Tonex One pedal being set to Stomp mode. Code is in place to do this automatically, but it seems it may have a bug. Manually enable Stomp mode on your pedal.

  • Solder a DC jack to the PCB, as shown below. Note the positive and negative polarity must match your power supply
  • Connect the USB-C port on the Waveshare board to the ToneX One USB-C port
  • Connect 5 volts DC to the power input jack that you soldered in the first step
  • Switch on the power supply
  • The Waveshare board USB port will power the Tonex One. Do not connect 9 volts to it!
  • Optional: for the Bluetooth Client version of code, switch on a M-Vave Chocolate Midi pedal (https://www.cuvave.com/productinfo/724103.html). After a few seconds it should connect and the Bluetooth icon should change from gray to blue
  • Optional: for the Bluetooth Server version of code, the controller will be available as a peripheral for you to connect to via a Bluetooth Midi device. The Bluetooth icon should change from gray to blue when connected.

wiring_waveshare_zero

Hardware Platform 3: Waveshare ESP32-S3 1.69" Display board (no touch)

This hardware platform uses this Waveshare ESP32-S3 1.69" LCD board. https://www.waveshare.com/esp32-s3-lcd-1.69.htm

Important note: Waveshare have a V1 and a V2 PCB. The V2 has a small sticker on the USB-C port.
The V2 works very well, but on the V1, due to an error in Waveshare's design, the onboard Buzzer will make some noise.
This issue is being investigated to find a work-around.
It is recommended to check with your supplier if the board has the V2 sticker, and try to only purchase this V2 version. image

This module is low cost (around US$16) and supports an LCD display, about the same size as an Apple Watch. It requires a 5 volt DC power supply. Caution: do not connect a pedalboard 9v! If you do, you will probably blow up both the PCB and your Tonex One!

Connections

Note: the controller code relies on the Tonex One pedal being set to Stomp mode. Code is in place to do this automatically, but it seems it may have a bug. Manually enable Stomp mode on your pedal.

  • Solder a DC jack to the PCB, as shown below. Note the positive and negative polarity must match your power supply
  • Connect the USB-C port on the Waveshare board to the ToneX One USB-C port
  • Connect 5 volts DC to the power input jack that you soldered in the first step
  • Switch on the power supply
  • The Waveshare board USB port will power the Tonex One. Do not connect 9 volts to it! wiring_waveshare_169



Wired Footswitches

Wired dual footswitches can optionally be used to select the Next/Previous preset. The footswitch must be a "momentary" type that is only has its contacts closed when it is pressed. The common pin of the footswitch must connect to the Controller ground pin, and the other 2 wires connected as shown. footswitches_waveshare_display footswitches_waveshare_zero footswitches_waveshare_169

Wired Midi (firmware version V1.0.4.1 or above required)

Note: Wired Midi is disabled by default. If it is enabled without the proper hardware (detailed below) being fitted, you may get "phantom" preset changes, due to the serial input "floating". Only enable wired Midi when hardware is connected!
Refer here for details on how to enable it, and set the Midi channel: https://github.com/Builty/TonexOneController/blob/main/WebConfiguration.md

Wired Midi is supported on all platforms. A extra PCB is required for all platforms, an "Adafruit Midi FeatherWing kit", for US$7.
https://www.adafruit.com/product/4740
This Midi board supports both 5-pin DIN sockets (included in kit) and 3.5mm jacks (not included in kit.)

The Waveshare Zero and 1.69" LCD boards can directly connect to the Midi Featherwing PCB.
The Waveshare 4.3B, due to hardware limitations, requires another small interface. This a common, low cost "TTL to RS485" adaptor.
Typical examples of this PCB: https://www.amazon.com/HiLetgo-Reciprocal-Hardware-Automatic-Converter/dp/B082Y19KV9
https://www.amazon.com.au/dp/B0DDLBYFJB
image
Midi Featherwing:
midi_featherwing

Waveshare Zero to Midi Featherwing:
midi_waveshare_zero

Waveshare 1.69" to Midi Featherwing:
midi_waveshare_169

Waveshare 4.3B to Midi Featherwing via the TTL to RS485 adaptor:
midi_waveshare_43b

Cases

With the Zero and 1.69" boards being bare PCBs, a case of some type is useful to protect it. Here are some links to 3D printed options.

Waveshare Zero

Community member "AlmaMaterFL" designed this one: https://www.printables.com/model/1110479-esp32-s3-zero-m-case-pin-version image image

Waveshare 1.69"

Community member "AlmaMaterFL" designed this one: https://www.printables.com/model/1114384-esp32-s3-169inch-case image image