vail-adapter/doc/advanced-install.md

2.2 KiB

Advanced Install

In the Arduino IDE, edit vail-adapter.ino with the pins you want to use on your device.

You will need the MidiUSB and Keyboard libraries installed. You can do this through the Library manager.

Then compile and upload the sketch.

Works with no source code changes

  • Seeeduino Xiao SAMD21
  • Adafruit Qt Py SAMD21

Known to work with source code changes

  • Arduino Micro
  • KeeYees Pro Micro
  • Arduino Leonardo
  • Arduino Zero
  • Adafruit Trinket M0
  • Adafruit GEMMA M0
  • Adafruit Feather M0

Will Not Work!

The RP2040 chip will not work, because it lacks a USB MCU, needed by the MIDIUSB library. I'm listing specific devices here in the hopes that seeing them crossed out will prevent people from making a purchasing mistake!

  • Seeeduino Xiao RP2040 Will not work!
  • Adafruit Qt Pi RP2040 Will not work!
  • Any RP2040 Device Will not work!

Advanced Wiring

XIAO Pinout

  • GND: Ground
  • D2: Dit
  • D1: Dah
  • D0: Straight Key
  • D10: Speaker or Passive piezo buzzer
  • A6: Capacative Dit
  • A7: Capacative Dah
  • A8: Capacative Straight Key

Using a headphone jack

You can wire a headphone jack up to GND, D1, and D2. GND should be the sleeve, D1 the ring, and D2 the tip.

 o  --- D2 (tip, dit)
|_| --- D1 (ring, dah)
| | --- GND (sleeve)
| |

Sidetone generator

If you connect a buzzer or speaker to pin 10 on one leg, and ground on the other, the adapter will beep when you press the straight key.

This will help a lot if there is a noticeable delay between when you press the key and when your computer starts making a local beeping sound.

If you feel like no matter what you do, you're always getting DAH with your straight key, you should try this.

Capacative Touch

The adapter works as a capacative touch sensor, like a touch lamp.

You might wire these pins to screws or conductive pads. These can be used instead of, or in additon to, the normal pins D0, D1, and D2.

You do not need a ground wire with capacative touch!

  • Pin A6: Dit capacative touch
  • Pin A7: Dah capacative touch
  • Pin A8: Straight key capacative touch