/* ****************************************************************** */
/*                        I43_SetAFMode                               */
/* ****************************************************************** */
/* Input Parameters:                                                  */
/*  bMode   - The new mode of the AF edge accumulation:               */
/*            I43CAF_SET_MODE_ULC  - uLC edge accumulation.           */
/*            I43CAF_SET_MODE_LC   - LC  edge accumulation.           */
/*            I43CAF_SET_MODE_HLPF - HPF-LPF edge accumulation.       */
/*  wParam1 - The minimal horizontal edge mask in uLC and LC mode.    */
/*            The minimal horizontal edge threshold in HPF-LPF mode.  */
/*  wParam2 - The minimal vertical edge mask in uLC and LC mode.      */
/*            The minimal vertical edge threshold in HPF-LPF mode.    */
/* Return Value:                                                      */
/*  Success - I43ERR_OK.                                              */
/*  Fail    - I43 error code according to the specific error.         */
/* ****************************************************************** */
/* This function defines the mode of operation of the auto focus edge */
/* accumulation algorithm.                                            */
/* ****************************************************************** */
/* I43 host commands in use:                                          */
/*  ConfigAF                                                          */
/* ****************************************************************** */
I43_ERROR_CODE I43_SetAFMode( I43_CONFIG_AF bMode,
                              I43_UINT16    wParam1,
                              I43_UINT16    wParam2
                            ) ;



/* ****************************************************************** */
/*                           I43_GetAFValues                          */
/* ****************************************************************** */
/* Input Parameters:                                                  */
/*  pwG_HEDGEHigh - Pointer were to write the returned G_HEDGE value  */
/*                  (MS word).                                        */
/*  pwG_HEDGELow  - Pointer were to write the returned G_HEDGE value  */
/*                  (LS word).                                        */
/*  pwG_VEDGEHigh - Pointer were to write the returned G_VEDGE value  */
/*                  (MS word).                                        */
/*  pwG_VEDGELow  - Pointer were to write the returned G_HEDGE value  */
/*                  (LS word).                                        */
/* Return Value:                                                      */
/*  Success - I43ERR_OK.                                              */
/*  Fail    - I43 error code according to the specific error.         */
/* ****************************************************************** */
/* This function returns the results of the edge accumulation from    */
/* the previous frame.                                                */
/* ****************************************************************** */
/* I43 host commands in use:                                          */
/*  GetAFValue                                                        */
/* ****************************************************************** */
I43_ERROR_CODE I43_GetAFValues( I43_UINT16* pwG_HEDGEHigh,
                                I43_UINT16* pwG_HEDGELow,
                                I43_UINT16* pwG_VEDGEHigh,
                                I43_UINT16* pwG_VEDGELow
                              ) ;









/* ****************************************************************** */
/*                           I43_DebugOtr                             */
/* ****************************************************************** */
/* Input Parameters:                                                  */
/*  bOpCode - The Otr opcode.                                         */
/*  wWord1  - parameter word 1.                                       */
/*  wWord2  - parameter word 2.                                       */
/*  wWord3  - parameter word 3.                                       */
/*  wWord4  - parameter word 4.                                       */
/* Return Value:                                                      */
/*  Success - I43ERR_OK.                                              */
/*  Fail    - I43 error code according to the specific error.         */
/* ****************************************************************** */
/* This function is for debug purposes only and should be removed     */
/* in later versions from the API.                                    */
/* ****************************************************************** */
/* I43 host commands in use:                                          */
/*  DebugOtr1 / DebugOtr2 / DebugOtr3 / DebugOtr4                     */
/* ****************************************************************** */
I43_ERROR_CODE I43_DebugOtr( I43_HOST_COMMAND   bOpCode,
                             I43_UINT16         wWord1,
                             I43_UINT16         wWord2,
                             I43_UINT16         wWord3,
                             I43_UINT16         wWord4
                           ) ;

/* ****************************************************************** */
/*                             I43_SetParam                           */
/* ****************************************************************** */
/* Input Parameters:                                                  */
/*  wParamID - The identifier of the COACH parameter to be set.       */
/*  wValue   - The value to be set to the specific COACH parameter.   */
/* Return Value:                                                      */
/*  Success - I43ERR_OK.                                              */
/*  Fail    - I43 error code according to the specific error.         */
/* ****************************************************************** */
/* This function allows the host to set a specific value to some      */
/* COACH parameters.                                                  */
/* ****************************************************************** */
/* I43 host commands in use:                                          */
/*  SetParam                                                          */
/* ****************************************************************** */
I43_ERROR_CODE I43_SetParam( I43_UINT16 wParamID,
                             I43_UINT16 wValue
                           );


/* ****************************************************************** */
/*                            I43_QueryStatus                         */
/* ****************************************************************** */
/* Input Parameters:                                                  */
/*  pwUSR1 - Pointer where to write the value of USR1.                */
/*  pwUSR2 - Pointer where to write the value of USR2.                */
/* Return Value:                                                      */
/*  Success - I43ERR_OK.                                              */
/*  Fail    - I43 error code according to the specific error.         */
/* ****************************************************************** */
/* This function lets the USB host read the USR1 and USR2 values.     */
/* When the I43's host is the USB host (and not a microcontroller),   */
/* the I43's DSP maintain in addition to the registers that           */
/* it maintains with a microcontroller host two shadow registers      */
/* in memory, USR1 and USR2, that represent SR1 and SR2, respectively.*/
/* When a USB host starts communication with the I43,                 */
/* the I43 updates those memory copies of SR1 and SR2, and from       */
/* that moment, as long the host USB "exists" it maintains them       */
/* as well as SR1 and SR2 of the microcontroller interface.           */
/* In response to the QueryStatus command the I43 sends these two     */
/* variables to the USB host, and clears USR2 LS byte. This is the    */
/* "USB equivalent" of a microcontroller read access to SR1 and SR2.  */
/* ****************************************************************** */
/* I43 host commands in use:                                          */
/*  QueryStatus                                                       */
/* ****************************************************************** */
I43_ERROR_CODE I43_QueryStatus( I43_UINT16* pwUSR1,
                                I43_UINT16* pwUSR2
                              );

/* ****************************************************************** */
/*                           I43_SetAEMode                            */
/* ****************************************************************** */
/* Input Parameters:                                                  */
/*  bMode - The COACH AE firmware mode of operation.                  */
/*   I43AE_MASTER = COACH is AE Master.                               */
/*   I43AE_ECC    = COACH is ECC (Exposure Calculator and Controller).*/
/*   I43AE_ECONLY = COACH is EC (Exposure Calculator).                */
/* Return Value:                                                      */
/*  Success - I43ERR_OK.                                              */
/*  Fail    - I43 error code according to the specific error.         */
/* ****************************************************************** */
/* This function sets the mode of operation of the Auto Exposure      */
/* firmware of the COACH.                                             */
/* ****************************************************************** */
/* I43 host commands in use:                                          */
/*  SetAEMode                                                         */
/* ****************************************************************** */
I43_ERROR_CODE I43_SetAEMode( I43_AE_MODE bMode
                            );

/* ****************************************************************** */
/*                           I43_SetAgcMode                           */
/* ****************************************************************** */
/* Input Parameters:                                                  */
/*  bMode - The COACH AGC firmware mode of operation.                 */
/*   I43AE_AUTO    = COACH updates the AGC automatically.             */
/*   I43AE_MANUAL  = AGC is done manually by host commands            */
/*   I43AE_OFF     = No AGC control.                                  */
/* Return Value:                                                      */
/*  Success - I43ERR_OK.                                              */
/*  Fail    - I43 error code according to the specific error.         */
/* ****************************************************************** */
/* This function sets the mode of operation of the AGC control by the */
/* firmware of the COACH.                                             */
/* ****************************************************************** */
/* I43 host commands in use:                                          */
/*  SetAgcMode                                                        */
/* ****************************************************************** */
I43_ERROR_CODE I43_SetAgcMode( I43_AGC_MODE bMode
                            );

/* ****************************************************************** */
/*                             I43_GetParam                           */
/* ****************************************************************** */
/* Input Parameters:                                                  */
/*  wParamID - The identifier of the COACH parameter to be set.       */
/*  pwValue  - Pointer where to write the value read from the COACH   */
/*             for the specific parameter.                            */
/* Return Value:                                                      */
/*  Success - I43ERR_OK.                                              */
/*  Fail    - I43 error code according to the specific error.         */
/* ****************************************************************** */
/* This function allows the host to get the value of a specific       */
/* COACH parameter.                                                   */
/* ****************************************************************** */
/* I43 host commands in use:                                          */
/*  GetParam                                                          */
/* ****************************************************************** */
I43_ERROR_CODE I43_GetParam( I43_UINT16 wParamID,
                             I43_UINT16 *pwValue