path: root/sound/soc/tegra/tegra_sndfx.h

/*
 * Copyright (c) 2010 NVIDIA Corporation.
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *
 * Redistributions of source code must retain the above copyright notice,
 * this list of conditions and the following disclaimer.
 *
 * Redistributions in binary form must reproduce the above copyright notice,
 * this list of conditions and the following disclaimer in the documentation
 * and/or other materials provided with the distribution.
 *
 * Neither the name of the NVIDIA Corporation nor the names of its contributors
 * may be used to endorse or promote products derived from this software
 * without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 *
 */

#ifndef INCLUDED_nvddk_audiofx_H
#define INCLUDED_nvddk_audiofx_H


#if defined(__cplusplus)
extern "C"
{
#endif

#include "nvrm_module.h"
#include "nvrm_transport.h"
#include "nvrm_init.h"

/** @file
 * @brief <b>NVIDIA Driver Development Kit: NvAudioFx APIs</b>
 *
 * @b Description: Declares Interface for NvAudioFx APIs.
 */

/**
 *  @brief API Object Handles.
 *
 *  NvAudioFxObjectHandle is the base handle for every type in the API.
 */

typedef struct NvAudioFxObjectRec *NvAudioFxObjectHandle;

typedef struct NvAudioFxRec *NvAudioFxHandle;

typedef struct NvAudioFxIoRec *NvAudioFxIoHandle;

typedef struct NvAudioFxMixBufferRec *NvAudioFxMixBufferHandle;

typedef struct NvAudioFxMixerRec *NvAudioFxMixerHandle;

typedef struct NvAudioFxNotifierRec *NvAudioFxNotifierHandle;

typedef struct NvAudioFxStreamRec *NvAudioFxStreamHandle;

/**
 *  @brief Object IDs.
 */

typedef NvS32 NvObjectId;
#define NvObjectNullId (0x0)
#define NvAudioFxObjectId (0x10000000)
#define NvAudioFxId (0x11000000)
#define NvAudioFxIoId (0x11100000)
#define NvAudioFxPluginId (0x11200000)
#define NvAudioFxMixBufferId (0x12000000)
#define NvAudioFx3dGroupId (0x14000000)
#define NvAudioFxNotifierId (0x30000000)
#define NvAudioFxConvertId (0x11000001)
#define NvAudioFxDrcId (0x11000002)
#define NvAudioFxEqId (0x11000003)
#define NvAudioFxMixerId (0x11000004)
#define NvAudioFxMixId (0x11000005)
#define NvAudioFxPeqId (0x11000006)
#define NvAudioFxResizeId (0x11000007)
#define NvAudioFxSplitId (0x11000008)
#define NvAudioFxSpreaderId (0x11000009)
#define NvAudioFxSrcId (0x1100000a)
#define NvAudioFxSwitchId (0x1100000b)
#define NvAudioFxVolumeId (0x1100000c)
#define NvAudioFxStreamId (0x11100001)
#define NvAudioFxI2sId (0x11100002)
#define NvAudioFxI2s2Id (0x11100002)
#define NvAudioFxSpdifId (0x11100003)
#define NvAudioFxDefaultPlaybackMixId (0x11300001)
#define NvAudioFxDefaultPlaybackSplitId (0x11300002)
#define NvAudioFxDefaultRecordMixId (0x11300003)
#define NvAudioFxDefaultRecordSplitId (0x11300004)
#define NvAudioFxI2sPlaybackMixId (0x11300005)
#define NvAudioFxI2sRecordSplitId (0x11300006)
#define NvAudioFxI2sLoopbackSplitId (0x11300007)
#define NvAudioFxI2s2PlaybackMixId (0x11300008)
#define NvAudioFxI2s2RecordSplitId (0x11300009)
#define NvAudioFxI2s2LoopbackSplitId (0x1130000a)
#define NvAudioFxSpdifPlaybackMixId (0x1130000b)
#define NvAudioFxSpdifRecordSplitId (0x1130000c)
#define NvAudioFxSpdifLoopbackSplitId (0x1130000d)
#define NvAudioFxMusicMixId (0x1130000e)
#define NvAudioFxMusicSplitId (0x1130000f)
#define NvAudioFxPhoneMixId (0x11300010)
#define NvAudioFxPhoneSplitId (0x11300011)

//
//                  Mixer
//                +------+
//                |      |
//                |  FX  |--@ ScratchSource ------------+
//                |      |                              |
//                +------+                              |
//
//                 Source                              Sink
//                +------+                           +------+
//   Copy Sink @--|      |--@ Loopback  Copy Sink @--|      |--@ Loopback
//                |  FX  |                           |  FX  |
//  ----> Sink @--|      |--@ Source ------> Sink @--|      |--@ Source ---->
//                +------+                           +------+
//

typedef NvS32 NvAudioFxPin;
#define NvAudioFxScratchSourcePin (-4)
#define NvAudioFxLoopbackPin (-3)
#define NvAudioFxCopySinkPin (-2)
#define NvAudioFxInvalidPin (-1)
#define NvAudioFxSinkPin (0)
#define NvAudioFxSourcePin (1)

typedef enum
{
    NvAudioFxProperty_Attach,
    NvAudioFxProperty_Detach,
    NvAudioFxProperty_Format,
    NvAudioFxProperty_Method,
    NvAudioFxProperty_SampleRate,
    NvAudioFxProperty_State,
    NvAudioFxPinProperty_Format,
    NvAudioFxDrcProperty_Drc,
    NvAudioFxEqProperty_Eq,
    NvAudioFxIoProperty_AddEvent,
    NvAudioFxIoProperty_Position,
    NvAudioFxIoProperty_RemoveEvent,
    NvAudioFxIoProperty_SetMappedPositionBuffer,
    NvAudioFxMixerProperty_ProcessBufferSize,
    NvAudioFxMixProperty_Headroom,
    NvAudioFxNotifierProperty_Connect,
    NvAudioFxNotifierProperty_Disconnect,
    NvAudioFxPeqProperty_Peq,
    NvAudioFxResizeProperty_OutputSize,
    NvAudioFxSpreaderProperty_Spreader,
    NvAudioFxSrcProperty_SampleRateShift,
    NvAudioFxVolumeProperty_Ramping,
    NvAudioFxVolumeProperty_Volume,
    NvAudioFxProperty_Num,
    NvAudioFxProperty_Force32 = 0x7FFFFFFF
} NvAudioFxProperty;

// Description of the NvAudioFxProperty_Attach and
// NvAudioFxProperty_Detach properties.

typedef struct NvAudioFxConnectionDescriptorRec
{
    NvAudioFxPin SourcePin;
    NvAudioFxHandle hSink;
    NvAudioFxPin SinkPin;
} NvAudioFxConnectionDescriptor;

// Audio format information of the stream or buffer.

typedef struct NvAudioFxFormatRec
{
    NvU32 FormatTag;
    NvU32 SampleRate;
    NvU32 Channels;
    NvU32 BitsPerSample;
    NvU32 ChannelMask;
} NvAudioFxFormat;

// Description of the NvAudioFxProperty_Method property.

typedef enum
{
    NvAudioFxMethod_Sliced,
    NvAudioFxMethod_Unsliced,
    NvAudioFxMethod_Num,
    NvAudioFxMethod_Force32 = 0x7FFFFFFF
} NvAudioFxMethod;

// Description of the position property.

typedef NvU64 NvAudioFxPosition;

// Description of supported power states in AudioFx.

typedef enum
{
    NvAudioFxPowerState_Low,
    NvAudioFxPowerState_High,
    NvAudioFxPowerState_Full,
    NvAudioFxPowerState_Ready,
    NvAudioFxPowerState_Off,
    NvAudioFxPowerState_Num,
    NvAudioFxPowerState_Force32 = 0x7FFFFFFF
} NvAudioFxPowerState;

// Description of the supported priority states.

typedef enum
{
    NvAudioFxPriority_Normal,
    NvAudioFxPriority_Medium,
    NvAudioFxPriority_High,
    NvAudioFxPriority_Critical,
    NvAudioFxPriority_Num,
    NvAudioFxPriority_Force32 = 0x7FFFFFFF
} NvAudioFxPriority;

// Description of the NvAudioFxProperty_State property.

typedef enum
{
    NvAudioFxState_Uninitialized,
    NvAudioFxState_Initialized,
    NvAudioFxState_Stop,
    NvAudioFxState_Run,
    NvAudioFxState_Pause,
    NvAudioFxState_Disable,
    NvAudioFxState_Num,
    NvAudioFxState_Force32 = 0x7FFFFFFF
} NvAudioFxState;

// Audio DRC information.

typedef struct NvAudioFxDrcDescriptorRec
{
    NvS32 EnableDrc;
    NvS32 NoiseGateThreshold;
    NvS32 LowerCompThreshold;
    NvS32 UpperCompThreshold;
    NvS32 ClippingThreshold;
} NvAudioFxDrcDescriptor;

// Audio EQ information.
#define NvAudioFxEqNumFilters (5)
#define NvAudioFxEqNumChannels (2)

typedef struct NvAudioFxEqDescriptorRec
{
    NvS32 dBGain[NvAudioFxEqNumChannels][NvAudioFxEqNumFilters];

}NvAudioFxEqDescriptor;

// Audio Spreader information.

typedef struct NvAudioFxSpreaderDescriptorRec
{
    NvU32 SpeakerWidth;
} NvAudioFxSpreaderDescriptor;

// Parameteric EQ Filter types

typedef enum
{
    NvAudioFxIirFilter_Undefined,
    NvAudioFxIirFilter_Bandpass,
    NvAudioFxIirFilter_Highpass,
    NvAudioFxIirFilter_Lowpass,
    NvAudioFxIirFilter_Num,
    NvAudioFxIirFilter_Force32 = 0x7FFFFFFF
} NvAudioFxIirFilter;

typedef struct NvAudioFxPeqDescriptorRec
{
    NvU32 Enable;
    NvU32 FilterType[NvAudioFxIirFilter_Num];
    NvS32 CenterFrequency[NvAudioFxIirFilter_Num];
    NvS32 Bandwidth[NvAudioFxIirFilter_Num];
    NvS32 dBGain[NvAudioFxIirFilter_Num];

}NvAudioFxPeqDescriptor;

// Audio pin-specific format information of the stream or buffer.

typedef struct NvAudioFxPinFormatDescriptorRec
{
    NvAudioFxFormat Format;
    NvAudioFxPin Pin;
} NvAudioFxPinFormatDescriptor;

// Audio volume information of the stream or buffer.

typedef struct NvAudioFxVolumeDescriptorRec
{
    NvS32 LeftVolume;
    NvS32 RightVolume;
    NvU32 Mute;
} NvAudioFxVolumeDescriptor;

// Description of the NvAudioFxVoiceProperty_SetMappedPositionBuffer property.

typedef struct NvAudioFxMappedBufferDescriptorRec
{
    NvAudioFxMixBufferHandle hMixBuffer;
    NvU32 Offset;
} NvAudioFxMappedBufferDescriptor;

 /**
 * @brief Defines the structure for adding a buffer to a stream.
 */

typedef struct NvAudioFxBufferDescriptorRec
{

    // A pointer which may be used for already mapped buffers.
    void* pAddr;

    // A physical address for accessing the buffer.
    NvRmPhysAddr PhysicalAddr;

    // The MixBuffer handle returned from NvAudioFxMixerMapBuffer.
    NvAudioFxMixBufferHandle hMixBuffer;

    // Buffer offset in bytes.
    NvU32 Offset;

    // Buffer size in bytes.
    NvU32 Size;

    // Size of non-Zero Fill data in buffer, usually same as Size
    NvU32 ValidSize;

    // The buffer format information.
    NvAudioFxFormat Format;
} NvAudioFxBufferDescriptor;

// Description of the NvAudioFxNotifierProperty_Connect property.

typedef struct NvAudioFxNotifierConnectionDescriptorRec
{
    NvU8 PortName[16];
} NvAudioFxNotifierConnectionDescriptor;

// Description of the NvAudioFxProperty_AddEvent and
// NvAudioFxProperty_RemoveEvent properties.

typedef NvS32 NvAudioFxEvent;
#define NvAudioFxEventBufferDone (0x1)
#define NvAudioFxEventStateChange (0x2)
#define NvAudioFxEventFormatChange (0x4)
#define NvAudioFxEventEndOfStream (0x8)
#define NvAudioFxEventPowerStateChange (0x10)
#define NvAudioFxEventAll (0xffffffff)

typedef struct NvAudioFxMessageRec
{
    NvAudioFxEvent Event;
    NvAudioFxHandle hFx;
    void* pContext;
} NvAudioFxMessage;

typedef struct NvAudioFxBufferDoneMessageRec
{
    NvAudioFxMessage m;
    NvAudioFxPosition Position;
} NvAudioFxBufferDoneMessage;

typedef struct NvAudioFxStateChangeMessageRec
{
    NvAudioFxMessage m;
    NvAudioFxState State;
} NvAudioFxStateChangeMessage;

typedef struct NvAudioFxFormatChangeMessageRec
{
    NvAudioFxMessage m;
    NvAudioFxFormat Format;
} NvAudioFxFormatChangeMessage;

typedef struct NvAudioFxPowerStateChangeMessageRec
{
    NvAudioFxMessage m;
    NvAudioFxPowerState PowerState;
} NvAudioFxPowerStateChangeMessage;

 /**
 * @brief Initializes and opens the AudioFX Mixer.
 *
 * @retval NvAudioFxMixerHandle A non-NULL value will be returned if the mixer
 * is successfully opened.
 */

 NvAudioFxMixerHandle NvddkAudioFxMixerOpen(
    void  );

 /**
 * @brief Closes the AudioFX Mixer. This function frees the resources associated
 * with the Mixer handle and cannot fail.
 *
 * @param hMixer A handle from NvAudioFxMixerOpen().  If hMixer is NULL or
 * invalid, this API does nothing.
 */

 void NvddkAudioFxMixerClose(
    NvAudioFxMixerHandle hMixer );

 /**
 * @brief Creates and initializes an AudioFX object.
 *
 * @param hMixer A handle from NvAudioFxMixerOpen().  If hMixer is NULL the
 * object will be created by the Global Mixer.  A NULL handle should only be
 * used from the driver and not a normal client application.
 * @param Id The ID of the object to create.
 *
 * @retval NvAudioFxObjectHandle A non-NULL value will be returned if the
 * object is successfully created.
 */

 NvAudioFxObjectHandle NvddkAudioFxMixerCreateObject(
    NvAudioFxMixerHandle hMixer,
    NvObjectId Id );

 /**
 * @brief Destroys the AudioFX object.
 *
 * @param hObject A handle from NvAudioFxMixerCreateObject.  If hObject is
 * NULL, this API does nothing.
 */

 void NvddkAudioFxMixerDestroyObject(
    NvAudioFxObjectHandle hObject );

 /**
 * @brief Maps a buffer to AudioFX address space.
 */

 NvAudioFxMixBufferHandle NvddkAudioFxMixerMapBuffer(
    NvAudioFxMixerHandle hMixer,
    NvU32 NvRmMemHandleId,
    NvU32 Offset,
    NvU32 Size );

 /**
 * @brief Unmaps a buffer from the AudioFX address space.
 */

 void NvddkAudioFxMixerUnmapBuffer(
    NvAudioFxMixBufferHandle hMixBuffer );

 /**
 * @brief Adds a buffer to a Stream object.
 *
 * @param hStream Handle to the Stream object to add the buffer.
 * @param pDescriptor Description of the buffer to add to the stream.
 *
 * @retval NvSuccess Indicates the operation succeeded.
 */

 NvError NvddkAudioFxStreamAddBuffer(
    NvAudioFxStreamHandle hStream,
    NvAudioFxBufferDescriptor * pDescriptor );

/**
 * @brief Get the property value from an AudioFX object.
 *
 * @param hObject Handle of the object to get the property value.
 * @param Property The property of interest.
 * @param Size Size of the descriptor.
 * @param pDescriptor Holds the value of the current property.
 *
 * @retval NvSuccess Indicates the operation succeeded.
 */

 NvError NvddkAudioFxGetProperty(
    NvAudioFxObjectHandle hObject,
    NvAudioFxProperty Property,
    NvU32 Size,
    void* pProperty );

/**
 * @brief Set a property value on an AudioFX object.
 *
 * @param hObject Handle of the object to set the property on.
 * @param Property The property of interest.
 * @param Size Size of the property descriptor.
 * @param pProperty Holds the value of the property to set.
 *
 * @retval NvSuccess Indicates the operation succeeded.
 */

 NvError NvddkAudioFxSetProperty(
    NvAudioFxObjectHandle hObject,
    NvAudioFxProperty Property,
    NvU32 Size,
    void* pProperty );

/**
 * @brief AVP API Function Table
 */

typedef struct NvddkAudioFxFxnTableRec
{
    NvAudioFxMixerHandle (*MixerOpen)(void);
    void (*MixerClose)(NvAudioFxMixerHandle hMixer);
    NvAudioFxObjectHandle (*MixerCreateObject)(NvAudioFxMixerHandle hMixer, NvObjectId Id);
    void (*MixerDestroyObject)(NvAudioFxObjectHandle hObject);
    NvAudioFxMixBufferHandle (*MixerMapBuffer)(NvAudioFxMixerHandle hMixer, NvU32 NvRmMemHandleId, NvU32 Offset, NvU32 Size);
    void (*MixerUnmapBuffer)(NvAudioFxMixBufferHandle hMixBuffer);
    NvError (*StreamAddBuffer)(NvAudioFxStreamHandle hStream, NvAudioFxBufferDescriptor* pDescriptor);
    NvError (*GetProperty)(NvAudioFxObjectHandle hObject, NvAudioFxProperty Property, NvU32 Size, void* pProperty);
    NvError (*SetProperty)(NvAudioFxObjectHandle hObject, NvAudioFxProperty Property, NvU32 Size, void* pProperty);

} NvddkAudioFxFxnTable;

static const NvU32 NvddkAudioFxFxnTableId = 0x6e766178;  // 'nvax'

typedef enum
{
    NvAudioFxIoctl_Generic   = 5020,
    NvAudioFxIoctl_ForceWord = 0x7FFFFFFF,

} NvAudioFxIoctl;

#if defined(__cplusplus)
}
#endif

#endif