/[svn]/linuxsampler/trunk/src/network/lscpserver.cpp

Diff of /linuxsampler/trunk/src/network/lscpserver.cpp

Parent Directory | Revision Log | View Patch Patch

-revision 121 by senkov,
Sat Jun 12 07:46:02 2004 UTC
+revision 1005 by schoenebeck,
Fri Dec 29 20:06:14 2006 UTC
 Line 3
   *   LinuxSampler - modular, streaming capable sampler                     *
   *                                                                         *
   *   Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck   *
+  *   Copyright (C) 2005, 2006 Christian Schoenebeck                        *
   *                                                                         *
-  *   This program is free software; you can redistribute it and/or modify  *
+  *   This library is free software; you can redistribute it and/or modify  *
   *   it under the terms of the GNU General Public License as published by  *
   *   the Free Software Foundation; either version 2 of the License, or     *
   *   (at your option) any later version.                                   *
   *                                                                         *
-  *   This program is distributed in the hope that it will be useful,       *
+  *   This library is distributed in the hope that it will be useful,       *
   *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
   *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
   *   GNU General Public License for more details.                          *
   *                                                                         *
   *   You should have received a copy of the GNU General Public License     *
-  *   along with this program; if not, write to the Free Software           *
+  *   along with this library; if not, write to the Free Software           *
   *   Foundation, Inc., 59 Temple Place, Suite 330, Boston,                 *
   *   MA  02111-1307  USA                                                   *
   ***************************************************************************/
  #include "lscpserver.h"
  #include "lscpresultset.h"
+ #include "lscpevent.h"
+ #include "../common/global.h"
- #include "../engines/gig/Engine.h"
+ #include <fcntl.h>
- LSCPServer::LSCPServer(Sampler* pSampler) : Thread(false, 0, -4) {
+ #if HAVE_SQLITE3
+ # include "sqlite3.h"
+ #endif
+ #include "../engines/EngineFactory.h"
+ #include "../engines/EngineChannelFactory.h"
+ #include "../drivers/audio/AudioOutputDeviceFactory.h"
+ #include "../drivers/midi/MidiInputDeviceFactory.h"
+ /**
+  * Below are a few static members of the LSCPServer class.
+  * The big assumption here is that LSCPServer is going to remain a singleton.
+  * These members are used to support client connections.
+  * Class handles multiple connections at the same time using select() and non-blocking recv()
+  * Commands are processed by a single LSCPServer thread.
+  * Notifications are delivered either by the thread that originated them
+  * or (if the resultset is currently in progress) by the LSCPServer thread
+  * after the resultset was sent out.
+  * This makes sure that resultsets can not be interrupted by notifications.
+  * This also makes sure that the thread sending notification is not blocked
+  * by the LSCPServer thread.
+  */
+ fd_set LSCPServer::fdSet;
+ int LSCPServer::currentSocket = -1;
+ std::vector<yyparse_param_t> LSCPServer::Sessions = std::vector<yyparse_param_t>();
+ std::map<int,String> LSCPServer::bufferedNotifies = std::map<int,String>();
+ std::map<int,String> LSCPServer::bufferedCommands = std::map<int,String>();
+ std::map< LSCPEvent::event_t, std::list<int> > LSCPServer::eventSubscriptions = std::map< LSCPEvent::event_t, std::list<int> >();
+ Mutex LSCPServer::NotifyMutex = Mutex();
+ Mutex LSCPServer::NotifyBufferMutex = Mutex();
+ Mutex LSCPServer::SubscriptionMutex = Mutex();
+ Mutex LSCPServer::RTNotifyMutex = Mutex();
+ LSCPServer::LSCPServer(Sampler* pSampler, long int addr, short int port) : Thread(true, false, 0, -4) {
+     SocketAddress.sin_family      = AF_INET;
+     SocketAddress.sin_addr.s_addr = addr;
+     SocketAddress.sin_port        = port;
      this->pSampler = pSampler;
+     LSCPEvent::RegisterEvent(LSCPEvent::event_audio_device_count, "AUDIO_OUTPUT_DEVICE_COUNT");
+     LSCPEvent::RegisterEvent(LSCPEvent::event_audio_device_info, "AUDIO_OUTPUT_DEVICE_INFO");
+     LSCPEvent::RegisterEvent(LSCPEvent::event_midi_device_count, "MIDI_INPUT_DEVICE_COUNT");
+     LSCPEvent::RegisterEvent(LSCPEvent::event_midi_device_info, "MIDI_INPUT_DEVICE_INFO");
+     LSCPEvent::RegisterEvent(LSCPEvent::event_channel_count, "CHANNEL_COUNT");
+     LSCPEvent::RegisterEvent(LSCPEvent::event_voice_count, "VOICE_COUNT");
+     LSCPEvent::RegisterEvent(LSCPEvent::event_stream_count, "STREAM_COUNT");
+     LSCPEvent::RegisterEvent(LSCPEvent::event_buffer_fill, "BUFFER_FILL");
+     LSCPEvent::RegisterEvent(LSCPEvent::event_channel_info, "CHANNEL_INFO");
+     LSCPEvent::RegisterEvent(LSCPEvent::event_midi_instr_map_count, "MIDI_INSTRUMENT_MAP_COUNT");
+     LSCPEvent::RegisterEvent(LSCPEvent::event_midi_instr_map_info, "MIDI_INSTRUMENT_MAP_INFO");
+     LSCPEvent::RegisterEvent(LSCPEvent::event_midi_instr_count, "MIDI_INSTRUMENT_COUNT");
+     LSCPEvent::RegisterEvent(LSCPEvent::event_midi_instr_info, "MIDI_INSTRUMENT_INFO");
+     LSCPEvent::RegisterEvent(LSCPEvent::event_misc, "MISCELLANEOUS");
+     LSCPEvent::RegisterEvent(LSCPEvent::event_total_voice_count, "TOTAL_VOICE_COUNT");
+     hSocket = -1;
+ }
+ LSCPServer::~LSCPServer() {
+     if (hSocket >= 0) close(hSocket);
+ }
+ /**
+  * Blocks the calling thread until the LSCP Server is initialized and
+  * accepting socket connections, if the server is already initialized then
+  * this method will return immediately.
+  * @param TimeoutSeconds     - optional: max. wait time in seconds
+  *                             (default: 0s)
+  * @param TimeoutNanoSeconds - optional: max wait time in nano seconds
+  *                             (default: 0ns)
+  * @returns  0 on success, a value less than 0 if timeout exceeded
+  */
+ int LSCPServer::WaitUntilInitialized(long TimeoutSeconds, long TimeoutNanoSeconds) {
+     return Initialized.WaitAndUnlockIf(false, TimeoutSeconds, TimeoutNanoSeconds);
  }
  int LSCPServer::Main() {
-Line 37 
 int LSCPServer::Main() {
+Line 110 
 int LSCPServer::Main() {
          exit(EXIT_FAILURE);
      }
-     SocketAddress.sin_family      = AF_INET;
-     SocketAddress.sin_port        = htons(LSCP_PORT);
-     SocketAddress.sin_addr.s_addr = htonl(INADDR_ANY);
      if (bind(hSocket, (sockaddr*) &SocketAddress, sizeof(sockaddr_in)) < 0) {
-         std::cerr << "LSCPServer: Could not bind server socket." << std::endl;
+         std::cerr << "LSCPServer: Could not bind server socket, retrying for " << ToString(LSCP_SERVER_BIND_TIMEOUT) << " seconds...";
-         close(hSocket);
+         for (int trial = 0; true; trial++) { // retry for LSCP_SERVER_BIND_TIMEOUT seconds
-         //return -1;
+             if (bind(hSocket, (sockaddr*) &SocketAddress, sizeof(sockaddr_in)) < 0) {
-         exit(EXIT_FAILURE);
+                 if (trial > LSCP_SERVER_BIND_TIMEOUT) {
+                     std::cerr << "gave up!" << std::endl;
+                     close(hSocket);
+                     //return -1;
+                     exit(EXIT_FAILURE);
+                 }
+                 else sleep(1); // sleep 1s
+             }
+             else break; // success
+         }
      }
      listen(hSocket, 1);
-     dmsg(1,("LSCPServer: Server running.\n")); // server running
+     Initialized.Set(true);
      // now wait for client connections and handle their requests
      sockaddr_in client;
      int length = sizeof(client);
+     FD_ZERO(&fdSet);
+     FD_SET(hSocket, &fdSet);
+     int maxSessions = hSocket;
+     timeval timeout;
      while (true) {
-         hSession = accept(hSocket, (sockaddr*) &client, (socklen_t*) &length);
+         // check if some engine channel's parameter / status changed, if so notify the respective LSCP event subscribers
-         if (hSession < 0) {
+         {
-             std::cerr << "LSCPServer: Client connection failed." << std::endl;
+             std::set<EngineChannel*> engineChannels = EngineChannelFactory::EngineChannelInstances();
-             close(hSocket);
+             std::set<EngineChannel*>::iterator itEngineChannel = engineChannels.begin();
-             //return -1;
+             std::set<EngineChannel*>::iterator itEnd           = engineChannels.end();
-             exit(EXIT_FAILURE);
+             for (; itEngineChannel != itEnd; ++itEngineChannel) {
-         }
+                 if ((*itEngineChannel)->StatusChanged()) {
+                     SendLSCPNotify(LSCPEvent(LSCPEvent::event_channel_info, (*itEngineChannel)->iSamplerChannelIndex));
-         dmsg(1,("LSCPServer: Client connection established.\n"));
+                 }
-         //send(hSession, "Welcome!\r\n", 10, 0);
+             }
+         }
-         // Parser invocation
-         yyparse_param_t yyparse_param;
+         //Now let's deliver late notifies (if any)
-         yyparse_param.pServer = this;
+         NotifyBufferMutex.Lock();
-         yylex_init(&yyparse_param.pScanner);
+         for (std::map<int,String>::iterator iterNotify = bufferedNotifies.begin(); iterNotify != bufferedNotifies.end(); iterNotify++) {
-         while (yyparse(&yyparse_param) == LSCP_SYNTAX_ERROR); // recall parser in case of syntax error
+ #ifdef MSG_NOSIGNAL
-         yylex_destroy(yyparse_param.pScanner);
+                 send(iterNotify->first, iterNotify->second.c_str(), iterNotify->second.size(), MSG_NOSIGNAL);
+ #else
+                 send(iterNotify->first, iterNotify->second.c_str(), iterNotify->second.size(), 0);
+ #endif
+         }
+         bufferedNotifies.clear();
+         NotifyBufferMutex.Unlock();
+         fd_set selectSet = fdSet;
+         timeout.tv_sec  = 0;
+         timeout.tv_usec = 100000;
+         int retval = select(maxSessions+1, &selectSet, NULL, NULL, &timeout);
+         if (retval == 0)
+                 continue; //Nothing try again
+         if (retval == -1) {
+                 std::cerr << "LSCPServer: Socket select error." << std::endl;
+                 close(hSocket);
+                 exit(EXIT_FAILURE);
+         }
-         close(hSession);
+         //Accept new connections now (if any)
-         dmsg(1,("LSCPServer: Client connection terminated.\n"));
+         if (FD_ISSET(hSocket, &selectSet)) {
+                 int socket = accept(hSocket, (sockaddr*) &client, (socklen_t*) &length);
+                 if (socket < 0) {
+                         std::cerr << "LSCPServer: Client connection failed." << std::endl;
+                         exit(EXIT_FAILURE);
+                 }
+                 if (fcntl(socket, F_SETFL, O_NONBLOCK)) {
+                         std::cerr << "LSCPServer: F_SETFL O_NONBLOCK failed." << std::endl;
+                         exit(EXIT_FAILURE);
+                 }
+                 // Parser initialization
+                 yyparse_param_t yyparse_param;
+                 yyparse_param.pServer  = this;
+                 yyparse_param.hSession = socket;
+                 Sessions.push_back(yyparse_param);
+                 FD_SET(socket, &fdSet);
+                 if (socket > maxSessions)
+                         maxSessions = socket;
+                 dmsg(1,("LSCPServer: Client connection established on socket:%d.\n", socket));
+                 LSCPServer::SendLSCPNotify(LSCPEvent(LSCPEvent::event_misc, "Client connection established on socket", socket));
+                 continue; //Maybe this was the only selected socket, better select again
+         }
+         //Something was selected and it was not the hSocket, so it must be some command(s) coming.
+         for (std::vector<yyparse_param_t>::iterator iter = Sessions.begin(); iter != Sessions.end(); iter++) {
+                 if (FD_ISSET((*iter).hSession, &selectSet)) {   //Was it this socket?
+                         if (GetLSCPCommand(iter)) {     //Have we read the entire command?
+                                 dmsg(3,("LSCPServer: Got command on socket %d, calling parser.\n", currentSocket));
+                                 int dummy; // just a temporary hack to fulfill the restart() function prototype
+                                 restart(NULL, dummy); // restart the 'scanner'
+                                 currentSocket = (*iter).hSession;  //a hack
+                                 dmsg(2,("LSCPServer: [%s]\n",bufferedCommands[currentSocket].c_str()));
+                                 if ((*iter).bVerbose) { // if echo mode enabled
+                                     AnswerClient(bufferedCommands[currentSocket]);
+                                 }
+                                 int result = yyparse(&(*iter));
+                                 currentSocket = -1;     //continuation of a hack
+                                 dmsg(3,("LSCPServer: Done parsing on socket %d.\n", currentSocket));
+                                 if (result == LSCP_QUIT) { //Was it a quit command by any chance?
+                                         CloseConnection(iter);
+                                 }
+                         }
+                         //socket may have been closed, iter may be invalid, get out of the loop for now.
+                         //we'll be back if there is data.
+                         break;
+                 }
+         }
      }
  }
+ void LSCPServer::CloseConnection( std::vector<yyparse_param_t>::iterator iter ) {
+         int socket = (*iter).hSession;
+         dmsg(1,("LSCPServer: Client connection terminated on socket:%d.\n",socket));
+         LSCPServer::SendLSCPNotify(LSCPEvent(LSCPEvent::event_misc, "Client connection terminated on socket", socket));
+         Sessions.erase(iter);
+         FD_CLR(socket,  &fdSet);
+         SubscriptionMutex.Lock(); //Must unsubscribe this socket from all events (if any)
+         for (std::map< LSCPEvent::event_t, std::list<int> >::iterator iter = eventSubscriptions.begin(); iter != eventSubscriptions.end(); iter++) {
+                 iter->second.remove(socket);
+         }
+         SubscriptionMutex.Unlock();
+         NotifyMutex.Lock();
+         bufferedCommands.erase(socket);
+         bufferedNotifies.erase(socket);
+         close(socket);
+         NotifyMutex.Unlock();
+ }
+ int LSCPServer::EventSubscribers( std::list<LSCPEvent::event_t> events ) {
+         int subs = 0;
+         SubscriptionMutex.Lock();
+         for( std::list<LSCPEvent::event_t>::iterator iter = events.begin();
+                         iter != events.end(); iter++)
+         {
+                 subs += eventSubscriptions.count(*iter);
+         }
+         SubscriptionMutex.Unlock();
+         return subs;
+ }
+ void LSCPServer::SendLSCPNotify( LSCPEvent event ) {
+         SubscriptionMutex.Lock();
+         if (eventSubscriptions.count(event.GetType()) == 0) {
+                 SubscriptionMutex.Unlock();     //Nobody is subscribed to this event
+                 return;
+         }
+         std::list<int>::iterator iter = eventSubscriptions[event.GetType()].begin();
+         std::list<int>::iterator end = eventSubscriptions[event.GetType()].end();
+         String notify = event.Produce();
+         while (true) {
+                 if (NotifyMutex.Trylock()) {
+                         for(;iter != end; iter++)
+ #ifdef MSG_NOSIGNAL
+                                 send(*iter, notify.c_str(), notify.size(), MSG_NOSIGNAL);
+ #else
+                                 send(*iter, notify.c_str(), notify.size(), 0);
+ #endif
+                         NotifyMutex.Unlock();
+                         break;
+                 } else {
+                         if (NotifyBufferMutex.Trylock()) {
+                                 for(;iter != end; iter++)
+                                         bufferedNotifies[*iter] += notify;
+                                 NotifyBufferMutex.Unlock();
+                                 break;
+                         }
+                 }
+         }
+         SubscriptionMutex.Unlock();
+ }
+ extern int GetLSCPCommand( void *buf, int max_size ) {
+         String command = LSCPServer::bufferedCommands[LSCPServer::currentSocket];
+         if (command.size() == 0) {              //Parser wants input but we have nothing.
+                 strcpy((char*) buf, "\n");      //So give it an empty command
+                 return 1;                       //to keep it happy.
+         }
+         if (max_size < command.size()) {
+                 std::cerr << "getLSCPCommand: Flex buffer too small, ignoring the command." << std::endl;
+                 return 0;       //This will never happen
+         }
+         strcpy((char*) buf, command.c_str());
+         LSCPServer::bufferedCommands.erase(LSCPServer::currentSocket);
+         return command.size();
+ }
+ /**
+  * Will be called to try to read the command from the socket
+  * If command is read, it will return true. Otherwise false is returned.
+  * In any case the received portion (complete or incomplete) is saved into bufferedCommand map.
+  */
+ bool LSCPServer::GetLSCPCommand( std::vector<yyparse_param_t>::iterator iter ) {
+         int socket = (*iter).hSession;
+         char c;
+         int i = 0;
+         while (true) {
+                 int result = recv(socket, (void *)&c, 1, 0); //Read one character at a time for now
+                 if (result == 0) { //socket was selected, so 0 here means client has closed the connection
+                         CloseConnection(iter);
+                         break;
+                 }
+                 if (result == 1) {
+                         if (c == '\r')
+                                 continue; //Ignore CR
+                         if (c == '\n') {
+                                 LSCPServer::SendLSCPNotify(LSCPEvent(LSCPEvent::event_misc, "Received \'" + bufferedCommands[socket] + "\' on socket", socket));
+                                 bufferedCommands[socket] += "\r\n";
+                                 return true; //Complete command was read
+                         }
+                         bufferedCommands[socket] += c;
+                 }
+                 if (result == -1) {
+                         if (errno == EAGAIN) //Would block, try again later.
+                                 return false;
+                         switch(errno) {
+                                 case EBADF:
+                                         dmsg(2,("LSCPScanner: The argument s is an invalid descriptor.\n"));
+                                         break;
+                                 case ECONNREFUSED:
+                                         dmsg(2,("LSCPScanner: A remote host refused to allow the network connection (typically because it is not running the requested service).\n"));
+                                         break;
+                                 case ENOTCONN:
+                                         dmsg(2,("LSCPScanner: The socket is associated with a connection-oriented protocol and has not been connected (see connect(2) and accept(2)).\n"));
+                                         break;
+                                 case ENOTSOCK:
+                                         dmsg(2,("LSCPScanner: The argument s does not refer to a socket.\n"));
+                                         break;
+                                 case EAGAIN:
+                                         dmsg(2,("LSCPScanner: The socket is marked non-blocking and the receive operation would block, or a receive timeout had been set and the timeout expired before data was received.\n"));
+                                         break;
+                                 case EINTR:
+                                         dmsg(2,("LSCPScanner: The receive was interrupted by delivery of a signal before any data were available.\n"));
+                                         break;
+                                 case EFAULT:
+                                         dmsg(2,("LSCPScanner: The receive buffer pointer(s) point outside the process's address space.\n"));
+                                         break;
+                                 case EINVAL:
+                                         dmsg(2,("LSCPScanner: Invalid argument passed.\n"));
+                                         break;
+                                 case ENOMEM:
+                                         dmsg(2,("LSCPScanner: Could not allocate memory for recvmsg.\n"));
+                                         break;
+                                 default:
+                                         dmsg(2,("LSCPScanner: Unknown recv() error.\n"));
+                                         break;
+                         }
+                         CloseConnection(iter);
+                         break;
+                 }
+         }
+         return false;
+ }
  /**
   * Will be called by the parser whenever it wants to send an answer to the
   * client / frontend.
-Line 86 
 int LSCPServer::Main() {
+Line 385 
 int LSCPServer::Main() {
   */
  void LSCPServer::AnswerClient(String ReturnMessage) {
      dmsg(2,("LSCPServer::AnswerClient(ReturnMessage=%s)", ReturnMessage.c_str()));
-     send(hSession, ReturnMessage.c_str(), ReturnMessage.size(), 0);
+     if (currentSocket != -1) {
+             NotifyMutex.Lock();
+ #ifdef MSG_NOSIGNAL
+             send(currentSocket, ReturnMessage.c_str(), ReturnMessage.size(), MSG_NOSIGNAL);
+ #else
+             send(currentSocket, ReturnMessage.c_str(), ReturnMessage.size(), 0);
+ #endif
+             NotifyMutex.Unlock();
+     }
+ }
+ /**
+  * Find a created audio output device index.
+  */
+ int LSCPServer::GetAudioOutputDeviceIndex ( AudioOutputDevice *pDevice )
+ {
+     // Search for the created device to get its index
+     std::map<uint, AudioOutputDevice*> devices = pSampler->GetAudioOutputDevices();
+     std::map<uint, AudioOutputDevice*>::iterator iter = devices.begin();
+     for (; iter != devices.end(); iter++) {
+         if (iter->second == pDevice)
+             return iter->first;
+     }
+     // Not found.
+     return -1;
+ }
+ /**
+  * Find a created midi input device index.
+  */
+ int LSCPServer::GetMidiInputDeviceIndex ( MidiInputDevice *pDevice )
+ {
+     // Search for the created device to get its index
+     std::map<uint, MidiInputDevice*> devices = pSampler->GetMidiInputDevices();
+     std::map<uint, MidiInputDevice*>::iterator iter = devices.begin();
+     for (; iter != devices.end(); iter++) {
+         if (iter->second == pDevice)
+             return iter->first;
+     }
+     // Not found.
+     return -1;
+ }
+ String LSCPServer::CreateAudioOutputDevice(String Driver, std::map<String,String> Parameters) {
+     dmsg(2,("LSCPServer: CreateAudioOutputDevice(Driver=%s)\n", Driver.c_str()));
+     LSCPResultSet result;
+     try {
+         AudioOutputDevice* pDevice = pSampler->CreateAudioOutputDevice(Driver, Parameters);
+         // search for the created device to get its index
+         int index = GetAudioOutputDeviceIndex(pDevice);
+         if (index == -1) throw Exception("Internal error: could not find created audio output device.");
+         result = index; // success
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::CreateMidiInputDevice(String Driver, std::map<String,String> Parameters) {
+     dmsg(2,("LSCPServer: CreateMidiInputDevice(Driver=%s)\n", Driver.c_str()));
+     LSCPResultSet result;
+     try {
+         MidiInputDevice* pDevice = pSampler->CreateMidiInputDevice(Driver, Parameters);
+         // search for the created device to get its index
+         int index = GetMidiInputDeviceIndex(pDevice);
+         if (index == -1) throw Exception("Internal error: could not find created midi input device.");
+         result = index; // success
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::DestroyAudioOutputDevice(uint DeviceIndex) {
+     dmsg(2,("LSCPServer: DestroyAudioOutputDevice(DeviceIndex=%d)\n", DeviceIndex));
+     LSCPResultSet result;
+     try {
+         std::map<uint, AudioOutputDevice*> devices = pSampler->GetAudioOutputDevices();
+         if (!devices.count(DeviceIndex)) throw Exception("There is no audio output device with index " + ToString(DeviceIndex) + ".");
+         AudioOutputDevice* pDevice = devices[DeviceIndex];
+         pSampler->DestroyAudioOutputDevice(pDevice);
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::DestroyMidiInputDevice(uint DeviceIndex) {
+     dmsg(2,("LSCPServer: DestroyMidiInputDevice(DeviceIndex=%d)\n", DeviceIndex));
+     LSCPResultSet result;
+     try {
+         std::map<uint, MidiInputDevice*> devices = pSampler->GetMidiInputDevices();
+         if (!devices.count(DeviceIndex)) throw Exception("There is no audio output device with index " + ToString(DeviceIndex) + ".");
+         MidiInputDevice* pDevice = devices[DeviceIndex];
+         pSampler->DestroyMidiInputDevice(pDevice);
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
  }
  /**
   * Will be called by the parser to load an instrument.
   */
- String LSCPServer::LoadInstrument(String Filename, uint uiInstrument, uint uiSamplerChannel) {
+ String LSCPServer::LoadInstrument(String Filename, uint uiInstrument, uint uiSamplerChannel, bool bBackground) {
      dmsg(2,("LSCPServer: LoadInstrument(Filename=%s,Instrument=%d,SamplerChannel=%d)\n", Filename.c_str(), uiInstrument, uiSamplerChannel));
      LSCPResultSet result;
      try {
          SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
-         if (!pSamplerChannel) throw LinuxSamplerException("Index out of bounds");
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
-         Engine* pEngine = pSamplerChannel->GetEngine();
+         EngineChannel* pEngineChannel = pSamplerChannel->GetEngineChannel();
-         if (!pEngine) throw LinuxSamplerException("No engine loaded on channel");
+         if (!pEngineChannel) throw Exception("No engine type assigned to sampler channel yet");
-         pEngine->LoadInstrument(Filename.c_str(), uiInstrument);
+         if (!pSamplerChannel->GetAudioOutputDevice())
+             throw Exception("No audio output device connected to sampler channel");
+         if (bBackground) {
+             InstrumentManager::instrument_id_t id;
+             id.FileName = Filename;
+             id.Index    = uiInstrument;
+             InstrumentManager::LoadInstrumentInBackground(id, pEngineChannel);
+         }
+         else {
+             // tell the engine channel which instrument to load
+             pEngineChannel->PrepareLoadInstrument(Filename.c_str(), uiInstrument);
+             // actually start to load the instrument (blocks until completed)
+             pEngineChannel->LoadInstrument();
+         }
      }
-     catch (LinuxSamplerException e) {
+     catch (Exception e) {
           result.Error(e);
      }
      return result.Produce();
  }
  /**
-  * Will be called by the parser to load and deploy an engine.
+  * Will be called by the parser to assign a sampler engine type to a
+  * sampler channel.
   */
- String LSCPServer::LoadEngine(String EngineName, uint uiSamplerChannel) {
+ String LSCPServer::SetEngineType(String EngineName, uint uiSamplerChannel) {
-     dmsg(2,("LSCPServer: LoadEngine(EngineName=%s,SamplerChannel=%d)\n", EngineName.c_str(), uiSamplerChannel));
+     dmsg(2,("LSCPServer: SetEngineType(EngineName=%s,uiSamplerChannel=%d)\n", EngineName.c_str(), uiSamplerChannel));
      LSCPResultSet result;
      try {
-         Engine::type_t type;
-         if ((EngineName == "GigEngine") || (EngineName == "gig")) type = Engine::type_gig;
-         else throw LinuxSamplerException("Unknown engine type");
          SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
-         if (!pSamplerChannel) throw LinuxSamplerException("Index out of bounds");
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
-         pSamplerChannel->LoadEngine(type);
+         LockRTNotify();
+         pSamplerChannel->SetEngineType(EngineName);
+         if(HasSoloChannel()) pSamplerChannel->GetEngineChannel()->SetMute(-1);
+         UnlockRTNotify();
      }
-     catch (LinuxSamplerException e) {
+     catch (Exception e) {
           result.Error(e);
      }
      return result.Produce();
-Line 139 
 String LSCPServer::GetChannels() {
+Line 554 
 String LSCPServer::GetChannels() {
  }
  /**
+  * Will be called by the parser to get the list of sampler channels.
+  */
+ String LSCPServer::ListChannels() {
+     dmsg(2,("LSCPServer: ListChannels()\n"));
+     String list;
+     std::map<uint,SamplerChannel*> channels = pSampler->GetSamplerChannels();
+     std::map<uint,SamplerChannel*>::iterator iter = channels.begin();
+     for (; iter != channels.end(); iter++) {
+         if (list != "") list += ",";
+         list += ToString(iter->first);
+     }
+     LSCPResultSet result;
+     result.Add(list);
+     return result.Produce();
+ }
+ /**
   * Will be called by the parser to add a sampler channel.
   */
  String LSCPServer::AddChannel() {
      dmsg(2,("LSCPServer: AddChannel()\n"));
+     LockRTNotify();
      SamplerChannel* pSamplerChannel = pSampler->AddSamplerChannel();
+     UnlockRTNotify();
      LSCPResultSet result(pSamplerChannel->Index());
      return result.Produce();
  }
-Line 154 
 String LSCPServer::AddChannel() {
+Line 588 
 String LSCPServer::AddChannel() {
  String LSCPServer::RemoveChannel(uint uiSamplerChannel) {
      dmsg(2,("LSCPServer: RemoveChannel(SamplerChannel=%d)\n", uiSamplerChannel));
      LSCPResultSet result;
+     LockRTNotify();
      pSampler->RemoveSamplerChannel(uiSamplerChannel);
+     UnlockRTNotify();
      return result.Produce();
  }
  /**
-  * Will be called by the parser to get all available engines.
+  * Will be called by the parser to get the amount of all available engines.
   */
  String LSCPServer::GetAvailableEngines() {
      dmsg(2,("LSCPServer: GetAvailableEngines()\n"));
-     LSCPResultSet result("GigEngine");
+     LSCPResultSet result;
+     try {
+         int n = EngineFactory::AvailableEngineTypes().size();
+         result.Add(n);
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
      return result.Produce();
  }
  /**
-  * Will be called by the parser to get descriptions for a particular engine.
+  * Will be called by the parser to get a list of all available engines.
+  */
+ String LSCPServer::ListAvailableEngines() {
+     dmsg(2,("LSCPServer: ListAvailableEngines()\n"));
+     LSCPResultSet result;
+     try {
+         String s = EngineFactory::AvailableEngineTypesAsString();
+         result.Add(s);
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ /**
+  * Will be called by the parser to get descriptions for a particular
+  * sampler engine.
   */
  String LSCPServer::GetEngineInfo(String EngineName) {
      dmsg(2,("LSCPServer: GetEngineInfo(EngineName=%s)\n", EngineName.c_str()));
      LSCPResultSet result;
+     LockRTNotify();
      try {
-         if ((EngineName == "GigEngine") || (EngineName == "gig")) {
+         Engine* pEngine = EngineFactory::Create(EngineName);
-             Engine* pEngine = new LinuxSampler::gig::Engine;
+         result.Add("DESCRIPTION", pEngine->Description());
-             result.Add(pEngine->Description());
+         result.Add("VERSION",     pEngine->Version());
-             delete pEngine;
+         EngineFactory::Destroy(pEngine);
-         }
-         else throw LinuxSamplerException("Unknown engine type");
      }
-     catch (LinuxSamplerException e) {
+     catch (Exception e) {
           result.Error(e);
      }
+     UnlockRTNotify();
      return result.Produce();
  }
-Line 196 
 String LSCPServer::GetChannelInfo(uint u
+Line 656 
 String LSCPServer::GetChannelInfo(uint u
      LSCPResultSet result;
      try {
          SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
-         if (!pSamplerChannel) throw LinuxSamplerException("Index out of bounds");
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
-         Engine* pEngine = pSamplerChannel->GetEngine();
+         EngineChannel* pEngineChannel = pSamplerChannel->GetEngineChannel();
          //Defaults values
          String EngineName = "NONE";
-         float Volume = 0;
+         float Volume = 0.0f;
          String InstrumentFileName = "NONE";
-         int InstrumentIndex = 0;
+         String InstrumentName = "NONE";
+         int InstrumentIndex = -1;
-         if (pEngine) {
+         int InstrumentStatus = -1;
-             EngineName =  pEngine->EngineName();
+         int AudioOutputChannels = 0;
-             Volume = pEngine->Volume();
+         String AudioRouting;
-             int iIdx = pEngine->InstrumentIndex();
+         int Mute = 0;
-             if (iIdx != -1) {
+         bool Solo = false;
-                 InstrumentFileName = pEngine->InstrumentFileName();
+         String MidiInstrumentMap;
-                 InstrumentIndex = iIdx;
+         if (pEngineChannel) {
+             EngineName          = pEngineChannel->EngineName();
+             AudioOutputChannels = pEngineChannel->Channels();
+             Volume              = pEngineChannel->Volume();
+             InstrumentStatus    = pEngineChannel->InstrumentStatus();
+             InstrumentIndex     = pEngineChannel->InstrumentIndex();
+             if (InstrumentIndex != -1) {
+                 InstrumentFileName = pEngineChannel->InstrumentFileName();
+                 InstrumentName     = pEngineChannel->InstrumentName();
+             }
+             for (int chan = 0; chan < pEngineChannel->Channels(); chan++) {
+                 if (AudioRouting != "") AudioRouting += ",";
+                 AudioRouting += ToString(pEngineChannel->OutputChannel(chan));
              }
+             Mute = pEngineChannel->GetMute();
+             Solo = pEngineChannel->GetSolo();
+             if (pEngineChannel->UsesNoMidiInstrumentMap())
+                 MidiInstrumentMap = "NONE";
+             else if (pEngineChannel->UsesDefaultMidiInstrumentMap())
+                 MidiInstrumentMap = "DEFAULT";
+             else
+                 MidiInstrumentMap = ToString(pEngineChannel->GetMidiInstrumentMap());
          }
          result.Add("ENGINE_NAME", EngineName);
          result.Add("VOLUME", Volume);
-         //Some hardcoded stuff for now to make GUI look good
+         //Some not-so-hardcoded stuff to make GUI look good
-         result.Add("AUDIO_OUTPUT_DEVICE", "0");
+         result.Add("AUDIO_OUTPUT_DEVICE", GetAudioOutputDeviceIndex(pSamplerChannel->GetAudioOutputDevice()));
-         result.Add("AUDIO_OUTPUT_CHANNELS", "2");
+         result.Add("AUDIO_OUTPUT_CHANNELS", AudioOutputChannels);
-         result.Add("AUDIO_OUTPUT_ROUTING", "0,1");
+         result.Add("AUDIO_OUTPUT_ROUTING", AudioRouting);
+         result.Add("MIDI_INPUT_DEVICE", GetMidiInputDeviceIndex(pSamplerChannel->GetMidiInputDevice()));
+         result.Add("MIDI_INPUT_PORT", pSamplerChannel->GetMidiInputPort());
+         if (pSamplerChannel->GetMidiInputChannel() == midi_chan_all) result.Add("MIDI_INPUT_CHANNEL", "ALL");
+         else result.Add("MIDI_INPUT_CHANNEL", pSamplerChannel->GetMidiInputChannel());
          result.Add("INSTRUMENT_FILE", InstrumentFileName);
          result.Add("INSTRUMENT_NR", InstrumentIndex);
+         result.Add("INSTRUMENT_NAME", InstrumentName);
-         //Some more hardcoded stuff for now to make GUI look good
+         result.Add("INSTRUMENT_STATUS", InstrumentStatus);
-         result.Add("MIDI_INPUT_DEVICE", "0");
+         result.Add("MUTE", Mute == -1 ? "MUTED_BY_SOLO" : (Mute ? "true" : "false"));
-         result.Add("MIDI_INPUT_PORT", "0");
+         result.Add("SOLO", Solo);
-         result.Add("MIDI_INPUT_CHANNEL", "1");
+         result.Add("MIDI_INSTRUMENT_MAP", MidiInstrumentMap);
      }
-     catch (LinuxSamplerException e) {
+     catch (Exception e) {
           result.Error(e);
      }
      return result.Produce();
-Line 246 
 String LSCPServer::GetVoiceCount(uint ui
+Line 732 
 String LSCPServer::GetVoiceCount(uint ui
      LSCPResultSet result;
      try {
          SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
-         if (!pSamplerChannel) throw LinuxSamplerException("Index out of bounds");
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
-         Engine* pEngine = pSamplerChannel->GetEngine();
+         EngineChannel* pEngineChannel = pSamplerChannel->GetEngineChannel();
-         if (!pEngine) throw LinuxSamplerException("No engine loaded on channel");
+         if (!pEngineChannel) throw Exception("No engine loaded on sampler channel");
-         result.Add(pEngine->VoiceCount());
+         if (!pEngineChannel->GetEngine()) throw Exception("No audio output device connected to sampler channel");
+         result.Add(pEngineChannel->GetEngine()->VoiceCount());
      }
-     catch (LinuxSamplerException e) {
+     catch (Exception e) {
           result.Error(e);
      }
      return result.Produce();
-Line 266 
 String LSCPServer::GetStreamCount(uint u
+Line 753 
 String LSCPServer::GetStreamCount(uint u
      LSCPResultSet result;
      try {
          SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
-         if (!pSamplerChannel) throw LinuxSamplerException("Index out of bounds");
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
-         Engine* pEngine = pSamplerChannel->GetEngine();
+         EngineChannel* pEngineChannel = pSamplerChannel->GetEngineChannel();
-         if (!pEngine) throw LinuxSamplerException("No engine loaded on channel");
+         if (!pEngineChannel) throw Exception("No engine type assigned to sampler channel");
-         result.Add(pEngine->DiskStreamCount());
+         if (!pEngineChannel->GetEngine()) throw Exception("No audio output device connected to sampler channel");
+         result.Add(pEngineChannel->GetEngine()->DiskStreamCount());
      }
-     catch (LinuxSamplerException e) {
+     catch (Exception e) {
           result.Error(e);
      }
      return result.Produce();
-Line 286 
 String LSCPServer::GetBufferFill(fill_re
+Line 774 
 String LSCPServer::GetBufferFill(fill_re
      LSCPResultSet result;
      try {
          SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
-         if (!pSamplerChannel) throw LinuxSamplerException("Index out of bounds");
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
-         Engine* pEngine = pSamplerChannel->GetEngine();
+         EngineChannel* pEngineChannel = pSamplerChannel->GetEngineChannel();
-         if (!pEngine) throw LinuxSamplerException("No engine loaded on channel");
+         if (!pEngineChannel) throw Exception("No engine type assigned to sampler channel");
-         if (!pEngine->DiskStreamSupported()) return "NA\r\n"; //FIXME: Update resultset class to support "NA"
+         if (!pEngineChannel->GetEngine()) throw Exception("No audio output device connected to sampler channel");
-         switch (ResponseType) {
+         if (!pEngineChannel->GetEngine()->DiskStreamSupported()) result.Add("NA");
-             case fill_response_bytes:
+         else {
-                 result.Add(pEngine->DiskStreamBufferFillBytes());
+             switch (ResponseType) {
-                 break;
+                 case fill_response_bytes:
-             case fill_response_percentage:
+                     result.Add(pEngineChannel->GetEngine()->DiskStreamBufferFillBytes());
-                 result.Add(pEngine->DiskStreamBufferFillPercentage());
+                     break;
-                 break;
+                 case fill_response_percentage:
-             default:
+                     result.Add(pEngineChannel->GetEngine()->DiskStreamBufferFillPercentage());
-                 throw LinuxSamplerException("Unknown fill response type");
+                     break;
-         }
+                 default:
+                     throw Exception("Unknown fill response type");
+             }
+         }
      }
-     catch (LinuxSamplerException e) {
+     catch (Exception e) {
           result.Error(e);
      }
      return result.Produce();
  }
- /**
+ String LSCPServer::GetAvailableAudioOutputDrivers() {
-  * Will be called by the parser to change the audio output type on a
+     dmsg(2,("LSCPServer: GetAvailableAudioOutputDrivers()\n"));
-  * particular sampler channel.
-  */
- String LSCPServer::SetAudioOutputType(AudioOutputDevice::type_t AudioOutputType, uint uiSamplerChannel) {
-     dmsg(2,("LSCPServer: SetAudioOutputType(AudioOutputType=%d, SamplerChannel=%d)\n", AudioOutputType, uiSamplerChannel));
      LSCPResultSet result;
      try {
-         SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
+         int n = AudioOutputDeviceFactory::AvailableDrivers().size();
-         if (!pSamplerChannel) throw LinuxSamplerException("Index out of bounds");
+         result.Add(n);
-         pSamplerChannel->SetAudioOutputDevice(AudioOutputType);
      }
-     catch (LinuxSamplerException e) {
+     catch (Exception e) {
-          result.Error(e);
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::ListAvailableAudioOutputDrivers() {
+     dmsg(2,("LSCPServer: ListAvailableAudioOutputDrivers()\n"));
+     LSCPResultSet result;
+     try {
+         String s = AudioOutputDeviceFactory::AvailableDriversAsString();
+         result.Add(s);
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::GetAvailableMidiInputDrivers() {
+     dmsg(2,("LSCPServer: GetAvailableMidiInputDrivers()\n"));
+     LSCPResultSet result;
+     try {
+         int n = MidiInputDeviceFactory::AvailableDrivers().size();
+         result.Add(n);
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::ListAvailableMidiInputDrivers() {
+     dmsg(2,("LSCPServer: ListAvailableMidiInputDrivers()\n"));
+     LSCPResultSet result;
+     try {
+         String s = MidiInputDeviceFactory::AvailableDriversAsString();
+         result.Add(s);
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::GetMidiInputDriverInfo(String Driver) {
+     dmsg(2,("LSCPServer: GetMidiInputDriverInfo(Driver=%s)\n",Driver.c_str()));
+     LSCPResultSet result;
+     try {
+         result.Add("DESCRIPTION", MidiInputDeviceFactory::GetDriverDescription(Driver));
+         result.Add("VERSION",     MidiInputDeviceFactory::GetDriverVersion(Driver));
+         std::map<String,DeviceCreationParameter*> parameters = MidiInputDeviceFactory::GetAvailableDriverParameters(Driver);
+         if (parameters.size()) { // if there are parameters defined for this driver
+             String s;
+             std::map<String,DeviceCreationParameter*>::iterator iter = parameters.begin();
+             for (;iter != parameters.end(); iter++) {
+                 if (s != "") s += ",";
+                 s += iter->first;
+             }
+             result.Add("PARAMETERS", s);
+         }
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::GetAudioOutputDriverInfo(String Driver) {
+     dmsg(2,("LSCPServer: GetAudioOutputDriverInfo(Driver=%s)\n",Driver.c_str()));
+     LSCPResultSet result;
+     try {
+         result.Add("DESCRIPTION", AudioOutputDeviceFactory::GetDriverDescription(Driver));
+         result.Add("VERSION",     AudioOutputDeviceFactory::GetDriverVersion(Driver));
+         std::map<String,DeviceCreationParameter*> parameters = AudioOutputDeviceFactory::GetAvailableDriverParameters(Driver);
+         if (parameters.size()) { // if there are parameters defined for this driver
+             String s;
+             std::map<String,DeviceCreationParameter*>::iterator iter = parameters.begin();
+             for (;iter != parameters.end(); iter++) {
+                 if (s != "") s += ",";
+                 s += iter->first;
+             }
+             result.Add("PARAMETERS", s);
+         }
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::GetMidiInputDriverParameterInfo(String Driver, String Parameter, std::map<String,String> DependencyList) {
+     dmsg(2,("LSCPServer: GetMidiInputDriverParameterInfo(Driver=%s,Parameter=%s,DependencyListSize=%d)\n",Driver.c_str(),Parameter.c_str(),DependencyList.size()));
+     LSCPResultSet result;
+     try {
+         DeviceCreationParameter* pParameter = MidiInputDeviceFactory::GetDriverParameter(Driver, Parameter);
+         result.Add("TYPE",         pParameter->Type());
+         result.Add("DESCRIPTION",  pParameter->Description());
+         result.Add("MANDATORY",    pParameter->Mandatory());
+         result.Add("FIX",          pParameter->Fix());
+         result.Add("MULTIPLICITY", pParameter->Multiplicity());
+         optional<String> oDepends       = pParameter->Depends();
+         optional<String> oDefault       = pParameter->Default(DependencyList);
+         optional<String> oRangeMin      = pParameter->RangeMin(DependencyList);
+         optional<String> oRangeMax      = pParameter->RangeMax(DependencyList);
+         optional<String> oPossibilities = pParameter->Possibilities(DependencyList);
+         if (oDepends)       result.Add("DEPENDS",       *oDepends);
+         if (oDefault)       result.Add("DEFAULT",       *oDefault);
+         if (oRangeMin)      result.Add("RANGE_MIN",     *oRangeMin);
+         if (oRangeMax)      result.Add("RANGE_MAX",     *oRangeMax);
+         if (oPossibilities) result.Add("POSSIBILITIES", *oPossibilities);
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::GetAudioOutputDriverParameterInfo(String Driver, String Parameter, std::map<String,String> DependencyList) {
+     dmsg(2,("LSCPServer: GetAudioOutputDriverParameterInfo(Driver=%s,Parameter=%s,DependencyListSize=%d)\n",Driver.c_str(),Parameter.c_str(),DependencyList.size()));
+     LSCPResultSet result;
+     try {
+         DeviceCreationParameter* pParameter = AudioOutputDeviceFactory::GetDriverParameter(Driver, Parameter);
+         result.Add("TYPE",         pParameter->Type());
+         result.Add("DESCRIPTION",  pParameter->Description());
+         result.Add("MANDATORY",    pParameter->Mandatory());
+         result.Add("FIX",          pParameter->Fix());
+         result.Add("MULTIPLICITY", pParameter->Multiplicity());
+         optional<String> oDepends       = pParameter->Depends();
+         optional<String> oDefault       = pParameter->Default(DependencyList);
+         optional<String> oRangeMin      = pParameter->RangeMin(DependencyList);
+         optional<String> oRangeMax      = pParameter->RangeMax(DependencyList);
+         optional<String> oPossibilities = pParameter->Possibilities(DependencyList);
+         if (oDepends)       result.Add("DEPENDS",       *oDepends);
+         if (oDefault)       result.Add("DEFAULT",       *oDefault);
+         if (oRangeMin)      result.Add("RANGE_MIN",     *oRangeMin);
+         if (oRangeMax)      result.Add("RANGE_MAX",     *oRangeMax);
+         if (oPossibilities) result.Add("POSSIBILITIES", *oPossibilities);
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::GetAudioOutputDeviceCount() {
+     dmsg(2,("LSCPServer: GetAudioOutputDeviceCount()\n"));
+     LSCPResultSet result;
+     try {
+         uint count = pSampler->AudioOutputDevices();
+         result.Add(count); // success
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::GetMidiInputDeviceCount() {
+     dmsg(2,("LSCPServer: GetMidiInputDeviceCount()\n"));
+     LSCPResultSet result;
+     try {
+         uint count = pSampler->MidiInputDevices();
+         result.Add(count); // success
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::GetAudioOutputDevices() {
+     dmsg(2,("LSCPServer: GetAudioOutputDevices()\n"));
+     LSCPResultSet result;
+     try {
+         String s;
+         std::map<uint, AudioOutputDevice*> devices = pSampler->GetAudioOutputDevices();
+         std::map<uint, AudioOutputDevice*>::iterator iter = devices.begin();
+         for (; iter != devices.end(); iter++) {
+             if (s != "") s += ",";
+             s += ToString(iter->first);
+         }
+         result.Add(s);
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::GetMidiInputDevices() {
+     dmsg(2,("LSCPServer: GetMidiInputDevices()\n"));
+     LSCPResultSet result;
+     try {
+         String s;
+         std::map<uint, MidiInputDevice*> devices = pSampler->GetMidiInputDevices();
+         std::map<uint, MidiInputDevice*>::iterator iter = devices.begin();
+         for (; iter != devices.end(); iter++) {
+             if (s != "") s += ",";
+             s += ToString(iter->first);
+         }
+         result.Add(s);
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::GetAudioOutputDeviceInfo(uint DeviceIndex) {
+     dmsg(2,("LSCPServer: GetAudioOutputDeviceInfo(DeviceIndex=%d)\n",DeviceIndex));
+     LSCPResultSet result;
+     try {
+         std::map<uint,AudioOutputDevice*> devices = pSampler->GetAudioOutputDevices();
+         if (!devices.count(DeviceIndex)) throw Exception("There is no audio output device with index " + ToString(DeviceIndex) + ".");
+         AudioOutputDevice* pDevice = devices[DeviceIndex];
+         result.Add("DRIVER", pDevice->Driver());
+         std::map<String,DeviceCreationParameter*> parameters = pDevice->DeviceParameters();
+         std::map<String,DeviceCreationParameter*>::iterator iter = parameters.begin();
+         for (; iter != parameters.end(); iter++) {
+             result.Add(iter->first, iter->second->Value());
+         }
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::GetMidiInputDeviceInfo(uint DeviceIndex) {
+     dmsg(2,("LSCPServer: GetMidiInputDeviceInfo(DeviceIndex=%d)\n",DeviceIndex));
+     LSCPResultSet result;
+     try {
+         std::map<uint,MidiInputDevice*> devices = pSampler->GetMidiInputDevices();
+         if (!devices.count(DeviceIndex)) throw Exception("There is no MIDI input device with index " + ToString(DeviceIndex) + ".");
+         MidiInputDevice* pDevice = devices[DeviceIndex];
+         result.Add("DRIVER", pDevice->Driver());
+         std::map<String,DeviceCreationParameter*> parameters = pDevice->DeviceParameters();
+         std::map<String,DeviceCreationParameter*>::iterator iter = parameters.begin();
+         for (; iter != parameters.end(); iter++) {
+             result.Add(iter->first, iter->second->Value());
+         }
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::GetMidiInputPortInfo(uint DeviceIndex, uint PortIndex) {
+     dmsg(2,("LSCPServer: GetMidiInputPortInfo(DeviceIndex=%d, PortIndex=%d)\n",DeviceIndex, PortIndex));
+     LSCPResultSet result;
+     try {
+         // get MIDI input device
+         std::map<uint,MidiInputDevice*> devices = pSampler->GetMidiInputDevices();
+         if (!devices.count(DeviceIndex)) throw Exception("There is no MIDI input device with index " + ToString(DeviceIndex) + ".");
+         MidiInputDevice* pDevice = devices[DeviceIndex];
+         // get MIDI port
+         MidiInputPort* pMidiInputPort = pDevice->GetPort(PortIndex);
+         if (!pMidiInputPort) throw Exception("There is no MIDI input port with index " + ToString(PortIndex) + ".");
+         // return the values of all MIDI port parameters
+         std::map<String,DeviceRuntimeParameter*> parameters = pMidiInputPort->PortParameters();
+         std::map<String,DeviceRuntimeParameter*>::iterator iter = parameters.begin();
+         for (; iter != parameters.end(); iter++) {
+             result.Add(iter->first, iter->second->Value());
+         }
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::GetAudioOutputChannelInfo(uint DeviceId, uint ChannelId) {
+     dmsg(2,("LSCPServer: GetAudioOutputChannelInfo(DeviceId=%d,ChannelId)\n",DeviceId,ChannelId));
+     LSCPResultSet result;
+     try {
+         // get audio output device
+         std::map<uint,AudioOutputDevice*> devices = pSampler->GetAudioOutputDevices();
+         if (!devices.count(DeviceId)) throw Exception("There is no audio output device with index " + ToString(DeviceId) + ".");
+         AudioOutputDevice* pDevice = devices[DeviceId];
+         // get audio channel
+         AudioChannel* pChannel = pDevice->Channel(ChannelId);
+         if (!pChannel) throw Exception("Audio output device does not have audio channel " + ToString(ChannelId) + ".");
+         // return the values of all audio channel parameters
+         std::map<String,DeviceRuntimeParameter*> parameters = pChannel->ChannelParameters();
+         std::map<String,DeviceRuntimeParameter*>::iterator iter = parameters.begin();
+         for (; iter != parameters.end(); iter++) {
+             result.Add(iter->first, iter->second->Value());
+         }
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::GetMidiInputPortParameterInfo(uint DeviceId, uint PortId, String ParameterName) {
+     dmsg(2,("LSCPServer: GetMidiInputPortParameterInfo(DeviceId=%d,PortId=%d,ParameterName=%s)\n",DeviceId,PortId,ParameterName.c_str()));
+     LSCPResultSet result;
+     try {
+         // get MIDI input device
+         std::map<uint,MidiInputDevice*> devices = pSampler->GetMidiInputDevices();
+         if (!devices.count(DeviceId)) throw Exception("There is no midi input device with index " + ToString(DeviceId) + ".");
+         MidiInputDevice* pDevice = devices[DeviceId];
+         // get midi port
+         MidiInputPort* pPort = pDevice->GetPort(PortId);
+         if (!pPort) throw Exception("Midi input device does not have port " + ToString(PortId) + ".");
+         // get desired port parameter
+         std::map<String,DeviceRuntimeParameter*> parameters = pPort->PortParameters();
+         if (!parameters.count(ParameterName)) throw Exception("Midi port does not provide a parameter '" + ParameterName + "'.");
+         DeviceRuntimeParameter* pParameter = parameters[ParameterName];
+         // return all fields of this audio channel parameter
+         result.Add("TYPE",         pParameter->Type());
+         result.Add("DESCRIPTION",  pParameter->Description());
+         result.Add("FIX",          pParameter->Fix());
+         result.Add("MULTIPLICITY", pParameter->Multiplicity());
+         if (pParameter->RangeMin())      result.Add("RANGE_MIN",     *pParameter->RangeMin());
+         if (pParameter->RangeMax())      result.Add("RANGE_MAX",     *pParameter->RangeMax());
+         if (pParameter->Possibilities()) result.Add("POSSIBILITIES", *pParameter->Possibilities());
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::GetAudioOutputChannelParameterInfo(uint DeviceId, uint ChannelId, String ParameterName) {
+     dmsg(2,("LSCPServer: GetAudioOutputChannelParameterInfo(DeviceId=%d,ChannelId=%d,ParameterName=%s)\n",DeviceId,ChannelId,ParameterName.c_str()));
+     LSCPResultSet result;
+     try {
+         // get audio output device
+         std::map<uint,AudioOutputDevice*> devices = pSampler->GetAudioOutputDevices();
+         if (!devices.count(DeviceId)) throw Exception("There is no audio output device with index " + ToString(DeviceId) + ".");
+         AudioOutputDevice* pDevice = devices[DeviceId];
+         // get audio channel
+         AudioChannel* pChannel = pDevice->Channel(ChannelId);
+         if (!pChannel) throw Exception("Audio output device does not have audio channel " + ToString(ChannelId) + ".");
+         // get desired audio channel parameter
+         std::map<String,DeviceRuntimeParameter*> parameters = pChannel->ChannelParameters();
+         if (!parameters.count(ParameterName)) throw Exception("Audio channel does not provide a parameter '" + ParameterName + "'.");
+         DeviceRuntimeParameter* pParameter = parameters[ParameterName];
+         // return all fields of this audio channel parameter
+         result.Add("TYPE",         pParameter->Type());
+         result.Add("DESCRIPTION",  pParameter->Description());
+         result.Add("FIX",          pParameter->Fix());
+         result.Add("MULTIPLICITY", pParameter->Multiplicity());
+         if (pParameter->RangeMin())      result.Add("RANGE_MIN",     *pParameter->RangeMin());
+         if (pParameter->RangeMax())      result.Add("RANGE_MAX",     *pParameter->RangeMax());
+         if (pParameter->Possibilities()) result.Add("POSSIBILITIES", *pParameter->Possibilities());
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::SetAudioOutputChannelParameter(uint DeviceId, uint ChannelId, String ParamKey, String ParamVal) {
+     dmsg(2,("LSCPServer: SetAudioOutputChannelParameter(DeviceId=%d,ChannelId=%d,ParamKey=%s,ParamVal=%s)\n",DeviceId,ChannelId,ParamKey.c_str(),ParamVal.c_str()));
+     LSCPResultSet result;
+     try {
+         // get audio output device
+         std::map<uint,AudioOutputDevice*> devices = pSampler->GetAudioOutputDevices();
+         if (!devices.count(DeviceId)) throw Exception("There is no audio output device with index " + ToString(DeviceId) + ".");
+         AudioOutputDevice* pDevice = devices[DeviceId];
+         // get audio channel
+         AudioChannel* pChannel = pDevice->Channel(ChannelId);
+         if (!pChannel) throw Exception("Audio output device does not have audio channel " + ToString(ChannelId) + ".");
+         // get desired audio channel parameter
+         std::map<String,DeviceRuntimeParameter*> parameters = pChannel->ChannelParameters();
+         if (!parameters.count(ParamKey)) throw Exception("Audio channel does not provide a parameter '" + ParamKey + "'.");
+         DeviceRuntimeParameter* pParameter = parameters[ParamKey];
+         // set new channel parameter value
+         pParameter->SetValue(ParamVal);
+         LSCPServer::SendLSCPNotify(LSCPEvent(LSCPEvent::event_audio_device_info, DeviceId));
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::SetAudioOutputDeviceParameter(uint DeviceIndex, String ParamKey, String ParamVal) {
+     dmsg(2,("LSCPServer: SetAudioOutputDeviceParameter(DeviceIndex=%d,ParamKey=%s,ParamVal=%s)\n",DeviceIndex,ParamKey.c_str(),ParamVal.c_str()));
+     LSCPResultSet result;
+     try {
+         std::map<uint,AudioOutputDevice*> devices = pSampler->GetAudioOutputDevices();
+         if (!devices.count(DeviceIndex)) throw Exception("There is no audio output device with index " + ToString(DeviceIndex) + ".");
+         AudioOutputDevice* pDevice = devices[DeviceIndex];
+         std::map<String,DeviceCreationParameter*> parameters = pDevice->DeviceParameters();
+         if (!parameters.count(ParamKey)) throw Exception("Audio output device " + ToString(DeviceIndex) + " does not have a device parameter '" + ParamKey + "'");
+         parameters[ParamKey]->SetValue(ParamVal);
+         LSCPServer::SendLSCPNotify(LSCPEvent(LSCPEvent::event_audio_device_info, DeviceIndex));
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::SetMidiInputDeviceParameter(uint DeviceIndex, String ParamKey, String ParamVal) {
+     dmsg(2,("LSCPServer: SetMidiOutputDeviceParameter(DeviceIndex=%d,ParamKey=%s,ParamVal=%s)\n",DeviceIndex,ParamKey.c_str(),ParamVal.c_str()));
+     LSCPResultSet result;
+     try {
+         std::map<uint,MidiInputDevice*> devices = pSampler->GetMidiInputDevices();
+         if (!devices.count(DeviceIndex)) throw Exception("There is no MIDI input device with index " + ToString(DeviceIndex) + ".");
+         MidiInputDevice* pDevice = devices[DeviceIndex];
+         std::map<String,DeviceCreationParameter*> parameters = pDevice->DeviceParameters();
+         if (!parameters.count(ParamKey)) throw Exception("MIDI input device " + ToString(DeviceIndex) + " does not have a device parameter '" + ParamKey + "'");
+         parameters[ParamKey]->SetValue(ParamVal);
+         LSCPServer::SendLSCPNotify(LSCPEvent(LSCPEvent::event_midi_device_info, DeviceIndex));
+     }
+     catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::SetMidiInputPortParameter(uint DeviceIndex, uint PortIndex, String ParamKey, String ParamVal) {
+     dmsg(2,("LSCPServer: SetMidiOutputDeviceParameter(DeviceIndex=%d,ParamKey=%s,ParamVal=%s)\n",DeviceIndex,ParamKey.c_str(),ParamVal.c_str()));
+     LSCPResultSet result;
+     try {
+         // get MIDI input device
+         std::map<uint,MidiInputDevice*> devices = pSampler->GetMidiInputDevices();
+         if (!devices.count(DeviceIndex)) throw Exception("There is no MIDI input device with index " + ToString(DeviceIndex) + ".");
+         MidiInputDevice* pDevice = devices[DeviceIndex];
+         // get MIDI port
+         MidiInputPort* pMidiInputPort = pDevice->GetPort(PortIndex);
+         if (!pMidiInputPort) throw Exception("There is no MIDI input port with index " + ToString(PortIndex) + ".");
+         // set port parameter value
+         std::map<String,DeviceRuntimeParameter*> parameters = pMidiInputPort->PortParameters();
+         if (!parameters.count(ParamKey)) throw Exception("MIDI input device " + ToString(PortIndex) + " does not have a parameter '" + ParamKey + "'");
+         parameters[ParamKey]->SetValue(ParamVal);
+         LSCPServer::SendLSCPNotify(LSCPEvent(LSCPEvent::event_midi_device_info, DeviceIndex));
+     }
+     catch (Exception e) {
+         result.Error(e);
      }
      return result.Produce();
  }
-Line 329 
 String LSCPServer::SetAudioOutputType(Au
+Line 1266 
 String LSCPServer::SetAudioOutputType(Au
   * Will be called by the parser to change the audio output channel for
   * playback on a particular sampler channel.
   */
- String LSCPServer::SetAudioOutputChannel(uint AudioOutputChannel, uint uiSamplerChannel) {
+ String LSCPServer::SetAudioOutputChannel(uint ChannelAudioOutputChannel, uint AudioOutputDeviceInputChannel, uint uiSamplerChannel) {
-     dmsg(2,("LSCPServer: SetAudioOutputChannel(AudioOutputChannel=%d, SamplerChannel=%d)\n", AudioOutputChannel, uiSamplerChannel));
+     dmsg(2,("LSCPServer: SetAudioOutputChannel(ChannelAudioOutputChannel=%d, AudioOutputDeviceInputChannel=%d, SamplerChannel=%d)\n",ChannelAudioOutputChannel,AudioOutputDeviceInputChannel,uiSamplerChannel));
-     return "ERR:0:Not implemented yet.\r\n"; //FIXME: Add support for this in resultset class?
+     LSCPResultSet result;
+     try {
+         SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
+         EngineChannel* pEngineChannel = pSamplerChannel->GetEngineChannel();
+         if (!pEngineChannel) throw Exception("No engine type yet assigned to sampler channel " + ToString(uiSamplerChannel));
+         if (!pSamplerChannel->GetAudioOutputDevice()) throw Exception("No audio output device connected to sampler channel " + ToString(uiSamplerChannel));
+         pEngineChannel->SetOutputChannel(ChannelAudioOutputChannel, AudioOutputDeviceInputChannel);
+     }
+     catch (Exception e) {
+          result.Error(e);
+     }
+     return result.Produce();
  }
- String LSCPServer::SetMIDIInputType(MidiInputDevice::type_t MidiInputType, uint uiSamplerChannel) {
+ String LSCPServer::SetAudioOutputDevice(uint AudioDeviceId, uint uiSamplerChannel) {
-     dmsg(2,("LSCPServer: SetMIDIInputType(MidiInputType=%d, SamplerChannel=%d)\n", MidiInputType, uiSamplerChannel));
+     dmsg(2,("LSCPServer: SetAudiotOutputDevice(AudioDeviceId=%d, SamplerChannel=%d)\n",AudioDeviceId,uiSamplerChannel));
      LSCPResultSet result;
+     LockRTNotify();
      try {
          SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
-         if (!pSamplerChannel) throw LinuxSamplerException("Index out of bounds");
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
-         pSamplerChannel->SetMidiInputDevice(MidiInputType);
+         std::map<uint, AudioOutputDevice*> devices = pSampler->GetAudioOutputDevices();
+         if (!devices.count(AudioDeviceId)) throw Exception("There is no audio output device with index " + ToString(AudioDeviceId));
+         AudioOutputDevice* pDevice = devices[AudioDeviceId];
+         pSamplerChannel->SetAudioOutputDevice(pDevice);
      }
-     catch (LinuxSamplerException e) {
+     catch (Exception e) {
           result.Error(e);
      }
+     UnlockRTNotify();
      return result.Produce();
  }
- /**
+ String LSCPServer::SetAudioOutputType(String AudioOutputDriver, uint uiSamplerChannel) {
-  * Will be called by the parser to change the MIDI input port on which the
+     dmsg(2,("LSCPServer: SetAudioOutputType(String AudioOutputDriver=%s, SamplerChannel=%d)\n",AudioOutputDriver.c_str(),uiSamplerChannel));
-  * engine of a particular sampler channel should listen to.
-  */
- String LSCPServer::SetMIDIInputPort(String MIDIInputPort, uint uiSamplerChannel) {
-     dmsg(2,("LSCPServer: SetMIDIInputPort(MIDIInputPort=%s, Samplerchannel=%d)\n", MIDIInputPort.c_str(), uiSamplerChannel));
      LSCPResultSet result;
+     LockRTNotify();
      try {
          SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
-         if (!pSamplerChannel) throw LinuxSamplerException("Index out of bounds");
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
-         if (!pSamplerChannel->GetMidiInputDevice()) throw LinuxSamplerException("No MIDI input device connected yet");
+         // Driver type name aliasing...
-         pSamplerChannel->GetMidiInputDevice()->SetInputPort(MIDIInputPort.c_str());
+         if (AudioOutputDriver == "Alsa") AudioOutputDriver = "ALSA";
+         if (AudioOutputDriver == "Jack") AudioOutputDriver = "JACK";
+         // Check if there's one audio output device already created
+         // for the intended audio driver type (AudioOutputDriver)...
+         AudioOutputDevice *pDevice = NULL;
+         std::map<uint, AudioOutputDevice*> devices = pSampler->GetAudioOutputDevices();
+         std::map<uint, AudioOutputDevice*>::iterator iter = devices.begin();
+         for (; iter != devices.end(); iter++) {
+             if ((iter->second)->Driver() == AudioOutputDriver) {
+                 pDevice = iter->second;
+                 break;
+             }
+         }
+         // If it doesn't exist, create a new one with default parameters...
+         if (pDevice == NULL) {
+             std::map<String,String> params;
+             pDevice = pSampler->CreateAudioOutputDevice(AudioOutputDriver, params);
+         }
+         // Must have a device...
+         if (pDevice == NULL)
+             throw Exception("Internal error: could not create audio output device.");
+         // Set it as the current channel device...
+         pSamplerChannel->SetAudioOutputDevice(pDevice);
      }
-     catch (LinuxSamplerException e) {
+     catch (Exception e) {
+          result.Error(e);
+     }
+     UnlockRTNotify();
+     return result.Produce();
+ }
+ String LSCPServer::SetMIDIInputPort(uint MIDIPort, uint uiSamplerChannel) {
+     dmsg(2,("LSCPServer: SetMIDIInputPort(MIDIPort=%d, SamplerChannel=%d)\n",MIDIPort,uiSamplerChannel));
+     LSCPResultSet result;
+     try {
+         SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
+         pSamplerChannel->SetMidiInputPort(MIDIPort);
+     }
+     catch (Exception e) {
+          result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::SetMIDIInputChannel(uint MIDIChannel, uint uiSamplerChannel) {
+     dmsg(2,("LSCPServer: SetMIDIInputChannel(MIDIChannel=%d, SamplerChannel=%d)\n",MIDIChannel,uiSamplerChannel));
+     LSCPResultSet result;
+     try {
+         SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
+         pSamplerChannel->SetMidiInputChannel((midi_chan_t) MIDIChannel);
+     }
+     catch (Exception e) {
+          result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::SetMIDIInputDevice(uint MIDIDeviceId, uint uiSamplerChannel) {
+     dmsg(2,("LSCPServer: SetMIDIInputDevice(MIDIDeviceId=%d, SamplerChannel=%d)\n",MIDIDeviceId,uiSamplerChannel));
+     LSCPResultSet result;
+     try {
+         SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
+         std::map<uint, MidiInputDevice*> devices = pSampler->GetMidiInputDevices();
+         if (!devices.count(MIDIDeviceId)) throw Exception("There is no MIDI input device with index " + ToString(MIDIDeviceId));
+         MidiInputDevice* pDevice = devices[MIDIDeviceId];
+         pSamplerChannel->SetMidiInputDevice(pDevice);
+     }
+     catch (Exception e) {
+          result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::SetMIDIInputType(String MidiInputDriver, uint uiSamplerChannel) {
+     dmsg(2,("LSCPServer: SetMIDIInputType(String MidiInputDriver=%s, SamplerChannel=%d)\n",MidiInputDriver.c_str(),uiSamplerChannel));
+     LSCPResultSet result;
+     try {
+         SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
+         // Driver type name aliasing...
+         if (MidiInputDriver == "Alsa") MidiInputDriver = "ALSA";
+         // Check if there's one MIDI input device already created
+         // for the intended MIDI driver type (MidiInputDriver)...
+         MidiInputDevice *pDevice = NULL;
+         std::map<uint, MidiInputDevice*> devices = pSampler->GetMidiInputDevices();
+         std::map<uint, MidiInputDevice*>::iterator iter = devices.begin();
+         for (; iter != devices.end(); iter++) {
+             if ((iter->second)->Driver() == MidiInputDriver) {
+                 pDevice = iter->second;
+                 break;
+             }
+         }
+         // If it doesn't exist, create a new one with default parameters...
+         if (pDevice == NULL) {
+             std::map<String,String> params;
+             pDevice = pSampler->CreateMidiInputDevice(MidiInputDriver, params);
+             // Make it with at least one initial port.
+             std::map<String,DeviceCreationParameter*> parameters = pDevice->DeviceParameters();
+             parameters["PORTS"]->SetValue("1");
+         }
+         // Must have a device...
+         if (pDevice == NULL)
+             throw Exception("Internal error: could not create MIDI input device.");
+         // Set it as the current channel device...
+         pSamplerChannel->SetMidiInputDevice(pDevice);
+     }
+     catch (Exception e) {
           result.Error(e);
      }
      return result.Produce();
  }
  /**
-  * Will be called by the parser to change the MIDI input channel on which the
+  * Will be called by the parser to change the MIDI input device, port and channel on which
   * engine of a particular sampler channel should listen to.
   */
- String LSCPServer::SetMIDIInputChannel(uint MIDIChannel, uint uiSamplerChannel) {
+ String LSCPServer::SetMIDIInput(uint MIDIDeviceId, uint MIDIPort, uint MIDIChannel, uint uiSamplerChannel) {
-     dmsg(2,("LSCPServer: SetMIDIInputChannel(MIDIChannel=%d, SamplerChannel=%d)\n", MIDIChannel, uiSamplerChannel));
+     dmsg(2,("LSCPServer: SetMIDIInput(MIDIDeviceId=%d, MIDIPort=%d, MIDIChannel=%d, SamplerChannel=%d)\n", MIDIDeviceId, MIDIPort, MIDIChannel, uiSamplerChannel));
      LSCPResultSet result;
      try {
          SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
-         if (!pSamplerChannel) throw LinuxSamplerException("Index out of bounds");
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
-         if (!pSamplerChannel->GetMidiInputDevice()) throw LinuxSamplerException("No MIDI input device connected yet");
+         std::map<uint, MidiInputDevice*> devices =  pSampler->GetMidiInputDevices();
-         MidiInputDevice::type_t oldtype = pSamplerChannel->GetMidiInputDevice()->Type();
+         if (!devices.count(MIDIDeviceId)) throw Exception("There is no MIDI input device with index " + ToString(MIDIDeviceId));
-         pSamplerChannel->SetMidiInputDevice(oldtype, (MidiInputDevice::midi_chan_t) MIDIChannel);
+         MidiInputDevice* pDevice = devices[MIDIDeviceId];
+         pSamplerChannel->SetMidiInput(pDevice, MIDIPort, (midi_chan_t) MIDIChannel);
      }
-     catch (LinuxSamplerException e) {
+     catch (Exception e) {
           result.Error(e);
      }
      return result.Produce();
-Line 391 
 String LSCPServer::SetMIDIInputChannel(u
+Line 1450 
 String LSCPServer::SetMIDIInputChannel(u
   * Will be called by the parser to change the global volume factor on a
   * particular sampler channel.
   */
- String LSCPServer::SetVolume(double Volume, uint uiSamplerChannel) {
+ String LSCPServer::SetVolume(double dVolume, uint uiSamplerChannel) {
-     dmsg(2,("LSCPServer: SetVolume(Volume=%f, SamplerChannel=%d)\n", Volume, uiSamplerChannel));
+     dmsg(2,("LSCPServer: SetVolume(Volume=%f, SamplerChannel=%d)\n", dVolume, uiSamplerChannel));
      LSCPResultSet result;
      try {
          SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
-         if (!pSamplerChannel) throw LinuxSamplerException("Index out of bounds");
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
-         Engine* pEngine = pSamplerChannel->GetEngine();
+         EngineChannel* pEngineChannel = pSamplerChannel->GetEngineChannel();
-         if (!pEngine) throw LinuxSamplerException("No engine loaded on channel");
+         if (!pEngineChannel) throw Exception("No engine type assigned to sampler channel");
-         pEngine->Volume(Volume);
+         pEngineChannel->Volume(dVolume);
      }
-     catch (LinuxSamplerException e) {
+     catch (Exception e) {
           result.Error(e);
      }
      return result.Produce();
  }
  /**
+  * Will be called by the parser to mute/unmute particular sampler channel.
+  */
+ String LSCPServer::SetChannelMute(bool bMute, uint uiSamplerChannel) {
+     dmsg(2,("LSCPServer: SetChannelMute(bMute=%d,uiSamplerChannel=%d)\n",bMute,uiSamplerChannel));
+     LSCPResultSet result;
+     try {
+         SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
+         EngineChannel* pEngineChannel = pSamplerChannel->GetEngineChannel();
+         if (!pEngineChannel) throw Exception("No engine type assigned to sampler channel");
+         if(!bMute) pEngineChannel->SetMute((HasSoloChannel() && !pEngineChannel->GetSolo()) ? -1 : 0);
+         else pEngineChannel->SetMute(1);
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ /**
+  * Will be called by the parser to solo particular sampler channel.
+  */
+ String LSCPServer::SetChannelSolo(bool bSolo, uint uiSamplerChannel) {
+     dmsg(2,("LSCPServer: SetChannelSolo(bSolo=%d,uiSamplerChannel=%d)\n",bSolo,uiSamplerChannel));
+     LSCPResultSet result;
+     try {
+         SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
+         EngineChannel* pEngineChannel = pSamplerChannel->GetEngineChannel();
+         if (!pEngineChannel) throw Exception("No engine type assigned to sampler channel");
+         bool oldSolo = pEngineChannel->GetSolo();
+         bool hadSoloChannel = HasSoloChannel();
+         pEngineChannel->SetSolo(bSolo);
+         if(!oldSolo && bSolo) {
+             if(pEngineChannel->GetMute() == -1) pEngineChannel->SetMute(0);
+             if(!hadSoloChannel) MuteNonSoloChannels();
+         }
+         if(oldSolo && !bSolo) {
+             if(!HasSoloChannel()) UnmuteChannels();
+             else if(!pEngineChannel->GetMute()) pEngineChannel->SetMute(-1);
+         }
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ /**
+  * Determines whether there is at least one solo channel in the channel list.
+  *
+  * @returns true if there is at least one solo channel in the channel list,
+  * false otherwise.
+  */
+ bool LSCPServer::HasSoloChannel() {
+     std::map<uint,SamplerChannel*> channels = pSampler->GetSamplerChannels();
+     std::map<uint,SamplerChannel*>::iterator iter = channels.begin();
+     for (; iter != channels.end(); iter++) {
+         EngineChannel* c = iter->second->GetEngineChannel();
+         if(c && c->GetSolo()) return true;
+     }
+     return false;
+ }
+ /**
+  * Mutes all unmuted non-solo channels. Notice that the channels are muted
+  * with -1 which indicates that they are muted because of the presence
+  * of a solo channel(s). Channels muted with -1 will be automatically unmuted
+  * when there are no solo channels left.
+  */
+ void LSCPServer::MuteNonSoloChannels() {
+     dmsg(2,("LSCPServer: MuteNonSoloChannels()\n"));
+     std::map<uint,SamplerChannel*> channels = pSampler->GetSamplerChannels();
+     std::map<uint,SamplerChannel*>::iterator iter = channels.begin();
+     for (; iter != channels.end(); iter++) {
+         EngineChannel* c = iter->second->GetEngineChannel();
+         if(c && !c->GetSolo() && !c->GetMute()) c->SetMute(-1);
+     }
+ }
+ /**
+  * Unmutes all channels that are muted because of the presence
+  * of a solo channel(s).
+  */
+ void  LSCPServer::UnmuteChannels() {
+     dmsg(2,("LSCPServer: UnmuteChannels()\n"));
+     std::map<uint,SamplerChannel*> channels = pSampler->GetSamplerChannels();
+     std::map<uint,SamplerChannel*>::iterator iter = channels.begin();
+     for (; iter != channels.end(); iter++) {
+         EngineChannel* c = iter->second->GetEngineChannel();
+         if(c && c->GetMute() == -1) c->SetMute(0);
+     }
+ }
+ String LSCPServer::AddOrReplaceMIDIInstrumentMapping(uint MidiMapID, uint MidiBank, uint MidiProg, String EngineType, String InstrumentFile, uint InstrumentIndex, float Volume, MidiInstrumentMapper::mode_t LoadMode, String Name) {
+     dmsg(2,("LSCPServer: AddOrReplaceMIDIInstrumentMapping()\n"));
+     midi_prog_index_t idx;
+     idx.midi_bank_msb = (MidiBank >> 7) & 0x7f;
+     idx.midi_bank_lsb = MidiBank & 0x7f;
+     idx.midi_prog     = MidiProg;
+     MidiInstrumentMapper::entry_t entry;
+     entry.EngineName      = EngineType;
+     entry.InstrumentFile  = InstrumentFile;
+     entry.InstrumentIndex = InstrumentIndex;
+     entry.LoadMode        = LoadMode;
+     entry.Volume          = Volume;
+     entry.Name            = Name;
+     LSCPResultSet result;
+     try {
+         // PERSISTENT mapping commands might bloock for a long time, so in
+         // that case we add/replace the mapping in another thread
+         bool bInBackground = (entry.LoadMode == MidiInstrumentMapper::PERSISTENT);
+         MidiInstrumentMapper::AddOrReplaceEntry(MidiMapID, idx, entry, bInBackground);
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::RemoveMIDIInstrumentMapping(uint MidiMapID, uint MidiBank, uint MidiProg) {
+     dmsg(2,("LSCPServer: RemoveMIDIInstrumentMapping()\n"));
+     midi_prog_index_t idx;
+     idx.midi_bank_msb = (MidiBank >> 7) & 0x7f;
+     idx.midi_bank_lsb = MidiBank & 0x7f;
+     idx.midi_prog     = MidiProg;
+     LSCPResultSet result;
+     try {
+         MidiInstrumentMapper::RemoveEntry(MidiMapID, idx);
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::GetMidiInstrumentMappings(uint MidiMapID) {
+     dmsg(2,("LSCPServer: GetMidiInstrumentMappings()\n"));
+     LSCPResultSet result;
+     try {
+         result.Add(MidiInstrumentMapper::Entries(MidiMapID).size());
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::GetAllMidiInstrumentMappings() {
+     dmsg(2,("LSCPServer: GetAllMidiInstrumentMappings()\n"));
+     LSCPResultSet result;
+     std::vector<int> maps = MidiInstrumentMapper::Maps();
+     int totalMappings = 0;
+     for (int i = 0; i < maps.size(); i++) {
+         try {
+             totalMappings += MidiInstrumentMapper::Entries(maps[i]).size();
+         } catch (Exception e) { /*NOOP*/ }
+     }
+     result.Add(totalMappings);
+     return result.Produce();
+ }
+ String LSCPServer::GetMidiInstrumentMapping(uint MidiMapID, uint MidiBank, uint MidiProg) {
+     dmsg(2,("LSCPServer: GetMidiIstrumentMapping()\n"));
+     LSCPResultSet result;
+     try {
+         midi_prog_index_t idx;
+         idx.midi_bank_msb = (MidiBank >> 7) & 0x7f;
+         idx.midi_bank_lsb = MidiBank & 0x7f;
+         idx.midi_prog     = MidiProg;
+         std::map<midi_prog_index_t,MidiInstrumentMapper::entry_t> mappings = MidiInstrumentMapper::Entries(MidiMapID);
+         std::map<midi_prog_index_t,MidiInstrumentMapper::entry_t>::iterator iter = mappings.find(idx);
+         if (iter == mappings.end()) result.Error("there is no map entry with that index");
+         else { // found
+             result.Add("NAME", iter->second.Name);
+             result.Add("ENGINE_NAME", iter->second.EngineName);
+             result.Add("INSTRUMENT_FILE", iter->second.InstrumentFile);
+             result.Add("INSTRUMENT_NR", (int) iter->second.InstrumentIndex);
+             String instrumentName;
+             Engine* pEngine = EngineFactory::Create(iter->second.EngineName);
+             if (pEngine) {
+                 if (pEngine->GetInstrumentManager()) {
+                     InstrumentManager::instrument_id_t instrID;
+                     instrID.FileName = iter->second.InstrumentFile;
+                     instrID.Index    = iter->second.InstrumentIndex;
+                     instrumentName = pEngine->GetInstrumentManager()->GetInstrumentName(instrID);
+                 }
+                 EngineFactory::Destroy(pEngine);
+             }
+             result.Add("INSTRUMENT_NAME", instrumentName);
+             switch (iter->second.LoadMode) {
+                 case MidiInstrumentMapper::ON_DEMAND:
+                     result.Add("LOAD_MODE", "ON_DEMAND");
+                     break;
+                 case MidiInstrumentMapper::ON_DEMAND_HOLD:
+                     result.Add("LOAD_MODE", "ON_DEMAND_HOLD");
+                     break;
+                 case MidiInstrumentMapper::PERSISTENT:
+                     result.Add("LOAD_MODE", "PERSISTENT");
+                     break;
+                 default:
+                     throw Exception("entry reflects invalid LOAD_MODE, consider this as a bug!");
+             }
+             result.Add("VOLUME", iter->second.Volume);
+         }
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::ListMidiInstrumentMappings(uint MidiMapID) {
+     dmsg(2,("LSCPServer: ListMidiInstrumentMappings()\n"));
+     LSCPResultSet result;
+     try {
+         String s;
+         std::map<midi_prog_index_t,MidiInstrumentMapper::entry_t> mappings = MidiInstrumentMapper::Entries(MidiMapID);
+         std::map<midi_prog_index_t,MidiInstrumentMapper::entry_t>::iterator iter = mappings.begin();
+         for (; iter != mappings.end(); iter++) {
+             if (s.size()) s += ",";
+             s += "{" + ToString(MidiMapID) + ","
+                      + ToString((int(iter->first.midi_bank_msb) << 7) & int(iter->first.midi_bank_lsb)) + ","
+                      + ToString(int(iter->first.midi_prog)) + "}";
+         }
+         result.Add(s);
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::ListAllMidiInstrumentMappings() {
+     dmsg(2,("LSCPServer: ListAllMidiInstrumentMappings()\n"));
+     LSCPResultSet result;
+     try {
+         std::vector<int> maps = MidiInstrumentMapper::Maps();
+         String s;
+         for (int i = 0; i < maps.size(); i++) {
+             std::map<midi_prog_index_t,MidiInstrumentMapper::entry_t> mappings = MidiInstrumentMapper::Entries(maps[i]);
+             std::map<midi_prog_index_t,MidiInstrumentMapper::entry_t>::iterator iter = mappings.begin();
+             for (; iter != mappings.end(); iter++) {
+                 if (s.size()) s += ",";
+                 s += "{" + ToString(maps[i]) + ","
+                          + ToString((int(iter->first.midi_bank_msb) << 7) & int(iter->first.midi_bank_lsb)) + ","
+                          + ToString(int(iter->first.midi_prog)) + "}";
+             }
+         }
+         result.Add(s);
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::ClearMidiInstrumentMappings(uint MidiMapID) {
+     dmsg(2,("LSCPServer: ClearMidiInstrumentMappings()\n"));
+     LSCPResultSet result;
+     try {
+         MidiInstrumentMapper::RemoveAllEntries(MidiMapID);
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::ClearAllMidiInstrumentMappings() {
+     dmsg(2,("LSCPServer: ClearAllMidiInstrumentMappings()\n"));
+     LSCPResultSet result;
+     try {
+         std::vector<int> maps = MidiInstrumentMapper::Maps();
+         for (int i = 0; i < maps.size(); i++)
+             MidiInstrumentMapper::RemoveAllEntries(maps[i]);
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::AddMidiInstrumentMap(String MapName) {
+     dmsg(2,("LSCPServer: AddMidiInstrumentMap()\n"));
+     LSCPResultSet result;
+     try {
+         int MapID = MidiInstrumentMapper::AddMap(MapName);
+         result = LSCPResultSet(MapID);
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::RemoveMidiInstrumentMap(uint MidiMapID) {
+     dmsg(2,("LSCPServer: RemoveMidiInstrumentMap()\n"));
+     LSCPResultSet result;
+     try {
+         MidiInstrumentMapper::RemoveMap(MidiMapID);
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::RemoveAllMidiInstrumentMaps() {
+     dmsg(2,("LSCPServer: RemoveAllMidiInstrumentMaps()\n"));
+     LSCPResultSet result;
+     try {
+         MidiInstrumentMapper::RemoveAllMaps();
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::GetMidiInstrumentMaps() {
+     dmsg(2,("LSCPServer: GetMidiInstrumentMaps()\n"));
+     LSCPResultSet result;
+     try {
+         result.Add(MidiInstrumentMapper::Maps().size());
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::ListMidiInstrumentMaps() {
+     dmsg(2,("LSCPServer: ListMidiInstrumentMaps()\n"));
+     LSCPResultSet result;
+     try {
+         std::vector<int> maps = MidiInstrumentMapper::Maps();
+         String sList;
+         for (int i = 0; i < maps.size(); i++) {
+             if (sList != "") sList += ",";
+             sList += ToString(maps[i]);
+         }
+         result.Add(sList);
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::GetMidiInstrumentMap(uint MidiMapID) {
+     dmsg(2,("LSCPServer: GetMidiInstrumentMap()\n"));
+     LSCPResultSet result;
+     try {
+         result.Add("NAME", MidiInstrumentMapper::MapName(MidiMapID));
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::SetMidiInstrumentMapName(uint MidiMapID, String NewName) {
+     dmsg(2,("LSCPServer: SetMidiInstrumentMapName()\n"));
+     LSCPResultSet result;
+     try {
+         MidiInstrumentMapper::RenameMap(MidiMapID, NewName);
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ /**
+  * Set the MIDI instrument map the given sampler channel shall use for
+  * handling MIDI program change messages. There are the following two
+  * special (negative) values:
+  *
+  *    - (-1) :  set to NONE (ignore program changes)
+  *    - (-2) :  set to DEFAULT map
+  */
+ String LSCPServer::SetChannelMap(uint uiSamplerChannel, int MidiMapID) {
+     dmsg(2,("LSCPServer: SetChannelMap()\n"));
+     LSCPResultSet result;
+     try {
+         SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
+         EngineChannel* pEngineChannel = pSamplerChannel->GetEngineChannel();
+         if (!pEngineChannel) throw Exception("There is no engine deployed on this sampler channel yet");
+         if      (MidiMapID == -1) pEngineChannel->SetMidiInstrumentMapToNone();
+         else if (MidiMapID == -2) pEngineChannel->SetMidiInstrumentMapToDefault();
+         else                      pEngineChannel->SetMidiInstrumentMap(MidiMapID);
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::CreateFxSend(uint uiSamplerChannel, uint MidiCtrl, String Name) {
+     dmsg(2,("LSCPServer: CreateFxSend()\n"));
+     LSCPResultSet result;
+     try {
+         SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
+         EngineChannel* pEngineChannel = pSamplerChannel->GetEngineChannel();
+         if (!pEngineChannel) throw Exception("There is no engine deployed on this sampler channel yet");
+         FxSend* pFxSend = pEngineChannel->AddFxSend(MidiCtrl, Name);
+         if (!pFxSend) throw Exception("Could not add FxSend, don't ask, I don't know why (probably a bug)");
+         result = LSCPResultSet(pFxSend->Id()); // success
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::DestroyFxSend(uint uiSamplerChannel, uint FxSendID) {
+     dmsg(2,("LSCPServer: DestroyFxSend()\n"));
+     LSCPResultSet result;
+     try {
+         SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
+         EngineChannel* pEngineChannel = pSamplerChannel->GetEngineChannel();
+         if (!pEngineChannel) throw Exception("There is no engine deployed on this sampler channel yet");
+         FxSend* pFxSend = NULL;
+         for (int i = 0; i < pEngineChannel->GetFxSendCount(); i++) {
+             if (pEngineChannel->GetFxSend(i)->Id() == FxSendID) {
+                 pFxSend = pEngineChannel->GetFxSend(i);
+                 break;
+             }
+         }
+         if (!pFxSend) throw Exception("There is no FxSend with that ID on the given sampler channel");
+         pEngineChannel->RemoveFxSend(pFxSend);
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::GetFxSends(uint uiSamplerChannel) {
+     dmsg(2,("LSCPServer: GetFxSends()\n"));
+     LSCPResultSet result;
+     try {
+         SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
+         EngineChannel* pEngineChannel = pSamplerChannel->GetEngineChannel();
+         if (!pEngineChannel) throw Exception("There is no engine deployed on this sampler channel yet");
+         result.Add(pEngineChannel->GetFxSendCount());
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::ListFxSends(uint uiSamplerChannel) {
+     dmsg(2,("LSCPServer: ListFxSends()\n"));
+     LSCPResultSet result;
+     String list;
+     try {
+         SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
+         EngineChannel* pEngineChannel = pSamplerChannel->GetEngineChannel();
+         if (!pEngineChannel) throw Exception("There is no engine deployed on this sampler channel yet");
+         for (int i = 0; i < pEngineChannel->GetFxSendCount(); i++) {
+             FxSend* pFxSend = pEngineChannel->GetFxSend(i);
+             if (list != "") list += ",";
+             list += ToString(pFxSend->Id());
+         }
+         result.Add(list);
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::GetFxSendInfo(uint uiSamplerChannel, uint FxSendID) {
+     dmsg(2,("LSCPServer: GetFxSendInfo()\n"));
+     LSCPResultSet result;
+     try {
+         SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
+         EngineChannel* pEngineChannel = pSamplerChannel->GetEngineChannel();
+         if (!pEngineChannel) throw Exception("There is no engine deployed on this sampler channel yet");
+         FxSend* pFxSend = NULL;
+         for (int i = 0; i < pEngineChannel->GetFxSendCount(); i++) {
+             if (pEngineChannel->GetFxSend(i)->Id() == FxSendID) {
+                 pFxSend = pEngineChannel->GetFxSend(i);
+                 break;
+             }
+         }
+         if (!pFxSend) throw Exception("There is no FxSend with that ID on the given sampler channel");
+         // gather audio routing informations
+         String AudioRouting;
+         for (int chan = 0; chan < pEngineChannel->Channels(); chan++) {
+             if (AudioRouting != "") AudioRouting += ",";
+             AudioRouting += ToString(pFxSend->DestinationChannel(chan));
+         }
+         // success
+         result.Add("NAME", pFxSend->Name());
+         result.Add("AUDIO_OUTPUT_ROUTING", AudioRouting);
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ String LSCPServer::SetFxSendAudioOutputChannel(uint uiSamplerChannel, uint FxSendID, uint FxSendChannel, uint DeviceChannel) {
+     dmsg(2,("LSCPServer: SetFxSendAudioOutputChannel()\n"));
+     LSCPResultSet result;
+     try {
+         SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
+         EngineChannel* pEngineChannel = pSamplerChannel->GetEngineChannel();
+         if (!pEngineChannel) throw Exception("There is no engine deployed on this sampler channel yet");
+         FxSend* pFxSend = NULL;
+         for (int i = 0; i < pEngineChannel->GetFxSendCount(); i++) {
+             if (pEngineChannel->GetFxSend(i)->Id() == FxSendID) {
+                 pFxSend = pEngineChannel->GetFxSend(i);
+                 break;
+             }
+         }
+         if (!pFxSend) throw Exception("There is no FxSend with that ID on the given sampler channel");
+         pFxSend->SetDestinationChannel(FxSendChannel, DeviceChannel);
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ /**
   * Will be called by the parser to reset a particular sampler channel.
   */
  String LSCPServer::ResetChannel(uint uiSamplerChannel) {
-Line 415 
 String LSCPServer::ResetChannel(uint uiS
+Line 2020 
 String LSCPServer::ResetChannel(uint uiS
      LSCPResultSet result;
      try {
          SamplerChannel* pSamplerChannel = pSampler->GetSamplerChannel(uiSamplerChannel);
-         if (!pSamplerChannel) throw LinuxSamplerException("Index out of bounds");
+         if (!pSamplerChannel) throw Exception("Invalid sampler channel number " + ToString(uiSamplerChannel));
-         Engine* pEngine = pSamplerChannel->GetEngine();
+         EngineChannel* pEngineChannel = pSamplerChannel->GetEngineChannel();
-         if (!pEngine) throw LinuxSamplerException("No engine loaded on channel");
+         if (!pEngineChannel) throw Exception("No engine type assigned to sampler channel");
-         pEngine->Reset();
+         pEngineChannel->Reset();
      }
-     catch (LinuxSamplerException e) {
+     catch (Exception e) {
           result.Error(e);
      }
      return result.Produce();
  }
  /**
+  * Will be called by the parser to reset the whole sampler.
+  */
+ String LSCPServer::ResetSampler() {
+     dmsg(2,("LSCPServer: ResetSampler()\n"));
+     pSampler->Reset();
+     LSCPResultSet result;
+     return result.Produce();
+ }
+ /**
+  * Will be called by the parser to return general informations about this
+  * sampler.
+  */
+ String LSCPServer::GetServerInfo() {
+     dmsg(2,("LSCPServer: GetServerInfo()\n"));
+     LSCPResultSet result;
+     result.Add("DESCRIPTION", "LinuxSampler - modular, streaming capable sampler");
+     result.Add("VERSION", VERSION);
+     result.Add("PROTOCOL_VERSION", ToString(LSCP_RELEASE_MAJOR) + "." + ToString(LSCP_RELEASE_MINOR));
+     return result.Produce();
+ }
+ /**
+  * Will be called by the parser to return the current number of all active voices.
+  */
+ String LSCPServer::GetTotalVoiceCount() {
+     dmsg(2,("LSCPServer: GetTotalVoiceCount()\n"));
+     LSCPResultSet result;
+     result.Add(pSampler->GetVoiceCount());
+     return result.Produce();
+ }
+ /**
+  * Will be called by the parser to return the maximum number of voices.
+  */
+ String LSCPServer::GetTotalVoiceCountMax() {
+     dmsg(2,("LSCPServer: GetTotalVoiceCountMax()\n"));
+     LSCPResultSet result;
+     result.Add(EngineFactory::EngineInstances().size() * CONFIG_MAX_VOICES);
+     return result.Produce();
+ }
+ String LSCPServer::GetGlobalVolume() {
+     LSCPResultSet result;
+     result.Add(ToString(GLOBAL_VOLUME)); // see common/global.cpp
+     return result.Produce();
+ }
+ String LSCPServer::SetGlobalVolume(double dVolume) {
+     LSCPResultSet result;
+     try {
+         if (dVolume < 0) throw Exception("Volume may not be negative");
+         GLOBAL_VOLUME = dVolume; // see common/global.cpp
+     } catch (Exception e) {
+         result.Error(e);
+     }
+     return result.Produce();
+ }
+ /**
   * Will be called by the parser to subscribe a client (frontend) on the
   * server for receiving event messages.
   */
- String LSCPServer::SubscribeNotification(uint UDPPort) {
+ String LSCPServer::SubscribeNotification(LSCPEvent::event_t type) {
-     dmsg(2,("LSCPServer: SubscribeNotification(UDPPort=%d)\n", UDPPort));
+     dmsg(2,("LSCPServer: SubscribeNotification(Event=%s)\n", LSCPEvent::Name(type).c_str()));
-     return "ERR:0:Not implemented yet.\r\n";
+     LSCPResultSet result;
+     SubscriptionMutex.Lock();
+     eventSubscriptions[type].push_back(currentSocket);
+     SubscriptionMutex.Unlock();
+     return result.Produce();
  }
  /**
   * Will be called by the parser to unsubscribe a client on the server
   * for not receiving further event messages.
   */
- String LSCPServer::UnsubscribeNotification(String SessionID) {
+ String LSCPServer::UnsubscribeNotification(LSCPEvent::event_t type) {
-     dmsg(2,("LSCPServer: UnsubscribeNotification(SessionID=%s)\n", SessionID.c_str()));
+     dmsg(2,("LSCPServer: UnsubscribeNotification(Event=%s)\n", LSCPEvent::Name(type).c_str()));
-     return "ERR:0:Not implemented yet.\r\n";
+     LSCPResultSet result;
+     SubscriptionMutex.Lock();
+     eventSubscriptions[type].remove(currentSocket);
+     SubscriptionMutex.Unlock();
+     return result.Produce();
+ }
+ static int select_callback(void * lscpResultSet, int argc,
+                         char **argv, char **azColName)
+ {
+     LSCPResultSet* resultSet = (LSCPResultSet*) lscpResultSet;
+     resultSet->Add(argc, argv);
+     return 0;
+ }
+ String LSCPServer::QueryDatabase(String query) {
+     LSCPResultSet result;
+ #if HAVE_SQLITE3
+     char* zErrMsg = NULL;
+     sqlite3 *db;
+     String selectStr = "SELECT " + query;
+     int rc = sqlite3_open("linuxsampler.db", &db);
+     if (rc == SQLITE_OK)
+     {
+             rc = sqlite3_exec(db, selectStr.c_str(), select_callback, &result, &zErrMsg);
+     }
+     if ( rc != SQLITE_OK )
+     {
+             result.Error(String(zErrMsg), rc);
+     }
+     sqlite3_close(db);
+ #else
+     result.Error(String("SQLITE3 was not installed when linuxsampler was built. SELECT statement is not available."), 0);
+ #endif
+     return result.Produce();
+ }
+ /**
+  * Will be called by the parser to enable or disable echo mode; if echo
+  * mode is enabled, all commands from the client will (immediately) be
+  * echoed back to the client.
+  */
+ String LSCPServer::SetEcho(yyparse_param_t* pSession, double boolean_value) {
+     dmsg(2,("LSCPServer: SetEcho(val=%f)\n", boolean_value));
+     LSCPResultSet result;
+     try {
+         if      (boolean_value == 0) pSession->bVerbose = false;
+         else if (boolean_value == 1) pSession->bVerbose = true;
+         else throw Exception("Not a boolean value, must either be 0 or 1");
+     }
+     catch (Exception e) {
+          result.Error(e);
+     }
+     return result.Produce();
  }

 Legend:



Removed from v.121
 


changed lines


 
Added in v.1005
 Legend:



Removed from v.121
 


changed lines


 
Added in v.1005
-Removed from v.121
+Added in v.1005

	ViewVC Help
Powered by ViewVC