source: svn/newcon3bcm2_21bu/nexus/modules/audio/7552/src/nexus_audyssey_adv.c

/***************************************************************************
*     (c)2004-2011 Broadcom Corporation
*  
*  This program is the proprietary software of Broadcom Corporation and/or its licensors,
*  and may only be used, duplicated, modified or distributed pursuant to the terms and
*  conditions of a separate, written license agreement executed between you and Broadcom
*  (an "Authorized License").  Except as set forth in an Authorized License, Broadcom grants
*  no license (express or implied), right to use, or waiver of any kind with respect to the
*  Software, and Broadcom expressly reserves all rights in and to the Software and all
*  intellectual property rights therein.  IF YOU HAVE NO AUTHORIZED LICENSE, THEN YOU
*  HAVE NO RIGHT TO USE THIS SOFTWARE IN ANY WAY, AND SHOULD IMMEDIATELY
*  NOTIFY BROADCOM AND DISCONTINUE ALL USE OF THE SOFTWARE.  
*   
*  Except as expressly set forth in the Authorized License,
*   
*  1.     This program, including its structure, sequence and organization, constitutes the valuable trade
*  secrets of Broadcom, and you shall use all reasonable efforts to protect the confidentiality thereof,
*  and to use this information only in connection with your use of Broadcom integrated circuit products.
*   
*  2.     TO THE MAXIMUM EXTENT PERMITTED BY LAW, THE SOFTWARE IS PROVIDED "AS IS" 
*  AND WITH ALL FAULTS AND BROADCOM MAKES NO PROMISES, REPRESENTATIONS OR 
*  WARRANTIES, EITHER EXPRESS, IMPLIED, STATUTORY, OR OTHERWISE, WITH RESPECT TO 
*  THE SOFTWARE.  BROADCOM SPECIFICALLY DISCLAIMS ANY AND ALL IMPLIED WARRANTIES 
*  OF TITLE, MERCHANTABILITY, NONINFRINGEMENT, FITNESS FOR A PARTICULAR PURPOSE, 
*  LACK OF VIRUSES, ACCURACY OR COMPLETENESS, QUIET ENJOYMENT, QUIET POSSESSION 
*  OR CORRESPONDENCE TO DESCRIPTION. YOU ASSUME THE ENTIRE RISK ARISING OUT OF 
*  USE OR PERFORMANCE OF THE SOFTWARE.
*  
*  3.     TO THE MAXIMUM EXTENT PERMITTED BY LAW, IN NO EVENT SHALL BROADCOM OR ITS 
*  LICENSORS BE LIABLE FOR (i) CONSEQUENTIAL, INCIDENTAL, SPECIAL, INDIRECT, OR 
*  EXEMPLARY DAMAGES WHATSOEVER ARISING OUT OF OR IN ANY WAY RELATING TO YOUR 
*  USE OF OR INABILITY TO USE THE SOFTWARE EVEN IF BROADCOM HAS BEEN ADVISED OF 
*  THE POSSIBILITY OF SUCH DAMAGES; OR (ii) ANY AMOUNT IN EXCESS OF THE AMOUNT 
*  ACTUALLY PAID FOR THE SOFTWARE ITSELF OR U.S. $1, WHICHEVER IS GREATER. THESE 
*  LIMITATIONS SHALL APPLY NOTWITHSTANDING ANY FAILURE OF ESSENTIAL PURPOSE OF 
*  ANY LIMITED REMEDY.
* 
* $brcm_Workfile: nexus_audyssey_adv.c $
* $brcm_Revision: 3 $
* $brcm_Date: 8/8/11 5:38p $
*
* API Description:
*   API name: AutoVolumeLevel
*    Specific APIs related to Broadcom AutoVolumeLevel (AVL) Audio Processing
*
* Revision History:
*
* $brcm_Log: /nexus/modules/audio/7422/src/nexus_audyssey_adv.c $
* 
* 3   8/8/11 5:38p jgarrett
* SWDTV-6761: Adding StudioSound
* 
* 2   5/25/11 5:16p jgarrett
* SW7425-408: Adding BDBG_OBJECT to input/output types and MS11 features
* 
* 1   5/16/11 5:19p jgarrett
* SWDTV-6762: Adding Audyssey ADV/ABX
* 
***************************************************************************/

#include "nexus_audio_module.h"

BDBG_MODULE(nexus_audyssey_adv);

BDBG_OBJECT_ID(NEXUS_AudysseyAdv);
typedef struct NEXUS_AudysseyAdv
{
    BDBG_OBJECT(NEXUS_AudysseyAdv)
    NEXUS_AudioInputObject connector;
    NEXUS_AudysseyAdvSettings settings;
    NEXUS_AudioInput input;
    BAPE_AudysseyAdvHandle apeHandle;
} NEXUS_AudysseyAdv;

void NEXUS_AudysseyAdv_GetDefaultSettings(
    NEXUS_AudysseyAdvSettings *pSettings   /* [out] default settings */
    )
{
    BAPE_AudysseyAdvSettings piSettings;
    unsigned i;

    BDBG_ASSERT(NULL != pSettings);
    BAPE_AudysseyAdv_GetDefaultSettings(&piSettings);

    pSettings->enabled = piSettings.enabled;
    pSettings->channelMask = piSettings.channelMask;
    pSettings->reInitialize = piSettings.reInitialize;
    pSettings->volumeScalingEnabled = piSettings.volumeScalingEnabled;
    pSettings->dynamicSurroundGainEnabled = piSettings.dynamicSurroundGainEnabled;
    pSettings->hiLoCompress = piSettings.hiLoCompress;
    BDBG_CASSERT((int)NEXUS_AudysseyAdvDynamicEqMode_eMax == (int)BAPE_AudysseyAdvDynamicEqMode_eMax);
    pSettings->dynamicEqMode = piSettings.dynamicEqMode;
    pSettings->volume = piSettings.volume;
    pSettings->gainCompression = piSettings.gainCompression;
    pSettings->headroomOffset = piSettings.headroomOffset;
    for ( i = 0; i < 8; i++ )
    {
        pSettings->chCalbGain[i] = piSettings.chCalbGain[i];
    }
}

NEXUS_AudysseyAdvHandle NEXUS_AudysseyAdv_Open(
    const NEXUS_AudysseyAdvSettings *pSettings     /* Pass NULL for default settings */
    )
{
    NEXUS_AudysseyAdvHandle handle;
    BAPE_AudysseyAdvSettings defaults;
    BAPE_Connector connector;
    BERR_Code errCode;
    handle = BKNI_Malloc(sizeof(NEXUS_AudysseyAdv));
    if ( NULL == handle )
    {
        (void)BERR_TRACE(BERR_OUT_OF_SYSTEM_MEMORY);
        return NULL;
    }
    BKNI_Memset(handle, 0, sizeof(NEXUS_AudysseyAdv));
    BDBG_OBJECT_SET(handle, NEXUS_AudysseyAdv);
    NEXUS_AUDIO_INPUT_INIT(&handle->connector, NEXUS_AudioInputType_eAudysseyAdv, handle);
    handle->connector.format = NEXUS_AudioInputFormat_eNone; /* Determined by inputs */
    BAPE_AudysseyAdv_GetDefaultSettings(&defaults);
    errCode = BAPE_AudysseyAdv_Create(NEXUS_AUDIO_DEVICE_HANDLE, &defaults, &handle->apeHandle);
    if ( errCode )
    {
        (void)BERR_TRACE(errCode);
        BDBG_OBJECT_DESTROY(handle, NEXUS_AudysseyAdv);
        BKNI_Free(handle);
        return NULL;
    }
    handle->connector.format = NEXUS_AudioInputFormat_ePcmStereo;
    BAPE_AudysseyAdv_GetConnector(handle->apeHandle, &connector);
    handle->connector.port = (uint32_t)connector;
    if ( NULL == pSettings )
    {
        NEXUS_AudysseyAdv_GetDefaultSettings(&handle->settings);
    }
    else
    {
        (void)NEXUS_AudysseyAdv_SetSettings(handle, pSettings);
    }

    return handle;
}

void NEXUS_AudysseyAdv_Close(
    NEXUS_AudysseyAdvHandle handle
    )
{
    BDBG_OBJECT_ASSERT(handle, NEXUS_AudysseyAdv);
    NEXUS_AudioInput_Shutdown(&handle->connector);
    BAPE_AudysseyAdv_Destroy(handle->apeHandle);
    BDBG_OBJECT_DESTROY(handle, NEXUS_AudysseyAdv);
    BKNI_Free(handle);
}


void NEXUS_AudysseyAdv_GetSettings(
    NEXUS_AudysseyAdvHandle handle,
    NEXUS_AudysseyAdvSettings *pSettings    /* [out] Settings */
    )
{
    BDBG_OBJECT_ASSERT(handle, NEXUS_AudysseyAdv);
    BDBG_ASSERT(NULL != pSettings);
    
    BKNI_Memcpy(pSettings, &handle->settings, sizeof(NEXUS_AudysseyAdvSettings));
}

NEXUS_Error NEXUS_AudysseyAdv_SetSettings(
    NEXUS_AudysseyAdvHandle handle,
    const NEXUS_AudysseyAdvSettings *pSettings
    )
{
    BERR_Code errCode;
    BAPE_AudysseyAdvSettings piSettings;
    unsigned i;
    
    BDBG_OBJECT_ASSERT(handle, NEXUS_AudysseyAdv);
    BDBG_ASSERT(NULL != pSettings);

    BAPE_AudysseyAdv_GetSettings(handle->apeHandle, &piSettings);
    
    piSettings.enabled = pSettings->enabled;
    piSettings.channelMask = pSettings->channelMask;
    piSettings.reInitialize = pSettings->reInitialize;
    piSettings.volumeScalingEnabled = pSettings->volumeScalingEnabled;
    piSettings.dynamicSurroundGainEnabled = pSettings->dynamicSurroundGainEnabled;
    piSettings.hiLoCompress = pSettings->hiLoCompress;
    piSettings.dynamicEqMode = pSettings->dynamicEqMode;
    piSettings.volume = pSettings->volume;
    piSettings.gainCompression = pSettings->gainCompression;
    piSettings.headroomOffset = pSettings->headroomOffset;
    for ( i = 0; i < 8; i++ )
    {
        piSettings.chCalbGain[i] = pSettings->chCalbGain[i];
    }

    errCode = BAPE_AudysseyAdv_SetSettings(handle->apeHandle, &piSettings);
    if ( errCode )
    {
        return BERR_TRACE(errCode);
    }
    BKNI_Memcpy(&handle->settings, pSettings, sizeof(NEXUS_AudysseyAdvSettings));
    return BERR_SUCCESS;
}

NEXUS_Error NEXUS_AudysseyAdv_GetStatus(
    NEXUS_AudysseyAdvHandle handle,
    NEXUS_AudysseyAdvStatus *pStatus   /* [out] current status */
    )
{
    BAPE_AudysseyAdvStatus piStatus;
    BERR_Code errCode;
    unsigned i;

    BDBG_OBJECT_ASSERT(handle, NEXUS_AudysseyAdv);
    BDBG_ASSERT(NULL != pStatus);

    errCode = BAPE_AudysseyAdv_GetStatus(handle->apeHandle, &piStatus);
    if ( errCode )
    {
        return BERR_TRACE(errCode);
    }

    pStatus->volumeApplied = piStatus.volumeApplied;
    for ( i = 0; i < 8; i++ )
    {
        pStatus->chCalcLevel[i] = piStatus.chCalcLevel[i];
    }
    pStatus->numChannels = piStatus.numChannels;
    pStatus->dynamicEqMode = (NEXUS_AudysseyAdvDynamicEqMode)piStatus.dynamicEqMode;

    return BERR_SUCCESS;
}

NEXUS_AudioInput NEXUS_AudysseyAdv_GetConnector(
    NEXUS_AudysseyAdvHandle handle
    )
{
    BDBG_OBJECT_ASSERT(handle, NEXUS_AudysseyAdv);
    return &handle->connector;
}

NEXUS_Error NEXUS_AudysseyAdv_AddInput(
    NEXUS_AudysseyAdvHandle handle,
    NEXUS_AudioInput input
    )
{
    NEXUS_Error errCode;
    BDBG_OBJECT_ASSERT(handle, NEXUS_AudysseyAdv);
    BDBG_ASSERT(NULL != input);
    if ( NULL != handle->input )
    {
        BDBG_ERR(("Only one input can be added"));
        return BERR_TRACE(BERR_NOT_SUPPORTED);
    }
    errCode = BAPE_AudysseyAdv_AddInput(handle->apeHandle, (BAPE_Connector)input->port);
    if ( errCode )
    {
        return BERR_TRACE(errCode);
    }
    errCode = NEXUS_AudioInput_P_AddInput(&handle->connector, input);
    if ( errCode )
    {
        (void)BAPE_AudysseyAdv_RemoveInput(handle->apeHandle, (BAPE_Connector)input->port);
        return BERR_TRACE(errCode);
    }
    handle->input = input;
    return BERR_SUCCESS;
}

NEXUS_Error NEXUS_AudysseyAdv_RemoveInput(
    NEXUS_AudysseyAdvHandle handle,
    NEXUS_AudioInput input
    )
{
    NEXUS_Error errCode;
    BDBG_OBJECT_ASSERT(handle, NEXUS_AudysseyAdv);
    BDBG_ASSERT(NULL != handle->input);
    if ( input != handle->input )
    {
        BDBG_ERR(("Input not connected"));
        return BERR_TRACE(BERR_NOT_SUPPORTED);
    }
    errCode = BAPE_AudysseyAdv_RemoveInput(handle->apeHandle, (BAPE_Connector)input->port);
    if ( errCode )
    {
        return BERR_TRACE(errCode);
    }
    errCode = NEXUS_AudioInput_P_RemoveInput(&handle->connector, input);
    if ( errCode )
    {
        return BERR_TRACE(errCode);
    }
    handle->input = NULL;
    return BERR_SUCCESS;
}

NEXUS_Error NEXUS_AudysseyAdv_RemoveAllInputs(
    NEXUS_AudysseyAdvHandle handle
    )
{
    BDBG_OBJECT_ASSERT(handle, NEXUS_AudysseyAdv);
    if ( handle->input )
    {
        return NEXUS_AudysseyAdv_RemoveInput(handle, handle->input);
    }
    return BERR_SUCCESS;
}