rm84cmn.h

神龙卡的linux sdk RMF-1.6.88.0.tar.gz

	    @li evOutputDevice_TV
	    @li evOutputDevice_HDTV
	    @li evOutputDevice_DigOvOnly
	    @note The default value is evOutputDevice_VGA for analog boards and evOutputDevice_VGATV for digital boards. 
	*/
	evOutputDevice, // evOutputDevice_type (equivalent with MpegAttrVideoTv & VIDEOOUT_MASK)

	/** TV output format (TV output)
	    @li evTvOutputFormat_COMPOSITE
	    @li evTvOutputFormat_COMPONENT_YUV
	    @li evTvOutputFormat_COMPONENT_RGB
	    @li evTvOutputFormat_OUTPUT_OFF
	    @li evTvOutputFormat_COMPONENT_RGB_SCART
	    @note The default value is evTvOutputFormat_COMPOSITE. 
	*/
	evTvOutputFormat, //? evTvOutputFormat_type (equivalent with MpegAttrVideoTv & COMPONENT_MASK) ???
	
	/** TV standard (TV output)
	    @li evTvStandard_NTSC
	    @li evTvStandard_PAL
	    @li evTvStandard_PAL60
	    @li evTvStandard_PALM
	    @note The default value is evTvStandard_NTSC. 
	*/
	evTvStandard,   //? evTvStandard_type  (equivalent with MpegAttrVideoTv & STANDARDTV_MASK) ???

	evBrightness,	//?	RMuint32: [0..1000], brightness (equivalent with MpegAttrVideoBrightness)
	evContrast,		//?	RMuint32: [0..1000], contrast	(equivalent with MpegAttrVideoContrast)
	evSaturation,	//?	RMuint32: [0..1000], saturation	(equivalent with MpegAttrVideoSaturation)

	/** Video input aspect ratio
	    @li evInAspectRatio_4x3
	    @li evInAspectRatio_16x9
	    @note The default value is evInAspectRatio_4x3. 
	*/
	evInAspectRatio,	//?	evInAspectRatio_type: 	(equivalent with MpegAttrVideoAspectRatio)

	/** Video input standard ( based on frame rate and vertical width )
	    @li evInStandard_NTSC
	    @li evInStandard_PAL
	    @note The default value is evInStandard_NTSC. 
	*/
	evInStandard,		//?	evInStandard_type: 	(equivalent with MpegAttrVideoMode, MpegAttrVideoRate)

	/** Video output display option 
	    @li evOutDisplayOption_Normal
	    @li evOutDisplayOption_16x9to4x3_PanScan
	    @li evOutDisplayOption_16x9to4x3_LetterBox
	    @li evOutDisplayOption_4x3to16x9_HorzCenter
	    @li evOutDisplayOption_4x3to16x9_VertCenter
	    @note The default value is evOutDisplayOption_Normal. 
	*/
	evOutDisplayOption,	//?	evOutDisplayOption_type: 	(equivalent with MpegAttrVideoOutputMode)

	/** Source video window - {0,0, MpegWidth, MpegHeight}
	    @note Default Source window is 720x480
	*/
	evSourceWindow,	// Wnd_type, set/get

	/** Zoomed video window - it should be inside the SourceWindow
	    @note Default the Zoomed video window is equal with SourceWindow 
	*/
	evZoomedWindow,         // Wnd_type, set/get

	/** Maximum  output display resolution
	    @note It depends on the evOutputDevice selected. 
	*/
	evMaxDisplayWindow,     // Wnd_type, get only

	/** evDestinationWindow
	    @note For full screen get evMaxDisplayWindow and set evDestinationWindow
	*/
	evDestinationWindow,    // Wnd_type, set/get

	/** evValidWindow = Video valid window
	    @note The default is evMaxDisplayWindow
	*/
	evValidWindow,          // Wnd_type, set/get

	evCustomHdtvParams,     // CustomHdtvParams_type, set/get, (equivalent with MpegAttrHDTVMode)

	/** Video speed 
	    @note The default value is 0 for normal speed playback
	*/
	evSpeed,			// evSpeed_type (equivalent with MpegAttrVideoSpeed)

	/** evCaptureParams uses evCaptureParams_type to specify: 
	    wWidth        = picture width in pixels
	    wHeight       = height of frame or field in lines
	    wPictureType  = 0 for frame, 1 for field
	    dwBufferSize  = size of the buffer to receive the YUV info corresponding to CaptureFormat already set
	*/
	evCaptureParams,        // evCaptureParams_type, get only

    /** evCaptureFormat uses evCaptureFormat_type to specify:
        YUV_420_FRAME = 0,      // frame, eventually weaved for interlaced content
        YUV_420_TOP_FIELD,      // top field for interlaced content.
                                // For progressive content or Mpeg1 selects the odd lines from frame for (Y and UV).
        YUV_420_BOTTOM_FIELD,   // bottom field for interlaced content.
						// For progressive content or Mpeg1 selects the even lines from frame for (Y and UV).
        YUV_422_TOP_FIELD,      // returns "top" field for Y and all UV
        YUV_422_BOTTOM_FIELD,   // returns "bottom" field for Y and all UV
        BGR_24BITS_BMP,         // frame, eventually weaved
        PALETTE_INDEX_BMP       // frame, eventually weaved
    */

    evCaptureFormat,        // evCaptureFormat_type

    /** evCaptureFrame has to provide a buffer of dwBufferSize bytes; dwBufferSize should be
    get from evCaptureParams, after setting the evCaptureFormat
    */
	evCaptureFrame,         // variable buffer size = dwBufferSize get from evCaptureParams_type

	evUnsupported,          // evFrameNumberInGOP unsupported starting with HwLib version 24

	/** AnalogCable Presence
	    @li evAnalogCable_NotConnected
	    @li evAnalogCable_Connected
	    @note The default value is evAnalogCable_Connected 
	*/
	evAnalogCable,		// evAnalogCable_type, get only

	/** DigitalCable Presence
	    @li evDigitalCable_NotConnected
	    @li evDigitalCable_Connected
	    @note The default value is evDigitalCable_Connected 
	*/
	evDigitalCable,		// evDigitalCable_type, get only

	/** ScartAspectRatio ( TV output )
	    @li evScartAspectRatio_Auto
	    @li evScartAspectRatio_4x3
	    @li evScartAspectRatio_16x9
	    @note The default value is evScartAspectRatio_Auto 
	*/
	evScartAspectRatio, // evScartAspectRatio_type, set and get

	/** Video frame counter gives the number of frames displayed since
	    previous video stop.
	    @note The default value after stop is 0.
	*/
	evFrameCounter,     // RMuint32, get only (similar with MpegAttrVideoFramePosition)

	evYUVWriteParams,   // evYUVWriteParams_type
	evDisplayFilter,    // evDisplayFilter_type

	evDigOvOnlyConfig,  // evDigOvOnlyConfig_type, set/get
	evDigOvOnlyParams,  // evDigOvOnlyParams_type, set/get

	evVOBUReverseParams,// evVOBUReverseParams_type
	evVOBULastPack,     // evVOBULastPack_type
	evVOBUReverseSpeed, // evSpeed_type

	/** @li 1 for BROADCASTED_VIDEO -  the video is streamed and contains I blocks.
	    @li 0 for DVD_VIDEO - the video contains complete I frames. 
	    @note The default value is DVD_VIDEO.
	*/
	evBroadcastedVideo,

	/** @li 1 - displays progressive or interlaced like in the video stream
	    @li 0 - displays only progressive if the stream switches very fast from interlaced to progressive
	    @note The default value is 0. 
	*/
 	evForcedProgressiveSourceOff,

	/** @li 1 - displays progressive for any video stream
	    @li 0 - displays progressive only for movies
	    @note The default value is 0. 
	*/
 	evForcedProgressiveAlways,
	
	/** @li 1 - it drops frames when it converts Ntsc clip to PAL TV.
	    @li 0 - it drops fields when it converts Ntsc clip to PAL TV.
	    @note The default value is 0.
	*/
 	evNtscPalFrameDrop,
	
	/** @li 1 - displays only BOB on progressive device output
	    @li 0 - displays BOB or WEAVE on progressive device output, depending on stream
	    @note The default value is 0.
	*/
 	evForcedBobDisplayOnOutputDevice,
	
	/** 4 bits info from video stream
		bit 1,0 = APS= analogue protection system= pseudo sync pulse, inverted split color burst
		bit 3,2 = CGMS= copy generation management system= copyright, copy generation
	*/
	evMacrovisionFlags, // RMuint32, set only (similar with MpegAttrVideoMacrovisionFlags)
	
	/** 
	    Information valid only in video decoding state.
		Index in table defined in Mpeg1/2 standard
	*/
	evHwFrameRateIndex,             // get only
	/** 
	    Information valid only in video decoding state.
		Index in table defined in Mpeg1/2 standard
	*/
	evHwAspectRatioIndex,           // get only

	/** 
    Is effective during the video PAUSE and STOP status after DICOM_Update flag is set to 1.
	evStreamDefaultAtPause
	evTopFieldAtPause,
	evBottomFieldAtPause,
	evBothFieldsAtPause
    */
	evFieldFrameAtPause,         // set, get, evFieldFrameAtPause_type
	evVideoHwPlay,		         // set, evVideoHwPlay_type
	evVideoHwPause,		         // set, no parameters needed
	evVideoHwStop,		         // set, no parameters needed

	evMax
/*
	evEnableSync,	//	MpegAttrVideoEnableSync
	evStill,		//	MpegAttrVideoStill
*/
}VIDEO_SET_ID;

// AUDIO_SET
typedef enum {

	/** setting for the "ppm value" for 27MHz input for audio clock.
	Supported only for Ne2kTv board.
	Accepted values: -150ppm, -75ppm, 0ppm, +75ppm, +150ppm
	*/
	eAudioFineVcxo = 0,         // int

	/** setting for the audio NovaLite Pll used for some hardware designs.
		In the VCXO_SET set:
		Coefficients[0] = (N & 0xFF) | ((M & 0xFF)<<8) | ((K & 0xFF)<<16);
		See NovaLite spec for values of N,M,K.
	*/
	eAudioVcxo,                 // VCXO_SET, set only

	/** setting for AC3 parameters:
	Ac3ComprDlgNorm      HwLib default eAc3LineOut
	Ac3SpeakerConfig     HwLib default eAc3SpeakerSurround
	Ac3HiLoDynamicRange  HwLib default 0xFFFF
	Ac3RepeatCounter     HwLib default 0x0000
	*/
	eaAc3Conf,                  // AC3_CONF structure

	/** setting for audio channels selection for the speakers:
	eAudioMode_Stereo
	eAudioMode_MonoRight
	eAudioMode_MonoLeft
	eAudioMode_MonoMix
	@note The default value is eAudioMode_Stereo.
	*/
	eAudioMode,                 // eAudioMode_type

	/** setting to select what audio signals are used for input/output,
	The setting is suppoted or not depending on the hardware design.
	Only Harmony = DigPvr board supports next settings:
	eAudioInOutDefault        - JDA1_SCkinJDA1CK_Jda1CkinGCK_ScinOUT_DamckOUT
	eAudioInOutVcxoJda1Ckin   - JDA1_SCkinJDA1CK_Jda1CkinDAMCK_ScinOUT_DamckIN, DAMCK = VCXO(27MHz)
	eAudioInOutExternJda1Ckin - JDA1_SCkinDAMCK_Jda1CkinGCK_ScinOUT_DamckIN, DAMCK = capture clock
	eAudioInOutSCkinCapture   - JDA1_SCkinJDA1CK_Jda1CkinDAMCK_ScinOUT_DamckIN, DAMCK = 1.5x(40MHz)
	@note The default value is eAudioInOutDefault.
	*/
	eaInOutConfig,              // AudioInOutConfig_type

	/** audio volume right from 0 to 100
	    @note The default value is 50.
	*/
	eaVolumeRight,               // RMuint32: [0..100], right volume

	/** audio volume left from 0 to 100
	    @note The default value is 50.
	*/
	eaVolumeLeft,                // RMuint32: [0..100], left volume

	/** format of the audio stream  ( mpeg, ac3, pcm,... )
	Setting should be applied in Stop state of the decoder.
	    @note The default value is eAudioFormat_AC3.
	*/
	eAudioFormat,                // eAudioFormat_type

	/** Sample rate of the audio stream  ( 32kHz, 48kHz, ... )
	    @note The default value is 48KHz.
	*/
	eAudioSampleRate,            // RMuint32

	/** Number of PCM channels of the audio stream, used only for PCM format.
	Setting should be applied in Stop state of the decoder.
	    @note The default value is 2.
	*/
	eAudioNumberOfChannels,      // RMuint32: 1,2,...,8

	/** Number bits per sample of PCM audio stream, used only for PCM format.
	Setting should be applied in Stop state of the decoder.
	    @note The default value is 16.
	*/
	eAudioNumberOfBitsPerSample, // RMuint32: 24, 20 or 16.

	/** eAudioI2SOutput enable or disable the I2S output
	    @li eAudioI2SOutput_Disabled
	    @li eAudioI2SOutput_Active
	    @li eAudioI2SOutput_ActiveData0
	    @note The default value is eAudioI2SOutput_Active.
	*/
	eAudioI2SOutput,             // eAudioI2SOutput_type

	/** eAudioSpdifOutput enable or disable the SPDIF output
	    @li eAudioSpdifOutput_Disabled
	    @li eAudioSpdifOutput_Active
	    @li eAudioSpdifOutput_ActiveData0
	    @note The default value is eAudioSpdifOutput_Active.
	*/
	eAudioSpdifOutput,           // eAudioSpdifOutput_type

	/** eAudioDigitalOutput selects if the audio data are decoded in Pcm or just passtrough
	    @li eAudioDigitalOutput_Pcm
	    @li eAudioDigitalOutput_Compressed
	    @note The default value is eAudioDigitalOutput_Pcm.
	*/
	eAudioDigitalOutput,         // eAudioDigitalOutput_type, (MpegAttrAudioOutput)

	/** 
    ChannelStatus in SPDIF has 192 bits. EM84xx has the possibility to
    program the first 32 bits using two 16 bits registers.
    MSB = bit 31 from ChannelStatus corresponds to bit 31 in SPDIF spec.
    LSB = bit 0 from ChannelStatus corresponds to bit 0 in SPDIF spec.
    Ex: Bit2 == copyright == (use SetMask = ResetMask = 0x00000004).

    HwLib code changes some bits from ChannelStatus registers:
     - bit 1 - programmed 0/1 according to PCM/digital content of the audio output,
       reprogrammed at every change of AudioFormat or AudioDigitalOutput.
     - bits 15,..,8 - initialized to 00011001 = 0x19, not reprogrammed.
     - bits 27,..,24 - programmed according to the audio sample rate,
       reprogrammed at every change of AudioSampleRate.
    The default ChannelStatus value is 0x02001902 (48k, DVD, digital content).

    SetProperty can modify any bit from the 32 available, using ResetMask
    and SetMask. The logical operation is:
      ChannelStatus = (ChannelStatus & ~ResetMask) | SetMask.
    It is application responsability to keep the sample rate and
    digital content correct ( protective mask 0x0F000002 ).

    GetProperty will return the value of ChannelStatus in SetMask.
	*/
	eAudioChannelStatus,       // ResetSetMask_type, set, get

	/** 
		Information available only in audio decoding AC3 or Mpeg state.
	    Get 32000, 44100, 48000 from the hardware audio decoder.
	*/
	eAudioHwDecSampleRate,       // get only

	/** 
	    Information valid only in audio decoding Mpeg state.
		Mpeg standard states:
		0 - stereo
		1 - joint_stereo
		2 - dual_channel
		3 - single_channel
	*/
	eAudioHwDecMode,             // get only

	/** 
	    Information valid only in audio decoding Mpeg state.
		Mpeg standard states:
		0 - no emphasis
		1 - 50/15 microsec. emphasis
		2 - reserved
		3 - CCITT J.17
	*/
	eAudioHwDecEmphasis,         // get only

	/** 
	    Information valid only in audio decoding Mpeg state.
	*/
	eAudioHwDecCopyright,        // get only

	eaMax
}AUDIO_SET_ID;

// TIME_SET uses TIME_INFO or etimSystemTimeClock_type
typedef enum {
	/** 
    etimPcrInfo (set/get) uses PCR_INFO structure
		Name			  Default	Comments/Unit
		-----------------------------------------------------------------------------
		PcrEnable			0		// 0/1 disables/enables Pcr mode;
		RecoveryTime		16		// log2 ( RecoveryTime / 200us )
		 							// e.g. For 16 -> RecoveryTime = 2^16 =13.1072sec
		PcrIntrPeriodUs		20000	// microsecond;	e.g 200000 = 200ms ->5 intr/sec
									// It can be changed to 20000=20ms->50 intr/sec,
									// for a smoother control of the voltage control
		TimeResolution		90000	// 90K unit;	e.g. 90000 = 1sec - specifies
									   the unit for the PCR_time
		DeltaPCR_SCR_Max	9000	// Max. accepted diff. between incoming PCR and board's clock SCR
									// 90K unit;	e.g. 9000 = 100ms
		DeltaSCR_APTS_Max	180		// Max. accepted diff. between SCR and the incoming AudioPTS
									// 90K unit;	e.g. 180 = 2ms
		HwVcxo				5		// Galaxy2 Siemens use PIO 5 for Vcxo
		PpmRange			150		// +/- 150ppm
	*/
	etimPcrInfo = 0,               // PCR_INFO

	/** 
    etimPcrTime uses etimSystemTimeClock_type structure, where
	dwTimeResolution		// 90000 for 90k pts unit, 1000 for ms unit
	dwlTime				    // time stamp
	*/
	etimPcrTime,             // etimSystemTimeClock_type, set, get

	/** 
    Replaces IDecodeBoard_ReadSCR/WriteSCR.
	Without setting etimSystemTimeClock, after VideoHwStop or AudioHwStop the first
	Pts received in SendVideoPayload or	SendAudioPayload will be used to update
	the decoder's reference	clock.
	If etimSystemTimeClock is set after VideoHwStop or AudioHwStop and before sending
	data and Pts the Pts from data will be disregarded.
	*/
	etimSystemTimeClock,     // etimSystemTimeClock_type, set, get

	/** 
	Returns the timestamp of the last decoded video frame (displayed or not).
	Replaces IDecoderBoard_ReadHwPts45k.
	*/
	etimLastDecodedVideoFrameTime, // etimSystemTimeClock_type, get only

	/** 
	Returns the timestamp of the last decoded audio frame.
	*/
	etimLastDecodedAudioFrameTime, // etimSystemTimeClock_type, set, get

	/** 
    etimVOPTimeIncrRes - only for Mpeg4.
    Should be set before starting play with the value from DSI info.
	Returns the previously set: