1 /* BlackMagic SDI driver */
8 #define INT64_C(c) c ## LL
11 #include <vlc_common.h>
12 #include <vlc_plugin.h>
13 #include <vlc_input.h>
14 #include <vlc_demux.h>
15 #include <vlc_access.h>
16 #include <vlc_picture.h>
17 #include <vlc_charset.h>
20 #include <arpa/inet.h>
22 #include "DeckLinkAPI.h"
23 #include "DeckLinkAPIDispatch.cpp"
25 static int Open ( vlc_object_t * );
26 static void Close( vlc_object_t * );
28 #define CARD_INDEX_TEXT N_("Input card to use")
29 #define CARD_INDEX_LONGTEXT N_( \
30 "SDI capture card to use, if multiple exist. " \
31 "The cards are numbered from 0." )
33 #define MODE_TEXT N_("Desired input video mode")
34 #define MODE_LONGTEXT N_( \
35 "Desired input video mode for SDI captures. " \
36 "This value should be a FOURCC code in textual " \
37 "form, e.g. \"ntsc\"." )
39 #define CACHING_TEXT N_("Caching value in ms")
40 #define CACHING_LONGTEXT N_( \
41 "Caching value for SDI captures. This " \
42 "value should be set in milliseconds." )
44 #define AUDIO_CONNECTION_TEXT N_("Audio connection")
45 #define AUDIO_CONNECTION_LONGTEXT N_( \
46 "Audio connection to use for SDI captures. " \
47 "Valid choices: embedded, aesebu, analog. " \
48 "Leave blank for card default." )
50 #define RATE_TEXT N_("Audio sampling rate in Hz")
51 #define RATE_LONGTEXT N_( \
52 "Audio sampling rate (in hertz) for SDI captures. " \
53 "0 disables audio input." )
55 #define CHANNELS_TEXT N_("Number of audio channels")
56 #define CHANNELS_LONGTEXT N_( \
57 "Number of input audio channels for SDI captures. " \
58 "Must be 2, 8 or 16. 0 disables audio input." )
60 #define VIDEO_CONNECTION_TEXT N_("Video connection")
61 #define VIDEO_CONNECTION_LONGTEXT N_( \
62 "Video connection to use for SDI captures. " \
63 "Valid choices: sdi, hdmi, opticalsdi, component, " \
64 "composite, svideo. " \
65 "Leave blank for card default." )
67 #define ASPECT_RATIO_TEXT N_("Aspect ratio")
68 #define ASPECT_RATIO_LONGTEXT N_( \
69 "Aspect ratio (4:3, 16:9). Default assumes square pixels." )
72 set_shortname( N_("SDI") )
73 set_description( N_("BlackMagic SDI input") )
74 set_category( CAT_INPUT )
75 set_subcategory( SUBCAT_INPUT_ACCESS )
77 add_integer( "sdi-card-index", 0, NULL,
78 CARD_INDEX_TEXT, CARD_INDEX_LONGTEXT, true )
79 add_string( "sdi-mode", "pal ", NULL,
80 MODE_TEXT, MODE_LONGTEXT, true )
81 add_integer( "sdi-caching", DEFAULT_PTS_DELAY / 1000, NULL,
82 CACHING_TEXT, CACHING_LONGTEXT, true )
83 add_string( "sdi-audio-connection", 0, NULL,
84 AUDIO_CONNECTION_TEXT, AUDIO_CONNECTION_LONGTEXT, true )
85 add_integer( "sdi-audio-rate", 48000, NULL,
86 RATE_TEXT, RATE_LONGTEXT, true )
87 add_integer( "sdi-audio-channels", 2, NULL,
88 CHANNELS_TEXT, CHANNELS_LONGTEXT, true )
89 add_string( "sdi-video-connection", 0, NULL,
90 VIDEO_CONNECTION_TEXT, VIDEO_CONNECTION_LONGTEXT, true )
91 add_string( "sdi-aspect-ratio", NULL, NULL,
92 ASPECT_RATIO_TEXT, ASPECT_RATIO_LONGTEXT, true )
95 set_capability( "access_demux", 10 )
96 set_callbacks( Open, Close )
99 static int Demux ( demux_t * );
100 static int Control( demux_t *, int, va_list );
102 class DeckLinkCaptureDelegate;
107 IDeckLinkInput *p_input;
108 DeckLinkCaptureDelegate *p_delegate;
110 es_out_id_t *p_video_es;
111 es_out_id_t *p_audio_es;
114 int i_width, i_height, i_fps_num, i_fps_den;
115 uint32_t i_dominance_flags;
117 int i_rate, i_channels;
119 vlc_mutex_t frame_lock;
120 block_t *p_video_frame; // protected by <frame_lock>
121 block_t *p_audio_frame; // protected by <frame_lock>
122 vlc_cond_t has_frame; // related to <frame_lock>
125 class DeckLinkCaptureDelegate : public IDeckLinkInputCallback
128 DeckLinkCaptureDelegate( demux_t *p_demux ) : p_demux_(p_demux) {}
130 // FIXME: These leak.
131 virtual HRESULT STDMETHODCALLTYPE QueryInterface(REFIID iid, LPVOID *ppv) { return E_NOINTERFACE; }
132 virtual ULONG STDMETHODCALLTYPE AddRef(void) { return 1; }
133 virtual ULONG STDMETHODCALLTYPE Release(void) { return 1; }
135 virtual HRESULT STDMETHODCALLTYPE VideoInputFormatChanged(BMDVideoInputFormatChangedEvents, IDeckLinkDisplayMode*, BMDDetectedVideoInputFormatFlags);
136 virtual HRESULT STDMETHODCALLTYPE VideoInputFrameArrived(IDeckLinkVideoInputFrame*, IDeckLinkAudioInputPacket*);
142 HRESULT DeckLinkCaptureDelegate::VideoInputFormatChanged(BMDVideoInputFormatChangedEvents events, IDeckLinkDisplayMode *mode, BMDDetectedVideoInputFormatFlags)
144 msg_Dbg( p_demux_, "Video input format changed" );
148 HRESULT DeckLinkCaptureDelegate::VideoInputFrameArrived(IDeckLinkVideoInputFrame* videoFrame, IDeckLinkAudioInputPacket* audioFrame)
150 demux_sys_t *p_sys = p_demux_->p_sys;
151 block_t *p_video_frame = NULL;
152 block_t *p_audio_frame = NULL;
156 if( videoFrame->GetFlags() & bmdFrameHasNoInputSource )
158 msg_Warn( p_demux_, "No input signal detected" );
162 const int i_width = videoFrame->GetWidth();
163 const int i_height = videoFrame->GetHeight();
164 const int i_stride = videoFrame->GetRowBytes();
167 p_video_frame = block_New( p_demux_, i_width * i_height * i_bpp );
170 msg_Err( p_demux_, "Could not allocate memory for video frame" );
175 videoFrame->GetBytes( &frame_bytes );
176 for( int y = 0; y < i_height; ++y )
178 const uint8_t *src = (const uint8_t *)frame_bytes + i_stride * y;
179 uint8_t *dst = (uint8_t *)p_video_frame->p_buffer + i_width * i_bpp * y;
180 memcpy( dst, src, i_width * i_bpp );
183 BMDTimeValue stream_time, frame_duration;
184 videoFrame->GetStreamTime( &stream_time, &frame_duration, CLOCK_FREQ );
185 p_video_frame->i_flags = BLOCK_FLAG_TYPE_I | p_sys->i_dominance_flags;
186 if( p_sys->b_first_frame )
188 p_video_frame->i_flags |= BLOCK_FLAG_DISCONTINUITY;
189 p_sys->b_first_frame = false;
191 p_video_frame->i_pts = p_video_frame->i_dts = VLC_TS_0 + stream_time;
196 const int i_bytes = audioFrame->GetSampleFrameCount() * sizeof(int16_t) * p_sys->i_channels;
198 p_audio_frame = block_New( p_demux_, i_bytes );
201 msg_Err( p_demux_, "Could not allocate memory for audio frame" );
206 audioFrame->GetBytes( &frame_bytes );
207 memcpy( p_audio_frame->p_buffer, frame_bytes, i_bytes );
209 BMDTimeValue packet_time;
210 audioFrame->GetPacketTime( &packet_time, CLOCK_FREQ );
211 p_audio_frame->i_pts = p_audio_frame->i_dts = VLC_TS_0 + packet_time;
214 if( p_video_frame || p_audio_frame )
216 vlc_mutex_lock( &p_sys->frame_lock );
219 if( p_sys->p_video_frame )
220 block_Release( p_sys->p_video_frame );
221 p_sys->p_video_frame = p_video_frame;
225 if( p_sys->p_audio_frame )
226 block_Release( p_sys->p_audio_frame );
227 p_sys->p_audio_frame = p_audio_frame;
229 vlc_cond_signal( &p_sys->has_frame );
230 vlc_mutex_unlock( &p_sys->frame_lock );
236 static int Open( vlc_object_t *p_this )
238 demux_t *p_demux = (demux_t*)p_this;
241 /* Only when selected */
242 if( *p_demux->psz_access == '\0' )
246 p_demux->pf_demux = Demux;
247 p_demux->pf_control = Control;
248 p_demux->info.i_update = 0;
249 p_demux->info.i_title = 0;
250 p_demux->info.i_seekpoint = 0;
251 p_demux->p_sys = p_sys = (demux_sys_t*)calloc( 1, sizeof( demux_sys_t ) );
255 vlc_mutex_init( &p_sys->frame_lock );
256 vlc_cond_init( &p_sys->has_frame );
257 p_sys->p_video_frame = NULL;
259 IDeckLinkIterator *decklink_iterator = CreateDeckLinkIteratorInstance();
260 if( !decklink_iterator )
262 msg_Err( p_demux, "DeckLink drivers not found." );
263 decklink_iterator->Release();
270 int i_card_index = var_CreateGetInteger( p_demux, "sdi-card-index" );
271 for( int i = 0; i <= i_card_index; ++i )
273 result = decklink_iterator->Next( &p_sys->p_card );
278 decklink_iterator->Release();
282 msg_Err( p_demux, "DeckLink PCI card %d not found", i_card_index );
287 const char *psz_model_name;
288 result = p_sys->p_card->GetModelName( &psz_model_name );
292 msg_Err( p_demux, "Could not get model name" );
297 msg_Dbg( p_demux, "Opened DeckLink PCI card %d (%s)", i_card_index, psz_model_name );
299 if( p_sys->p_card->QueryInterface( IID_IDeckLinkInput, (void**)&p_sys->p_input) != S_OK )
301 msg_Err( p_demux, "Card has no inputs" );
306 // Set up the video and audio sources.
307 IDeckLinkConfiguration *p_config;
308 if( p_sys->p_card->QueryInterface( IID_IDeckLinkConfiguration, (void**)&p_config) != S_OK )
310 msg_Err( p_demux, "Failed to get configuration interface" );
315 char *psz_tmp = var_CreateGetNonEmptyString( p_demux, "sdi-video-connection" );
318 BMDVideoConnection conn;
319 if ( !strcmp( psz_tmp, "sdi" ) )
320 conn = bmdVideoConnectionSDI;
321 else if ( !strcmp( psz_tmp, "hdmi" ) )
322 conn = bmdVideoConnectionHDMI;
323 else if ( !strcmp( psz_tmp, "opticalsdi" ) )
324 conn = bmdVideoConnectionOpticalSDI;
325 else if ( !strcmp( psz_tmp, "component" ) )
326 conn = bmdVideoConnectionComponent;
327 else if ( !strcmp( psz_tmp, "composite" ) )
328 conn = bmdVideoConnectionComposite;
329 else if ( !strcmp( psz_tmp, "svideo" ) )
330 conn = bmdVideoConnectionSVideo;
333 msg_Err( p_demux, "Invalid --sdi-video-connection specified; choose one of " \
334 "sdi, hdmi, opticalsdi, component, composite, or svideo." );
342 msg_Dbg( p_demux, "Setting video input format to 0x%x", conn);
343 result = p_config->SetVideoInputFormat( conn );
346 msg_Err( p_demux, "Failed to set video input connection" );
353 psz_tmp = var_CreateGetNonEmptyString( p_demux, "sdi-audio-connection" );
356 BMDAudioConnection conn;
357 if ( !strcmp( psz_tmp, "embedded" ) )
358 conn = bmdAudioConnectionEmbedded;
359 else if ( !strcmp( psz_tmp, "aesebu" ) )
360 conn = bmdAudioConnectionAESEBU;
361 else if ( !strcmp( psz_tmp, "analog" ) )
362 conn = bmdAudioConnectionAnalog;
365 msg_Err( p_demux, "Invalid --sdi-audio-connection specified; choose one of " \
366 "embedded, aesebu, or analog." );
372 msg_Dbg( p_demux, "Setting audio input format to 0x%x", conn);
373 result = p_config->SetAudioInputFormat( conn );
376 msg_Err( p_demux, "Failed to set audio input connection" );
385 // Get the list of display modes.
386 IDeckLinkDisplayModeIterator *p_display_iterator;
387 result = p_sys->p_input->GetDisplayModeIterator( &p_display_iterator );
390 msg_Err( p_demux, "Failed to enumerate display modes" );
391 p_display_iterator->Release();
396 char *psz_display_mode = var_CreateGetString( p_demux, "sdi-mode" );
397 if( !psz_display_mode || strlen( psz_display_mode ) == 0 || strlen( psz_display_mode ) > 4 ) {
398 msg_Err( p_demux, "Missing or invalid --sdi-mode string" );
399 p_display_iterator->Release();
404 // Pad the --sdi-mode string to four characters, so the user can specify e.g. "pal"
405 // without having to add the trailing space.
406 char sz_display_mode_padded[5];
407 strcpy(sz_display_mode_padded, " ");
408 for( int i = 0; i < strlen( psz_display_mode ); ++i )
409 sz_display_mode_padded[i] = psz_display_mode[i];
411 BMDDisplayMode wanted_mode_id;
412 memcpy( &wanted_mode_id, &sz_display_mode_padded, sizeof(wanted_mode_id) );
414 bool b_found_mode = false;
418 IDeckLinkDisplayMode *p_display_mode;
419 result = p_display_iterator->Next( &p_display_mode );
420 if( result != S_OK || !p_display_mode )
425 char sz_mode_id_text[5] = {0};
426 BMDDisplayMode mode_id = ntohl( p_display_mode->GetDisplayMode() );
427 memcpy( sz_mode_id_text, &mode_id, sizeof(mode_id) );
429 const char *psz_mode_name;
430 result = p_display_mode->GetName( &psz_mode_name );
433 msg_Err( p_demux, "Failed to get display mode name" );
434 p_display_iterator->Release();
439 BMDTimeValue frame_duration, time_scale;
440 result = p_display_mode->GetFrameRate( &frame_duration, &time_scale );
443 msg_Err( p_demux, "Failed to get frame rate" );
444 p_display_iterator->Release();
449 const char *psz_field_dominance;
450 uint32_t i_dominance_flags = 0;
451 switch( p_display_mode->GetFieldDominance() )
453 case bmdProgressiveFrame:
454 psz_field_dominance = "";
456 case bmdProgressiveSegmentedFrame:
457 psz_field_dominance = ", segmented";
459 case bmdLowerFieldFirst:
460 psz_field_dominance = ", interlaced [BFF]";
461 i_dominance_flags = BLOCK_FLAG_BOTTOM_FIELD_FIRST;
463 case bmdUpperFieldFirst:
464 psz_field_dominance = ", interlaced [TFF]";
465 i_dominance_flags = BLOCK_FLAG_TOP_FIELD_FIRST;
467 case bmdUnknownFieldDominance:
469 psz_field_dominance = ", unknown field dominance";
473 msg_Dbg( p_demux, "Found mode '%s': %s (%dx%d, %.3f fps%s)",
474 sz_mode_id_text, psz_mode_name,
475 p_display_mode->GetWidth(), p_display_mode->GetHeight(),
476 double(time_scale) / frame_duration, psz_field_dominance );
478 if( wanted_mode_id == mode_id )
481 p_sys->i_width = p_display_mode->GetWidth();
482 p_sys->i_height = p_display_mode->GetHeight();
483 p_sys->i_fps_num = time_scale;
484 p_sys->i_fps_den = frame_duration;
485 p_sys->i_dominance_flags = i_dominance_flags;
489 p_display_iterator->Release();
493 msg_Err( p_demux, "Unknown SDI mode specified. " \
494 "Run VLC with -v --verbose-objects=-all,+sdi " \
495 "to get a list of supported modes." );
500 result = p_sys->p_input->EnableVideoInput( htonl( wanted_mode_id ), bmdFormat8BitYUV, 0 );
503 msg_Err( p_demux, "Failed to enable video input" );
509 p_sys->i_rate = var_CreateGetInteger( p_demux, "sdi-audio-rate" );
510 p_sys->i_channels = var_CreateGetInteger( p_demux, "sdi-audio-channels" );
511 if( p_sys->i_rate > 0 && p_sys->i_channels > 0 )
513 result = p_sys->p_input->EnableAudioInput( p_sys->i_rate, bmdAudioSampleType16bitInteger, p_sys->i_channels );
516 msg_Err( p_demux, "Failed to enable audio input" );
522 p_sys->p_delegate = new DeckLinkCaptureDelegate( p_demux );
523 p_sys->p_input->SetCallback( p_sys->p_delegate );
525 result = p_sys->p_input->StartStreams();
528 msg_Err( p_demux, "Failed to start streams" );
533 /* Declare elementary streams */
534 es_format_t video_fmt;
535 es_format_Init( &video_fmt, VIDEO_ES, VLC_CODEC_UYVY );
536 video_fmt.video.i_width = p_sys->i_width;
537 video_fmt.video.i_height = p_sys->i_height;
538 video_fmt.video.i_sar_num = 1;
539 video_fmt.video.i_sar_den = 1;
540 video_fmt.video.i_frame_rate = p_sys->i_fps_num;
541 video_fmt.video.i_frame_rate_base = p_sys->i_fps_den;
542 video_fmt.i_bitrate = video_fmt.video.i_width * video_fmt.video.i_height * video_fmt.video.i_frame_rate * 2 * 8;
544 psz_tmp = var_CreateGetNonEmptyString( p_demux, "sdi-aspect-ratio" );
547 char *psz_denominator = strchr( psz_tmp, ':' );
548 if( psz_denominator )
550 *psz_denominator++ = '\0';
551 video_fmt.video.i_sar_num = atoi( psz_tmp ) * video_fmt.video.i_height;
552 video_fmt.video.i_sar_den = atoi( psz_denominator ) * video_fmt.video.i_width;
557 msg_Dbg( p_demux, "added new video es %4.4s %dx%d",
558 (char*)&video_fmt.i_codec, video_fmt.video.i_width, video_fmt.video.i_height );
559 p_sys->p_video_es = es_out_Add( p_demux->out, &video_fmt );
561 es_format_t audio_fmt;
562 es_format_Init( &audio_fmt, AUDIO_ES, VLC_CODEC_S16N );
563 audio_fmt.audio.i_channels = p_sys->i_channels;
564 audio_fmt.audio.i_rate = p_sys->i_rate;
565 audio_fmt.audio.i_bitspersample = 16;
566 audio_fmt.audio.i_blockalign = audio_fmt.audio.i_channels * audio_fmt.audio.i_bitspersample / 8;
567 audio_fmt.i_bitrate = audio_fmt.audio.i_channels * audio_fmt.audio.i_rate * audio_fmt.audio.i_bitspersample;
569 msg_Dbg( p_demux, "added new audio es %4.4s %dHz %dbpp %dch",
570 (char*)&audio_fmt.i_codec, audio_fmt.audio.i_rate, audio_fmt.audio.i_bitspersample, audio_fmt.audio.i_channels);
571 p_sys->p_audio_es = es_out_Add( p_demux->out, &audio_fmt );
573 p_sys->b_first_frame = true;
575 /* Update default_pts to a suitable value for access */
576 var_Create( p_demux, "sdi-caching", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT );
581 static void Close( vlc_object_t *p_this )
583 demux_t *p_demux = (demux_t *)p_this;
584 demux_sys_t *p_sys = p_demux->p_sys;
588 p_sys->p_input->StopStreams();
589 p_sys->p_input->Release();
593 p_sys->p_card->Release();
595 delete p_sys->p_delegate;
599 static int Control( demux_t *p_demux, int i_query, va_list args )
606 /* Special for access_demux */
607 case DEMUX_CAN_PAUSE:
609 case DEMUX_CAN_CONTROL_PACE:
610 pb = (bool*)va_arg( args, bool * );
614 case DEMUX_GET_PTS_DELAY:
615 pi64 = (int64_t*)va_arg( args, int64_t * );
616 *pi64 = var_GetInteger( p_demux, "sdi-caching" ) * 1000;
620 pi64 = (int64_t*)va_arg( args, int64_t * );
621 *pi64 = mdate(); // FIXME
624 /* TODO implement others */
632 static int Demux( demux_t *p_demux )
634 demux_sys_t *p_sys = p_demux->p_sys;
635 block_t *p_video_block = NULL;
636 block_t *p_audio_block = NULL;
638 vlc_mutex_lock( &p_sys->frame_lock );
640 while( !p_sys->p_video_frame && !p_sys->p_audio_frame )
641 vlc_cond_wait( &p_sys->has_frame, &p_sys->frame_lock );
643 p_video_block = p_sys->p_video_frame;
644 p_sys->p_video_frame = NULL;
646 p_audio_block = p_sys->p_audio_frame;
647 p_sys->p_audio_frame = NULL;
649 vlc_mutex_unlock( &p_sys->frame_lock );
653 es_out_Control( p_demux->out, ES_OUT_SET_PCR, p_video_block->i_pts );
654 es_out_Send( p_demux->out, p_sys->p_video_es, p_video_block );
659 es_out_Control( p_demux->out, ES_OUT_SET_PCR, p_audio_block->i_pts );
660 es_out_Send( p_demux->out, p_sys->p_audio_es, p_audio_block );