Add MIDI Program Change, SysEx, NRPN, PitchBend and AfterTouch Output

[nkymut]

This update adds support for sending MIDI Program Change and System Exclusive (SysEx) messages for @strudel/midi package. It builds upon the changes made in #1212; however, MIDI mapping and Hi-res CC have not been tested yet.

Examples:

Program Change:

// [obsolete]note("c a f e").pc("<0 1 2>").midichan(1).midi()
$: note("c a f e").progNum("<0 1 2>").midichan(1).midi()
$: "10 20 30".progNum().midichan(1).midi()

// midi/gm.mjs provides mapping of gm intrrument names and pg numbers. 
// [obsolete] note("c a f e").pc(gm['marimba']).midichan(2).midi()
note("c a f e").progNum(gm['marimba']).midichan(2).midi()
//use midicmd
$: note("c a f e").midicmd("progNum:10").midichan(1).midi()
$: "progNum:20 progNum:30".midicmd().midichan(1).midi()

SysEx Messages:

// Send a simple SysEx message
let id = 0x43; //Yamaha ID for Gakken(Yamaha) NSX-39
let data = "0x79:0x09:0x11:0x0A:0x00:0x00"; // Set NSX-39 voice to say "Aa"

$: note("c d e f e d c").sysex([id,data]).midi();
$: note("c d e f e d c").sysexid(id).sysexdata(data).midi();

//ID can be an array of numbers
//let id = "0x00:0x20:0x32"; //Behringer 

Test & ToDo

• GAKKEN(YAMAHA) NSX-39
• update pc to progNum
• add progNum support to midicmd
• add sysex support to midicmd
• MIDI mappings External mappings for MIDI instruments #1212
  • mapping sysex message

[felixroos]

great stuff! would it make sense to add this to the existing midicmd ( #710 ) instead of the new pc function?

[felixroos]

wow also nice work on the docs

[nkymut]

Thank you for bringing this to my attention (#710). I overlooked the existing midicmd control completely.
I should have also referenced Tidal's MIDI control conventions,
as I agree that the pc function (for program change) could be more descriptive.

Superdirt uses a 'midicmd' control to specify the different midi commands.
https://tidalcycles.org/docs/configuration/MIDIOSC/midi/#synchronising-midi-clock-via-tidal

This mirrors the supercollider midi api
https://doc.sccode.org/Tutorials/A-Practical-Guide/PG_08_Event_Types_and_Parameters.html#MIDI%20output

[nkymut]

Regarding sysex (System Exclusive) messages,
I'm struggling with how to pass multiple pattern arguments (esp involving lists) to functions.

While ideally I'd want to structure it as:

sysex(id, data)

Currently, I've split it into:

sysexid(id).sysexdata(data)

This split approach largely follows webmidijs's sendSysex method specification,
which handles ID and data as separate parameters.
https://webmidijs.org/api/classes/Output#sendSysex

sendSysex([id],[data],[option])

If we adopt midicmd, it would be

midicmd("sysex:id:data")

here are some relevant topic on discord channel.
SysEx and lists
https://discordapp.com/channels/779427371270275082/1191429292744245250/1329202181055709226
Concatenate strings as a pattern
https://discordapp.com/channels/779427371270275082/1191429292744245250/1304375383268921397

Or

[nkymut]

I have managed to get sysex(id, data) working while keeping it chainable and the arguments are patternable Yay!
BTW, the idea that everything in Strudel/Tidal is a pattern is genuinely fascinating!

Here I have added a sysex method in controls.mjs using register from '@strudel/core' and pass args into 'sysexid' and 'sysexdata' controls to process furthur making the method to return a Pattern,.

export const sysex = register('sysex', (args, pat) => {
  if (!Array.isArray(args)) {
    throw new Error('sysex expects an array of [id, data]');
  }
  const [id, data] = args;
  return pat.sysexid(id).sysexdata(data); //return a chain of controls (which returns a Pattern)
});

[felixroos]

thanks! looking forward to testing this. i hope this can be part of the next release (happening soonish)

[felixroos]

so i assume we have to merge #1212 first, right?

[nkymut]

I tried adding API references, but it’s causing errors in the test code. I’ll fix it tomorrow morning by adding some dummy code for testing MIDI in and out.

[nkymut]

Maybe I should have split them into seperate smaller PRs,
but I went ahead and added support for nprn #192 , midibend, and miditouch.