tmbslhdmitx_app.c

HDMI NXP9983 chipset controller driver

/**
 * Copyright (C) 2006 Koninklijke Philips Electronics N.V., All Rights Reserved.
 * This source code and any compilation or derivative thereof is the proprietary
 * information of Koninklijke Philips Electronics N.V. and is confidential in
 * nature. Under no circumstances is this software to be  exposed to or placed
 * under an Open Source License of any type without the expressed written
 * permission of Koninklijke Philips Electronics N.V.
 *
 * \file          tmbslHdmiTx_app.c
 *
 * \version       $Revision: 65 $
 *
 * \date          $Date: 18/02/08 $
 *
 * \brief         Optional top-level application functions to simplify the
 *                use of the TDA998x HDMI Transmitter BSL driver component.
 *                This module corresponds to the DVP 'device' layer.
 *                This code can be used directly in user applications, with
 *                areas of customisation indicated by 'todo' comments.
 *
 * \section refs  Reference Documents
 * HDMI Driver - Outline Architecture.doc
 * HDMI Driver - tmbslHdmiTx - SCS.doc
 *
 * \section info  Change Information
 *
 * \verbatim
   $History: tmbslHdmiTx_app.c $
 *
 ******************  Version 65  ****************
 * User: G. Burnouf     Date: 18/02/08
 * Updated in $/Source/tmbslHdmiTx/src
 * PR1355 : Set audio channel allocation
 *
 ******************  Version 64  ****************
 * User: G. Burnouf     Date: 03/01/08
 * Updated in $/Source/tmbslHdmiTx/src
 * PR982 : replace memset by lAppMemset
 *
 * *****************  Version 63  ****************
 * User: B.Vereecke     Date: 29/10/07   Time: 14:11
 * Updated in $/Source/tmbslHdmiTx/src
 * PR833 : update appHdmiTx_setAudio error codes
 *
 * *****************  Version 62  ****************
 * User: B.Vereecke     Date: 17/10/07   Time: 14:11
 * Updated in $/Source/tmbslHdmiTx/src
 * PR872 : add new formats, 1080p24/25/30
 *
 * ****************  Version 61  ****************
 * User: B.Vereecke     Date: 10/10/07   Time: 11:11
 * Updated in $/Source/tmbslHdmiTx/src
 * PR815 : Update bluescreen infoframes
 *         According to the output mode
 *
 * * **************  Version 60  *****************
 * User: B.Vereecke   Date: 19/09/07   Time: 09:44
 * Updated in $/Source/tmbslHdmiTx/src
 * PR721   - Fix Bug in appHdmiTx_setInputOutput()
 *           when sink parameter is HDMITX_SINK_EDID
 *
 * * **************  Version 59  *****************
 * User: B.Vereecke   Date: 07/09/07   Time: 18:11
 * Updated in $/Source/tmbslHdmiTx/src
 * PR673   - Fix bad parameter error in Pc format
 *           in function setVideoInfoframe()
 *
 * * **************  Version 58  *****************
 * User: B.Vereecke   Date: 03/09/07   Time: 11:11
 * Updated in $/Source/tmbslHdmiTx/src
 * PR647   - Fix bad_parameter error in DVI mode
 *           Update in appHdmiTx_setInputOutput()
 *
 * * **************  Version 57  *****************
 * User: B.Vereecke   Date: 30/08/07   Time: 14:45
 * Updated in $/Source/tmbslHdmiTx/src
 * PR4   - add new appHdmiTx_ReadEdidAtPowerOn()
 *         function, calling result after resuming 
 *         from power_down is a EDID reading.
 *
 * * **************  Version 56  *****************
 * User: B.Vereecke   Date: 23/08/07   Time: 09:45
 * Updated in $/Source/tmbslHdmiTx/Inc
 * PR609 - in appHdmiTx_handleSHA_1() for TDA9981 
 *         only:Fix problem in repeater mode with 
 *         devcount=0
 *
 * * **************  Version 55  *****************
 * User: B.Vereecke   Date: 23/07/07   Time: 13:18
 * Updated in $/Source/tmbslHdmiTx/Inc
 * PR502 - Add new appHdmiTx_setAudio() function
 *         for change Audio parameters without update
 *         video input/output
 *
 *****************  Version 54  ******************
 * User: B.Vereecke   Date: 19/07/07   Time: 10:30
 * Updated in $/Source/tmbslHdmiTx/Inc
 * PR511 - add new PixelEdge argument in 
 *          appHdmiTx_setInputOutput
 *
 *****************  Version 53  ******************
 * User: B.Vereecke   Date: 17/07/07   Time: 10:30
 * Updated in $/Source/tmbslHdmiTx/Inc
 * PR217 - Add Pattern type parameter to
 *         appHdmiTx_test_pattern_on API in order
 *         to add blue pattern functionality
 *
 *****************  Version 52  ******************
 * User: J. Lamotte   Date: 29/06/07   Time: 15:50
 * Updated in $/Source/tmbslHdmiTx/Inc
 * PR210 - Add video output format parameter to
 *         appHdmiTx_test_pattern_on API in order
 *         to update AVI info frame for color bar.
 *
 *****************  Version 51  ******************
 * User: J. Lamotte   Date: 27/06/07   Time: 11:23
 * Updated in $/Source/tmbslHdmiTx/Inc
 * PR456 - For TDA9981 only, change the serializer
 *         register configuration, srl_phase3 = 8
 *         and srl_phase2 = 4.
 *         (tmbslHdmiTxTmdsSetSerializer parameter)
 *
 *****************  Version 50  ******************
 * User: J. Lamotte   Date: 26/06/07   Time: 11:21
 * Updated in $/Source/tmbslHdmiTx/Inc
 * PR457 - In appHdmiTx_handleSHA_1 function,
 *         check bksv list for top level only 
 *
 *****************  Version 49  ******************
 * User: J. Lamotte   Date: 22/06/07   Time: 16:00
 * Updated in $/Source/tmbslHdmiTx/Inc
 * PR448 : Make the initialisation of shortVinFmt and
 *         shortVoutFmt in getReflineRefPix function
 *         only for TV format to prevent buffer overflow
 * PR385 : Execute tmbslHdmiTxHdcpHandleBKSVResult
 *         even if bCheckRequired is false to
 *         continue HDCP authentification for 
 *        repeater in appHdmiTx_handleBCAPS
 *
 *****************  Version 48  ******************
 * User: burnouf      Date: 08/06/07   Time: 17:03
 * Updated in $/Source/tmbslHdmiTx/Inc
 * PR347 - add new PC Formats
 *
 ******************  Version 47  ******************
 * User: J. Lamotte      Date: 08/06/07   Time: 09:30
 * Updated in $/Source/tmbslHdmiTx/src
 * PR377 - Reset fifo applied before audio configuration
 *
 *******************  Version 46  *****************
 * User: J. Lamotte      Date: 16/04/07   Time: 11:30
 * Updated in $/Source/tmbslHdmiTx/src
 * PR50 - add configuration file for TDA9981
 *      - add support of TDA9981 in appHdmiTx_setInputOutput 
 *
 *******************  Version 45  *****************
 * User: C. Logiou      Date: 08/03/07   Time: 16:52
 * Updated in $/Source/tmbslHdmiTx/src
 * PR214 - add new input format repeated 480i/576i 
 *
 * *****************  Version 44  *****************
 * User: burnouf      Date: 06/02/07   Time: 17:03
 * Updated in $/Source/tmbslHdmiTx/Inc
 * PR49 - add PC Formats
 *
 * *****************  Version 43  *****************
 * User: Burnouf      Date: 14/12/06   Time: 09:54
 * Updated in $/Source/tmbslHdmiTx/Src
 * PR48 Update value Refpix and Refline
 * 
 * *****************  Version 42  *****************
 * User: Burnouf      Date: 07/12/06   Time: 16:30
 * Updated in $/Source/tmbslHdmiTx/Src
 * PR46 Change error number
 * 
 * *****************  Version 41  *****************
 * User: Burnouf      Date: 07/12/06   Time: 11:17
 * Updated in $/Source/tmbslHdmiTx/Src
 * PR46 set serial phase
 *
 * *****************  Version 40  *****************
 * User: Mayhew       Date: 23/11/06   Time: 15:07
 * Updated in $/Source/tmbslHdmiTx/Src
 * PNF77 Wait 500ms before reading EDID when hotplug=on, to allow DDC
 * connection to settle and avoid EDID checksum errors
 *
 * *****************  Version 38  *****************
 * User: Djw          Date: 10/11/06   Time: 14:00
 * Updated in $/Source/tmbslHdmiTx/Src
 * PNF69 Add call to tmbslHdmiTxAudioOutSetChanStatus in
 * appHdmiTx_setInputOutput.
 * 
 * *****************  Version 37  *****************
 * User: Mayhew       Date: 10/11/06   Time: 10:12
 * Updated in $/Source/tmbslHdmiTx/Src
 * PNF68 HDCP check parameters HDCP_CHECK_INTERVAL_MS and HDCP_NUM_CHECKS
 * added and passed to tmbslHdmiTxHdcpConfigure
 * 
 * *****************  Version 35  *****************
 * User: Mayhew       Date: 31/10/06   Time: 16:23
 * Updated in $/Source/tmbslHdmiTx/Src
 * PNF65 setVideoInfoframe ignores OPERATION_NOT_PERMITTED, to work in DVI
 * mode
 * PNF66 New kRefpixRefline values for CCIR656+EMB
 * 
 * *****************  Version 33  *****************
 * User: Mayhew       Date: 27/10/06   Time: 12:31
 * Updated in $/Source/tmbslHdmiTx/Src
 * PNF59 Test pattern APi split into _on and _off APIs
 * PNF59 appHdmiTx_handleBCAPS has new pbBksvSecure parameter
 * Comments added to highlight user customisation
 * appHdmiTx_Hdcp_On no longer resets EdidVFmtsAvail
 * 
 * *****************  Version 31  *****************
 * User: Djw          Date: 25/10/06   Time: 13:36
 * Updated in $/Source/tmbslHdmiTx/Src
 * PNF58 Added vinMode to call to tmbslHdmiTxVideoInSetSyncAuto
 * 
 * *****************  Version 29  *****************
 * User: Djw          Date: 25/10/06   Time: 11:52
 * Updated in $/Source/tmbslHdmiTx/Src
 * PNF57 Change the handleBCAPS timer from 100ms to 10ms
 * 
 * *****************  Version 27  *****************
 * User: Djw          Date: 24/10/06   Time: 17:53
 * Updated in $/Source/tmbslHdmiTx/Src
 * PNF2 (part) New RefPix table values for scaled 480p/576p
 * 
 * *****************  Version 25  *****************
 * User: Mayhew       Date: 23/10/06   Time: 16:41
 * Updated in $/Source/tmbslHdmiTx/Src
 * PNF37 Refpix table size reduced to save code space
 * PNF53 Output field order corrected for p->i conversion
 * 
 * *****************  Version 23  *****************
 * User: Mayhew       Date: 13/10/06   Time: 11:17
 * Updated in $/Source/tmbslHdmiTx/Src
 * PNF37 Pass syncSource not syncIn. Comment out non-scaler RefPix table
 * combinations. Use uRefPix = 0 to do new VideoInSetSyncAuto algorithm.
 * PNF43 Scaler field order for 1080i
 * PNF47 Audio latency
 * 
 * *****************  Version 21  *****************
 * User: Mayhew       Date: 21/09/06   Time: 15:45
 * Updated in $/Source/tmbslHdmiTx/Src
 * PNF35 Only set channel count in audio info frame
 * PNF36 576p->1080i,DE,EMB,CCIR656 now verified
 * 
 * *****************  Version 19  *****************
 * User: Mayhew       Date: 15/09/06   Time: 16:07
 * Updated in $/Source/tmbslHdmiTx/Src
 * PNF19 Add i2sQualifier arg to setInputOutput, set AIF
 * PNF25 Add pEdidVidFlags arg to handleHPD
 * Fix Raisonance and QAC warnings
 * 
 * *****************  Version 17  *****************
 * User: Mayhew       Date: 7/09/06    Time: 9:43
 * Updated in $/Source/tmbslHdmiTx/Src
 * New refpix table
 * 
 * *****************  Version 15  *****************
 * User: Djw          Date: 24/08/06   Time: 12:07
 * Updated in $/Source/tmbslHdmiTx/Src
 * Add new refpix/refline values.
 * PNF13 TdmsSetOutputs uses FORCED0 not FORCED1.
 * PNF14 Set correct pixel repetition.
 * PNF16 Set correct cts values for I2S.
 * 
 * *****************  Version 14  *****************