vail-adapter

MIDI.md

 1# Vail MIDI Protocol
 2
 3When it boots,
 4the Vail adapter sends left and right Control keyboard key up and down events.
 5It also shows up as a MIDI device.
 6
 7The Vail web site sends MIDI control commands to enable MIDI keyer mode,
 8tells the keyer what sideband pitch to generate,
 9and can set the keyer mode.
10
11
12## Controller 0 - MIDI Mode
13
14`b0 00 ff` will enable MIDI mode and disable Keyboard mode
15
16`b0 00 00` will enable Keyboard mode and disable MIDI mode
17
18
19## Controller 1 - dit length
20
21`b0 00 xx` will set the dit duration to `xx` times 2 milliseconds
22
23
24## Controller 2 - sidetone note
25
26`b0 00 xx` will play note `xx` as the sidetone note
27
28
29## Program Change
30
31`c0 xx` will change the keyer mode to `xx`.
32
33
34### Keyer Modes
35
36* 0: passthrough (sends C# and D for dit and dah)
37* 1: cootie / straight key
38* 2: bug
39* 3: electric bug
40* 4: single dot
41* 5: ultimatic
42* 6: plain iambic
43* 7: iambic a
44* 8: iambic b
45* 9: keyahead
46
47Any other mode will set to passthrough.
48
49
50## Notes (key down / key up)
51
52`90 00 xx` will begin playing note `xx`  
53`80 00 xx` will end playing note `xx`
54
55These work just like a regular MIDI synthesizer.