Skip to content

HardwarePlatform_Waveshare4.3B.md

Latest commit

 

History

History
98 lines (84 loc) · 6.78 KB

HardwarePlatform_Waveshare4.3B.md

File metadata and controls

98 lines (84 loc) · 6.78 KB

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

Waveshare 4.3B Hardware Platform and Wiring Details

Table of Contents

  1. Connections
  2. Wired Footswitches - onboard
  3. Wired Footswitches - external
  4. Wired Midi

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

image
image
image

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.

  • 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 1 amp (minimum) 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.
  • Note: some users have had issues due to the quality of the power supply. If it is insufficient current, or electrically noisy, it may cause the board to crash/reset/flicker. A good quality power supply is recommended
  • Note: it is highly recommended to link all of the ground terminals together. Some users have experienced crashing/instability without this, particularly if also using footswitches and Midi
  • Switch on the power supply
  • The Waveshare board USB port will power the Tonex One
  • 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



Wired Footswitches (onboard)

Wired footswitches can optionally be used. These "onboard" switches connect directly to the controller with out needing any additional circuitry.
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 wires connected as shown.

For the Waveshare 4.3B, a maximum of 2 footswitches are supported, always in next/previous preset mode.

footswitches_waveshare_display



Wired Footswitches (external)

Starting from firmware version 1.0.8.2, with the use of an additional PCB, up to 16 footswitches can be connected.
The footswitch must be a "momentary" type that is only has its contacts closed when it is pressed.

The additional PCB must use the "SX1509" chip. The recommeded one is the Sparkfun SX1509 breakout board: https://www.sparkfun.com/sparkfun-16-output-i-o-expander-breakout-sx1509.html
image

NOTE: other types of IO expander boards that use different chips are not supported and will not function. It must contain the SX1509 chip.

Address Setting

The SX1509 PCB has a selectable address system. This must be set correctly in order for the board to function with the controller.

  • Using a sharp knife, carefully cut the thin tracks between the pads as shown below
  • Use solder to bridge the pads as shown below
  • This sets the SX1509 adress to "11" which avoids conflicting with other parts on the controller boards sx1509_address

The common pin of each footswitch must connect to the SX1509 ground pins. The labels "0", "1" etc are the individual switch inputs. Footswitch 1 connected to input 0. Footswitch 2 to input 1 etc.

Multiple modes are supported, configured using the web configuration. external_waveshare_display

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 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 4.3B to Midi Featherwing via the TTL to RS485 adaptor:
midi_waveshare_43b