/[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 1133 - (show annotations) (download) (as text)
Mon Mar 26 08:27:06 2007 UTC (17 years ago) by iliev
File MIME type: text/x-c++hdr
File size: 15693 byte(s)
- code cleanup

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 EventHandler : public ChannelCountListener, public AudioDeviceCountListener,
217 public MidiDeviceCountListener, public MidiInstrumentCountListener,
218 public MidiInstrumentInfoListener, public MidiInstrumentMapCountListener,
219 public MidiInstrumentMapInfoListener, public FxSendCountListener,
220 public VoiceCountListener, public StreamCountListener,
221 public BufferFillListener, public TotalVoiceCountListener {
222
223 public:
224 /**
225 * Invoked when the number of sampler channels has changed.
226 * @param NewCount The new number of sampler channels.
227 */
228 virtual void ChannelCountChanged(int NewCount);
229
230 /**
231 * Invoked when the number of audio output devices has changed.
232 * @param NewCount The new number of audio output devices.
233 */
234 virtual void AudioDeviceCountChanged(int NewCount);
235
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
242 /**
243 * Invoked when the number of MIDI instruments has changed.
244 * @param MapId The numerical ID of the MIDI instrument map.
245 * @param NewCount The new number of MIDI instruments.
246 */
247 virtual void MidiInstrumentCountChanged(int MapId, int NewCount);
248
249 /**
250 * Invoked when a MIDI instrument in a MIDI instrument map is changed.
251 * @param MapId The numerical ID of the MIDI instrument map.
252 * @param Bank The index of the MIDI bank, containing the instrument.
253 * @param Program The MIDI program number of the instrument.
254 */
255 virtual void MidiInstrumentInfoChanged(int MapId, int Bank, int Program);
256
257 /**
258 * Invoked when the number of MIDI instrument maps has changed.
259 * @param NewCount The new number of MIDI instruments.
260 */
261 virtual void MidiInstrumentMapCountChanged(int NewCount);
262
263 /**
264 * Invoked when the settings of a MIDI instrument map are changed.
265 * @param MapId The numerical ID of the MIDI instrument map.
266 */
267 virtual void MidiInstrumentMapInfoChanged(int MapId);
268
269 /**
270 * Invoked when the number of effect sends
271 * on the specified sampler channel has changed.
272 * @param ChannelId The numerical ID of the sampler channel.
273 * @param NewCount The new number of effect sends.
274 */
275 virtual void FxSendCountChanged(int ChannelId, int NewCount);
276
277 /**
278 * Invoked when the number of active voices
279 * on the specified sampler channel has changed.
280 * @param ChannelId The numerical ID of the sampler channel.
281 * @param NewCount The new number of active voices.
282 */
283 virtual void VoiceCountChanged(int ChannelId, int NewCount);
284
285 /**
286 * Invoked when the number of active disk streams
287 * on the specified sampler channel has changed.
288 * @param ChannelId The numerical ID of the sampler channel.
289 * @param NewCount The new number of active disk streams.
290 */
291 virtual void StreamCountChanged(int ChannelId, int NewCount);
292
293 /**
294 * Invoked when the fill state of the disk stream
295 * buffers on the specified sampler channel is changed.
296 * @param ChannelId The numerical ID of the sampler channel.
297 * @param FillData The buffer fill data for the specified sampler channel.
298 */
299 virtual void BufferFillChanged(int ChannelId, String FillData);
300
301 /**
302 * Invoked when the total number of active voices is changed.
303 * @param NewCount The new number of active voices.
304 */
305 virtual void TotalVoiceCountChanged(int NewCount);
306 } eventHandler;
307 };
308
309 #endif // __LSCPSERVER_H_

  ViewVC Help
Powered by ViewVC