FreeRDP
All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Modules Pages
audin_pulse.c
1
22#include <freerdp/config.h>
23
24#include <stdio.h>
25#include <stdlib.h>
26#include <string.h>
27
28#include <winpr/crt.h>
29#include <winpr/cmdline.h>
30#include <winpr/wlog.h>
31#include <winpr/cast.h>
32
33#include <pulse/pulseaudio.h>
34
35#include <freerdp/types.h>
36#include <freerdp/addin.h>
37#include <freerdp/freerdp.h>
38#include <freerdp/codec/audio.h>
39#include <freerdp/client/audin.h>
40
41#include "audin_main.h"
42
43typedef struct
44{
45 IAudinDevice iface;
46
47 char* device_name;
48 UINT32 frames_per_packet;
49 pa_threaded_mainloop* mainloop;
50 pa_context* context;
51 pa_sample_spec sample_spec;
52 pa_stream* stream;
53 AUDIO_FORMAT format;
54
55 size_t bytes_per_frame;
56 size_t buffer_frames;
57
58 AudinReceive receive;
59 void* user_data;
60
61 rdpContext* rdpcontext;
62 wLog* log;
63} AudinPulseDevice;
64
65static const char* pulse_context_state_string(pa_context_state_t state)
66{
67 switch (state)
68 {
69 case PA_CONTEXT_UNCONNECTED:
70 return "PA_CONTEXT_UNCONNECTED";
71 case PA_CONTEXT_CONNECTING:
72 return "PA_CONTEXT_CONNECTING";
73 case PA_CONTEXT_AUTHORIZING:
74 return "PA_CONTEXT_AUTHORIZING";
75 case PA_CONTEXT_SETTING_NAME:
76 return "PA_CONTEXT_SETTING_NAME";
77 case PA_CONTEXT_READY:
78 return "PA_CONTEXT_READY";
79 case PA_CONTEXT_FAILED:
80 return "PA_CONTEXT_FAILED";
81 case PA_CONTEXT_TERMINATED:
82 return "PA_CONTEXT_TERMINATED";
83 default:
84 return "UNKNOWN";
85 }
86}
87
88static const char* pulse_stream_state_string(pa_stream_state_t state)
89{
90 switch (state)
91 {
92 case PA_STREAM_UNCONNECTED:
93 return "PA_STREAM_UNCONNECTED";
94 case PA_STREAM_CREATING:
95 return "PA_STREAM_CREATING";
96 case PA_STREAM_READY:
97 return "PA_STREAM_READY";
98 case PA_STREAM_FAILED:
99 return "PA_STREAM_FAILED";
100 case PA_STREAM_TERMINATED:
101 return "PA_STREAM_TERMINATED";
102 default:
103 return "UNKNOWN";
104 }
105}
106
107static void audin_pulse_context_state_callback(pa_context* context, void* userdata)
108{
109 AudinPulseDevice* pulse = (AudinPulseDevice*)userdata;
110 pa_context_state_t state = pa_context_get_state(context);
111
112 WLog_Print(pulse->log, WLOG_DEBUG, "context state %s", pulse_context_state_string(state));
113 switch (state)
114 {
115 case PA_CONTEXT_READY:
116 case PA_CONTEXT_FAILED:
117 case PA_CONTEXT_TERMINATED:
118 pa_threaded_mainloop_signal(pulse->mainloop, 0);
119 break;
120
121 default:
122 break;
123 }
124}
125
131static UINT audin_pulse_connect(IAudinDevice* device)
132{
133 pa_context_state_t state = PA_CONTEXT_FAILED;
134 AudinPulseDevice* pulse = (AudinPulseDevice*)device;
135
136 if (!pulse->context)
137 return ERROR_INVALID_PARAMETER;
138
139 if (pa_context_connect(pulse->context, NULL, 0, NULL))
140 {
141 WLog_Print(pulse->log, WLOG_ERROR, "pa_context_connect failed (%d)",
142 pa_context_errno(pulse->context));
143 return ERROR_INTERNAL_ERROR;
144 }
145
146 pa_threaded_mainloop_lock(pulse->mainloop);
147
148 if (pa_threaded_mainloop_start(pulse->mainloop) < 0)
149 {
150 pa_threaded_mainloop_unlock(pulse->mainloop);
151 WLog_Print(pulse->log, WLOG_ERROR, "pa_threaded_mainloop_start failed (%d)",
152 pa_context_errno(pulse->context));
153 return ERROR_INTERNAL_ERROR;
154 }
155
156 for (;;)
157 {
158 state = pa_context_get_state(pulse->context);
159
160 if (state == PA_CONTEXT_READY)
161 break;
162
163 if (!PA_CONTEXT_IS_GOOD(state))
164 {
165 WLog_Print(pulse->log, WLOG_ERROR, "bad context state (%s: %d)",
166 pulse_context_state_string(state), pa_context_errno(pulse->context));
167 pa_context_disconnect(pulse->context);
168 return ERROR_INVALID_STATE;
169 }
170
171 pa_threaded_mainloop_wait(pulse->mainloop);
172 }
173
174 pa_threaded_mainloop_unlock(pulse->mainloop);
175 WLog_Print(pulse->log, WLOG_DEBUG, "connected");
176 return CHANNEL_RC_OK;
177}
178
184static UINT audin_pulse_free(IAudinDevice* device)
185{
186 AudinPulseDevice* pulse = (AudinPulseDevice*)device;
187
188 if (!pulse)
189 return ERROR_INVALID_PARAMETER;
190
191 if (pulse->mainloop)
192 {
193 pa_threaded_mainloop_stop(pulse->mainloop);
194 }
195
196 if (pulse->context)
197 {
198 pa_context_disconnect(pulse->context);
199 pa_context_unref(pulse->context);
200 pulse->context = NULL;
201 }
202
203 if (pulse->mainloop)
204 {
205 pa_threaded_mainloop_free(pulse->mainloop);
206 pulse->mainloop = NULL;
207 }
208
209 free(pulse);
210 return CHANNEL_RC_OK;
211}
212
213static BOOL audin_pulse_format_supported(IAudinDevice* device, const AUDIO_FORMAT* format)
214{
215 AudinPulseDevice* pulse = (AudinPulseDevice*)device;
216
217 if (!pulse || !format)
218 return FALSE;
219
220 if (!pulse->context)
221 return 0;
222
223 switch (format->wFormatTag)
224 {
225 case WAVE_FORMAT_PCM:
226 if (format->cbSize == 0 && (format->nSamplesPerSec <= PA_RATE_MAX) &&
227 (format->wBitsPerSample == 8 || format->wBitsPerSample == 16) &&
228 (format->nChannels >= 1 && format->nChannels <= PA_CHANNELS_MAX))
229 {
230 return TRUE;
231 }
232
233 break;
234
235 default:
236 return FALSE;
237 }
238
239 return FALSE;
240}
241
247static UINT audin_pulse_set_format(IAudinDevice* device, const AUDIO_FORMAT* format,
248 UINT32 FramesPerPacket)
249{
250 pa_sample_spec sample_spec = { 0 };
251 AudinPulseDevice* pulse = (AudinPulseDevice*)device;
252
253 if (!pulse || !format)
254 return ERROR_INVALID_PARAMETER;
255
256 if (!pulse->context)
257 return ERROR_INVALID_PARAMETER;
258
259 if (FramesPerPacket > 0)
260 pulse->frames_per_packet = FramesPerPacket;
261
262 sample_spec.rate = format->nSamplesPerSec;
263
264 sample_spec.channels = WINPR_ASSERTING_INT_CAST(uint8_t, format->nChannels);
265
266 switch (format->wFormatTag)
267 {
268 case WAVE_FORMAT_PCM: /* PCM */
269 switch (format->wBitsPerSample)
270 {
271 case 8:
272 sample_spec.format = PA_SAMPLE_U8;
273 break;
274
275 case 16:
276 sample_spec.format = PA_SAMPLE_S16LE;
277 break;
278
279 default:
280 return ERROR_INTERNAL_ERROR;
281 }
282
283 break;
284
285 default:
286 return ERROR_INTERNAL_ERROR;
287 }
288
289 pulse->sample_spec = sample_spec;
290 pulse->format = *format;
291 return CHANNEL_RC_OK;
292}
293
294static void audin_pulse_stream_state_callback(pa_stream* stream, void* userdata)
295{
296 AudinPulseDevice* pulse = (AudinPulseDevice*)userdata;
297 WINPR_ASSERT(pulse);
298
299 pa_stream_state_t state = pa_stream_get_state(stream);
300
301 WLog_Print(pulse->log, WLOG_DEBUG, "stream state %s", pulse_stream_state_string(state));
302 switch (state)
303 {
304 case PA_STREAM_READY:
305 case PA_STREAM_FAILED:
306 case PA_STREAM_TERMINATED:
307 pa_threaded_mainloop_signal(pulse->mainloop, 0);
308 break;
309
310 case PA_STREAM_UNCONNECTED:
311 case PA_STREAM_CREATING:
312 default:
313 break;
314 }
315}
316
317static void audin_pulse_stream_request_callback(pa_stream* stream, size_t length, void* userdata)
318{
319 const void* data = NULL;
320 AudinPulseDevice* pulse = (AudinPulseDevice*)userdata;
321 UINT error = CHANNEL_RC_OK;
322 pa_stream_peek(stream, &data, &length);
323 error =
324 IFCALLRESULT(CHANNEL_RC_OK, pulse->receive, &pulse->format, data, length, pulse->user_data);
325 pa_stream_drop(stream);
326
327 if (error && pulse->rdpcontext)
328 setChannelError(pulse->rdpcontext, error, "audin_pulse_thread_func reported an error");
329}
330
336static UINT audin_pulse_close(IAudinDevice* device)
337{
338 AudinPulseDevice* pulse = (AudinPulseDevice*)device;
339
340 if (!pulse)
341 return ERROR_INVALID_PARAMETER;
342
343 if (pulse->stream)
344 {
345 pa_threaded_mainloop_lock(pulse->mainloop);
346 pa_stream_disconnect(pulse->stream);
347 pa_stream_unref(pulse->stream);
348 pulse->stream = NULL;
349 pa_threaded_mainloop_unlock(pulse->mainloop);
350 }
351
352 pulse->receive = NULL;
353 pulse->user_data = NULL;
354 return CHANNEL_RC_OK;
355}
356
362static UINT audin_pulse_open(IAudinDevice* device, AudinReceive receive, void* user_data)
363{
364 pa_stream_state_t state = PA_STREAM_FAILED;
365 pa_buffer_attr buffer_attr = { 0 };
366 AudinPulseDevice* pulse = (AudinPulseDevice*)device;
367
368 if (!pulse || !receive || !user_data)
369 return ERROR_INVALID_PARAMETER;
370
371 if (!pulse->context)
372 return ERROR_INVALID_PARAMETER;
373
374 if (!pulse->sample_spec.rate || pulse->stream)
375 return ERROR_INVALID_PARAMETER;
376
377 pulse->receive = receive;
378 pulse->user_data = user_data;
379 pa_threaded_mainloop_lock(pulse->mainloop);
380 pulse->stream = pa_stream_new(pulse->context, "freerdp_audin", &pulse->sample_spec, NULL);
381
382 if (!pulse->stream)
383 {
384 pa_threaded_mainloop_unlock(pulse->mainloop);
385 WLog_Print(pulse->log, WLOG_DEBUG, "pa_stream_new failed (%d)",
386 pa_context_errno(pulse->context));
387 const int rc = pa_context_errno(pulse->context);
388 return (UINT)rc;
389 }
390
391 pulse->bytes_per_frame = pa_frame_size(&pulse->sample_spec);
392 pa_stream_set_state_callback(pulse->stream, audin_pulse_stream_state_callback, pulse);
393 pa_stream_set_read_callback(pulse->stream, audin_pulse_stream_request_callback, pulse);
394 buffer_attr.maxlength = (UINT32)-1;
395 buffer_attr.tlength = (UINT32)-1;
396 buffer_attr.prebuf = (UINT32)-1;
397 buffer_attr.minreq = (UINT32)-1;
398 /* 500ms latency */
399 const size_t frag = pulse->bytes_per_frame * pulse->frames_per_packet;
400 WINPR_ASSERT(frag <= UINT32_MAX);
401 buffer_attr.fragsize = (uint32_t)frag;
402
403 if (buffer_attr.fragsize % pulse->format.nBlockAlign)
404 buffer_attr.fragsize +=
405 pulse->format.nBlockAlign - buffer_attr.fragsize % pulse->format.nBlockAlign;
406
407 if (pa_stream_connect_record(pulse->stream, pulse->device_name, &buffer_attr,
408 PA_STREAM_ADJUST_LATENCY) < 0)
409 {
410 pa_threaded_mainloop_unlock(pulse->mainloop);
411 WLog_Print(pulse->log, WLOG_ERROR, "pa_stream_connect_playback failed (%d)",
412 pa_context_errno(pulse->context));
413 const int rc = pa_context_errno(pulse->context);
414 return (UINT)rc;
415 }
416
417 while (pulse->stream)
418 {
419 state = pa_stream_get_state(pulse->stream);
420
421 if (state == PA_STREAM_READY)
422 break;
423
424 if (!PA_STREAM_IS_GOOD(state))
425 {
426 audin_pulse_close(device);
427 WLog_Print(pulse->log, WLOG_ERROR, "bad stream state (%s: %d)",
428 pulse_stream_state_string(state), pa_context_errno(pulse->context));
429 pa_threaded_mainloop_unlock(pulse->mainloop);
430 const int rc = pa_context_errno(pulse->context);
431 return (UINT)rc;
432 }
433
434 pa_threaded_mainloop_wait(pulse->mainloop);
435 }
436
437 pa_threaded_mainloop_unlock(pulse->mainloop);
438 pulse->buffer_frames = 0;
439 WLog_Print(pulse->log, WLOG_DEBUG, "connected");
440 return CHANNEL_RC_OK;
441}
442
448static UINT audin_pulse_parse_addin_args(AudinPulseDevice* device, const ADDIN_ARGV* args)
449{
450 int status = 0;
451 DWORD flags = 0;
452 const COMMAND_LINE_ARGUMENT_A* arg = NULL;
453 AudinPulseDevice* pulse = device;
454 COMMAND_LINE_ARGUMENT_A audin_pulse_args[] = { { "dev", COMMAND_LINE_VALUE_REQUIRED, "<device>",
455 NULL, NULL, -1, NULL, "audio device name" },
456 { NULL, 0, NULL, NULL, NULL, -1, NULL, NULL } };
457
458 flags =
459 COMMAND_LINE_SIGIL_NONE | COMMAND_LINE_SEPARATOR_COLON | COMMAND_LINE_IGN_UNKNOWN_KEYWORD;
460 status = CommandLineParseArgumentsA(args->argc, args->argv, audin_pulse_args, flags, pulse,
461 NULL, NULL);
462
463 if (status < 0)
464 return ERROR_INVALID_PARAMETER;
465
466 arg = audin_pulse_args;
467
468 do
469 {
470 if (!(arg->Flags & COMMAND_LINE_VALUE_PRESENT))
471 continue;
472
473 CommandLineSwitchStart(arg) CommandLineSwitchCase(arg, "dev")
474 {
475 pulse->device_name = _strdup(arg->Value);
476
477 if (!pulse->device_name)
478 {
479 WLog_Print(pulse->log, WLOG_ERROR, "_strdup failed!");
480 return CHANNEL_RC_NO_MEMORY;
481 }
482 }
483 CommandLineSwitchEnd(arg)
484 } while ((arg = CommandLineFindNextArgumentA(arg)) != NULL);
485
486 return CHANNEL_RC_OK;
487}
488
494FREERDP_ENTRY_POINT(UINT VCAPITYPE pulse_freerdp_audin_client_subsystem_entry(
496{
497 const ADDIN_ARGV* args = NULL;
498 AudinPulseDevice* pulse = NULL;
499 UINT error = 0;
500 pulse = (AudinPulseDevice*)calloc(1, sizeof(AudinPulseDevice));
501
502 if (!pulse)
503 {
504 WLog_ERR(TAG, "calloc failed!");
505 return CHANNEL_RC_NO_MEMORY;
506 }
507
508 pulse->log = WLog_Get(TAG);
509 pulse->iface.Open = audin_pulse_open;
510 pulse->iface.FormatSupported = audin_pulse_format_supported;
511 pulse->iface.SetFormat = audin_pulse_set_format;
512 pulse->iface.Close = audin_pulse_close;
513 pulse->iface.Free = audin_pulse_free;
514 pulse->rdpcontext = pEntryPoints->rdpcontext;
515 args = pEntryPoints->args;
516
517 if ((error = audin_pulse_parse_addin_args(pulse, args)))
518 {
519 WLog_Print(pulse->log, WLOG_ERROR,
520 "audin_pulse_parse_addin_args failed with error %" PRIu32 "!", error);
521 goto error_out;
522 }
523
524 pulse->mainloop = pa_threaded_mainloop_new();
525
526 if (!pulse->mainloop)
527 {
528 WLog_Print(pulse->log, WLOG_ERROR, "pa_threaded_mainloop_new failed");
529 error = CHANNEL_RC_NO_MEMORY;
530 goto error_out;
531 }
532
533 pulse->context = pa_context_new(pa_threaded_mainloop_get_api(pulse->mainloop), "freerdp");
534
535 if (!pulse->context)
536 {
537 WLog_Print(pulse->log, WLOG_ERROR, "pa_context_new failed");
538 error = CHANNEL_RC_NO_MEMORY;
539 goto error_out;
540 }
541
542 pa_context_set_state_callback(pulse->context, audin_pulse_context_state_callback, pulse);
543
544 if ((error = audin_pulse_connect(&pulse->iface)))
545 {
546 WLog_Print(pulse->log, WLOG_ERROR, "audin_pulse_connect failed");
547 goto error_out;
548 }
549
550 if ((error = pEntryPoints->pRegisterAudinDevice(pEntryPoints->plugin, &pulse->iface)))
551 {
552 WLog_Print(pulse->log, WLOG_ERROR, "RegisterAudinDevice failed with error %" PRIu32 "!",
553 error);
554 goto error_out;
555 }
556
557 return CHANNEL_RC_OK;
558error_out:
559 audin_pulse_free(&pulse->iface);
560 return error;
561}