MIDI SAMPLE DUMP STANDARD
1) INTRODUCTION
The MIDI SDS was adopted in January 1986 by the MIDI
Manufacturers Association and the Japanese MIDI Standards Committee.
The SDS defines the standard method for transfer of sound sample data
between MIDI-equipped devices. Sample dumps may be accomplished with
either an 'open loop' or 'closed loop' system. The open loop method
simply involves the straight dump of all sample data from its source
to the destination, with no timeouts, packet acknowledgements, or any
other form of handshaking, much as in the manner of a sysex bulk dump,
usually intiated at the source. The closed loop method allows the use
of handshaking messages between the dump source and destination, and
usually places the dump process under the control of the slave, to
allow it time to process the incoming data as necessary. As with any
standard, it can not be assumed that a device adheres to it unless the
accompanying documentation specifically indicates it. Even then, it is
best to check its conformity with non-critical data.
2) SPEC: SAMPLE DUMP FORMATS
DUMP HEADER:
F0 7E cc 01 ss ss ee ff ff ff gg gg gg hh hh hh ii ii ii jj F7
where
cc = channel number
ss ss = sample number (LSB first)
ee = sample format (number of significant bits; 8->28)
ff ff ff = sample period (1/sample rate) in nanoseconds (LSB first)
gg gg gg = sample length, in words
hh hh hh = sustain loop start point (word number) (LSB first)
ii ii ii = sustain loop end point (word number) (LSB first)
jj = loop type (00:forwards only; 01:alternating)
DATA PACKET:
F0 7E cc 02 kk <120 bytes> mm F7
where
cc = channel number
kk = running packet count (00->7F)
mm = checksum (XOR of 7E, cc, 02, kk <120 bytes>)
The total size of a data packet is 127 bytes. This is to avoid
overflow of the MIDI input buffer of a device that may want to receive
an entire packet before processing it.
A data packet consists of its own header, a packet number, 120
bytes of data, a checksum, and an EOX. The packet number begins at 00
and increments with each new packet. It resets to 00 after it reaches
7F, and continues counting. The packet number is used by the receiver
to distinguish between a new data packet, or a resend of a previous
packet. The packet number is followed by 120 bytes of data, which form
60, 40, or 30 words (MSB first for multiword samples), depending on
the length of a single data sample.
Each data byte hold seven bits, with the msb in each byte set to
0, in order to conform to the requirements of MIDI data transmission.
Information is left justified within the 7-bit bytes, and unused bits
are filled with 0.
Example: Assume a data point in the memory of a 16-bit sampler,
with the value 87E5. In binary, that would be
1000 0111 1110 0101
and would be encoded as the following MIDI data stream:
01000011 01111001 00100000
The checksum is the running XOR of all the data after the SYSEX
byte, up to but not including the checksum itself.
3) SPEC: SAMPLE DUMP MESSAGES
DUMP REQUEST:
F0 7E cc 03 ss ss F7
where
cc = channel number
ss ss = sample number requested (LSB first)
Upon receiving the request, the sampler checks the sample number
to see if it is within legal range. If it is not, the request is
ignored. If it is, the sample dump is started. One packet at a time is
sent, under control of the handshaking messages outlined below.
HANDSHAKING MESSAGES:
For all below:
cc = channel number
pp = packet number
Packet numbers are included in the handshaking messages to
accomodate machines that have the intelligence to re-transmit specific
packets after an entire dump is finished, or if synchronization is
lost.
ACK : F0 7E cc 7F pp F7
Means last packet was recieved correctly (checksum OK, etc),
please send next one. Packet number is packet being acknowledged as
correct.
NAK : F0 7E cc 7E pp F7
Means last packet not received correctly, please send again.
Packet number is packet being rejected.
CANCEL : F0 7E cc 7D pp F7
Means abort dump immediately. Packet number is packet on which
abort occurs.
WAIT : F0 7E cc 7C pp F7
Means pause dump indefinitely, until next message is sent. Allows
the unit recieving the dump to perform other functions (disk access,
etc), before receiving the remainder of the dump. The next message it
sends (eg ACK, ABORT) will determine if the dump continues or aborts.
4) DUMP PROCEDURE: MASTER (DUMP SOURCE)
Once a dump has been requested, either via MIDI or through the
front panel, the DUMP HEADER is sent. After sending the header, the
master must time out for at least two seconds, to allow the receiver
to decide if it will accept this sample (has enough memory, etc).
If it receives a CANCEL, within this time, it should abort
immediately. If it receives an CAK, it will start sending packets
immediately. If it receives a WAIT, it pauses until another message is
received, and then processes that mesage normally. If nothing is
recieved within the timeout, an open loop is assumed, and the dump
starts with the first packet.
After sending each packet, the master should time out for at
least 20 milliseconds and watch its MIDI In. If an ACK is received, it
sends the next packet immediately. If it receives an NAK, and the
packet number matches the number of the last packet sent, it resend
that packet If the packet numbers don't match, and the device is
incapable of sending packets out of order, the NAK will be ignored.
If a WAIT is received, the master should watch its MIDI In port
indefinitely for another ACK, NAK, or CANCEL message, which it should
then process normally.
If no messages are received within 20 milliseconds of the
transmission of a packet, the master may assume an open loop
configuration, and send the next packet.
This process continues until there are less than 121 data bytes
to send. The final packet will still consist of 120n bytes, regardless
of how many significant bytes actually remain, and the unused bytes
will be filled with zeroes. The receiver should handshake after
receiving the last packet.
5) DUMP PROCEDURE: SLAVE (DUMP DESTINATION)
When receiving a sample dump, a device should keep a running
checksum during reception. If its checksum matches the checksum in the
data packet, it will send an ACK and wait for the next packet. If it
does not match, it will send an NAK containing the number of the
packet that caused the error, and wait for the next packet. If, after
sending an NAK, the packet number of the next packet doesn't match the
previous packet number (the one that was NAK'd), and the unit is not
capable of accepting packets out of order, the error is ignored and
the dump continues as if the checksums had matched.
If a receiver runs out of memory before the dumpo is completed,
it should send a CANCEL to stop the dump.
6) SDS OVERVIEW
SAMPLE DUMP DATA FORMAT: DUMP HEADER:
Sysex
ID: Universal Non-Real Time
Channel Number
Sub ID: Header
Sample Number (2 bytes, LSB first)
Sample Format
Sample Period (3 bytes, LSB first)
Sample Length (3 bytes, LSB first)
Sustain Loop Start Point (3 bytes, LSB first)
Sustain Loop End Point (3 bytes, LSB first)
Loop Type
Eox
SAMPLE DUMP DATA FORMAT: DATA PACKET:
Sysex
ID: Universal Non-Real Time
Channel Number
Sub ID: Data Packet
Packet Number
Sample Data (120 bytes)
Checksum
Eox
SAMPLE DUMP MESSAGES: DUMP REQUEST:
Sysex
ID: Universal Non-Real Time
Channel Number
Sub ID: Dump Request
Sample Number (2 bytes, LSB first)
Eox
SAMPLE DUMP MESSAGES: HANDSHAKING FLAGS:
Sysex
ID: Universal Non-Real Time
Channel Number
Sub ID: ACK or NAK or CANCEL or WAIT
Packet Number
Eox