/[svn]/linuxsampler/trunk/src/network/lscpserver.h
ViewVC logotype

Contents of /linuxsampler/trunk/src/network/lscpserver.h

Parent Directory Parent Directory | Revision Log Revision Log


Revision 527 - (show annotations) (download) (as text)
Mon May 9 11:59:58 2005 UTC (15 years, 8 months ago) by capela
File MIME type: text/x-c++hdr
File size: 8994 byte(s)
* [bug #9] Fixed for a LSCP command syntax convention
  consistency, regarding the enumeration of available
  sampler engines, Audio and MIDI drivers; this has
  affected the semantics of the following commands:
    GET AVAILABLE_ENGINES
    GET AVAILABLE_AUDIO_DRIVERS
    GET AVAILABLE_MIDI_DRIVERS
  which are now returning an integer count of engines
  and drivers, respectively, while the following
  new commands are now being introduced:
    LIST AVAILABLE_ENGINES
    LIST AVAILABLE_AUDIO_DRIVERS
    LIST AVAILABLE_MIDI_DRIVERS
  taking on the previous functionality, returning
  a comma separated list of names.

* LinuxSampler version bumped to 0.3.1.

1 /***************************************************************************
2 * *
3 * LinuxSampler - modular, streaming capable sampler *
4 * *
5 * Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck *
6 * Copyright (C) 2005 Christian Schoenebeck *
7 * *
8 * This library is free software; you can redistribute it and/or modify *
9 * it under the terms of the GNU General Public License as published by *
10 * the Free Software Foundation; either version 2 of the License, or *
11 * (at your option) any later version. *
12 * *
13 * This library is distributed in the hope that it will be useful, *
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
16 * GNU General Public License for more details. *
17 * *
18 * You should have received a copy of the GNU General Public License *
19 * along with this library; if not, write to the Free Software *
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, *
21 * MA 02111-1307 USA *
22 ***************************************************************************/
23
24 #ifndef __LSCPSERVER_H_
25 #define __LSCPSERVER_H_
26
27 #include <unistd.h>
28 #include <sys/types.h>
29 #include <sys/socket.h>
30 #include <sys/select.h>
31 #include <sys/time.h>
32 #include <netinet/in.h>
33 #include <netinet/tcp.h>
34 #include <arpa/inet.h>
35 #include <netdb.h>
36
37 #include <list>
38
39 #include "lscp.h"
40 #include "lscpparser.h"
41 #include "lscp.h"
42 #include "lscpevent.h"
43 #include "lscpinstrumentloader.h"
44 #include "../Sampler.h"
45 #include "../common/Thread.h"
46 #include "../common/Mutex.h"
47 #include "../common/Condition.h"
48
49 /// TCP Port on which the server should listen for connection requests.
50 #define LSCP_PORT 8888
51
52 /// try up to 3 minutes to bind server socket
53 #define LSCP_SERVER_BIND_TIMEOUT 180
54
55 using namespace LinuxSampler;
56
57 // External references to the main scanner and parser functions
58 extern int yyparse(void* YYPARSE_PARAM);
59 extern void restart(yyparse_param_t* pparam, int& yychar);
60
61 /**
62 * Network server for the LinuxSampler Control Protocol (LSCP).
63 */
64 class LSCPServer : public Thread {
65 public:
66 LSCPServer(Sampler* pSampler);
67 virtual ~LSCPServer();
68 int WaitUntilInitialized(long TimeoutSeconds = 0L, long TimeoutNanoSeconds = 0L);
69
70 // Methods called by the parser
71 String DestroyAudioOutputDevice(uint DeviceIndex);
72 String DestroyMidiInputDevice(uint DeviceIndex);
73 String LoadInstrument(String Filename, uint uiInstrument, uint uiSamplerChannel, bool bBackground = false);
74 String SetEngineType(String EngineName, uint uiSamplerChannel);
75 String GetChannels();
76 String ListChannels();
77 String AddChannel();
78 String RemoveChannel(uint uiSamplerChannel);
79 String GetAvailableEngines();
80 String ListAvailableEngines();
81 String GetEngineInfo(String EngineName);
82 String GetChannelInfo(uint uiSamplerChannel);
83 String GetVoiceCount(uint uiSamplerChannel);
84 String GetStreamCount(uint uiSamplerChannel);
85 String GetBufferFill(fill_response_t ResponseType, uint uiSamplerChannel);
86 String GetAvailableAudioOutputDrivers();
87 String ListAvailableAudioOutputDrivers();
88 String GetAvailableMidiInputDrivers();
89 String ListAvailableMidiInputDrivers();
90 String GetAudioOutputDriverInfo(String Driver);
91 String GetMidiInputDriverInfo(String Driver);
92 #ifdef __GNUC__
93 typedef std::map<String,String> StringMap; // nasty workaround for a GCC bug (see GCC bug #15980, #57)
94 String GetAudioOutputDriverParameterInfo(String Driver, String Parameter, std::map<String,String> DependencyList = StringMap());
95 String GetMidiInputDriverParameterInfo(String Driver, String Parameter, std::map<String,String> DependencyList = StringMap());
96 String CreateAudioOutputDevice(String Driver, std::map<String,String> Parameters = StringMap());
97 String CreateMidiInputDevice(String Driver, std::map<String,String> Parameters = StringMap());
98 #else
99 String GetAudioOutputDriverParameterInfo(String Driver, String Parameter, std::map<String,String> DependencyList = std::map<String,String>());
100 String GetMidiInputDriverParameterInfo(String Driver, String Parameter, std::map<String,String> DependencyList = std::map<String,String>());
101 String CreateAudioOutputDevice(String Driver, std::map<String,String> Parameters = std::map<String,String>());
102 String CreateMidiInputDevice(String Driver, std::map<String,String> Parameters = std::map<String,String>());
103 #endif // __GNUC__
104 String GetAudioOutputDeviceCount();
105 String GetMidiInputDeviceCount();
106 String GetAudioOutputDevices();
107 String GetMidiInputDevices();
108 String GetAudioOutputDeviceInfo(uint DeviceIndex);
109 String GetMidiInputDeviceInfo(uint DeviceIndex);
110 String GetMidiInputPortInfo(uint DeviceIndex, uint PortIndex);
111 String GetMidiInputPortParameterInfo(uint DeviceId, uint PortId, String ParameterName);
112 String GetAudioOutputChannelInfo(uint DeviceId, uint ChannelId);
113 String GetAudioOutputChannelParameterInfo(uint DeviceId, uint ChannelId, String ParameterName);
114 String SetAudioOutputChannelParameter(uint DeviceId, uint ChannelId, String ParamKey, String ParamVal);
115 String SetAudioOutputDeviceParameter(uint DeviceIndex, String ParamKey, String ParamVal);
116 String SetMidiInputDeviceParameter(uint DeviceIndex, String ParamKey, String ParamVal);
117 String SetMidiInputPortParameter(uint DeviceIndex, uint PortIndex, String ParamKey, String ParamVal);
118 String SetAudioOutputChannel(uint ChannelAudioOutputChannel, uint AudioOutputDeviceInputChannel, uint uiSamplerChannel);
119 String SetAudioOutputDevice(uint AudioDeviceId, uint SamplerChannel);
120 String SetAudioOutputType(String AudioOutputDriver, uint uiSamplerChannel);
121 String SetMIDIInputPort(uint MIDIPort, uint uiSamplerChannel);
122 String SetMIDIInputChannel(uint MIDIChannel, uint uiSamplerChannel);
123 String SetMIDIInputDevice(uint MIDIDeviceId, uint uiSamplerChannel);
124 String SetMIDIInputType(String MidiInputDriver, uint uiSamplerChannel);
125 String SetMIDIInput(uint MIDIDeviceId, uint MIDIPort, uint MIDIChannel, uint uiSamplerChannel);
126 String SetVolume(double dVolume, uint uiSamplerChannel);
127 String ResetChannel(uint uiSamplerChannel);
128 String ResetSampler();
129 String SubscribeNotification(LSCPEvent::event_t);
130 String UnsubscribeNotification(LSCPEvent::event_t);
131 String QueryDatabase(String query);
132 String SetEcho(yyparse_param_t* pSession, double boolean_value);
133 void AnswerClient(String ReturnMessage);
134
135 static int currentSocket;
136 static std::map<int,String> bufferedCommands;
137
138 static void SendLSCPNotify( LSCPEvent Event );
139 static int EventSubscribers( std::list<LSCPEvent::event_t> events );
140 static void LockRTNotify( void ) { RTNotifyMutex.Lock(); }
141 static void UnlockRTNotify( void ) { RTNotifyMutex.Unlock(); }
142
143 protected:
144 int hSocket;
145 sockaddr_in SocketAddress;
146 Sampler* pSampler;
147 Condition Initialized;
148 LSCPInstrumentLoader InstrumentLoader; ///< thread responsible for loading instruments in the background
149
150 int Main(); ///< Implementation of virtual method from class Thread
151
152 private:
153
154 /**
155 * Find a created audio output device index.
156 */
157 int GetAudioOutputDeviceIndex (AudioOutputDevice *pDevice);
158
159 /**
160 * Find a created midi input device index.
161 */
162 int GetMidiInputDeviceIndex (MidiInputDevice *pDevice);
163
164 static std::map<int,String> bufferedNotifies;
165 static Mutex NotifyMutex;
166 static Mutex NotifyBufferMutex;
167 static bool GetLSCPCommand( std::vector<yyparse_param_t>::iterator iter );
168 static void CloseConnection( std::vector<yyparse_param_t>::iterator iter );
169 static std::vector<yyparse_param_t> Sessions;
170 static Mutex SubscriptionMutex;
171 static std::map< LSCPEvent::event_t, std::list<int> > eventSubscriptions;
172 static fd_set fdSet;
173
174 //Protect main thread that generates real time notify messages
175 //like voice count, stream count and buffer fill
176 //from LSCP server removing engines and channels from underneath
177 static Mutex RTNotifyMutex;
178 };
179
180 #endif // __LSCPSERVER_H_

  ViewVC Help
Powered by ViewVC