WinCE6.0 MFC SMDKV210. Revision 1.90 October Samsung Electronics Co., Ltd. All rights reserved.

Transcription

1 WinCE6.0 MFC SMDKV210 Revision 1.90 October Samsung Electronics Co., Ltd. All rights reserved.

2 Important Notice The information in this publication has been carefully checked and is believed to be entirely accurate at the time of publication. Samsung assumes no responsibility, however, for possible errors or omissions, or for any consequences resulting from the use of the information contained herein. Samsung reserves the right to make changes in its products or product specifications with the intent to improve function or design at any time and without notice and is not required to update this documentation to reflect such changes. This publication does not convey to a purchaser of semiconductor devices described herein any license under the patent rights of Samsung or others. Samsung makes no warranty, representation, or guarantee regarding the suitability of its products for any particular purpose, nor does Samsung assume any liability arising out of the application or use of any product or circuit and specifically disclaims any and all liability, including without limitation any consequential or incidental damages. "Typical" parameters can and do vary in different applications. All operating parameters, including "Typicals" must be validated for each customer application by the customer's technical experts. Samsung products are not designed, intended, or authorized for use as components in systems intended for surgical implant into the body, for other applications intended to support or sustain life, or for any other application in which the failure of the Samsung product could create a situation where personal injury or death may occur. Should the Buyer purchase or use a Samsung product for any such unintended or unauthorized application, the Buyer shall indemnify and hold Samsung and its officers, employees, subsidiaries, affiliates, and distributors harmless against all claims, costs, damages, expenses, and reasonable attorney fees arising out of, either directly or indirectly, any claim of personal injury or death that may be associated with such unintended or unauthorized use, even if such claim alleges that Samsung was negligent regarding the design or manufacture of said product. Copyright 2010 Samsung Electronics Co., Ltd. All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electric or mechanical, by photocopying, recording, or otherwise, without the prior written consent of Samsung Electronics. Samsung Electronics Co., Ltd. San #24 Nongseo-Dong, Giheung-Gu Yongin-City, Gyeonggi-Do, Korea Contact Us: junghwan.shin@samsung.com Home Page:

3 Revision History Revision No. Date Author(s) , 2009 Initial Draft Peter Oh , 2009 Encoder API function changed Peter Oh , 2009 Encoder API related structure changed Peter Oh , 2009 Crop info related API added Peter Oh , 2009 OS independent API function applied Peter Oh , 2010 Definitions and variables for open GOP structure for H.264 encoding added Changhwan Youn , 2010 for VC-1 stream is added Peter Oh , 2010 for decoding input buffer added Jeongtae Park , 2010 Definition of Hierarchical P feature added Peter Oh , 2010 S.LSI Reference Kimoon Kim

4 Table of Contents 1 INTRODUCTION Purpose Scope Intended Audience SOFTWARE ARCHITECTURE Overview Decoding Decoding API Functions Decoding Flow Input Buffer MPEG H H VC Encoding Encoding API Functions Encoding Flow DECODER API SsbSipMfcDecOpen SsbSipMfcDecInit SsbSipMfcDecClose SsbSipMfcDecExe SsbSipMfcDecGetInBuf SsbSipMfcDecSetInBuf SsbSipMfcDecGetOutBuf SsbSipMfcDecSetConfig SsbSipMfcDecGetConfig ENCODER API SsbSipMfcEncOpen SsbSipMfcEncInit SsbSipMfcEncClose SsbSipMfcEncExe SsbSipMfcEncGetInBuf SsbSipMfcEncSetInBuf SsbSipMfcEncGetOutBuf SsbSipMfcEncSetOutBuf SsbSipMfcEncSetConfig SsbSipMfcEncGetConfig DATA STRUCTURE SSBSIP_MFC_DEC_OUTPUT_INFO SSBSIP_MFC_ENC_INPUT_INFO SSBSIP_MFC_ENC_OUTPUT_INFO

5 5.4 SSBSIP_MFC_ENC_H263_PARAM (total: 18) SSBSIP_MFC_ENC_MPEG4_PARAM (total: 25) SSBSIP_MFC_ENC_H264_PARAM (total: 36) DEFINITION AND ERROR CODES Types SSBSIP_MFC_CODEC_TYPE SSBSIP_MFC_FORCE_SET_FRAME_TYPE SSBSIP_MFC_FRAME_TYPE SSBSIP_MFC_DEC_OUTBUF_STATUS SSBSIP_MFC_DEC_CONF SSBSIP_MFC_ENC_CONF SSBSIP_MFC_ERROR_CODE

6 List of Figures Figure Title Page Number Number Figure 2-1 SW Structure of S5PV210 MFC Figure 2-2 Supporting Format of S5PV210 MFC Figure 2-3 NV12 Linear format Figure 2-4 Decoding API Functions Figure 2-5 Decoding Flow Figure 2-6 Encoding API Functions Figure 2-7 Encoding flow

7 List of Tables Table Title Page Number Number Table 2-1 MPEG4 Video Stream (Case #1) Table 2-2 MPEG4 Video Stream (Case #2) Table 2-3 H.263 Video Stream Table 2-4 H.264 Video Stream (Case #1) Table 2-5 H.264 Video Stream (Case #2) Table 2-6 VC-1 Video Stream (Case #1) Table 2-7 VC-1 Video Stream (Case #2)

8 List of Acronyms MFC API Acronyms Multi-Format Codec Application Programming Interface s

9 1 INTRODUCTION 1 INTRODUCTION 1.1 Purpose This document is prepared for the purpose of describing the S5PV210 HW codec (MFC V5.0) API, so that users can implement their multimedia application easily. 1.2 Scope The scope of this document is to describe Software architecture of Encoder/Decoder Data structures and API used for Encoder/Decoder Usage example of Encoder/Decoder 1.3 Intended Audience Intended Audience Project Manager Project Leader Project Team Member Test Engineer Yes Yes Yes Yes Tick whenever Applicable 1-1

10 2 INTRODUCTION 2 SOFTWARE ARCHITECTURE 2.1 Overview The S5PV210 Multi-Format Codec s Encoder/Decoder SW package consists of two parts: S5PV210 Multi-Format Codec Encoder/Decoder Library (located in user region) S5PV210 Multi-Format Codec Device Driver (located in OS region) User Application Create MFC instance Release MFC resources Get memory address of in/out buffer Set memory address of in/out buffer Initialize MFC instance Execute MFC stream Get CODEC configuration Set CODEC configuration S5PV210 MFC Decoder/Encoder Library open release ioctl mmap Linux File I/O functions S5PV210 MFC Device Driver Figure 2-1 SW Structure of S5PV210 MFC 2-1

11 2 INTRODUCTION The software architecture is shown in Figure 2-1. User s multimedia application can call the API functions provided by S5PV210 Multi-Format Codec Encoder/Decoder Library to encode and decode the multimedia data. Moreover, it can call the OS (WIN32, VFS of Linux) file I/O functions directly because those functions are also exposed in the user region. Figure 2-2 Supporting Format of S5PV210 MFC NV12 Linear format is supported for decoding output (Tiled Mode Only) and encoding input. A plane of 8 bit Y samples followed by an interleaved U/V plane containing 8 bit 2x2 sub sampled color difference samples. Y0 Y1 Y2 Y U0 V0 U1 V Figure 2-3 NV12 Linear format 2-2

12 2 INTRODUCTION 2.2 Decoding Decoding API Functions Figure 2-4 Decoding API Functions Decoding Flow SsbSipMfcDecOpen() SsbSipMfcDecGetInBuf() SsbSipMfcDecSetInBuf() SsbSipMfcDecInit() SsbSipMfcDecExe() SsbSipMfcDecGetOutBuf() no Is out buffer empty? yes SsbSipMfcDecClose() Figure 2-5 Decoding Flow 2-3

13 2 INTRODUCTION Input Buffer For decoding, the application needs to fill the input buffer with the exact size of one frame in the video stream. The stream header contains Visual Object Sequence, Visual Object, Video Object, Visual Object Layer and User Data for MPEG4; SPS, PPS and SEI for H.264; and Metadata, Sequence Layer and Entry-Pointer Layer for VC-1. The first input buffer (PIC #1) contains the stream header only or stream header with first I frame data. Note that MFC is able to handle both cases for decoding start: the stream header alone, and the stream header and the first frame together. In case of H.263, there is no sequence header and there is only frame header. In other words, there is no stream header for the first frame; the first input buffer (PIC #1) is used for parsing the frame header and decoding the first frame data MPEG4 In Table 2-1 the CONFIG stream is introduced for the configuration. It consists of several stream data which are Visual Object Sequence, Visual Object, Video Object, Visual Object Layer and User Data. The VOP streams are introduced individually to the decoder for obtaining decoded frame. Like PIC #N-2, when it happens to have the CONFIG stream in the middle of the VOP streams, it should be merged with the next VOP stream and then introduced to decoder for decoding. Table 2-2 shows the alternative method to initialize decoder and decoding first I-picture. Unlike Table 2-1 you can make up the PIC #1 with some stream data and first I-picture for decoder. PIC # 1 Table 2-1 MPEG4 Video Stream (Case #1) Values Stream Bytes Type Visual Object Sequence B0 03 Visual Object B5 09 Video Object Visual Object Layer F User Data B2 CC CC 63 CONFIG Stream 2 Video Object Plane (I-picture) B VOP Stream 3 Video Object Plane (P-picture) B6 50 7D... VOP Stream 4 Video Object Plane (P-picture) B6 50 FA... VOP Stream 5 Video Object Plane (P-picture) B6 50 ED... VOP Stream N-2 Visual Object Visual Object Layer F User Data B2 CC CC 63 Video Object Plane (I-picture) B CONFIG Stream N-1 Video Object Plane (P-picture) B VOP Stream 2-4

14 2 INTRODUCTION PIC # Values Stream Bytes Type N Video Object Plane (P-picture) B VOP Stream PIC # 1 Table 2-2 MPEG4 Video Stream (Case #2) Values Stream Bytes Type Visual Object Sequence B0 03 Visual Object B5 09 Video Object Visual Object Layer F User Data B2 CC CC 63 Video Object Plane (I-picture) B CONFIG Stream 2 Video Object Plane (P-picture) B6 50 7D... VOP Stream H.263 In case of H.263, each compressed video frame has its header. The video frame of I-picture is used as initializing CONFIG stream for the H.263 decoding. Also, it is used as decoding first frame data. Table 2-3 H.263 Video Stream PIC # N Video Header Video Data (I-picture) Video Header Video Data (P-picture) Video Header Video Data (P-picture) Values Stream Bytes Type Video Header Video Data (P-picture) C... CONFIG Stream A 0A VOP Stream A VOP Stream A 0A VOP Stream

15 2 INTRODUCTION H.264 In Table 2-4, the CONFIG stream is introduced to the H.264 decoder for the configuration. It consists of SPS, PPS, and SEI NALs. The VIDEO streams are introduced individually to the decoder for obtaining decoded frame. Likewise MPEG4 decoding, PIC #1 can include first I-slice, it shown in Table 2-5. PIC # 1 Table 2-4 H.264 Video Stream (Case #1) NAL Unit Type Stream Bytes (Example) Type Sequence Parameter Set (SPS) C 04 Picture Parameter Set (PPS) CE 09 C8 Suppl. Enhancement Info. (SEI) CONFIG Stream 2 Coded slice (I) B8 AF 78 VIDEO Stream 3 Coded slice (P) E1 98 VIDEO Stream 4 Coded slice (P) E2 E0 VIDEO Stream 5 Coded slice (P) (multi-slice 1) Coded slice (P) (multi-slice 2) E3 E E3 E M Sequence Parameter Set (SPS) Picture Parameter Set (PPS) DE 12 C8 Coded slice (I) B8 BF N-1 VIDEO Stream CONFIG Stream Picture Parameter Set (PPS) A0 D1 CONFIG Coded slice (I) B8 EA 62 Stream N Coded slice (P) E2 24 VIDEO Stream Table 2-5 H.264 Video Stream (Case #2) PIC # NAL Unit Type Stream Bytes (Example) Type 1 Sequence Parameter Set (SPS) C 04 Picture Parameter Set (PPS) CE 09 C8 Suppl. Enhancement Info. (SEI) Coded slice (I) B8 AF 78 CONFIG Stream 2 Coded slice (P) E1 98 VIDEO Stream

16 2 INTRODUCTION When it happens to have the SPS, PPS and/or SEI NALs in the middle of the VIDEO streams, it should be merged with the next VIDEO stream (commonly it is I-slice) and then introduced to decoder for decoding, The PIC #M and PIC #N-1 in Table 2-5 show above status. H.264 standard supports the multi-sliced NALs. The PIC #5 in Table 2-4 shows the multi-sliced NALs. Multiple slices are put together in the input buffer if they are part of one picture. NOTE: 1. For the MPEG4/H.263/H.264 decoding, CONFIGURATION call is followed by the procedure of input buffer fill with the next VOP stream. Then DECODE call comes for decoding it. 2. Multi-sliced NALs need to be put together in H.264 decoding if they are part of one picture in order to interface based on frame (Default). 3. In addition, each slice can be put to stream buffer for decoding in order to interface based on slice VC-1 In Table 2-6, the CONFIG stream is introduced to the VC-1 decoder for the configuration. Note that it includes the Sequence Layer ( F) & Entry-Point Layer ( E). Likewise other decoding process, you can divide it separately. The VIDEO streams are introduced individually to the decoder for obtaining decoded frame. Make sure that start code for VC-1 frame data is D. The container based on WMV9 (WVC1) can extract different format, for example there might be no start code depending on parser. The container based on VOB has the Sequence Layer & Entry-Point Layer in the middle of the VIDEO streams; it should be merged with the next VIDEO stream and then introduced to decoder for decoding, it shown in Table 2-6 (PIC #N-1). Table 2-6 VC-1 Video Stream (Case #1) PIC # NAL Unit Type Stream Bytes (Example) Type 1 2 Sequence Layer Entry-Point Layer Video Header Video Data Video Header Video Data F E D CONFIG Stream D VIDEO Stream N-1 Video Header Video Data Sequence Layer Entry-Point Layer Video Header Video Data D VIDEO Stream F E D CONFIG Stream 2-7

17 2 INTRODUCTION PIC # NAL Unit Type Stream Bytes (Example) Type N Video Header Video Data D VIDEO Stream Table 2-7 VC-1 Video Stream (Case #2) PIC # NAL Unit Type Stream Bytes (Example) Type 1 Sequence Layer F CONFIG Entry-Point Layer E Stream 2 Video Header Video Data D VIDEO Stream

18 2 INTRODUCTION 2.3 Encoding Encoding API Functions Encoding API Functions SsbSipMfcEncOpen() SsbSipMfcEncClose() MPEG4_ENC H263_ENC H264_ENC SsbSipMfcEncInit() SsbSipMfcEncExe() SsbSipMfcEncGetInBuf() SsbSipMfcEncSetInBuf() SsbSipMfcEncGetOutBuf() SsbSipMfcEncSetOutBuf() SsbSipMfcEncSetConfig() SsbSipMfcEncGetConfig() Figure 2-6 Encoding API Functions Encoding Flow SsbSipMfcEncOpen() SsbSipMfcEncInit() SsbSipMfcEncGetInBuf() SsbSipMfcEncSetInBuf() SsbSipMfcEncSetOutBuf() SsbSipMfcEncExe() SsbSipMfcEncGetOutBuf() no Is out buffer empty? yes SsbSipMfcEncClose() Figure 2-7 Encoding flow 2-9

19 3 INTRODUCTION 3 DECODER API 3.1 SsbSipMfcDecOpen SsbSipMfcDecOpen () This function is to create the MFC decoder instance void * SsbSipMfcDecOpen (void); Parameters Handle of the MFC decoder instance. 3.2 SsbSipMfcDecInit SsbSipMfcDecInit () Parameters This function is to Initialize MFC decoder instance MFC_ERROR_CODE SsbSipMfcDecInit (void *openhandle, SSBSIP_MFC_CODEC_TYPE codec_type, int Frameleng) [IN] openhandle - Return handle from SsbSipMfcDecOpen () [IN] codec_type Codec type to be decoded [IN] Frameleng the maximum length of input stream. Error code. 3.3 SsbSipMfcDecClose SsbSipMfcDecClose () This function is to release MFC decoder resources MFC_ERROR_CODE SsbSipMfcDecClose (void *openhandle); Parameters [IN] openhandle - Return handle from SsbSipMfcDecOpen () Error code 3-1

20 3 INTRODUCTION 3.4 SsbSipMfcDecExe SsbSipMfcDecExe () Parameters This function is to decode MFC video stream MFC_ERROR_CODE SsbSipMfcDecExe (void *openhandle, int lengthbuffill); [IN] openhandle - Return handle from SsbSipMfcDecOpen () [IN] lengthbuffill Length of data filled in the input buffer Error code. 3.5 SsbSipMfcDecGetInBuf SsbSipMfcDecGetInBuf () Parameters This function is to get memory address of decoding input buffer void * SsbSipMfcDecGetInBuf (void *openhandle, void **phyinbuf, int inputbuffersize); [IN] openhandle - Return handle from SsbSipMfcDecOpen (). [OUT] phyinbuf physical address of allocated buffer [IN] inputbuffersize - Allocation size(byte) Virtual address of input buffer. 3.6 SsbSipMfcDecSetInBuf SsbSipMfcDecSetInBuf () Parameters This function is to set memory address of decoding input buffer MFC_ERROR_CODE SsbSipMfcDecSetInBuf (void *openhandle, void *phyinbuf, void *virinbuf, int inputbuffersize); [IN] openhandle - Return handle from SsbSipMfcDecOpen (). [IN] phyinbuf physical address of buffer [IN] virinbuf virtuall address of buffer [IN] inputbuffersize - Allocated size(byte) Error code. NOTE: Buffer should not be located over 256MB from the MFC FW buffer, and buffer should be align to 64KByte 3-2

21 3 INTRODUCTION 3.7 SsbSipMfcDecGetOutBuf SsbSipMfcDecGetOutBuf () This function is to get memory address for decoding output buffer Parameters SSBSIP_MFC_DEC_OUTBUF_STATUS SsbSipMfcDecGetOutBuf (void *openhandle, SSBSIP_MFC_DEC_OUTPUT_INFO *output_info); [IN] openhandle - Return handle from SsbSipMfcDecOpen (). [OUT] output_info Output information Current status of output buffer 3.8 SsbSipMfcDecSetConfig SsbSipMfcDecSetConfig () This function is to set codec variables MFC_ERROR_CODE Parameters SsbSipMfcDecSetConfig (void *openhandle, SSBSIP_MFC_DEC_CONF conf_type, void *value); [IN] openhandle Return handle from SsbSipMfcDecOpen (). [IN] conf_type Configuration type [IN] value Configuration value. Error code. 3-3

22 3 INTRODUCTION 3.9 SsbSipMfcDecGetConfig Parameters SsbSipMfcDecGetConfig () This function is to get codec variables MFC_ERROR_CODE SsbSipMfcDecGetConfig (void *openhandle, SSBSIP_MFC_DEC_CONF conf_type, void *value); [IN] openhandle Return handle from SsbSipMfcDecOpen (). [IN] conf_type Configuration type [OUT] value Configuration value Error code. 3-4

23 4 INTRODUCTION 4 ENCODER API 4.1 SsbSipMfcEncOpen Parameters SsbSipMfcEncOpen () This function is to create the MFC encoder instance void * SsbSipMfcEncOpen (void); Handle of the MFC encoder instance. 4.2 SsbSipMfcEncInit Parameters SsbSipMfcEncInit () This function is To Initialize MFC encoder instance MFC_ERROR_CODE SsbSipMfcEncInit (void *openhandle, void *param); [IN] openhandle - Return handle from SsbSipMfcEncOpen () [IN] param encoding parameter structure pointer Error code. 4.3 SsbSipMfcEncClose SsbSipMfcEncClose () This function is to release MFC encoder resources MFC_ERROR_CODE SsbSipMfcEncClose (void *openhandle); Parameters [IN] openhandle - Return handle from SsbSipMfcEncOpen () Error code 4-1

24 4 INTRODUCTION 4.4 SsbSipMfcEncExe SsbSipMfcEncExe () This function is to encode MFC video stream MFC_ERROR_CODE SsbSipMfcEncExe(void *openhandle); Parameters [IN] openhandle - Return handle from SsbSipMfcEncOpen () Error code 4.5 SsbSipMfcEncGetInBuf Parameters SsbSipMfcEncGetInBuf () This function is to get memory address of encoding input buffer MFC_ERROR_CODE SsbSipMfcEncGetInBuf (void *openhandle, SSBSIP_MFC_ENC_INPUT_INFO * input_info); [IN] openhandle - Return handle from SsbSipMfcEncOpen (). [OUT] input_info output value Error code 4.6 SsbSipMfcEncSetInBuf Parameters SsbSipMfcEncGetInBuf () This function is to set memory address of encoding input buffer MFC_ERROR_CODE SsbSipMfcEncSetInBuf (void *openhandle, SSBSIP_MFC_ENC_INPUT_INFO * input_info); [IN] openhandle - Return handle from SsbSipMfcEncOpen (). [IN] input_info setting value Error code. NOTE: Each Buffer(Y and C) should be align to 64KB 4-2

25 4 INTRODUCTION 4.7 SsbSipMfcEncGetOutBuf Parameters SsbSipMfcEncGetOutBuf () This function is to get memory address for encoding output buffer MFC_ERROR_CODE SsbSipMfcEncGetOutBuf (void *openhandle, SSBSIP_MFC_ENC_OUTPUT_INFO *output_info); [IN] openhandle - Return handle from SsbSipMfcEncOpen (). [OUT] output_info output information. Virtual address of out buffer. 4.8 SsbSipMfcEncSetOutBuf Parameters SsbSipMfcEncSetOutBuf () This function is to set memory address for encoding output buffer MFC_ERROR_CODE SsbSipMfcEncSetOutBuf (void *openhandle, void *phyoutbuf, void *viroutbuf, int outputbuffersize); [IN] openhandle - Return handle from SsbSipMfcEncOpen (). [IN] phyoutbuf physical address of output buffer [IN] viroutbuf virtual address of output buffer [IN] outputbuffersize - Allocated size(byte) Error code. 4.9 SsbSipMfcEncSetConfig Parameters SsbSipMfcEncSetConfig () This function is to set codec variables MFC_ERROR_CODE SsbSipMfcEncSetConfig (void *openhandle, SSBSIP_MFC_ENC_CONF conf_type, void *value); [IN] openhandle Return handle from SsbSipMfcEncOpen (). [IN] conf_type Configuration type [IN] value Configuration value. Error code. 4-3

26 4 INTRODUCTION 4.10 SsbSipMfcEncGetConfig Parameters SsbSipMfcEncGetConfig () This function is to get codec variables MFC_ERROR_CODE SsbSipMfcEncGetConfig (void *openhandle, SSBSIP_MFC_ENC_CONF conf_type, void *value); [IN] openhandle Return handle from SsbSipMfcEncOpen (). [IN] conf_type Configuration type [OUT] value Configuration value Error code. 4-4

27 5 INTRODUCTION 5 DATA STRUCTURE 5.1 SSBSIP_MFC_DEC_OUTPUT_INFO SSBSIP_MFC_DEC_OUTPUT_INFO void *YPhyAddr Physical address of luma data void *CPhyAddr Physical address of chroma data void *YVirAddr Virtual address of luma data void *CVirAddr Virtual address of chroma data int img_width Width of real image int img_height Height of real image int buf_width Width of output buffer, It is multiple of 16 int buf_height Height of output buffer, It is multiple of 32 int timestamp_top Timestamp of top field int timestamp_bottom Timestamp of bottom field int consumedbyte The number of byte consumed during decoding int crop_right_offset int crop_left_offset int crop_bottom_offset Frame crop information (Only in case of H.264) int crop_top_offset 5.2 SSBSIP_MFC_ENC_INPUT_INFO void *YPhyAddr void *CPhyAddr void *YVirAddr void *CVirAddr int YSize int CSize SSBSIP_MFC_ENC_INPUT_INFO Physical address of luma data Physical address of chroma data Virtual address of luma data Virtual address of chroma The size of luma data The size of chroma data 5-1

28 5 INTRODUCTION 5.3 SSBSIP_MFC_ENC_OUTPUT_INFO unsigned int datasize unsigned int headersize unsigned int frametype void *StrmPhyAddr void *StrmVirAddr void *encodedyphyaddr void *encodedcphyaddr SSBSIP_MFC_ENC_OUTPUT_INFO The length of encoded data stream The length of encoded header stream The type of encoded frame The physical address of stream buffer The virtual address of stream buffer The physical address of encoded luma data The physical address of encoded chroma data 5.4 SSBSIP_MFC_ENC_H263_PARAM (total: 18) Variable Value Range SSBSIP_MFC_CODEC_TYPE codectype Codec type See int SourceWidth; Width of video to be encoded 64 ~ 1920 int SourceHeight Height of video to be encoded 64 ~ 1080 int IDRPeriod int SliceMode GOP number(interval of I-frame) Multi slice mode 0 = All frame is P frame 1 = All frame is I frame 2 = I-P-I-P 3 = I-P-P-I-P-P-I-P 0 = Disable 1 = Enable int RandomIntraMBRefresh Cyclic intra refresh 0 ~ MBCnt int EnableFRMRateControl Frame based rate control enable int FrameRate Rate control parameter(frame rate) 1 ~ int Bitrate Rate control parameter(bit rate) 1 ~ 0 = Disable 1 = Enable int FrameQp The quantization parameter of the frame 1 ~ 31 int FrameQp_P The quantization parameter of the P frame 1 ~ 31 int QSCodeMax Maximum Quantization value 1 ~ 31 int QSCodeMin Minimum Quantization value 1 ~ 31 int CBRPeriodRf int PadControlOn Reaction coefficient parameter for rate control Enable padding control int LumaPadVal Luma pel value used to fill padding area 0 ~ 255 CBR: 2 ~ 10 VBR: 100~1000 int CbPadVal CB pel value used to fill padding area 0 ~ = Use boundary pixel 1 = Use the below setting value 5-2

29 5 INTRODUCTION Variable Value Range int CrPadVal CR pel value used to fill padding area 0 ~ SSBSIP_MFC_ENC_MPEG4_PARAM (total: 25) Variable Value Range SSBSIP_MFC_CODEC_TYPE codectype Codec type See int SourceWidth; width of video to be encoded 64 ~ 1920 int SourceHeight height of video to be encoded 64 ~ 1080 int IDRPeriod int SliceMode int SliceArgument GOP number(interval of I-frame) Multi slice mode MB number or byte number int RandomIntraMBRefresh cyclic intra refresh 0 ~ MBCnt int EnableFRMRateControl frame based rate control enable int TimeIncreamentRes rate control parameter(frame rate) 1 ~ int VopTimeIncreament rate control parameter(frame rate) 1 ~ int Bitrate rate control parameter(bit rate) 1 ~ 0 = All frame is P frame 1 = All frame is I frame 2 = I-P-I-P 3 = I-P-P-I-P-P-I-P 0 = Disable 1 = Fixed MB number slice 2 = Fixed byte number slice 4 = Variable MB number slice MB number: 1 ~ (MBCnt -1) Byte number: 1900 ~ 0 = Disable 1 = Enable int FrameQp The quantization parameter of the frame 1 ~ 31 int FrameQp_P int FrameQp_B The quantization parameter of the P frame The quantization parameter of the B frame 1 ~ 31 1 ~ 31 int QSCodeMax Maximum Quantization value 1 ~ 31 int QSCodeMin Minimum Quantization value 1 ~ 31 int CBRPeriodRf int PadControlOn Reaction coefficient parameter for rate control Enable padding control int LumaPadVal Luma pel value used to fill padding area 0 ~ 255 int CbPadVal CB pel value used to fill padding area 0 ~ 255 int CrPadVal CR pel value used to fill padding area 0 ~ 255 int ProfileIDC profile CBR: 2 ~ 10 VBR: 100~ = Use boundary pixel 1 = Use the below setting value 0 = SP 1 = ASP 5-3

30 5 INTRODUCTION Variable Value Range int LevelIDC level 0 (level 0) ~ 50 (level 5.0) int NumberBFrames int DisableQpelME The number of consequtive B frame inserted disable quarter-pixel motion estimation 0 (not used) ~ 2 0 = Enable 1 = Disable 5.6 SSBSIP_MFC_ENC_H264_PARAM (total: 36) Variable Value Range SSBSIP_MFC_CODEC_TYPE codectype Codec type See int SourceWidth; Width of video to be encoded 64 ~ 1920 int SourceHeight Height of video to be encoded 64 ~ 1080 int IDRPeriod int SliceMode int SliceArgument GOP number(interval of I-frame) Multi slice mode MB number or byte number int RandomIntraMBRefresh Cyclic intra refresh 0 ~ MBCnt int EnableFRMRateControl Enable frame based rate control int FrameRate Rate control parameter(frame rate) 1 ~ int Bitrate Rate control parameter(bit rate) 1 ~ int FrameQp int FrameQp_P int FrameQp_B The quantization parameter of the frame (for I frame) The quantization parameter of the frame (for P frame) The quantization parameter of the frame (for B frame) 0 = All frame is P frame 1 = All frame is I frame 2 = I-P-I-P 3 = I-P-P-I-P-P-I-P 0 = Disable 1 = Fixed MB number slice 2 = Fixed byte number slice 4 = Variable MB number slice MB number: 1 ~ (MBCnt -1) Byte number: 1900 ~ 0 = Disable 1 = Enable 1 ~ 51 1 ~ 51 1 ~ 51 int QSCodeMax Maximum Quantization value 1 ~ 51 int QSCodeMin Minimum Quantization value 1 ~ 51 int CBRPeriodRf int PadControlOn Reaction coefficient parameter for rate control Enable padding control CBR: 2 ~ 10 VBR: 100~1000 int LumaPadVal Luma pel value used to fill padding area 0 ~ = Use boundary pixel 1 = Use the below setting value 5-4

31 5 INTRODUCTION Variable Value Range int CbPadVal CB pel value used to fill padding area 0 ~ 255 int CrPadVal CR pel value used to fill padding area 0 ~ 255 int ProfileIDC Profile 0 = main 1 = high 2 = baseline int LevelIDC Level 1(level 1.0) ~ 40(level 4.0) int NumberBFrames The number of consecutive B frame inserted int NumberReferenceFrames The number of reference pictures used 1 ~ 2 int NumberRefForPframes int LoopFilterDisable The number of reference pictures used for encoding P pictures Disable the loop filter 0(not used) ~ 2 1 ~ 2 0 = Enable 1 = Disable int LoopFilterAlphaC0Offset Alpha & C0 offset for H.264 loop filter -6 ~ +6 int LoopFilterBetaOffset Beta offset for H.264 loop filter -6 ~ +6 int SymbolMode int PictureInterlace int Transform8x8Mode int EnableMBRateControl int DarkDisable int SmoothDisable int StaticDisable int ActivityDisable The mode of entropy coding Enables the interlace mode Allow 8x8 transform(this is allowed only for high profile) Enable macroblock-level rate control Disable adaptive rate control on dark region Disable adaptive rate control on smooth region Disable adaptive rate control on static region Disable adaptive rate control on high activity region 0 = CAVLC 1 = CABAC 0 = Frame picture 1 = Field picture 0 = Disable 1 = Enable 0 = Disable 1 = Enable 0 = Disable 1 = Enable 0 = Disable 1 = Enable 0 = Disable 1 = Enable 0 = Disable 1 = Enable 5-5

32 6 INTRODUCTION 6 DEFINITION AND ERROR CODES 6.1 Types SSBSIP_MFC_CODEC_TYPE SSBSIP_MFC_FORCE_SET_FRAME_TYPE DONT_CARE I_FRAME NOT_CODED MFC_FORCE_SET_FRAME_TYPE Don t care I frame Not coded frame SSBSIP_MFC_FRAME_TYPE MFC_FRAME_TYPE_NOT_CODED MFC_FRAME_TYPE_I_FRAME MFC_FRAME_TYPE_P_FRAME MFC_FRAME_TYPE_B_FRAME MFC_FRAME_TYPE_OTHERS SSBSIP_MFC_FRAME_TYPE Not coded type (skipped frame) I /IDR frame P frame B frame Other type SSBSIP_MFC_DEC_OUTBUF_STATUS MFC_GETOUTPUT_DECODING_ONLY MFC_GETOUTPUT_DISPLAY_DECODING MFC_GETOUTPUT_DISPLAY_ONLY MFC_GETOUTPUT_DISPLAY_END SSBSIP_MFC_DEC_OUTBUF_STATUS There is no data to be displayed in output buffer There is data to be displayed in output buffer There is data to be displayed in output buffer, After this status, input stream has to be skipped. Displayable data is not determined yet 6-1

33 6 INTRODUCTION SSBSIP_MFC_DEC_CONF MFC_DEC_SETCONF_POST_ENABLE MFC_DEC_SETCONF_EXTRA_BUFFER_NUM SSBSIP_MFC_DEC_CONF Set mpeg4 post filter enable Set the number of extra buffer to prevent tearing MFC_DEC_SETCONF_DISPLAY_DELAY Set the number of display delay only for H.264 MFC_DEC_SETCONF_IS_LAST_FRAME MFC_DEC_SETCONF_SLICE_ENABLE MFC_DEC_SETCONF_CRC_ENABLE MFC_DEC_GETCONF_CRC_DATA MFC_DEC_GETCONF_BUF_WIDTH_HEIGHT Tell to driver that this stream is the last. Set slice based input Set CRC generation for conformance test Get CRC data to verify decoded data. Get buf_width and buf_height after SsbSipMfcDecInit() SSBSIP_MFC_ENC_CONF MFC_ENC_SETCONF_FRAME_TYPE MFC_ENC_SETCONF_CHANGE_FRAME_RATE MFC_ENC_SETCONF_CHANGE_BIT_RATE MFC_ENC_SETCONF_ALLOW_FRAME_SKIP MFC_ENC_SETCONF_I_PERIOD MFC_ENC_SETCONF_HIER_P SSBSIP_MFC_ENC_CONF Set frame type by force Change frame rate during encoding Change bit rate during encoding Allow frame skip to guarantee max bit rate Set intra picture period to generate open GOP. Valid for H.264 encoder only Set using hierarchical prediction structure 6.2 SSBSIP_MFC_ERROR_CODE Error MFC_RET_OK 1 MFC_RET_FAIL MFC_RET_OPEN_FAIL MFC_RET_CLOSE_FAIL MFC_RET_DEC_INIT_FAIL MFC_RET_DEC_EXE_TIME_OUT MFC_RET_DEC_EXE_ERR MFC_RET_DEC_GET_INBUF_FAIL MFC_RET_DEC_SET_INBUF_FAIL MFC_RET_DEC_GET_OUTBUF_FAIL MFC_RET_DEC_GET_CONF_FAIL MFC_RET_DEC_SET_CONF_FAIL Error Code 6-2

34 6 INTRODUCTION Error MFC_RET_ENC_INIT_FAIL MFC_RET_ENC_EXE_TIME_OUT MFC_RET_ENC_EXE_ERR MFC_RET_ENC_GET_INBUF_FAIL MFC_RET_ENC_SET_INBUF_FAIL MFC_RET_ENC_GET_OUTBUF_FAIL MFC_RET_ENC_SET_OUTBUF_FAIL MFC_RET_ENC_GET_CONF_FAIL MFC_RET_ENC_SET_CONF_FAIL MFC_RET_STATE_INVALID MFC_RET_DEC_HEADER_FAIL MFC_RET_DEC_INIT_BUF_FAIL MFC_RET_ENC_HEADER_FAIL MFC_RET_ENC_PARAM_FAIL MFC_RET_FRM_BUF_SIZE_FAIL MFC_RET_FW_LOAD_FAIL MFC_RET_FW_INIT_FAIL MFC_RET_INST_NUM_EXCEEDED_FAIL MFC_RET_MEM_ALLOC_FAIL MFC_RET_MEM_INVALID_ADDR_FAIL MFC_RET_MEM_MAPPING_FAIL MFC_RET_GET_CONF_FAIL MFC_RET_SET_CONF_FAIL MFC_RET_INVALID_PARAM_FAIL MFC_RET_API_FAIL Error Code 6-3