                           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
