/[svn]/web/trunk/www.linuxsampler.org/api/draft-linuxsampler-protocol.html

Diff of /web/trunk/www.linuxsampler.org/api/draft-linuxsampler-protocol.html

Parent Directory | Revision Log | View Patch Patch

-revision 1572 by schoenebeck,
Fri Dec  7 01:07:11 2007 UTC
+revision 1773 by iliev,
Wed Sep 10 15:14:31 2008 UTC
 Line 145
  <tr><td class="header">LinuxSampler Developers</td><td class="header">C. Schoenebeck</td></tr>
  <tr><td class="header">Internet-Draft</td><td class="header">Interessengemeinschaft Software</td></tr>
  <tr><td class="header">Intended status: Standards Track</td><td class="header">Engineering e. V.</td></tr>
- <tr><td class="header">Expires: June 7, 2008</td><td class="header">December 5, 2007</td></tr>
+ <tr><td class="header">Expires: March 14, 2009</td><td class="header">September 10, 2008</td></tr>
  </table></td></tr></table>
- <h1><br />LinuxSampler Control Protocol<br />LSCP 1.3</h1>
+ <h1><br />LinuxSampler Control Protocol<br />LSCP 1.4</h1>
  <h3>Status of this Memo</h3>
  <p>
 Line 173 
 The list of current Internet-Drafts can
  The list of Internet-Draft Shadow Directories can be accessed at
  <a href='http://www.ietf.org/shadow.html'>http://www.ietf.org/shadow.html</a>.</p>
  <p>
- This Internet-Draft will expire on June 7, 2008.</p>
+ This Internet-Draft will expire on March 14, 2009.</p>
  <h3>Copyright Notice</h3>
  <p>
- Copyright &copy; The IETF Trust (2007).</p>
+ Copyright &copy; The IETF Trust (2008).</p>
  <h3>Abstract</h3>
 Line 336 
 Altering effect send's audio routing<br
  Altering effect send's MIDI controller<br />
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET FX_SEND LEVEL">6.4.33.</a>&nbsp;
  Altering effect send's send level<br />
- &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#RESET CHANNEL">6.4.34.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SEND CHANNEL MIDI_DATA">6.4.34.</a>&nbsp;
+ Sending MIDI messages to sampler channel<br />
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#RESET CHANNEL">6.4.35.</a>&nbsp;
  Resetting a sampler channel<br />
  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor12">6.5.</a>&nbsp;
  Controlling connection<br />
-Line 436 
 Finding instruments<br />
+Line 438 
 Finding instruments<br />
  Getting job status information<br />
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#FORMAT INSTRUMENTS_DB">6.8.22.</a>&nbsp;
  Formatting the instruments database<br />
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#FIND LOST DB_INSTRUMENT_FILES">6.8.23.</a>&nbsp;
+ Checking for lost instrument files<br />
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET DB_INSTRUMENT FILE_PATH">6.8.24.</a>&nbsp;
+ Replacing an instrument file<br />
  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#editing_instruments">6.9.</a>&nbsp;
  Editing Instruments<br />
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#EDIT INSTRUMENT">6.9.1.</a>&nbsp;
-Line 464 
 Number of MIDI input devices changed<br
+Line 470 
 Number of MIDI input devices changed<br
  MIDI input device's settings changed<br />
  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL_COUNT">8.5.</a>&nbsp;
  Number of sampler channels changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE VOICE_COUNT">8.6.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL_MIDI">8.6.</a>&nbsp;
+ MIDI data on a sampler channel arrived<br />
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DEVICE_MIDI">8.7.</a>&nbsp;
+ MIDI data on a MIDI input device arrived<br />
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE VOICE_COUNT">8.8.</a>&nbsp;
  Number of active voices changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE STREAM_COUNT">8.7.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE STREAM_COUNT">8.9.</a>&nbsp;
  Number of active disk streams changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE BUFFER_FILL">8.8.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE BUFFER_FILL">8.10.</a>&nbsp;
  Disk stream buffer fill state changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL_INFO">8.9.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL_INFO">8.11.</a>&nbsp;
  Channel information changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE FX_SEND_COUNT">8.10.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE FX_SEND_COUNT">8.12.</a>&nbsp;
  Number of effect sends changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE FX_SEND_INFO">8.11.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE FX_SEND_INFO">8.13.</a>&nbsp;
  Effect send information changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE TOTAL_VOICE_COUNT">8.12.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE TOTAL_VOICE_COUNT">8.14.</a>&nbsp;
  Total number of active voices changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE TOTAL_STREAM_COUNT">8.13.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE TOTAL_STREAM_COUNT">8.15.</a>&nbsp;
  Total number of active disk streams changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT">8.14.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT">8.16.</a>&nbsp;
  Number of MIDI instrument maps changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO">8.15.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO">8.17.</a>&nbsp;
  MIDI instrument map information changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_COUNT">8.16.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_COUNT">8.18.</a>&nbsp;
  Number of MIDI instruments changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_INFO">8.17.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_INFO">8.19.</a>&nbsp;
  MIDI instrument information changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE GLOBAL_INFO">8.18.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE GLOBAL_INFO">8.20.</a>&nbsp;
  Global settings changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_DIRECTORY_COUNT">8.19.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_DIRECTORY_COUNT">8.21.</a>&nbsp;
  Number of database instrument directories changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_DIRECTORY_INFO">8.20.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_DIRECTORY_INFO">8.22.</a>&nbsp;
  Database instrument directory information changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_COUNT">8.21.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_COUNT">8.23.</a>&nbsp;
  Number of database instruments changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_INFO">8.22.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_INFO">8.24.</a>&nbsp;
  Database instrument information changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENTS_JOB_INFO">8.23.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENTS_JOB_INFO">8.25.</a>&nbsp;
  Database job status information changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MISCELLANEOUS">8.24.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MISCELLANEOUS">8.26.</a>&nbsp;
  Miscellaneous and debugging events<br />
  <a href="#anchor14">9.</a>&nbsp;
  Security Considerations<br />
-Line 5741 
 Altering effect send's send level</h3>
+Line 5751 
 Altering effect send's send level</h3>
  </blockquote><p>
  </p>
- <a name="RESET CHANNEL"></a><br /><hr />
+ <a name="SEND CHANNEL MIDI_DATA"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
  <a name="rfc.section.6.4.34"></a><h3>6.4.34.&nbsp;
+ Sending MIDI messages to sampler channel</h3>
+ <p>The front-end can send MIDI events to specific sampler channel
+                     by sending the following command:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>SEND CHANNEL MIDI_DATA &lt;midi-msg&gt; &lt;sampler-chan&gt; &lt;arg1&gt; &lt;arg2&gt;
+ </p>
+ </blockquote><p>
+ </p>
+ <p>Where &lt;sampler-chan&gt; is the sampler channel number
+                     as returned by the <a class='info' href='#ADD CHANNEL'>"ADD CHANNEL"<span> (</span><span class='info'>Adding a new sampler channel</span><span>)</span></a>
+                     or <a class='info' href='#LIST CHANNELS'>"LIST CHANNELS"<span> (</span><span class='info'>Getting all created sampler channel list</span><span>)</span></a> command,
+                     &lt;arg1&gt; and &lt;arg2&gt; arguments depend on the &lt;midi-msg&gt; argument, which
+                     specifies the MIDI message type. Currently, the following MIDI messages are supported:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>"NOTE_ON" -
+                                 </p>
+ <blockquote class="text">
+ <p>For turning on MIDI notes, where &lt;arg1&gt;
+                                     specifies the key number and &lt;arg2&gt; the velocity
+                                     as described in the MIDI specification.
+ </p>
+ </blockquote>
+ <p>"NOTE_OFF" -
+                                 </p>
+ <blockquote class="text">
+ <p>For turning a currently playing MIDI note off, where &lt;arg1&gt;
+                                     specifies the key number and &lt;arg2&gt; the velocity
+                                     as described in the MIDI specification.
+ </p>
+ </blockquote>
+ </blockquote><p>
+ </p>
+ <p>CAUTION: This command is provided for implementations of virtual MIDI keyboards
+                     and no realtime guarantee whatsoever will be made!
+ </p>
+ <p>Possible Answers:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>"OK" -
+                                 </p>
+ <blockquote class="text">
+ <p>on success
+ </p>
+ </blockquote>
+ <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
+                                 </p>
+ <blockquote class="text">
+ <p>in case it failed, providing an appropriate error code and error message
+ </p>
+ </blockquote>
+ </blockquote><p>
+ </p>
+ <p>Example:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>C: "SEND CHANNEL MIDI_DATA NOTE_ON 0 56 112"
+ </p>
+ <p>S: "OK"
+ </p>
+ </blockquote><p>
+ </p>
+ <a name="RESET CHANNEL"></a><br /><hr />
+ <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
+ <a name="rfc.section.6.4.35"></a><h3>6.4.35.&nbsp;
  Resetting a sampler channel</h3>
  <p>The front-end can reset a particular sampler channel by sending the following command:
-Line 9100 
 Formatting the instruments database</h3>
+Line 9197 
 Formatting the instruments database</h3>
  </blockquote><p>
  </p>
+ <a name="FIND LOST DB_INSTRUMENT_FILES"></a><br /><hr />
+ <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
+ <a name="rfc.section.6.8.23"></a><h3>6.8.23.&nbsp;
+ Checking for lost instrument files</h3>
+ <p>The front-end can retrieve the list of all instrument files in the instruments database
+                     that don't exist in the filesystem by sending the following command:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>FIND LOST DB_INSTRUMENT_FILES
+ </p>
+ </blockquote><p>
+ </p>
+ <p>Possible Answers:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>A comma separated list with the absolute path names
+                             (encapsulated into apostrophes) of all lost instrument files.
+ </p>
+ <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
+                                 </p>
+ <blockquote class="text">
+ <p>in case it failed, providing an appropriate error code and error message.
+ </p>
+ </blockquote>
+ </blockquote><p>
+ </p>
+ <p>Example:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>C: "FIND LOST DB_INSTRUMENT_FILES"
+ </p>
+ <p>S: "'/gigs/Bosendorfer 290.gig','/gigs/Steinway D.gig','/gigs/Free Piano.gig'"
+ </p>
+ </blockquote><p>
+ </p>
+ <a name="SET DB_INSTRUMENT FILE_PATH"></a><br /><hr />
+ <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
+ <a name="rfc.section.6.8.24"></a><h3>6.8.24.&nbsp;
+ Replacing an instrument file</h3>
+ <p>The front-end can substitute all occurrences of an instrument file
+                     in the instruments database with a new one by sending the following command:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>SET DB_INSTRUMENT FILE_PATH &lt;old_path&gt; &lt;new_path&gt;
+ </p>
+ </blockquote><p>
+ </p>
+ <p>Where &lt;old_path&gt; is the absolute path name of the instrument file
+                     to substitute with &lt;new_path&gt;.
+ </p>
+ <p>Possible Answers:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>"OK" -
+                                 </p>
+ <blockquote class="text">
+ <p>on success
+ </p>
+ </blockquote>
+ <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
+                                 </p>
+ <blockquote class="text">
+ <p>in case it failed, providing an appropriate error code and error message.
+ </p>
+ </blockquote>
+ </blockquote><p>
+ </p>
+ <p>Example:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>C: "SET DB_INSTRUMENT FILE_PATH '/gigs/Bosendorfer 290.gig' '/gigs/pianos/Bosendorfer 290.gig'"
+ </p>
+ <p>S: "OK"
+ </p>
+ </blockquote><p>
+ </p>
  <a name="editing_instruments"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
  <a name="rfc.section.6.9"></a><h3>6.9.&nbsp;
-Line 9423 
 Retrieving informations about one instru
+Line 9622 
 Retrieving informations about one instru
  </blockquote>
+ <p>KEY_BINDINGS -
+                                         </p>
+ <blockquote class="text">
+ <p>comma separated list of integer values representing
+                                                the instrument's key mapping in the range between 0 .. 127,
+                                                reflecting the analog meaning of the MIDI specification.
+ </p>
+ </blockquote>
+ <p>KEYSWITCH_BINDINGS -
+                                         </p>
+ <blockquote class="text">
+ <p>comma separated list of integer values representing
+                                                the instrument's keyswitch mapping in the range between 0 .. 127,
+                                                reflecting the analog meaning of the MIDI specification.
+ </p>
+ </blockquote>
  </blockquote>
-Line 9572 
 Command Syntax</h3>
+Line 9791 
 Command Syntax</h3>
  </p>
  <p>/ FORMAT SP format_instruction
+ </p>
+ <p>SEND SP send_instruction
  </p>
  <p>/ RESET
-Line 9637 
 Command Syntax</h3>
+Line 9859 
 Command Syntax</h3>
  <p>/ CHANNEL_COUNT
  </p>
+ <p>/ CHANNEL_MIDI
+ </p>
+ <p>/ DEVICE_MIDI
+ </p>
  <p>/ VOICE_COUNT
  </p>
-Line 9715 
 Command Syntax</h3>
+Line 9943 
 Command Syntax</h3>
  <p>/ CHANNEL_COUNT
  </p>
+ <p>/ CHANNEL_MIDI
+ </p>
+ <p>/ DEVICE_MIDI
+ </p>
  <p>/ VOICE_COUNT
  </p>
-Line 10012 
 Command Syntax</h3>
+Line 10246 
 Command Syntax</h3>
  <p>/ DB_INSTRUMENT SP DESCRIPTION SP db_path SP stringval_escaped
  </p>
+ <p>/ DB_INSTRUMENT SP FILE_PATH SP filename SP filename
+ </p>
  <p>/ ECHO SP boolean
  </p>
-Line 10081 
 Command Syntax</h3>
+Line 10318 
 Command Syntax</h3>
  <p>/ DB_INSTRUMENT_DIRECTORIES SP db_path SP query_val_list
  </p>
+ <p>/ LOST SP DB_INSTRUMENT_FILES
+ </p>
  </blockquote><p>
  </p>
-Line 10288 
 Command Syntax</h3>
+Line 10528 
 Command Syntax</h3>
  </blockquote><p>
  </p>
+ <p>send_instruction =
+         </p>
+ <blockquote class="text">
+ <p>CHANNEL SP MIDI_DATA SP string SP sampler_channel SP number SP number
+ </p>
+ </blockquote><p>
+ </p>
  <p>load_instr_args =
          </p>
  <blockquote class="text">
-Line 10698 
 Character Set and Escape Sequences</h3>
+Line 10947 
 Character Set and Escape Sequences</h3>
  </p>
  <p><a class='info' href='#COPY DB_INSTRUMENT_DIRECTORY'>"COPY DB_INSTRUMENT_DIRECTORY"<span> (</span><span class='info'>Copying instrument directories</span><span>)</span></a>
  </p>
+ <p><a class='info' href='#FIND LOST DB_INSTRUMENT_FILES'>"FIND LOST DB_INSTRUMENT_FILES"<span> (</span><span class='info'>Checking for lost instrument files</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#SET DB_INSTRUMENT FILE_PATH'>"SET DB_INSTRUMENT FILE_PATH"<span> (</span><span class='info'>Replacing an instrument file</span><span>)</span></a>
+ </p>
  <p><a class='info' href='#GET FILE INSTRUMENTS'>"GET FILE INSTRUMENTS"<span> (</span><span class='info'>Retrieving amount of instruments of a file</span><span>)</span></a>
  </p>
  <p><a class='info' href='#LIST FILE INSTRUMENTS'>"LIST FILE INSTRUMENTS"<span> (</span><span class='info'>Retrieving all instruments of a file</span><span>)</span></a>
-Line 10934 
 Number of sampler channels changed</h3>
+Line 11187 
 Number of sampler channels changed</h3>
  <p>where &lt;channels&gt; will be replaced by the new number
                  of sampler channels.
  </p>
- <a name="SUBSCRIBE VOICE_COUNT"></a><br /><hr />
+ <a name="SUBSCRIBE CHANNEL_MIDI"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
  <a name="rfc.section.8.6"></a><h3>8.6.&nbsp;
+ MIDI data on a sampler channel arrived</h3>
+ <p>Client may want to be notified when MIDI data arrive on sampler channels on
+                 back-end side, by issuing the following command:
+ </p>
+ <p>
+                     </p>
+ <blockquote class="text">
+ <p>SUBSCRIBE CHANNEL_MIDI
+ </p>
+ </blockquote><p>
+ </p>
+ <p>Server will start sending one of the the following notification messages:
+ </p>
+ <p>
+                     </p>
+ <blockquote class="text">
+ <p>"NOTIFY:CHANNEL_MIDI:&lt;channel-id&gt; NOTE_ON  &lt;note&gt; &lt;velocity&gt;"
+ </p>
+ <p>"NOTIFY:CHANNEL_MIDI:&lt;channel-id&gt; NOTE_OFF &lt;note&gt; &lt;velocity&gt;"
+ </p>
+ </blockquote><p>
+ </p>
+ <p>where &lt;channel-id&gt; will be replaced by the ID of the sampler channel where the MIDI
+                 data arrived. &lt;note&gt; and &lt;velocity&gt; are integer values in the range between
+.. 127, reflecting the analog meaning of the MIDI specification.
+ </p>
+ <p>CAUTION: no guarantee whatsoever will be made that MIDI events are actually all
+                 delivered by this mechanism! With other words: events could be lost at any time!
+                 This restriction was made to keep the RT-safeness of the backend's MIDI and audio
+                 thread unaffected by this feature.
+ </p>
+ <a name="SUBSCRIBE DEVICE_MIDI"></a><br /><hr />
+ <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
+ <a name="rfc.section.8.7"></a><h3>8.7.&nbsp;
+ MIDI data on a MIDI input device arrived</h3>
+ <p>Client may want to be notified when MIDI data arrive on MIDI input devices by issuing the following command:
+ </p>
+ <p>
+                             </p>
+ <blockquote class="text">
+ <p>SUBSCRIBE DEVICE_MIDI
+ </p>
+ </blockquote><p>
+ </p>
+ <p>Server will start sending one of the the following notification messages:
+ </p>
+ <p>
+                             </p>
+ <blockquote class="text">
+ <p>"NOTIFY:DEVICE_MIDI:&lt;device-id&gt; &lt;port-id&gt; NOTE_ON &lt;note&gt; &lt;velocity&gt;"
+ </p>
+ <p>"NOTIFY:DEVICE_MIDI:&lt;device-id&gt; &lt;port-id&gt; NOTE_OFF &lt;note&gt; &lt;velocity&gt;"
+ </p>
+ </blockquote><p>
+ </p>
+ <p>where &lt;device-id&gt; &lt;port-id&gt; will be replaced
+                        by the IDs of the respective MIDI input device and the device's MIDI port where the MIDI
+                        data arrived. &lt;note&gt; and &lt;velocity&gt; are integer values in the range between
+.. 127, reflecting the analog meaning of the MIDI specification.
+ </p>
+ <p>CAUTION: no guarantee whatsoever will be made that MIDI events are actually all
+                        delivered by this mechanism! With other words: events could be lost at any time!
+                        This restriction was made to keep the RT-safeness of the backend's MIDI and audio
+                        thread unaffected by this feature.
+ </p>
+ <a name="SUBSCRIBE VOICE_COUNT"></a><br /><hr />
+ <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
+ <a name="rfc.section.8.8"></a><h3>8.8.&nbsp;
  Number of active voices changed</h3>
  <p>Client may want to be notified when the number of voices on the
-Line 10966 
 Number of active voices changed</h3>
+Line 11295 
 Number of active voices changed</h3>
  </p>
  <a name="SUBSCRIBE STREAM_COUNT"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.7"></a><h3>8.7.&nbsp;
+ <a name="rfc.section.8.9"></a><h3>8.9.&nbsp;
  Number of active disk streams changed</h3>
  <p>Client may want to be notified when the number of streams on the back-end
-Line 10996 
 Number of active disk streams changed</h
+Line 11325 
 Number of active disk streams changed</h
  </p>
  <a name="SUBSCRIBE BUFFER_FILL"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.8"></a><h3>8.8.&nbsp;
+ <a name="rfc.section.8.10"></a><h3>8.10.&nbsp;
  Disk stream buffer fill state changed</h3>
  <p>Client may want to be notified when the buffer fill state of a disk stream
-Line 11027 
 Disk stream buffer fill state changed</h
+Line 11356 
 Disk stream buffer fill state changed</h
  </p>
  <a name="SUBSCRIBE CHANNEL_INFO"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.9"></a><h3>8.9.&nbsp;
+ <a name="rfc.section.8.11"></a><h3>8.11.&nbsp;
  Channel information changed</h3>
  <p>Client may want to be notified when changes were made to sampler channels on the
-Line 11060 
 Channel information changed</h3>
+Line 11389 
 Channel information changed</h3>
  </p>
  <a name="SUBSCRIBE FX_SEND_COUNT"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.10"></a><h3>8.10.&nbsp;
+ <a name="rfc.section.8.12"></a><h3>8.12.&nbsp;
  Number of effect sends changed</h3>
  <p>Client may want to be notified when the number of effect sends on
-Line 11090 
 Number of effect sends changed</h3>
+Line 11419 
 Number of effect sends changed</h3>
  </p>
  <a name="SUBSCRIBE FX_SEND_INFO"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.11"></a><h3>8.11.&nbsp;
+ <a name="rfc.section.8.13"></a><h3>8.13.&nbsp;
  Effect send information changed</h3>
  <p>Client may want to be notified when changes were made to effect sends on a
-Line 11120 
 Effect send information changed</h3>
+Line 11449 
 Effect send information changed</h3>
  </p>
  <a name="SUBSCRIBE TOTAL_VOICE_COUNT"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.12"></a><h3>8.12.&nbsp;
+ <a name="rfc.section.8.14"></a><h3>8.14.&nbsp;
  Total number of active voices changed</h3>
  <p>Client may want to be notified when the total number of voices on the
-Line 11149 
 Total number of active voices changed</h
+Line 11478 
 Total number of active voices changed</h
  </p>
  <a name="SUBSCRIBE TOTAL_STREAM_COUNT"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.13"></a><h3>8.13.&nbsp;
+ <a name="rfc.section.8.15"></a><h3>8.15.&nbsp;
  Total number of active disk streams changed</h3>
  <p>Client may want to be notified when the total number of disk streams on the
-Line 11178 
 Total number of active disk streams chan
+Line 11507 
 Total number of active disk streams chan
  </p>
  <a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.14"></a><h3>8.14.&nbsp;
+ <a name="rfc.section.8.16"></a><h3>8.16.&nbsp;
  Number of MIDI instrument maps changed</h3>
  <p>Client may want to be notified when the number of MIDI instrument maps on the
-Line 11207 
 Number of MIDI instrument maps changed</
+Line 11536 
 Number of MIDI instrument maps changed</
  </p>
  <a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.15"></a><h3>8.15.&nbsp;
+ <a name="rfc.section.8.17"></a><h3>8.17.&nbsp;
  MIDI instrument map information changed</h3>
  <p>Client may want to be notified when changes were made to MIDI instrument maps on the
-Line 11240 
 MIDI instrument map information changed<
+Line 11569 
 MIDI instrument map information changed<
  </p>
  <a name="SUBSCRIBE MIDI_INSTRUMENT_COUNT"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.16"></a><h3>8.16.&nbsp;
+ <a name="rfc.section.8.18"></a><h3>8.18.&nbsp;
  Number of MIDI instruments changed</h3>
  <p>Client may want to be notified when the number of MIDI instrument maps on the
-Line 11270 
 Number of MIDI instruments changed</h3>
+Line 11599 
 Number of MIDI instruments changed</h3>
  </p>
  <a name="SUBSCRIBE MIDI_INSTRUMENT_INFO"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.17"></a><h3>8.17.&nbsp;
+ <a name="rfc.section.8.19"></a><h3>8.19.&nbsp;
  MIDI instrument information changed</h3>
  <p>Client may want to be notified when changes were made to MIDI instruments on the
-Line 11304 
 MIDI instrument information changed</h3>
+Line 11633 
 MIDI instrument information changed</h3>
  </p>
  <a name="SUBSCRIBE GLOBAL_INFO"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.18"></a><h3>8.18.&nbsp;
+ <a name="rfc.section.8.20"></a><h3>8.20.&nbsp;
  Global settings changed</h3>
  <p>Client may want to be notified when changes to the global settings
-Line 11333 
 Global settings changed</h3>
+Line 11662 
 Global settings changed</h3>
  </p>
  <a name="SUBSCRIBE DB_INSTRUMENT_DIRECTORY_COUNT"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.19"></a><h3>8.19.&nbsp;
+ <a name="rfc.section.8.21"></a><h3>8.21.&nbsp;
  Number of database instrument directories changed</h3>
  <p>Client may want to be notified when the number of instrument
-Line 11367 
 Number of database instrument directorie
+Line 11696 
 Number of database instrument directorie
  </p>
  <a name="SUBSCRIBE DB_INSTRUMENT_DIRECTORY_INFO"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.20"></a><h3>8.20.&nbsp;
+ <a name="rfc.section.8.22"></a><h3>8.22.&nbsp;
  Database instrument directory information changed</h3>
  <p>Client may want to be notified when changes were made to directories
-Line 11412 
 Database instrument directory informatio
+Line 11741 
 Database instrument directory informatio
  </p>
  <a name="SUBSCRIBE DB_INSTRUMENT_COUNT"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.21"></a><h3>8.21.&nbsp;
+ <a name="rfc.section.8.23"></a><h3>8.23.&nbsp;
  Number of database instruments changed</h3>
  <p>Client may want to be notified when the number of instruments
-Line 11446 
 Number of database instruments changed</
+Line 11775 
 Number of database instruments changed</
  </p>
  <a name="SUBSCRIBE DB_INSTRUMENT_INFO"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.22"></a><h3>8.22.&nbsp;
+ <a name="rfc.section.8.24"></a><h3>8.24.&nbsp;
  Database instrument information changed</h3>
  <p>Client may want to be notified when changes were made to instruments
-Line 11491 
 Database instrument information changed<
+Line 11820 
 Database instrument information changed<
  </p>
  <a name="SUBSCRIBE DB_INSTRUMENTS_JOB_INFO"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.23"></a><h3>8.23.&nbsp;
+ <a name="rfc.section.8.25"></a><h3>8.25.&nbsp;
  Database job status information changed</h3>
  <p>Client may want to be notified when the status of particular database
-Line 11524 
 Database job status information changed<
+Line 11853 
 Database job status information changed<
  </p>
  <a name="SUBSCRIBE MISCELLANEOUS"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.24"></a><h3>8.24.&nbsp;
+ <a name="rfc.section.8.26"></a><h3>8.26.&nbsp;
  Miscellaneous and debugging events</h3>
  <p>Client may want to be notified of miscellaneous and debugging events occurring at
-Line 11621 
 Schoenebeck</td></tr>
+Line 11950 
 Schoenebeck</td></tr>
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
  <h3>Full Copyright Statement</h3>
  <p class='copyright'>
- Copyright &copy; The IETF Trust (2007).</p>
+ Copyright &copy; The IETF Trust (2008).</p>
  <p class='copyright'>
  This document is subject to the rights,
  licenses and restrictions contained in BCP&nbsp;78,
-Line 11668 
 Please address the information to the IE
+Line 11997 
 Please address the information to the IE
  Funding for the RFC Editor function is provided by
  the IETF Administrative Support Activity (IASA).</p>
  </body></html>

 Legend:



Removed from v.1572
 


changed lines


 
Added in v.1773
 Legend:



Removed from v.1572
 


changed lines


 
Added in v.1773
-Removed from v.1572
+Added in v.1773

	ViewVC Help
Powered by ViewVC