AMY assigns synths between 1 and 16 to MIDI channels and listens to MIDI messages on those synths. For example, to set up a MIDI channel with a Juno-6 patch, you simply do
amy.send(synth=1, patch_number=3, num_voices=5)Where num_voices indicates the polyphony supported for that channel. AMY will handle note stealing and voice allocation.
AMY responds to MIDI note ons and note offs.
AMY responds to MIDI pitch bend messages. This does apply to every note played on the entire AMY instance.
AMY responds to MIDI sustain pedal messages.
AMY will turn off all notes when receiving an All Notes Off control change.
If you enable a MIDI input hook you can add more controller mappings. In the AMY source we provide midi_mappings.c with examples. The juno_filter_midi_handler assigns MIDI CC 70 to filter_freq and 71 to resonance. You probably want to make your own MIDI input hook to expand on this for your use cases.
AMY responds to a so far small set of MIDI CC changes to apply to CtrlCoefs on that channel.
TODO: fill this in
AMY responds to MIDI program changes. Since program changes are limited to 0-127, right now, we only support switching within an AMY "bank" -- if a synth is setup for Juno-6 (0-127), you can only change between other Juno-6 patches. If a synth is setup for DX-7 (128-255), you can set any DX-7 patch. For example, to change a DX7 patch from 5 to 3, send a program change to that synth with 128+3 = 131.
TODO: BANKS
AMY can receive its wire messages over SYSEX. Since wire messages are always in lower ASCII, you do not need to encode your wire message before sending it to AMY.
Preface your wire message with AMY's SYSEX manufacturer code: 0x00 0x03 0x45.
For example, to send the wire message v0f440l1 (sine wave, 440Hz, note on) to AMY over SYSEX, you'd send 0xF0 0x00 0x03 0x45 v 0 f 4 4 0 l 1 0xF7.
AMY supports MIDI realtime transport for the internal sequencer:
0xF8(Timing Clock): advances the sequencer from external clock input.0xFA(Start): starts sequencer playback from tick 0 in external clock mode.0xFC(Stop): stops sequencer playback.
MIDI Timing Clock is 24 PPQ. AMY's sequencer runs at 48 PPQ, so AMY advances two sequencer ticks per one MIDI clock pulse.
If you stop the sequencer with MIDI (using 0xFC) the only way to start the sequencer again is with MIDI 0xFA. We don't (yet) have AMY controls to stop / start the sequencer.