User Manual

32
System Exclusive (SysEx) Messages
The Particle uses MIDI System Exclusive Messages to get and set configuration properties and state.
The protocol is very similar to MIDI Capability Inquiry (MIDI-CI) Property Exchange, but the defined prop-
erties and semantics for MIDI-CI Property Exchange are not part of the MIDI-CI specification and have not
been published as of March 2019.
The following System Exclusive messages can be used to configure the particle, read current configura-
tion, and access other functionality that is not available through standard MIDI messages (for example,
saving presets to internal memory). You can use these messages to write a custom editor or configure
a MIDI controller to control the Particle. Our web editor prints the System Exclusive messages that it
sends to the JavaScript console, so you can perform an action using the web editor and then copy the
SysEx to your controller.
The basic format is the same for all messages:
Byte (hex) Description
F0 System Exclusive (SysEx)
00 Red Panda ID byte 1
02 Red Panda ID byte 2
23 Red Panda ID byte 3
01 Particle family ID
01 Particle product ID
00 Message version
1 byte Message type:
0x34: get property
0x35: reply to get property
0x36: set property
2 bytes Property ID
nn bytes Property data (length depends on ID)
F7 End of Exclusive (EOX)
Example: Save Preset to Internal Memory 3
Byte (hex) Description
F0 System Exclusive (SysEx)
00 Red Panda ID byte 1
02 Red Panda ID byte 2
23 Red Panda ID byte 3
01 Particle family ID
01 Particle product ID
00 Message version
36 Set property
7F Save preset to memory byte 1
13 Save preset to memory byte 2
03 Preset location
(0-based hexadecimal program change number)