ntv2linuxdriverinterface.h

Go to the documentation of this file.

/* SPDX-License-Identifier: MIT */
#ifndef NTV2LINUXDRIVERINTERFACE_H
#define NTV2LINUXDRIVERINTERFACE_H
 
#include "ntv2driverinterface.h"
#include <assert.h>
#include <stdio.h>
#include <string.h>
#include <string>
 
#define CopyMemory(a,b,c) memcpy((a),(b),(c))
 
// oem dma: save locked pages in a stl::vector
#include <vector>
typedef std::vector<ULWord *> DMA_LOCKED_VEC;
 
class CNTV2LinuxDriverInterface : public CNTV2DriverInterface
{
    public:
                            CNTV2LinuxDriverInterface();
        AJA_VIRTUAL         ~CNTV2LinuxDriverInterface();
 
        AJA_VIRTUAL bool    WriteRegister (const ULWord inRegNum, const ULWord inValue, const ULWord inMask = 0xFFFFFFFF, const ULWord inShift = 0);
        AJA_VIRTUAL bool    ReadRegister (const ULWord inRegNum,  ULWord & outValue,  const ULWord inMask = 0xFFFFFFFF, const ULWord inShift = 0);
#if !defined(NTV2_DEPRECATE_14_3)
    AJA_VIRTUAL inline NTV2_DEPRECATED_f(bool ReadRegister (const ULWord inRegNum, ULWord * pOutValue, const ULWord inRegMask = 0xFFFFFFFF, const ULWord inRegShift = 0x0))
                                                {return pOutValue && ReadRegister(inRegNum, *pOutValue, inRegMask, inRegShift);}
#endif  //  !defined(NTV2_DEPRECATE_14_3)
 
        AJA_VIRTUAL bool    RestoreHardwareProcampRegisters (void);
 
        AJA_VIRTUAL bool    DmaTransfer (const NTV2DMAEngine    inDMAEngine,
                                        const bool              inIsRead,
                                        const ULWord            inFrameNumber,
                                        ULWord *                pFrameBuffer,
                                        const ULWord            inCardOffsetBytes,
                                        const ULWord            inTotalByteCount,
                                        const bool              inSynchronous = true);
 
        AJA_VIRTUAL bool    DmaTransfer (const NTV2DMAEngine    inDMAEngine,
                                        const bool              inIsRead,
                                        const ULWord            inFrameNumber,
                                        ULWord *                pFrameBuffer,
                                        const ULWord            inCardOffsetBytes,
                                        const ULWord            inTotalByteCount,
                                        const ULWord            inNumSegments,
                                        const ULWord            inHostPitchPerSeg,
                                        const ULWord            inCardPitchPerSeg,
                                        const bool              inSynchronous = true);
 
    AJA_VIRTUAL bool        DmaTransfer (const NTV2DMAEngine        inDMAEngine,
                                        const NTV2Channel           inDMAChannel,
                                        const bool                  inTarget,
                                        const ULWord                inFrameNumber,
                                        const ULWord                inCardOffsetBytes,
                                        const ULWord                inByteCount,
                                        const ULWord                inNumSegments,
                                        const ULWord                inSegmentHostPitch,
                                        const ULWord                inSegmentCardPitch,
                                        const PCHANNEL_P2P_STRUCT & inP2PData);
 
    AJA_VIRTUAL bool ConfigureSubscription (const bool bSubscribe, const INTERRUPT_ENUMS eInterruptType, PULWord & hSubcription)
                                            {(void)bSubscribe; (void)eInterruptType; (void)hSubcription; return true;}
    AJA_VIRTUAL bool ConfigureInterrupt (const bool bEnable, const INTERRUPT_ENUMS eInterruptType);
    AJA_VIRTUAL bool GetInterruptCount (const INTERRUPT_ENUMS eInterrupt, ULWord & outCount);
    AJA_VIRTUAL bool WaitForInterrupt (INTERRUPT_ENUMS eInterrupt, ULWord timeOutMs = 68);  // default of 68 ms timeout is enough time for 2K at 14.98 HZ
 
    AJA_VIRTUAL bool AutoCirculate (AUTOCIRCULATE_DATA &autoCircData);
    AJA_VIRTUAL bool NTV2Message (NTV2_HEADER * pInOutMessage);
    AJA_VIRTUAL bool ControlDriverDebugMessages(NTV2_DriverDebugMessageSet msgSet,
                                    bool enable);
    AJA_VIRTUAL bool HevcSendMessage(HevcMessageHeader* pMessage);
 
    AJA_VIRTUAL bool SetupBoard(void);
 
    // User allocated buffer methods.  Not as fast as driverbuffer methods, but no kernel patch required.
    AJA_VIRTUAL bool DmaWriteWithOffsets (NTV2DMAEngine DMAEngine, ULWord frameNumber, ULWord * pFrameBuffer,
                                                                    ULWord offsetSrc, ULWord offsetDest, ULWord bytes);
    AJA_VIRTUAL bool DmaReadWithOffsets (NTV2DMAEngine DMAEngine, ULWord frameNumber, ULWord * pFrameBuffer,
                                                                    ULWord offsetSrc, ULWord offsetDest, ULWord bytes);
 
public:
#if !defined(NTV2_DEPRECATE_13_0)
    AJA_VIRTUAL NTV2_DEPRECATED_f(bool SetRelativeVideoPlaybackDelay (ULWord frmDelay)) {(void)frmDelay; return false;} 
    AJA_VIRTUAL NTV2_DEPRECATED_f(bool GetRelativeVideoPlaybackDelay (ULWord* frmDelay)){(void)frmDelay; return false;} 
    AJA_VIRTUAL NTV2_DEPRECATED_f(bool SetAudioPlaybackPinDelay (ULWord msDelay))   {(void)msDelay; return false;}  
    AJA_VIRTUAL NTV2_DEPRECATED_f(bool GetAudioPlaybackPinDelay (ULWord* msDelay))  {(void)msDelay; return false;}  
    AJA_VIRTUAL NTV2_DEPRECATED_f(bool SetAudioRecordPinDelay (ULWord msDelay))     {(void)msDelay; return false;}  
    AJA_VIRTUAL NTV2_DEPRECATED_f(bool GetAudioRecordPinDelay (ULWord* msDelay))    {(void)msDelay; return false;}  
#endif  //  !defined(NTV2_DEPRECATE_13_0)
#if !defined(NTV2_DEPRECATE_16_0)
    AJA_VIRTUAL inline NTV2_SHOULD_BE_DEPRECATED(bool GetStreamingApplication(ULWord & outAppType, int32_t & outPID))   {return CNTV2DriverInterface::GetStreamingApplication(outAppType,outPID);}  
    AJA_VIRTUAL inline NTV2_SHOULD_BE_DEPRECATED(bool GetStreamingApplication(ULWord * pAppType, int32_t * pPID))       {return pAppType && pPID ? CNTV2DriverInterface::GetStreamingApplication(*pAppType,*pPID) : false;} 
    AJA_VIRTUAL NTV2_SHOULD_BE_DEPRECATED(bool MapFrameBuffers(void));      
    AJA_VIRTUAL NTV2_SHOULD_BE_DEPRECATED(bool UnmapFrameBuffers(void));    
    AJA_VIRTUAL NTV2_SHOULD_BE_DEPRECATED(bool MapRegisters(void));         
    AJA_VIRTUAL NTV2_SHOULD_BE_DEPRECATED(bool UnmapRegisters(void));       
    AJA_VIRTUAL NTV2_SHOULD_BE_DEPRECATED(bool GetBA0MemorySize(ULWord* memSize));  
    AJA_VIRTUAL NTV2_SHOULD_BE_DEPRECATED(bool GetBA1MemorySize(ULWord* memSize));  
    AJA_VIRTUAL NTV2_SHOULD_BE_DEPRECATED(bool GetBA2MemorySize(ULWord* memSize));  
    AJA_VIRTUAL NTV2_SHOULD_BE_DEPRECATED(bool GetBA4MemorySize(ULWord* memSize));  
    AJA_VIRTUAL NTV2_SHOULD_BE_DEPRECATED(bool MapXena2Flash(void));    
    AJA_VIRTUAL NTV2_SHOULD_BE_DEPRECATED(bool UnmapXena2Flash(void));  
    AJA_VIRTUAL NTV2_SHOULD_BE_DEPRECATED(bool MapDNXRegisters(void));  
    AJA_VIRTUAL NTV2_SHOULD_BE_DEPRECATED(bool UnmapDNXRegisters(void));
    // Driver allocated buffer (DMA performance enhancement, requires bigphysarea patch to kernel)
    AJA_VIRTUAL NTV2_SHOULD_BE_DEPRECATED(bool MapDMADriverBuffer());
    AJA_VIRTUAL NTV2_SHOULD_BE_DEPRECATED(bool UnmapDMADriverBuffer());
 
    AJA_VIRTUAL NTV2_SHOULD_BE_DEPRECATED(bool DmaReadFrameDriverBuffer (NTV2DMAEngine DMAEngine, ULWord frameNumber, unsigned long dmaBufferFrame,
                                                                            ULWord bytes, ULWord downSample, ULWord linePitch, ULWord poll));
 
    AJA_VIRTUAL NTV2_SHOULD_BE_DEPRECATED(bool DmaReadFrameDriverBuffer (NTV2DMAEngine DMAEngine, ULWord frameNumber, unsigned long dmaBufferFrame,
                                                                            ULWord offsetSrc, ULWord offsetDest, ULWord bytes,
                                                                            ULWord downSample, ULWord linePitch, ULWord poll));
 
    AJA_VIRTUAL NTV2_SHOULD_BE_DEPRECATED(bool DmaWriteFrameDriverBuffer (NTV2DMAEngine DMAEngine, ULWord frameNumber, unsigned long dmaBufferFrame,
                                                                        ULWord bytes, ULWord poll));
    AJA_VIRTUAL NTV2_SHOULD_BE_DEPRECATED(bool DmaWriteFrameDriverBuffer (NTV2DMAEngine DMAEngine, ULWord frameNumber, unsigned long dmaBufferFrame,
                                                                        ULWord offsetSrc, ULWord offsetDest, ULWord bytes, ULWord poll));
    AJA_VIRTUAL NTV2_SHOULD_BE_DEPRECATED(bool GetDMADriverBufferPhysicalAddress(ULWord* physAddr));
    AJA_VIRTUAL NTV2_SHOULD_BE_DEPRECATED(bool GetDMADriverBufferAddress(ULWord** pDMADriverBuffer));
    AJA_VIRTUAL NTV2_SHOULD_BE_DEPRECATED(bool GetDMANumDriverBuffers(ULWord* pNumDmaDriverBuffers));
#endif  //  defined(NTV2_DRIVER_ALLOCATED_BUFFERS)
    AJA_VIRTUAL bool SetAudioOutputMode(NTV2_GlobalAudioPlaybackMode mode); // Supported!
    AJA_VIRTUAL bool GetAudioOutputMode(NTV2_GlobalAudioPlaybackMode* mode);// Supported!
 
#if !defined(NTV2_NULL_DEVICE)
protected:  //  PRIVATE METHODS
    AJA_VIRTUAL bool    OpenLocalPhysical (const UWord inDeviceIndex);  
    AJA_VIRTUAL bool    CloseLocalPhysical  (void);
#endif  //  !defined(NTV2_NULL_DEVICE)
 
protected:  //  INSTANCE DATA
    std::string     _bitfileDirectory;
    HANDLE          _hDevice;
#if !defined(NTV2_DEPRECATE_16_0)
    ULWord *        _pDMADriverBufferAddress;
    ULWord          _BA0MemorySize;
    ULWord *        _pDNXRegisterBaseAddress;
    ULWord          _BA2MemorySize;
    ULWord          _BA4MemorySize;          // XENA2 only
#endif  //  !defined(NTV2_DEPRECATE_16_0)
};  //  CNTV2LinuxDriverInterface
 
#endif  //  NTV2LINUXDRIVERINTERFACE_H