/*

  audio_hwctrl_chipset_api.h

  Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). 

  All rights reserved.

  This program and the accompanying materials are made available 

  under the terms of the Eclipse Public License v1.0 which accompanies 

  this distribution, and is available at 

  http://www.eclipse.org/legal/epl-v10.html

  Initial Contributors:

  Nokia Corporation - initial contribution.

  Contributors:

*/

#ifndef AUDIO_HWCTRL_CHIPSET_API_H

#define AUDIO_HWCTRL_CHIPSET_API_H

#ifdef __cplusplus

extern "C" {

#endif /* __cplusplus */

/* Each OMX header must include all required header files to allow the

 * header to compile without errors.  The includes below are required

 * for this header file to compile successfully 

 */

#include <OMX_Audio.h>

/** Audio power control.

*/

typedef struct OMX_AUDIO_CONFIG_POWERTYPE  { 

    OMX_U32 nSize;                                    

    OMX_VERSIONTYPE nVersion;                   

    OMX_U32 nPortIndex;            

    OMX_U32 nChannel;

    OMX_BOOL bPower;

} OMX_AUDIO_CONFIG_POWERTYPE;

/** Audio volume ramp control.

*/

typedef struct OMX_AUDIO_CONFIG_VOLUMERAMPTYPE  { 

    OMX_U32 nSize;                                    

    OMX_VERSIONTYPE nVersion;                   

    OMX_U32 nPortIndex;            

    OMX_U32 nChannel;

    OMX_BOOL bLinear;

    OMX_BS32 sStartVolume;

    OMX_BS32 sEndVolume;

    OMX_TICKS nRampDuration;

    OMX_BOOL bRampTerminate;

    OMX_BS32 sCurrentVolume;

    OMX_TICKS nRampCurrentTime;

    OMX_TICKS nRampMinDuration;

    OMX_TICKS nRampMaxDuration;

    OMX_U32 nVolumeStep;

} OMX_AUDIO_CONFIG_VOLUMERAMPTYPE;

/** Settings burst control.

*/

typedef struct OMX_AUDIO_CONFIG_BURSTCONTROLTYPE  { 

    OMX_U32 nSize;                                    

    OMX_VERSIONTYPE nVersion;                   

    OMX_U32 nPortIndex;            

    OMX_BOOL bBurstControl;

    OMX_BOOL bStatus;

} OMX_AUDIO_CONFIG_BURSTCONTROLTYPE;

/** Audio register bank query.

*/

typedef struct OMX_AUDIO_CONFIG_REGISTERBANKQUERYTYPE  { 

    OMX_U32 nSize;                                    

    OMX_VERSIONTYPE nVersion;                   

    OMX_U32 nPortIndex;   

    OMX_U16 nNumRegisterBanks;           

} OMX_AUDIO_CONFIG_REGISTERBANKQUERYTYPE;

typedef enum OMX_AUDIO_HWREGISTERTYPE { 

    OMX_AUDIO_IO = 0,

    OMX_AUDIO_I2C,

    OMX_AUDIO_SLIMBUS,

    OMX_AUDIO_CBUS = 0xFFFF     

} OMX_AUDIO_HWREGISTERTYPE;

typedef struct OMX_AUDIO_REGBANKDESCRIPTORTYPE { 

    OMX_U32 nSize;                                    

    OMX_VERSIONTYPE nVersion;                   

    OMX_U32 nRegBankIndex;   

    OMX_U32 nLogicalStartAddr;

    OMX_U32 nLogicalEndAddr;

    OMX_AUDIO_HWREGISTERTYPE eRegBankType;

} OMX_AUDIO_REGBANKDESCRIPTORTYPE;

/** Audio register bank table control.

*/

typedef struct OMX_AUDIO_CONFIG_REGISTERBANKTABLETYPE  { 

    OMX_U32 nSize;                                    

    OMX_VERSIONTYPE nVersion;                   

    OMX_U32 nPortIndex;   

    OMX_U16 nNumRegisterBanks; 

    OMX_AUDIO_REGBANKDESCRIPTORTYPE RegBankDescriptorTable;     

} OMX_AUDIO_CONFIG_REGISTERBANKTABLETYPE;

typedef enum OMX_AUDIO_HWCTRL_STATUSTYPE { 

    OMX_AUDIO_OK = 0,

    OMX_AUDIO_FAIL,

    /* if callback facility is somehow solved in OpenMAX IL for getconfig/setconfig parameter calls, it is expected */

    /* to have here extra status information that can be returned for e.g. multi-read/write commands */

    OMX_AUDIO_NOT_SUPPORTED = 0xFFFF     

} OMX_AUDIO_HWCTRL_STATUSTYPE;

typedef enum OMX_AUDIO_HWOPERATIONTYPE { 

     OMX_AUDIO_NOOP = 0,

     OMX_AUDIO_8BIT_SINGLE_READ,

     OMX_AUDIO_8BIT_SINGLE_WRITE,

     OMX_AUDIO_16BIT_SINGLE_READ,

     OMX_AUDIO_16BIT_SINGLE_WRITE,

     OMX_AUDIO_32BIT_SINGLE_READ,

     OMX_AUDIO_32BIT_SINGLE_WRITE,

     OMX_AUDIO_8BIT_MULTI_READ,

     OMX_AUDIO_8BIT_MULTI_WRITE,

     OMX_AUDIO_16BIT_MULTI_READ,

     OMX_AUDIO_16BIT_MULTI_WRITE,

     OMX_AUDIO_32BIT_MULTI_READ,

     OMX_AUDIO_32BIT_MULTI_WRITE,

     OMX_AUDIO_8BIT_BURST_MULTI_READ,

     OMX_AUDIO_8BIT_BURST_MULTI_WRITE,

     OMX_AUDIO_16BIT_BURST_MULTI_READ,

     OMX_AUDIO_16BIT_BURST_MULTI_WRITE,

     OMX_AUDIO_32BIT_BURST_MULTI_READ,

     OMX_AUDIO_32BIT_BURST_MULTI_WRITE = 0xFFFF     

} OMX_AUDIO_HWOPERATIONTYPE;

/** Custom audio HW control.

*/

typedef struct OMX_AUDIO_CONFIG_CUSTOMHWCONTROLTYPE  { 

    OMX_U32 nSize;                                    

    OMX_VERSIONTYPE nVersion;                   

    OMX_U32 nPortIndex;   

    OMX_AUDIO_HWCTRL_STATUSTYPE eStatus;

    OMX_AUDIO_HWOPERATIONTYPE eHwOperation;

    OMX_AUDIO_HWREGISTERTYPE eRegisterType;

    OMX_U16 nDataCount;

    OMX_U8 nAddressDataSequence[];      

} OMX_AUDIO_CONFIG_CUSTOMHWCONTROLTYPE;

typedef enum OMX_AUDIO_HWLOOPSTYPE { 

    OMX_AUDIO_NOLOOP = 0,

    OMX_AUDIO_SIDETONE_LOOP = 0xFFFF

    /* rest of HW loops are to be defined on a vendor specific basis */

} OMX_AUDIO_HWLOOPSTYPE;

/** Audio HW loop support query.

*/

typedef struct OMX_AUDIO_CONFIG_HWLOOPSUPPORTTYPE  { 

    OMX_U32 nSize;                                    

    OMX_VERSIONTYPE nVersion;                   

    OMX_U32 nPortIndex;

    OMX_U32 nSupportedLoops;    

    OMX_AUDIO_HWLOOPSTYPE eLoopIndex;

} OMX_AUDIO_CONFIG_HWLOOPSUPPORTTYPE;

/** Audio HW loop control.

*/

typedef struct OMX_AUDIO_CONFIG_HWLOOPCONTROLTYPE  { 

    OMX_U32 nSize;                                    

    OMX_VERSIONTYPE nVersion;                   

    OMX_U32 nPortIndex;   

    OMX_AUDIO_HWLOOPSTYPE eLoopIndex;

    OMX_U32 nChannel;

    OMX_BOOL bControlSwitch;

    OMX_BOOL bLinear;

    OMX_BS32 sLoopVolume;

} OMX_AUDIO_CONFIG_HWLOOPCONTROLTYPE;

/** Non-OpenMAX API layers */

/***************************/

/* channel ID denoting special case of all channels being selected where possible */       

#define AUDIO_COMMON_CHANNEL_ALL	0x7FFFFFFF

/** 8 bit unsigned quantity that is byte aligned */

typedef unsigned char uint8;

/** 8 bit signed quantity that is byte aligned */

typedef signed char int8;

/** 16 bit unsigned quantity that is 16 bit word aligned */

typedef unsigned short uint16;

/** 16 bit signed quantity that is 16 bit word aligned */

typedef signed short int16;

/** 32 bit unsigned quantity that is 32 bit word aligned */

typedef unsigned long uint32;

/** signed quantity that is 32 bit word aligned */

typedef signed long int32;

typedef enum AUDIO_COMMON_SWITCH { 

     AUDIO_COMMON_OFF = 0,

     AUDIO_COMMON_ON,  

     AUDIO_COMMON_UNSUPPORTED = 0xFFFF     

 } AUDIO_COMMON_SWITCH;

typedef enum AUDIO_COMMON_STATUS { 

     AUDIO_COMMON_OK = 0,

     AUDIO_COMMON_FAIL,  

     AUDIO_COMMON_ALLCHANNELS_UNSUPPORTED = 0xFFFF     

} AUDIO_COMMON_STATUS;

typedef enum AUDIO_HAL_HW_LOOPS { 

     AUDIO_NOLOOP = 0,

     AUDIO_SIDETONE_LOOP = 0xFFFF

     /* rest of HW loops are to be defined on a vendor specific basis */

} AUDIO_HAL_HW_LOOPS;

typedef enum AUDIO_HAL_HW_OPERATION{ 

     AUDIO_HAL_NOOP = 0,

     AUDIO_HAL_8BIT_SINGLE_READ,

     AUDIO_HAL_8BIT_SINGLE_WRITE,

     AUDIO_HAL_16BIT_SINGLE_READ,

     AUDIO_HAL_16BIT_SINGLE_WRITE,

     AUDIO_HAL_32BIT_SINGLE_READ,

     AUDIO_HAL_32BIT_SINGLE_WRITE,

     AUDIO_HAL_8BIT_MULTI_READ,

     AUDIO_HAL_8BIT_MULTI_WRITE,

     AUDIO_HAL_16BIT_MULTI_READ,

     AUDIO_HAL_16BIT_MULTI_WRITE,

     AUDIO_HAL_32BIT_MULTI_READ,

     AUDIO_HAL_32BIT_MULTI_WRITE, 

     AUDIO_HAL_8BIT_BURST_MULTI_READ,

     AUDIO_HAL_8BIT_BURST_MULTI_WRITE,

     AUDIO_HAL_16BIT_BURST_MULTI_READ,

     AUDIO_HAL_16BIT_BURST_MULTI_WRITE,

     AUDIO_HAL_32BIT_BURST_MULTI_READ,

     AUDIO_HAL_32BIT_BURST_MULTI_WRITE = 0xFFFF     

} AUDIO_HAL_HW_OPERATION;

typedef enum AUDIO_HAL_HW_REGISTER_TYPE { 

     AUDIO_HAL_IO = 0,

     AUDIO_HAL_I2C,

     AUDIO_HAL_SLIMBUS,

     AUDIO_HAL_CBUS = 0xFFFF     

} AUDIO_HAL_HW_REGISTER_TYPE;

typedef struct AUDIO_HAL_REGBANK_DESCRIPTOR{ 

     uint32 reg_bank_index;   

     uint32 logical_start_addr;

     uint32 logical_end_addr;

     AUDIO_HAL_HW_REGISTER_TYPE reg_bank_type;

} AUDIO_HAL_REGBANK_DESCRIPTOR;

typedef struct AUDIO_HAL_GAIN_DESCRIPTOR  { 

     uint32 channel_index; 

     uint16 gain_index;

     uint32 linear;

     int32 min_gain;

     int32 max_gain;

     uint32 gain_step;

     uint32 analog_gain;

} AUDIO_HAL_GAIN_DESCRIPTOR;

typedef struct AUDIO_TIMED_RAMP_INFO  { 

      uint32 linear;

      int32 ramp_start_volume;

      int32 ramp_end_volume;

      int32 current_volume;

      uint32 current_time_hi;

      uint32 current_time_lo;

      uint32 ramp_min_duration_hi;

      uint32 ramp_min_duration_lo;

      uint32 ramp_max_duration_hi;

      uint32 ramp_max_duration_lo;

      int32 min_volume;

      int32 max_volume;

      uint32 volume_step;

} AUDIO_TIMED_RAMP_INFO;

// Function prototypes

/* HAL layer */

void audio_hal_mute_control (void (*call_back_fn_ptr)(AUDIO_COMMON_STATUS status, uint32 channel_index, uint32 extra_status_info), 

                             uint32 channel_index, 

                             AUDIO_COMMON_SWITCH mute_control);

AUDIO_COMMON_SWITCH audio_hal_mute_status (uint32 channel_index);

void audio_hal_power_control (void (*call_back_fn_ptr)(AUDIO_COMMON_STATUS status, uint32 channel_index, uint32 extra_status_info), 

                             uint32 channel_index, AUDIO_COMMON_SWITCH power_control);

AUDIO_COMMON_SWITCH audio_hal_power_status(uint32 channel_index);

void audio_hal_gain_capabilities_query(uint32* num_channels, uint16* max_num_gains);

void audio_hal_gains_descriptor_query(AUDIO_HAL_GAIN_DESCRIPTOR* gain_descriptor_table);

void audio_hal_loop_gain_capabilities_query(uint16* num_loops, uint16* max_num_gains);

void audio_hal_supported_loops_query (uint16* supported_loop_indexes);

void audio_hal_loop_gains_descriptor_query (AUDIO_HAL_HW_LOOPS loop_index,

                                    AUDIO_HAL_GAIN_DESCRIPTOR* gain_descriptor_table);

AUDIO_COMMON_STATUS audio_hal_gain_control (void (*call_back_fn_ptr)(AUDIO_COMMON_STATUS status, uint32 channel_index, uint32 extra_status_info), 

                                    uint32 channel_index, uint16 gain_index,

                                    uint32 linear, int32 gain_value);

AUDIO_COMMON_STATUS audio_hal_gain_query (uint32 channel_index, uint16 gain_index,

                                    uint32 linear, int32* gain_value);

AUDIO_COMMON_STATUS audio_hal_loop_control(void (*call_back_fn_ptr)(AUDIO_COMMON_STATUS status, uint32 channel_index, 

                                                  AUDIO_HAL_HW_LOOPS loop_index, uint32 extra_status_info), 

                                    AUDIO_HAL_HW_LOOPS loop_index, AUDIO_COMMON_SWITCH loop_switch,

                                    uint16 channel_index, uint16 gain_index, uint32 linear,

                                    int32 loop_gain_value);

uint16 audio_hal_registerbank_query();

void audio_hal_regbank_descriptors_query(AUDIO_HAL_REGBANK_DESCRIPTOR* register_banks);

void audio_hal_custom_hw_control (void (*call_back_fn_ptr)(AUDIO_COMMON_STATUS status, uint32 extra_status_info), 

                                 AUDIO_HAL_HW_OPERATION hw_operation, AUDIO_HAL_HW_REGISTER_TYPE register_type,

                                 uint16 num_data, uint8* address_data_sequence);

/* Sequencer layer */

void audio_sequencer_mute_control(void (*call_back_fn_ptr)(AUDIO_COMMON_STATUS status, uint32 channel_index, uint32 extra_status_info), 

                                  uint32 channel_index, AUDIO_COMMON_SWITCH mute_control);

void audio_sequencer_power_control(void (*call_back_fn_ptr)(AUDIO_COMMON_STATUS status, uint32 channel_index, uint32 extra_status_info), 

                                  uint32 channel_index, AUDIO_COMMON_SWITCH power_control);

AUDIO_COMMON_STATUS audio_sequencer_burst_control(void (*call_back_fn_ptr)(AUDIO_COMMON_STATUS status, uint32 extra_status_info), 

                                                  AUDIO_COMMON_SWITCH burst_control);

void audio_sequencer_volume_control(void (*call_back_fn_ptr)(AUDIO_COMMON_STATUS status, uint32 channel_index, uint32 extra_status_info), 

                                     uint32 channel_index, uint32 linear, int32 volume);

void audio_sequencer_volume_query(uint32 channel_index, uint32 linear, int32* min_volume, int32* max_volume, int32* current_volume);

/* Timing critical layer */

void audio_timed_mute_control(void (*call_back_fn_ptr)(AUDIO_COMMON_STATUS status, uint32 channel_index, uint32 extra_status_info), 

                              uint32 channel_index, AUDIO_COMMON_SWITCH mute_control);

void audio_timed_volume_ramp_control (void (*call_back_fn_ptr)(AUDIO_COMMON_STATUS status, uint32 channel_index, uint32 extra_status_info), 

                             uint32 channel_index, uint32 linear, int32 start_volume,

                             int32 end_volume, uint32 ramp_duration_hi, uint32 ram_duration_lo,

                             AUDIO_COMMON_SWITCH ramp_terminate);

void audio_timed_volume_ramp_query (uint32 channel_index, AUDIO_TIMED_RAMP_INFO* volume_ramp_info);

#ifdef __cplusplus

}

#endif /* __cplusplus */

#endif /* OMX_Nokia_AudioExt_h */