aja.cpp File Reference

#include "config_msvc.h"
#include "config_unix.h"
#include "config_win32.h"
#include "debug.h"
#include <algorithm>
#include <chrono>
#include <condition_variable>
#include <cstdint>
#include <cstdio>
#include <cstdlib>
#include <cstring>
#include <iostream>
#include <memory>
#include <mutex>
#include <sstream>
#include <stdexcept>
#include <string>
#include <thread>
#include <unordered_map>
#include <utility>
#include "audio/types.h"
#include "audio/utils.h"
#include "host.h"
#include "lib_common.h"
#include "utils/video_frame_pool.h"
#include "video.h"
#include "video_capture.h"
#include "ajatypes.h"
#include <ajantv2/includes/ntv2rp188.h>
#include "ntv2devicescanner.h"
#include "ajabase/common/types.h"
#include "ajabase/common/videotypes.h"
#include "ajabase/common/circularbuffer.h"
#include "ajabase/system/process.h"
#include "ajabase/system/systemtime.h"
#include "ajabase/system/thread.h"
#include "ntv2utils.h"
#include "ntv2devicefeatures.h"
#include "aja_common.hpp"

Include dependency graph for aja.cpp:

Go to the source code of this file.

Classes
struct	aligned_data_allocator
class	vidcap_state_aja
struct	vidcap_state_aja::mAudio

Macros
#define	CHECK(cmd)
#define	CHECK_OK(cmd, msg, action_failed)
#define	CHECK_RET_FAIL(cmd)
#define	LINK_SPEC   static
#define	MOD_NAME   "[AJA cap.] "
#define	NOOP   ((void)0)
#define	NTV2_AUDIOSIZE_MAX   (401 * 1024)

Functions
	ADD_TO_PARAM ("aja-fourcc", "* aja-fourcc\n" " Specifies application FourCC for AJA.\n")
	REGISTER_MODULE (aja, &vidcap_aja_info, LIBRARY_CLASS_VIDEO_CAPTURE, VIDEO_CAPTURE_ABI_VERSION)
static void	show_help ()
LINK_SPEC void	vidcap_aja_done (void *state)
LINK_SPEC struct video_frame *	vidcap_aja_grab (void *state, struct audio_frame **audio)
LINK_SPEC int	vidcap_aja_init (struct vidcap_params *params, void **state)
LINK_SPEC void	vidcap_aja_probe (device_info **available_cards, int *count, void(**deleter)(void *))

Variables
unsigned int *	aja_audio_capture_channels = &audio_capture_channels
static const ULWord	app = AJA_FOURCC ('U','L','G','R')
static const struct video_capture_info	vidcap_aja_info

Detailed Description

Author

Martin Pulec pulec.nosp@m.@ces.nosp@m.net.c.nosp@m.z

Based on AJA samples ntv2framegrabber, ntv2capture and ntv2llburn (Ping-Pong)

Todo

Capture what is on the wire (RGB if RGB, YCbCr otherwise)

Definition in file aja.cpp.

Macro Definition Documentation

CHECK

#define CHECK

(

cmd

)

Value:

CHECK_OK(cmd, #cmd " failed", NOOP)

Definition at line 135 of file aja.cpp.

Referenced by vidcap_state_aja::~vidcap_state_aja(), vidcap_state_aja::CaptureFrames(), vidcap_state_aja::EnableInput(), vidcap_state_aja::GetVideoFormatFromInputSource(), vidcap_state_aja::Init(), vidcap_state_aja::IsInput3Gb(), vidcap_state_aja::Quit(), vidcap_state_aja::SetupAudio(), vidcap_state_aja::SetupHostBuffers(), and vidcap_state_aja::SetupVideo().

CHECK_OK

#define CHECK_OK	(		cmd,
			msg,
			action_failed )

Value:

        do { bool ret = cmd; if (!ret) {\
        LOG(LOG_LEVEL_WARNING) << MOD_NAME << (msg) << "\n";\
        action_failed;\
}\
} while(0)

Definition at line 127 of file aja.cpp.

#define CHECK_OK(cmd, msg, action_failed) do { bool ret = cmd; if (!ret) {\
        LOG(LOG_LEVEL_WARNING) << MOD_NAME << (msg) << "\n";\
        action_failed;\
}\
} while(0)

Referenced by vidcap_state_aja::Init(), vidcap_state_aja::SetupAudio(), and vidcap_state_aja::SetupVideo().

CHECK_RET_FAIL

#define CHECK_RET_FAIL

(

cmd

)

Value:

CHECK_OK(cmd, #cmd " failed", return AJA_STATUS_FAIL)

Definition at line 134 of file aja.cpp.

Referenced by vidcap_state_aja::SetupHDMI().

LINK_SPEC

#define LINK_SPEC   static

Definition at line 124 of file aja.cpp.

MOD_NAME

#define MOD_NAME   "[AJA cap.] "

Definition at line 110 of file aja.cpp.

Referenced by vidcap_state_aja::vidcap_state_aja(), vidcap_state_aja::CaptureFrames(), vidcap_state_aja::grab(), vidcap_state_aja::SetupAudio(), and vidcap_state_aja::SetupVideo().

NOOP

#define NOOP   ((void)0)

Definition at line 132 of file aja.cpp.

Referenced by vidcap_state_aja::Init(), vidcap_state_aja::SetupAudio(), and vidcap_state_aja::SetupVideo().

NTV2_AUDIOSIZE_MAX

#define NTV2_AUDIOSIZE_MAX   (401 * 1024)

Definition at line 106 of file aja.cpp.

Referenced by vidcap_state_aja::CaptureFrames(), vidcap_state_aja::SetupAudio(), and vidcap_state_aja::SetupHostBuffers().

Function Documentation

ADD_TO_PARAM()

ADD_TO_PARAM	(	"aja-fourcc"	,
		"* aja-fourcc\n" " Specifies application FourCC for AJA.\n"	)

REGISTER_MODULE()

REGISTER_MODULE	(	aja	,
		&	vidcap_aja_info,
		LIBRARY_CLASS_VIDEO_CAPTURE	,
		VIDEO_CAPTURE_ABI_VERSION	)

show_help()

static void show_help ( void )

static

Definition at line 992 of file aja.cpp.

                        {
        col() << "Usage:\n";
        col() << SBOLD(SRED("\t-t aja") << "[[:4K][:clear-routing][:channel=<ch>][:codec=<pixfmt>][:connection=<c>][:device=<idx>][:format=<fmt>][:progressive][:RGB|:YUV]|:help] -r [embedded|AESEBU|analog]")"\n";
        col() << "where\n";
 
        col() << SBOLD("\t4K") << "\n";
        col() << "\t\tVideo input is 4K.\n";
 
        col() << SBOLD("\tclear-routing") "\n" <<
                "\t\tremove all existing signal paths for device\n";
 
        col() << SBOLD("\tchannel") "\n";
        col() << "\t\tChannel number to use (indexed from 1). Doesn't need to "
                 "be set for SDI, useful for HDMI (capture and display should "
                 "have different channel numbers if both used, also other than "
                 "1 if SDI1 is in use).\n";
 
        col() << SBOLD("\tconnection") "\n" <<
                "\t\tConnection can be one of: ";
        NTV2InputSource source = NTV2InputSource();
        while (source != NTV2_INPUTSOURCE_INVALID) {
                if (source > 0) {
                        col() << ", ";
                }
                col() << NTV2InputSourceToString(source, true);
                // should be this, but GetNTV2InputSourceForIndex knows only SDIs
                //source = ::GetNTV2InputSourceForIndex(::GetIndexForNTV2InputSource(source) + 1);
                source = (NTV2InputSource) ((int) source + 1);
        }
        col() << "\n";
 
        col() << SBOLD("\tprogressive") "\n";
        col() << "\t\tVideo input is progressive.\n";
 
        col() << SBOLD("\tRGB|YUV") "\n";
        col() << "\t\tSet SDI video input to RGB or YCbCr explicitly. If "
                 "capture pixel format is set, expect the same encoding on "
                 "input. You can override this setting by specifying the "
                 "signal color space explicitly by this option (see "
                 "https://github.com/CESNET/UltraGrid/wiki/"
                 "Device-Settings#RGB_over_SDI for details).\n";
        col() << "\n";
 
        printf("Available devices:\n");
        CNTV2DeviceScanner      deviceScanner;
        for (unsigned int i = 0; i < deviceScanner.GetNumDevices (); i++) {
                CNTV2Card device;
                if (!CNTV2DeviceScanner::GetDeviceAtIndex(i, device)) {
                        MSG(WARNING, "Cannot get device at index #%u!\n", i);
                        continue;
                }
 
                col() << "\t" << SBOLD(i) << ") "
                      << SBOLD(device.GetDisplayName());
                print_aja_device_details(&device);
                const NTV2DeviceID deviceID = device.GetBaseDeviceID();
                NTV2VideoFormatSet fmt_set;
                if (NTV2DeviceGetSupportedVideoFormats(deviceID, fmt_set)) {
                        col() << SUNDERLINE("\tAvailable formats:");
                        for (auto fmt : fmt_set) {
                                if (fmt != *fmt_set.begin()) {
                                        col()<< ",";
                                }
                                col() << " \"" << NTV2VideoFormatToString(fmt)
                                      << "\"";
                        }
                        col() << "\n";
                }
                NTV2FrameBufferFormatSet pix_fmts;
                if (NTV2DeviceGetSupportedPixelFormats(deviceID, pix_fmts)) {
                        if (pix_fmts.count(NTV2_FBF_10BIT_YCBCR) == 0 && NTV2DeviceCanDoFrameBufferFormat(deviceID, NTV2_FBF_10BIT_YCBCR)) {
                                pix_fmts.insert(NTV2_FBF_10BIT_YCBCR); // workaround NTV2 bug
                        }
                        col() << SUNDERLINE("\tAvailable pixel formats:");
                        for (auto fmt : pix_fmts) {
                                if (fmt != *pix_fmts.begin()) {
                                        col() << ",";
                                }
                                if (ugaja::codec_map.find(fmt) ==
                                    ugaja::codec_map.end()) {
                                        col() << " "
                                              << NTV2FrameBufferFormatToString(
                                                     fmt)
                                              << " (unsupported)";
                                } else {
                                        col() << " "
                                              << get_codec_name(
                                                     ugaja::codec_map.at(fmt));
                                }
                        }
                        col() << "\n";
                }
                col() << SUNDERLINE("\tNumber of frame stores: ") << NTV2DeviceGetNumFrameStores (deviceID) << "\n";
        }
        if (deviceScanner.GetNumDevices() == 0) {
                col() << SUNDERLINE("\tno devices found") "\n";
        }
        col() << "\n";
}

References ultragrid::aja::codec_map, fmt, get_codec_name(), MSG, print_aja_device_details(), SBOLD, SRED, and SUNDERLINE.

Referenced by vidcap_aja_init().

Here is the call graph for this function:

vidcap_aja_done()

LINK_SPEC void vidcap_aja_done

(

void *

state

)

Definition at line 1131 of file aja.cpp.

{
        auto s = static_cast<vidcap_state_aja *>(state);
        s->Quit();
        delete s;
}

References vidcap_state_aja::Quit(), and state.

Here is the call graph for this function:

vidcap_aja_grab()

LINK_SPEC struct video_frame * vidcap_aja_grab	(	void *	state,
		struct audio_frame **	audio )

Definition at line 1138 of file aja.cpp.

{
        return ((vidcap_state_aja *) state)->grab(audio);
}

References audio, and state.

vidcap_aja_init()

LINK_SPEC int vidcap_aja_init	(	struct vidcap_params *	params,
		void **	state )

Definition at line 1092 of file aja.cpp.

{
        unordered_map<string, string> parameters_map;
        char *tmp = strdup(vidcap_params_get_fmt(params));
        if (strcmp(tmp, "help") == 0) {
                show_help();
                free(tmp);
                return VIDCAP_INIT_NOERR;
        }
        char *item, *cfg = tmp;
        while ((item = strtok(cfg, ":"))) {
                char *key_cstr = item;
                if (strchr(item, '=')) {
                        char *val_cstr = strchr(item, '=') + 1;
                        *strchr(item, '=') = '\0';
                        parameters_map[key_cstr] = val_cstr;
                } else {
                        parameters_map[key_cstr] = string();
                }
                cfg = NULL;
        }
        free(tmp);
 
        vidcap_state_aja *ret = nullptr;
        try {
                ret = new vidcap_state_aja(parameters_map, vidcap_params_get_flags(params) & VIDCAP_FLAG_AUDIO_ANY);
                ret->Run();
        } catch (string const & s) {
                LOG(LOG_LEVEL_ERROR) << "[AJA cap.] " << s << "\n";
                delete ret;
                return VIDCAP_INIT_FAIL;
        } catch (...) {
                delete ret;
                return VIDCAP_INIT_FAIL;
        }
        *state = ret;
        return VIDCAP_INIT_OK;
}

References LOG, LOG_LEVEL_ERROR, vidcap_state_aja::Run(), show_help(), state, VIDCAP_FLAG_AUDIO_ANY, VIDCAP_INIT_FAIL, VIDCAP_INIT_NOERR, VIDCAP_INIT_OK, vidcap_params_get_flags(), and vidcap_params_get_fmt().

Referenced by vidcap_aja_init_proxy().

Here is the call graph for this function:

vidcap_aja_probe()

LINK_SPEC void vidcap_aja_probe	(	device_info **	available_cards,
		int *	count,
		void(**	deleter )(void *) )

Definition at line 1143 of file aja.cpp.

{
        *deleter = free;
 
        device_info *cards = nullptr;
        int card_count = 0;
 
        CNTV2DeviceScanner      deviceScanner;
        for (unsigned int i = 0; i < deviceScanner.GetNumDevices (); i++) {
                CNTV2Card device;
                if (!CNTV2DeviceScanner::GetDeviceAtIndex(i, device)) {
                        MSG(WARNING, "Cannot get device at index #%u!\n", i);
                        continue;
                }
                card_count += 1;
                cards = (struct device_info *)
                        realloc(cards, card_count * sizeof(struct device_info));
                memset(&cards[card_count - 1], 0, sizeof(struct device_info));
                snprintf(cards[card_count - 1].dev, sizeof cards[card_count - 1].dev,
                                ":device=%d", i);
                snprintf(cards[card_count - 1].name, sizeof cards[card_count - 1].name,
                                "AJA %s", device.GetDisplayName().c_str());
                snprintf(cards[card_count - 1].extra, sizeof cards[card_count - 1].extra,
                                "\"embeddedAudioAvailable\":\"t\"");
        }
 
        *available_cards = cards;
        *count = card_count;
}

References count, deleter, device_info::dev, device_info::extra, MSG, and name.

Variable Documentation

aja_audio_capture_channels

unsigned int* aja_audio_capture_channels = &audio_capture_channels

Definition at line 118 of file aja.cpp.

Referenced by vidcap_state_aja::SetupAudio(), and vidcap_aja_init_proxy().

app

const ULWord app = AJA_FOURCC ('U','L','G','R')

static

Definition at line 162 of file aja.cpp.

Referenced by vidcap_state_aja::~vidcap_state_aja(), format_rtcp_app(), vidcap_state_aja::Init(), main(), process_rtcp_app(), rtp_process_ctrl(), and send_rtcp().

vidcap_aja_info

const struct video_capture_info vidcap_aja_info

static

Initial value:

= {
        vidcap_aja_probe,
        vidcap_aja_init,
        vidcap_aja_done,
        vidcap_aja_grab,
        VIDCAP_NO_GENERIC_FPS_INDICATOR,
}

Definition at line 1174 of file aja.cpp.

                                                         {
        vidcap_aja_probe,
        vidcap_aja_init,
        vidcap_aja_done,
        vidcap_aja_grab,
        VIDCAP_NO_GENERIC_FPS_INDICATOR,
};