/[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 1130 - (show annotations) (download) (as text)
Sun Mar 25 18:59:14 2007 UTC (17 years ago) by iliev
File MIME type: text/x-c++hdr
File size: 16777 byte(s)
* Implemented new, improved notification system

1 /***************************************************************************
2 * *
3 * LinuxSampler - modular, streaming capable sampler *
4 * *
5 * Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck *
6 * Copyright (C) 2005 - 2007 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 "../Sampler.h"
44 #include "../common/Thread.h"
45 #include "../common/Mutex.h"
46 #include "../common/Condition.h"
47
48 #include "../drivers/midi/MidiInstrumentMapper.h"
49
50 /// TCP Port on which the server should listen for connection requests.
51 #define LSCP_ADDR INADDR_ANY
52 #define LSCP_PORT 8888
53
54 /// try up to 3 minutes to bind server socket
55 #define LSCP_SERVER_BIND_TIMEOUT 180
56
57 using namespace LinuxSampler;
58
59 // External references to the main scanner and parser functions
60 extern int yyparse(void* YYPARSE_PARAM);
61 extern void restart(yyparse_param_t* pparam, int& yychar);
62
63 /**
64 * Network server for the LinuxSampler Control Protocol (LSCP).
65 */
66 class LSCPServer : public Thread {
67 public:
68 LSCPServer(Sampler* pSampler, long int addr, short int port);
69 virtual ~LSCPServer();
70 int WaitUntilInitialized(long TimeoutSeconds = 0L, long TimeoutNanoSeconds = 0L);
71
72 // Methods called by the parser
73 String DestroyAudioOutputDevice(uint DeviceIndex);
74 String DestroyMidiInputDevice(uint DeviceIndex);
75 String LoadInstrument(String Filename, uint uiInstrument, uint uiSamplerChannel, bool bBackground = false);
76 String SetEngineType(String EngineName, uint uiSamplerChannel);
77 String GetChannels();
78 String ListChannels();
79 String AddChannel();
80 String RemoveChannel(uint uiSamplerChannel);
81 String GetAvailableEngines();
82 String ListAvailableEngines();
83 String GetEngineInfo(String EngineName);
84 String GetChannelInfo(uint uiSamplerChannel);
85 String GetVoiceCount(uint uiSamplerChannel);
86 String GetStreamCount(uint uiSamplerChannel);
87 String GetBufferFill(fill_response_t ResponseType, uint uiSamplerChannel);
88 String GetAvailableAudioOutputDrivers();
89 String ListAvailableAudioOutputDrivers();
90 String GetAvailableMidiInputDrivers();
91 String ListAvailableMidiInputDrivers();
92 String GetAudioOutputDriverInfo(String Driver);
93 String GetMidiInputDriverInfo(String Driver);
94 #ifdef __GNUC__
95 typedef std::map<String,String> StringMap; // nasty workaround for a GCC bug (see GCC bug #15980, #57)
96 String GetAudioOutputDriverParameterInfo(String Driver, String Parameter, std::map<String,String> DependencyList = StringMap());
97 String GetMidiInputDriverParameterInfo(String Driver, String Parameter, std::map<String,String> DependencyList = StringMap());
98 String CreateAudioOutputDevice(String Driver, std::map<String,String> Parameters = StringMap());
99 String CreateMidiInputDevice(String Driver, std::map<String,String> Parameters = StringMap());
100 #else
101 String GetAudioOutputDriverParameterInfo(String Driver, String Parameter, std::map<String,String> DependencyList = std::map<String,String>());
102 String GetMidiInputDriverParameterInfo(String Driver, String Parameter, std::map<String,String> DependencyList = std::map<String,String>());
103 String CreateAudioOutputDevice(String Driver, std::map<String,String> Parameters = std::map<String,String>());
104 String CreateMidiInputDevice(String Driver, std::map<String,String> Parameters = std::map<String,String>());
105 #endif // __GNUC__
106 String GetAudioOutputDeviceCount();
107 String GetMidiInputDeviceCount();
108 String GetAudioOutputDevices();
109 String GetMidiInputDevices();
110 String GetAudioOutputDeviceInfo(uint DeviceIndex);
111 String GetMidiInputDeviceInfo(uint DeviceIndex);
112 String GetMidiInputPortInfo(uint DeviceIndex, uint PortIndex);
113 String GetMidiInputPortParameterInfo(uint DeviceId, uint PortId, String ParameterName);
114 String GetAudioOutputChannelInfo(uint DeviceId, uint ChannelId);
115 String GetAudioOutputChannelParameterInfo(uint DeviceId, uint ChannelId, String ParameterName);
116 String SetAudioOutputChannelParameter(uint DeviceId, uint ChannelId, String ParamKey, String ParamVal);
117 String SetAudioOutputDeviceParameter(uint DeviceIndex, String ParamKey, String ParamVal);
118 String SetMidiInputDeviceParameter(uint DeviceIndex, String ParamKey, String ParamVal);
119 String SetMidiInputPortParameter(uint DeviceIndex, uint PortIndex, String ParamKey, String ParamVal);
120 String SetAudioOutputChannel(uint ChannelAudioOutputChannel, uint AudioOutputDeviceInputChannel, uint uiSamplerChannel);
121 String SetAudioOutputDevice(uint AudioDeviceId, uint SamplerChannel);
122 String SetAudioOutputType(String AudioOutputDriver, uint uiSamplerChannel);
123 String SetMIDIInputPort(uint MIDIPort, uint uiSamplerChannel);
124 String SetMIDIInputChannel(uint MIDIChannel, uint uiSamplerChannel);
125 String SetMIDIInputDevice(uint MIDIDeviceId, uint uiSamplerChannel);
126 String SetMIDIInputType(String MidiInputDriver, uint uiSamplerChannel);
127 String SetMIDIInput(uint MIDIDeviceId, uint MIDIPort, uint MIDIChannel, uint uiSamplerChannel);
128 String SetVolume(double dVolume, uint uiSamplerChannel);
129 String SetChannelMute(bool bMute, uint uiSamplerChannel);
130 String SetChannelSolo(bool bSolo, uint uiSamplerChannel);
131 String AddOrReplaceMIDIInstrumentMapping(uint MidiMapID, uint MidiBank, uint MidiProg, String EngineType, String InstrumentFile, uint InstrumentIndex, float Volume, MidiInstrumentMapper::mode_t LoadMode, String Name, bool bModal);
132 String RemoveMIDIInstrumentMapping(uint MidiMapID, uint MidiBank, uint MidiProg);
133 String GetMidiInstrumentMappings(uint MidiMapID);
134 String GetAllMidiInstrumentMappings();
135 String GetMidiInstrumentMapping(uint MidiMapID, uint MidiBank, uint MidiProg);
136 String ListMidiInstrumentMappings(uint MidiMapID);
137 String ListAllMidiInstrumentMappings();
138 String ClearMidiInstrumentMappings(uint MidiMapID);
139 String ClearAllMidiInstrumentMappings();
140 String AddMidiInstrumentMap(String MapName = "");
141 String RemoveMidiInstrumentMap(uint MidiMapID);
142 String RemoveAllMidiInstrumentMaps();
143 String GetMidiInstrumentMaps();
144 String ListMidiInstrumentMaps();
145 String GetMidiInstrumentMap(uint MidiMapID);
146 String SetMidiInstrumentMapName(uint MidiMapID, String NewName);
147 String SetChannelMap(uint uiSamplerChannel, int MidiMapID);
148 String CreateFxSend(uint uiSamplerChannel, uint MidiCtrl, String Name = "");
149 String DestroyFxSend(uint uiSamplerChannel, uint FxSendID);
150 String GetFxSends(uint uiSamplerChannel);
151 String ListFxSends(uint uiSamplerChannel);
152 String GetFxSendInfo(uint uiSamplerChannel, uint FxSendID);
153 String SetFxSendAudioOutputChannel(uint uiSamplerChannel, uint FxSendID, uint FxSendChannel, uint DeviceChannel);
154 String SetFxSendMidiController(uint uiSamplerChannel, uint FxSendID, uint MidiController);
155 String SetFxSendLevel(uint uiSamplerChannel, uint FxSendID, double dLevel);
156 String ResetChannel(uint uiSamplerChannel);
157 String ResetSampler();
158 String GetServerInfo();
159 String GetTotalVoiceCount();
160 String GetTotalVoiceCountMax();
161 String GetGlobalVolume();
162 String SetGlobalVolume(double dVolume);
163 String SubscribeNotification(LSCPEvent::event_t);
164 String UnsubscribeNotification(LSCPEvent::event_t);
165 String QueryDatabase(String query);
166 String SetEcho(yyparse_param_t* pSession, double boolean_value);
167 void AnswerClient(String ReturnMessage);
168
169 static int currentSocket;
170 static std::map<int,String> bufferedCommands;
171
172 static void SendLSCPNotify( LSCPEvent Event );
173 static int EventSubscribers( std::list<LSCPEvent::event_t> events );
174 static void LockRTNotify( void ) { RTNotifyMutex.Lock(); }
175 static void UnlockRTNotify( void ) { RTNotifyMutex.Unlock(); }
176
177 protected:
178 int hSocket;
179 sockaddr_in SocketAddress;
180 Sampler* pSampler;
181 Condition Initialized;
182
183 int Main(); ///< Implementation of virtual method from class Thread
184
185 private:
186
187 /**
188 * Find a created audio output device index.
189 */
190 int GetAudioOutputDeviceIndex (AudioOutputDevice *pDevice);
191
192 /**
193 * Find a created midi input device index.
194 */
195 int GetMidiInputDeviceIndex (MidiInputDevice *pDevice);
196
197 bool HasSoloChannel();
198 void MuteNonSoloChannels();
199 void UnmuteChannels();
200
201 static std::map<int,String> bufferedNotifies;
202 static Mutex NotifyMutex;
203 static Mutex NotifyBufferMutex;
204 static bool GetLSCPCommand( std::vector<yyparse_param_t>::iterator iter );
205 static void CloseConnection( std::vector<yyparse_param_t>::iterator iter );
206 static std::vector<yyparse_param_t> Sessions;
207 static Mutex SubscriptionMutex;
208 static std::map< LSCPEvent::event_t, std::list<int> > eventSubscriptions;
209 static fd_set fdSet;
210
211 //Protect main thread that generates real time notify messages
212 //like voice count, stream count and buffer fill
213 //from LSCP server removing engines and channels from underneath
214 static Mutex RTNotifyMutex;
215
216 class LscpChannelCountListener : public ChannelCountListener {
217 public:
218 /**
219 * Invoked when the number of sampler channels has changed.
220 * @param NewCount The new number of sampler channels.
221 */
222 virtual void ChannelCountChanged(int NewCount);
223 } channelCountListener;
224
225 class LscpAudioDeviceCountListener : public AudioDeviceCountListener {
226 public:
227 /**
228 * Invoked when the number of audio output devices has changed.
229 * @param NewCount The new number of audio output devices.
230 */
231 virtual void AudioDeviceCountChanged(int NewCount);
232 } audioDeviceCountListener;
233
234 class LscpMidiDeviceCountListener : public MidiDeviceCountListener {
235 public:
236 /**
237 * Invoked when the number of MIDI input devices has changed.
238 * @param NewCount The new number of MIDI input devices.
239 */
240 virtual void MidiDeviceCountChanged(int NewCount);
241 } midiDeviceCountListener;
242
243 class LscpMidiInstrumentCountListener : public MidiInstrumentCountListener {
244 public:
245 /**
246 * Invoked when the number of MIDI instruments has changed.
247 * @param MapId The numerical ID of the MIDI instrument map.
248 * @param NewCount The new number of MIDI instruments.
249 */
250 virtual void MidiInstrumentCountChanged(int MapId, int NewCount);
251 } midiInstrumentCountListener;
252
253 class LscpMidiInstrumentInfoListener : public MidiInstrumentInfoListener {
254 public:
255 /**
256 * Invoked when a MIDI instrument in a MIDI instrument map is changed.
257 * @param MapId The numerical ID of the MIDI instrument map.
258 * @param Bank The index of the MIDI bank, containing the instrument.
259 * @param Program The MIDI program number of the instrument.
260 */
261 virtual void MidiInstrumentInfoChanged(int MapId, int Bank, int Program);
262 } midiInstrumentInfoListener;
263
264 class LscpMidiInstrumentMapCountListener : public MidiInstrumentMapCountListener {
265 public:
266 /**
267 * Invoked when the number of MIDI instrument maps has changed.
268 * @param NewCount The new number of MIDI instruments.
269 */
270 virtual void MidiInstrumentMapCountChanged(int NewCount);
271 } midiInstrumentMapCountListener;
272
273 class LscpMidiInstrumentMapInfoListener : public MidiInstrumentMapInfoListener {
274 public:
275 /**
276 * Invoked when the settings of a MIDI instrument map are changed.
277 * @param MapId The numerical ID of the MIDI instrument map.
278 */
279 virtual void MidiInstrumentMapInfoChanged(int MapId);
280 } midiInstrumentMapInfoListener;
281
282 class LscpFxSendCountListener : public FxSendCountListener {
283 public:
284 /**
285 * Invoked when the number of effect sends
286 * on the specified sampler channel has changed.
287 * @param ChannelId The numerical ID of the sampler channel.
288 * @param NewCount The new number of effect sends.
289 */
290 virtual void FxSendCountChanged(int ChannelId, int NewCount);
291 } fxSendCountListener;
292
293 class LscpVoiceCountListener : public VoiceCountListener {
294 public:
295 /**
296 * Invoked when the number of active voices
297 * on the specified sampler channel has changed.
298 * @param ChannelId The numerical ID of the sampler channel.
299 * @param NewCount The new number of active voices.
300 */
301 virtual void VoiceCountChanged(int ChannelId, int NewCount);
302 } voiceCountListener;
303
304 class LscpStreamCountListener : public StreamCountListener {
305 public:
306 /**
307 * Invoked when the number of active disk streams
308 * on the specified sampler channel has changed.
309 * @param ChannelId The numerical ID of the sampler channel.
310 * @param NewCount The new number of active disk streams.
311 */
312 virtual void StreamCountChanged(int ChannelId, int NewCount);
313 } streamCountListener;
314
315 class LscpBufferFillListener : public BufferFillListener {
316 public:
317 /**
318 * Invoked when the fill state of the disk stream
319 * buffers on the specified sampler channel is changed.
320 * @param ChannelId The numerical ID of the sampler channel.
321 * @param FillData The buffer fill data for the specified sampler channel.
322 */
323 virtual void BufferFillChanged(int ChannelId, String FillData);
324 } bufferFillListener;
325
326 class LscpTotalVoiceCountListener : public TotalVoiceCountListener {
327 public:
328 /**
329 * Invoked when the total number of active voices is changed.
330 * @param NewCount The new number of active voices.
331 */
332 virtual void TotalVoiceCountChanged(int NewCount);
333 } totalVoiceCountListener;
334 };
335
336 #endif // __LSCPSERVER_H_

  ViewVC Help
Powered by ViewVC