This is an attempt to reverse engineer the control protocol of a pretty old MIDI-keyboard SAMSON Graphite 49 (other models probably are similar).
The info here is for the latest available "version 1" firmware 1.42. As there exists "version 2" too (for the units with different LCD) it can have some differences.
Files included:
- sysex.md — the main list of SysEx'es used for reading and writing settings for the device
- hardware_ids.md — IDs used in the SysEx'es for addressing the device physical controls
- cc_table.md — CC numbers used for assigning functions to conrols, standard MIDI and vendor extended "virtual CC" ones
- registers.md — byte registers used for miscellaneous device-wide settings (zones setup mostly)
- rc_presets.md — short description of "Remote Control" presets
- quirks.md — quirks and issues
Also, two Python utility scripts (using rtmidi library) for getting presets from the device and putting them there:
scripts/get_preset— outputs the preset specified in the command line into the standard output as an XML file. Saving into a file can be easily done by redirection, the corresponding fragment in the script is commented out, but can be turned on if needed.scripts/set_control— loads the controls from a specified XML file into the device. Without registers and saving — I'm still figuring out the registers and probably will make a separate script for them, and the saving can be done manually into any user preset if needed.