/** @file DHL_AVCAP.h @brief DHL AVCAP (Audio/Video decoding and Capture) API AudioVideo decoding/capture/output API Header Copyright 2006~2010 Digital STREAM Technology, Inc. All Rights Reserved */ #ifndef __DHL_AVCAP_H__ #define __DHL_AVCAP_H__ #include "DHL_OSAL.h" #include "DHL_MPEGTypes.h" #ifdef __cplusplus extern "C" { #endif #if COMMENT ____Overview____(){} #endif /** @file DHL_AVCAP.h HAL Interface Design Philosophy Target: Audio Video 디코딩 및 출력과 관련된 기능. 각 서비스 별 입력 데이터 포트 아날로그 입력 NTSC 방송 아날로그 외부 입력 (컴포넌트, 컴포지트) ==> BT.601/656 입력 포트 핸들로 추상화 함. 디지털 Compressed 입력 Terrestrial 및 Cable RF 방송 IEEE1 1394 ==> 모두 DHL Demux의 DHL_TSD 핸들로 추상화 함. 디지털 Uncompressed 입력 HDMI 입력 ==> TBD.. module overview - - APIs implementations dependencies nv parameters */ #if COMMENT ____Config____(){} #endif /* 이 부분은 별도의 DHL_XXX_Config configuration file 을 활용하는 것이 좋을 것 같음. */ #include "DHL_Config.h" #if COMMENT ____Types____(){} #endif typedef enum { eDHL_UD_TYPE_SEQ, eDHL_UD_TYPE_GOP, eDHL_UD_TYPE_PICTURE, eDHL_UD_TYPE_SEI, /*H.264*/ eDHL_UD_TYPE_ENTRYPOINT, eDHL_UD_TYPE_FIELD, eDHL_UD_TYPE_FRAME, eDHL_UD_TYPE_SLICE } tDHL_UserDataType; typedef enum { eDHL_PIC_POLARITY_TOP_FIELD, eDHL_PIC_POLARITY_TOP_BOTTOM, eDHL_PIC_POLARITY_TOP_FRAME } tDHL_PicPolarity; typedef enum { eDHL_PIC_CODING_UNKNOWN=0, eDHL_PIC_CODING_I, eDHL_PIC_CODING_P, eDHL_PIC_CODING_B } tDHL_PicCoding; typedef struct { UINT32 block_size; tDHL_PicPolarity polarity; tDHL_UserDataType ud_type; BOOL top_field_first; BOOL repeat_first_field; tDHL_PicCoding pic_coding; BOOL pts_valid; UINT32 pts; UINT32 pic_coding_ext[2]; UINT32 payload_size; } tDHL_UserDataHeader; typedef struct { tDHL_UserDataHeader hdr; UINT8 *pdata; } tDHL_UserData; /** @brief video 출력 단자 (포트) 외관 상으로 보이는 비디오 단자 (터미널)는 모두 이 중의 하나에 해당된다. */ typedef enum { eDHL_DISP_PORT_UNKNOWN = 0x0, eDHL_DISP_PORT_COMPONENT = 0x1, eDHL_DISP_PORT_COMPOSITE = 0x2, eDHL_DISP_PORT_SVIDEO = 0x4, eDHL_DISP_PORT_DVI = 0x8, eDHL_DISP_PORT_HDMI = 0x10 } tDHL_DispPort; #if 0 // 당장 사용되는 곳이 없음. /** @brief video display 출력 타입. DHL_AV_ChangeVideoFormat() API 에서 인자로 사용. 각 타입들은 독립적인 출력 포트 (커넥터)가 되어야 할텐데, 이 상수들은 bit flag로 정의 되어 있으므로, bit OR를 하여 건네면 된다. 문제점 - HDMI의 경우 YCbCr 4:4:4, YCbCr 4:2:2 등과 같이 세부 사항을 지정할 수 있는 방법이 없음. */ typedef enum { eDHL_DISP_OUTPUT_UNKNOWN=0x0, eDHL_DISP_OUTPUT_PS2=0x1, /* 1 PS/2 ("VGA") */ eDHL_DISP_OUTPUT_DVI=0x2, /* 2 DVI */ eDHL_DISP_OUTPUT_656=0x4, /* 3 ITU-R BT.656, 8-bit output */ eDHL_DISP_OUTPUT_YPRPB=0x8, /* 4 YPrPb (HDTV), tri-sync */ eDHL_DISP_OUTPUT_COMPOSITE=0x10, /* 5 SDTV composite */ eDHL_DISP_OUTPUT_SVIDEO=0x20, /* 6 SDTV S-Video */ eDHL_DISP_OUTPUT_YPRPB_YSYNC=0x40, /* 7 YPrPb (HDTV), sync on Y only */ eDHL_DISP_OUTPUT_RGB=0x80, /* 8 RGB component, tri-sync */ eDHL_DISP_OUTPUT_RGB_GSYNC=0x100, /* 9 RGB component, sync on green */ eDHL_DISP_OUTPUT_PS2_YPRPB=0x200 /* 10 PS/2 ("VGA") YPrPb output */ } tDHL_DispOutput; #endif /** @brief display output timing 값 이름은 VideoFormat 이지만, STB 입장에서는 사실 DisplayTiming 이 더 정확한 표현이다. DHL_AV_DispSetFormat() API의 인자로 사용된다. 여기에는 출력 frequency를 구분하는 정보는 없다. 50Hz, 60Hz를 둘 다 지원하면서 설정에 따라 바뀌는 그런 제품은 없음. 따라서 각 제품 사양에 따라 특정 주파수로 고정한다. 60Hz 와 59.94Hz 와 같은 차이는 HAL 내부에서 알아서 결정. VGA 호환 출력의 경우 아래에 있는 정보만으로는 턱없이 부족하고, 뭔가 다른 방법으로 지정해야 한다. (TODO) 일단 VGA는 지원하지 않는 것으로 간주. HDMI 비표준 해상도의 경우도 역시 다른 방법이 필요하다. (TODO) 일반적으로 표준 해상도를 주로 사용한다. 이 타입은 DHL_AV_VideoGetStatus() api 에서도 사용하는데, 그 경우 현재 출력 format이 아래 리스트에 없는 경우 eDHL_DISP_UNKNOWN 을 되돌려준다. 이 eDHL_DISP_UNKNOWN 는 DHL_AV_DispSetFormat() api 에서는 사용되어서는 안된다. */ typedef enum { eDHL_DISP_NO_OUTPUT, eDHL_DISP_720x480i, /*720x480 interlaced */ eDHL_DISP_720x480p, /*720x480 progressive */ eDHL_DISP_960x540p, /*960x540*/ eDHL_DISP_1280x720p, /*1280x720 progressive */ eDHL_DISP_1920x1080i, /*1920x1080 interlaced */ eDHL_DISP_1366x768, /*1366x768P 59.94Hz : 32" WXGA LG LCD */ eDHL_DISP_UNKNOWN = 0xF0, /* Unknown format */ } tDHL_DispFormat; #if 0 // 당장 사용되는 곳이 없음. /** @brief TV display의 aspect ratio. HDMI 장치의 경우 EDID로 부터 읽을 수도 있는데, 일단 application이 지정하는 것으로 함. 자동 ARC 기능에서 이 정보를 활용하는 경우가 있다. 그 외에는 이 정보는 informational 이며, AFD의 경우 application에서는 이미 이 정보를 알고 있으므로 그냥 참조용으로만 활용된다. 현재는 4:3과 16:9 만 의미가 있음. */ typedef enum { eDHL_DISP_ASPECT_1_1 = 1, /* Display aspect ratio is 1:1 */ eDHL_DISP_ASPECT_4_3, /* Display aspect ratio is 4:3 */ eDHL_DISP_ASPECT_16_9, /* Display aspect ratio is 16:9 */ eDHL_DISP_ASPECT_5_4 /* Display aspect ratio is 5:4 */ } tDHL_DispAspectRatio; #endif /** @brief display color space 컴포넌트 단자 및 HDMI/DVI 경우에만 설정이 가능하다. */ typedef enum { eDHL_DISP_CS_DEFAULT, eDHL_DISP_CS_YCBCR, eDHL_DISP_CS_RGB, } tDHL_DispColorSpace; /** @brief 비디오 디코더 ID 비디오 디코더 ID. 0부터 시작하는 정수. single decoder만 지원하는 시스템에서는 0을 사용한다. */ typedef UINT8 tDHL_VDID; /** @brief 비디오 캡쳐 장치 ID 비디오 캡쳐 장치 ID. */ typedef UINT8 tDHL_VCAPID; /** @brief 비디오 코덱 타입. DHL_AV_VideoStart API 에서 사용된다. 반드시 정확한 type을 지정해야 정상적인 동작이 보장된다. */ typedef enum { eDHL_VIDEO_TYPE_UNKNOWN =0, eDHL_VIDEO_TYPE_MPEG1= 1, /* MPEG-1 Video (ISO/IEC 11172-2) */ eDHL_VIDEO_TYPE_MPEG2= 2, /* MPEG-2 Video (ISO/IEC 13818-2) */ eDHL_VIDEO_TYPE_MPEG4P2= 0x10, /* MPEG-4 Part 2 Video */ eDHL_VIDEO_TYPE_H263 = 0x1A, /* H.263 Video. The value of the enum is not based on PSI standards. */ eDHL_VIDEO_TYPE_H264= 5, /* H.264 (ITU-T) or ISO/IEC 14496-10/MPEG-4 AVC */ eDHL_VIDEO_TYPE_VC1 = 0xEA, /* VC-1 Advanced Profile */ eDHL_VIDEO_TYPE_VC1SM = 0xEB, /* VC-1 Simple&Main Profile */ eDHL_VIDEO_TYPE_DIVX311= 0x311, /* DivX 3.11 coded video */ eDHL_VIDEO_TYPE_AVS = 0x42, /* AVS video */ eDHL_VIDEO_TYPE_DC2 } tDHL_VideoCodingType; /** @brief MPEG-2 Video ES sequence_header 정보 특정 application에서는 이 정보를 필요로 하므로 제공함. MPEG-4 나 AVC의 경우에는 호환이 되지 않을 수 있음. */ typedef struct { UINT32 generationNumber; /* Increments each time it changes */ UINT16 horizontal_size; /* incorporates horizontal_size_value and extension */ UINT16 vertical_size; /* incorporates vettical_size_value and extension */ MPEG_ASPECT_RATIO aspect_ratio_information; MPEG_FRAME_RATE frame_rate_code; float frame_rate; /* incorporates frame_rate_code, extension_n,_d */ UINT32 bit_rate; /* bit_rate_extension is added */ UINT32 vbv_buffer_size; /* Specified in bytes. (vbv_buffer_size_extension,value * 16/8 * 1024 */ BOOL constrained_parameter_flag; BOOL MPEG2; /* True if sequece_extension is present */ UINT8 profile_and_level_indication; BOOL progressive_sequence; MPEG_CHROMA_FORMAT chroma_format; BOOL low_delay; } tDHL_VideoSeqHdr; /** @brief 비디오 디코딩 상태 정보 예외 처리 체크를 위해 동작 모니터링을 하기 위해 사용된다. 또는 info banner 등에 사용자를 위한 각종 정보 표시를 위해 사용된다. */ typedef struct { /** @brief 디코딩이 진행중이면 TRUE. API는 start 되었지만 내부적으로 halt 된 경우라면? 이 값은 항상 DHL_AV_VideoStart/Stop API 호출 상태를 반영해야 한다. video decoder의 내부 동작 오류의 복구에 대한 책임은 HAL에 있다. */ BOOL bDecoding; /** @brief 현재 decoding 중인 비디오 타입. 대부분의 경우, DHL_AV_VideoStart 에서 지정했던 값이 될 것이지만, stream type auto detection 기능이 있다면 더 정확한 정보가 될 수 있다. */ tDHL_VideoCodingType type; /** @brief 비디오 데이터가 출력 중이면 TRUE. 디코딩을 시작 했더라도 pid 등이 잘못 지정되었다면 실제로는 아무런 디코딩이 수행되지 않는다. 이때 이 값은 FALSE가 되어야 한다. DHL_AV_VideoGetStatus API를 호출 할 시점의 상태이어야 한다. */ BOOL bOutputExist; /** @brief scrambled 비디오인 경우 TRUE. DHL_AV_VideoGetStatus API를 호출 할 시점의 상태이어야 한다. */ BOOL bScrambleDetected; /** @brief 현재 hdmi가 연결 중이면 TRUE. 현재는 HDMI 연결 정보를 알려주는 callback은 없고, app에서는 주기적으로 polling 체크 해야 한다. */ BOOL bHdmiConnected; /** @brief 현재 출력중인 hdmi (또는 component) display format을 알려준다. platform 이 hdmi 와 component 해상도를 별도로 지정이 불가능할 경우 hdmi 연결 상태에 따라 hd 출력 해상도가 달라지게 된다. 이때 이 api로 실제 출력 신호 format을 알 수 있다. hdmi가 연결이 안된 상태라면 이 값은 component 출력 해상도를 말한다. 만약 hdmi 와 component 해상도를 다르게 설정할 수 있는 platform 인 경우, 이 값은 hdmi 포트의 출력 해상도이다. (component 해상도는 아님) component 출력 해상도는 항상 마지막 DHL_AV_DispSetFormat() api에서 지정한 값이므로 굳이 query하지 않아도 알 수 있다. */ tDHL_DispFormat curDisplayFormat; } tDHL_VideoStatus; /** @brief HDMI 상태 정보. eDHL_CB_HdmiStatusChanged 콜백의 파라미터로 사용된다. 현재 이 정보를 query하는 API는 아직 준비하지 않았음. 일부 내용은 DHL_AV_VideoGetStatus() 로 알 수는 있다. */ typedef struct { /** @brief 현재 hdmi/dvi가 연결 중이면 TRUE. 단순히 물리적인 연결이 아니고, hdmi/dvi 연결 후 RX sense 후에 edid 정보까지 해석되고 나서 "connected"가 된다. */ BOOL bConnected; /** @brief 현재 연결된 hdmi display에서 지원하는 해상도 정보 bitmap. 각 bit가 tDHL_DispFormat 타이밍을 지원할 경우 1이 되며, LSB bit 0 부터 사용. 예를 들어 480p, 1080i 를 지원하는 TV라면 다음 값을 갖는다. (1 << eDHL_DISP_720x480p) | (1 << eDHL_DISP_1920x1080i) eDHL_DISP_UNKNOWN 값은 표시하지 않는다. "connected" 상태가 아닌 경우 이 값은 0이 되어야 한다. */ UINT32 supportedFormat; /** @brief TV가 선호하는 format. TV의 선호 format이 DHL에서 지원하지 못하는 형식일 경우 eDHL_DISP_UNKNOWN 으로 알려준다. */ tDHL_DispFormat preferedFormat; } tDHL_VideoHdmiStatus; /** @brief 비디오 출력의 Aspect Ratio Adjustment. ARC 라고도 한다. (Aspect Ratio Correction) DHL_AV_VideoSetARC API의 인자로 사용된다. eDHL_ARC_USER 모드의 경우 어떤 식으로 사용자가 설정할 것인지에 대해서는 방법은 확정되지 않았다. */ typedef enum { /*! 특별한 의미로 사용. API의 인자로는 사용되면 안됨. */ eDHL_ARC_UNKNOWN = 0, /*! 전체 화면: 출력해상도 전부를 채움 */ eDHL_ARC_FULLSCREEN = 1, /*! 레터박스 모드: 상하 여백(상12.5% 하12.5%), no crop, 전체 video */ eDHL_ARC_LETTERBOX = 2, /*! 사이드바 모드: 좌우 여백(좌12.5% 우12.5%), no crop, 전체 video */ eDHL_ARC_SIDEBAR = 3, /*! 팬스캔 모드: 좌우 25% crop(좌12.5% 우12.5%), 전체 스크린 */ eDHL_ARC_PAN_AND_SCAN = 4, /*! 틸트스캔 모드: 상하 25% crop(상12.5% 하12.5%), 전체 스크린 */ eDHL_ARC_TILT_AND_SCAN = 5, /*! 부분 레터박스 모드: 상하 여백(상6.25% 하6.25%), 좌우 12.5% crop(좌6.25% 우6.25%), 레터박스 모드와 팬스캔 모드의 중간. */ eDHL_ARC_PARTIAL_LETTERBOX = 6, /*! 부분 사이드바 모드: 좌우 여백(좌6.25% 우6.25%), 상하 12.5% crop(상6.25% 하6.25%), 사이드바 모드와 틸트스캔 모드의 중간. */ eDHL_ARC_PARTIAL_SIDEBAR = 7, /*! 상하좌우 12.5% crop(상6.25% 하6.25% 좌6.25% 우6.25%). 전체 스크린 */ eDHL_ARC_ZOOM1 = 8, /*! 상하좌우 25% crop(상12.5% 하12.5% 좌12.5% 우12.5%). 전체 스크린 */ eDHL_ARC_ZOOM2 = 9, /*! callback에 의해 사용자가 직접 지정/ 아직 어떠한 API, 메커니즘에 의해서 처리를 할지 확정 되지 않았음. 위의 ARC 모드 이외에 더 많은 모드를 원하는 customer가 있다면 그 때 고려하도록 함. */ eDHL_ARC_USER = 100, } tDHL_DispARC; typedef struct { INT16 x; INT16 y; INT16 w; INT16 h; } DHL_WINRECT; #if COMMENT ____Types2____(){} #endif /** @brief Audio Coding type. DHL_AV_AudioStart() API 에서 사용됨. 보통은 PMT의 stream type 정보에서 audio coding type을 알아낸다. 정확하게 지정하지 않으면 audio decoding이 제대로 동작하지 않는다. */ typedef enum { eDHL_AUDIO_TYPE_UNKNOWN=0, eDHL_AUDIO_TYPE_PCM, eDHL_AUDIO_TYPE_AC3, ///< Dolby AC3 (A/52) eDHL_AUDIO_TYPE_AAC_ADTS, ///< MPEG-2 part 7 AAC with ADTS syntax eDHL_AUDIO_TYPE_AAC_LATM, ///< MPEG-4 part 3 AAC with LATM syntax eDHL_AUDIO_TYPE_DTS, /** @todo 아래 항목들이 어떻게 구분되는지 체크 필요함. */ eDHL_AUDIO_TYPE_MPEG_1, eDHL_AUDIO_TYPE_MPEG_2, eDHL_AUDIO_TYPE_MPEG_4, eDHL_AUDIO_TYPE_MPEG_L1, eDHL_AUDIO_TYPE_MPEG_L2, eDHL_AUDIO_TYPE_MPEG_L3, eDHL_AUDIO_TYPE_AIFF, eDHL_AUDIO_TYPE_SINEWAVE } tDHL_AudioCodingType; /** @brief 오디오 디코딩 상태 정보 예외 처리 체크를 위해 동작 모니터링을 하기 위해 사용된다. 또는 info banner 등에 사용자를 위한 각종 정보 표시를 위해 사용된다. */ typedef struct { BOOL bDecoding; ///< 디코딩이 진행중이면 TRUE를 리턴한다. tDHL_AudioCodingType type; /** 디코딩이 진행 중이더라도 pid 등이 잘못 지정되었다면 실제로는 아무런 소리도 나오지 않는다. 이때 이 값은 FALSE가 되어야 한다. 실제로 귀에 소리가 들리는지 여부와는 상관 없다. (무음 정보가 encoding 된 스트림이 play 되는 경우 이 값은 TRUE가 되어야 함) */ BOOL bOutputExist; ///< audio 데이터가 출력 중이면 TRUE를 리턴. BOOL bSurround; ///< 2채널 초과 인 경우 TRUE. 2.1~5.1 채널 BOOL bStereo; ///< stereo 2ch 오디오라면 TRUE } tDHL_AudioStatus; /** @brief 디지털 오디오 출력 형태 설정. S/PDIF 출력 포트 또는 HDMI의 오디오 출력 부분에 설정 가능하다. DISABLE을 사용하면 신호 출력 자체가 나가지 않는 것이며, 해당 포트의 audio mute와는 약간의 차이가 있을 수 있다. */ typedef enum { eDHL_AUDIO_OUT_DISABLE, eDHL_AUDIO_OUT_PCM, ///< IEC 958 PCM uncompressed 출력 eDHL_AUDIO_OUT_COMPRESSED, ///< IEC 61937 compressed 출력 eDHL_AUDIO_OUT_END } tDHL_AudioIecOutFormat; /** @brief 오디오 출력 mute 설정 포인트 API를 이용하여 SW적으로 mute 제어 할 수 있는 위치들이다. 오디오 mute 제어는 다음과 같은 여러 조건에서 필요하다. - 사용자가 리모컨의 MUTE 키를 누른 경우 - 각종 block 상태 (ch block, rating block 등..) - 오디오 볼륨 0 상태 - 부팅 초기화 단계의 pop noise 제거를 위해 - standby 진입 직전 pop noise 제거를 위해 하지만 application 계층에서 이러한 구분 처리를 하므로, DHL 레벨에서는 한 종류의 mute만 제공해도 무방하다. */ typedef enum { eDHL_AUDIO_MUTE_DECODER, ///< 오디오 디코더에서 mute를 수행. 모든 오디오 출력 포트에 다 적용된다. ///< 따라서 app level 에서 기본적으로 사용하는 mute 방식이다. eDHL_AUDIO_MUTE_GPIO, ///< GPIO로 직접 구현한 mute 회로 ///< 이 옵션은 전원 on/off 시의 pop-up noise 제거를 위해 주로 사용된다. eDHL_AUDIO_MUTE_AMP, ///< DAC 또는 Amp의 RST/MUTE 등을 이용한 방식. ///< DAC이 내장되어 SoC에서 직접 LR 신호가 나오는 경우라든가, ///< DDX로 출력이 되는 경우에도, 눈에 보이는 앰프는 없지만 ///< 적절한 mute 기능 구현 필요. eDHL_AUDIO_MUTE_SPDIF, ///< S/PDIF 출력 오디오의 mute. ///< 신호 출력 자체가 disable 된 것과는 구분된다. eDHL_AUDIO_MUTE_HDMI, ///< HDMI 출력 오디오의 mute. eDHL_AUDIO_MUTE_HEADPHONE, ///< 헤드폰 출력 단자가 있을 경우 mute. } tDHL_AudioMutePlace; /** @brief 오디오 다운믹스 타입 */ typedef enum { eDHL_AUDIO_MIX_TYPE_LTRT = 0, ///< Line out mode. eDHL_AUDIO_MIX_TYPE_LORO = 1, ///< RF mode. } tDHL_AudioDownmixType; #if COMMENT ____Types3____(){} #endif /** @brief 일반 조회 함수의 조회할 내용. DHL_AV_Query API의 인자로 사용된다. 각 값 별로 DHL_AV_Query 리턴 결과 값 (pValue)의 의미가 정해져 있다. */ typedef enum { eDHL_AV_QUERY_UNKNOWN, /** Video decoder capability data. 결과: 비디오 디코더 cap data. tDHL_VideoCodingType 열거 타입의 bit 표현이다. ex) MPEG1과 MPEG2만 지원한다고 하면, 아래 cap 값이 리턴된다. cap = (1<