acoustic ec software library · main page related pages modules data structures files profiling...

MainPage RelatedPages Modules DataStructures

Files Profiling

AcousticECSoftwareLibrary

ProfilinghasbeendoneinordertoevaluatetheresourceconsumptionintermsofMIPS.RAMandFLASHfiguresmaychangedependingonspecificusecaseoptimizations.ThefollowingfigureshowstheprofilingresultsforacousticechocancellationusingaSTM32F446MCUbasedonanARMM4corewithfloatingpointunitrunningat168MHz(210DMIPSavailable)andtheIARembeddedworkbenchtoolchain,version7.70.OptimizationhasbeensetonHigh,speed.

Memoryfootprintdependsonthelengthofthefiltertail.Datahasbeencollectedusingafiltertaillengthequalto128and512.

Generatedby 1.8.11

Files Profiling

Modules

Hereisalistofallmodules:[detaillevel 1 2 3 4 ]

▼MIDDLEWARES ▼ACOUSTIC_EC ▼AcousticECExportedConstants Acoustic_EC_errors Echocancellationerrors Acoustic_EC_preprocessor Echocancellation

preprocessor AcousticECExportedTypes AcousticBFExportedFunctions

Generatedby 1.8.11

Files ProfilingModules

MIDDLEWARES

Modules ACOUSTIC_EC

DetailedDescription

Generatedby 1.8.11

ACOUSTIC_ECMIDDLEWARES

Modules AcousticECExportedConstants AcousticECExportedTypes AcousticBFExportedFunctions

DetailedDescription

Generatedby 1.8.11

AcousticECExportedConstantsMIDDLEWARES»ACOUSTIC_EC

Modules Acoustic_EC_errors Echocancellationerrors. Acoustic_EC_preprocessor Echocancellationpreprocessor.

DetailedDescription

Generatedby 1.8.11

Files ProfilingMacros

Acoustic_EC_errorsMIDDLEWARES»ACOUSTIC_EC»AcousticECExportedConstants

Echocancellationerrors.More...

Macros#define ACOUSTIC_EC_TAIL_LENGTH_ERROR((uint32_t)0x00000001)#define ACOUSTIC_EC_AEC_LEVEL_ERROR((uint32_t)0x00000002)#define ACOUSTIC_EC_PTR_CHANNELS_ERROR((uint32_t)0x00000004)#define ACOUSTIC_EC_PREPROCESS_ERROR((uint32_t)0x00000010)#define ACOUSTIC_LOCK_ERROR((uint32_t)0x10000000)

DetailedDescription

Echocancellationerrors.

Generatedby 1.8.11

Files ProfilingMacros

Acoustic_EC_preprocessorMIDDLEWARES»ACOUSTIC_EC»AcousticECExportedConstants

Echocancellationpreprocessor.More...

Macros#define ACOUSTIC_EC_PREPROCESS_ENABLE((uint32_t)0x00000001)#define ACOUSTIC_EC_PREPROCESS_DISABLE((uint32_t)0x00000000)

DetailedDescription

Echocancellationpreprocessor.

Generatedby 1.8.11

Files ProfilingDataStructures

AcousticECExportedTypesMIDDLEWARES»ACOUSTIC_EC

DataStructuresstruct AcousticEC_Handler_t Libraryhandler.Itkeepstrackofthestaticparametersandit

handlestheinternalstateofthealgorithm.More...struct AcousticEC_Config_t Librarydynamicconfigurationhandler.Itcontainsdynamic

parameters.More...

DetailedDescription

Generatedby 1.8.11

Files ProfilingDataStructures DataStructureIndex DataFields

DataFields

AcousticEC_Handler_tStructReferenceMIDDLEWARES»ACOUSTIC_EC»AcousticECExportedTypes

Libraryhandler.Itkeepstrackofthestaticparametersandithandlestheinternalstateofthealgorithm.More...

#include<acoustic_ec.h>

DataFieldsuint16_t tail_length

uint32_t preprocess_init

uint16_t ptr_primary_channels

uint16_t ptr_reference_channels

uint16_t ptr_output_channels

uint32_t internal_memory_size

uint32_t* pInternalMemory

DetailedDescription

Libraryhandler.Itkeepstrackofthestaticparametersandithandlestheinternalstateofthealgorithm.

FieldDocumentation

uint32_tinternal_memory_size

Keepstrackoftheamountofmemoryrequiredforthecurrentsetup.It'sfilledbythelibSpeexAEC_getMemorySize()functionandmustbeusedtoallocatetherightamountofRAM

uint32_t*pInternalMemory

Pointertothememoryallocatedbytheuser

uint32_tpreprocess_init

Specifiestheoptionforthepreprocessoruinitialization.ThisparametercanbeavalueofAcoustic_EC_preprocessor.

uint16_tptr_output_channels

SpecifiesthenumberofchannelintheOutputStream.DefaultValueis1.

uint16_tptr_primary_channels

SpecifiesthenumberofchannelinthePrimaryStream.DefaultValueis1.

uint16_tptr_reference_channels

SpecifiesthenumberofchannelintheReferenceStream.DefaultValueis1.

uint16_ttail_length

Specifiesthelengthofthefiltertail.DefaultValueis512.

Thedocumentationforthisstructwasgeneratedfromthefollowingfile:

D:/Documents/Repositories/DMIC/Private/Fw/OSX_Libraries/EchoCancellation/trunk/export/

Generatedby 1.8.11

DataFields

AcousticEC_Config_tStructReferenceMIDDLEWARES»ACOUSTIC_EC»AcousticECExportedTypes

Librarydynamicconfigurationhandler.Itcontainsdynamicparameters.More...

#include<acoustic_ec.h>

DataFieldsuint32_t preprocess_stateuint32_t AGC_valueuint32_t residual_echo_removeint32_t noise_suppress_default

int32_t echo_suppress_default

int32_t echo_suppress_active

DetailedDescription

Librarydynamicconfigurationhandler.Itcontainsdynamicparameters.

FieldDocumentation

uint32_tAGC_value

SpecifiesthethresholdfortheAGC,ifactivated

int32_techo_suppress_active

Specifiestheechosuppressactiveparameterofthepreprocessor

int32_techo_suppress_default

Specifiestheechosuppressdefaultparameterofthepreprocessor

int32_tnoise_suppress_default

Specifiesthenoisesuppressdefaultparameterofthepreprocessor

uint32_tpreprocess_state

Enableordisablepre-processfunction

uint32_tresidual_echo_remove

Activateresidualechoremoval

Thedocumentationforthisstructwasgeneratedfromthefollowingfile:

D:/Documents/Repositories/DMIC/Private/Fw/OSX_Libraries/EchoCancellation/trunk/export/

Generatedby 1.8.11

Files ProfilingFunctions

AcousticBFExportedFunctionsMIDDLEWARES»ACOUSTIC_EC

Functions

uint32_t AcousticEC_getMemorySize(AcousticEC_Handler_t*pHandler)

Fillsthe"internal_memory_size"ofthepHandlerparameterpassedasargumentwithavaluerepresentingtherightamountofmemoryneededbythelibrary,dependingonthespecificstaticparametersadopted.More...

uint32_t AcousticEC_Init(AcousticEC_Handler_t*pHandler) Libraryinitialization.More...

uint32_tAcousticEC_Data_Input(void*ptrPrimary,void*ptrReference,void*ptrBufferOut,AcousticEC_Handler_t*pHandler)

Librarydatainputandoutputfunction.More...uint32_t AcousticEC_Process(AcousticEC_Handler_t*pHandler) Libraryrunfunction,performsaudioanalysiswhenall

requireddatahasbeencollected.More...

uint32_t AcousticEC_setConfig(AcousticEC_Handler_t*pHandler,AcousticEC_Config_t*pConfig)

Librarysetupfunction,itsetsthevaluesfordynamicparameters.Itcanbecalledatruntimetochangedynamicparameters.More...

uint32_t AcousticEC_getConfig(AcousticEC_Handler_t*pHandler,AcousticEC_Config_t*pConfig) FillsthepConfigstructurewiththeactualdynamic

parametersastheyareusedinsidethelibrary.More...uint32_t AcousticEC_GetLibVersion(char*version) Tobeusedtoretrieveversioninformation.More...

DetailedDescription

FunctionDocumentation

uint32_tAcousticEC_Data_Input ( void* ptrPrimary,

void* ptrReference,void* ptrBufferOut,AcousticEC_Handler_t* pHandler)

Librarydatainputandoutputfunction.

ParametersptrPrimary pointertoanarraythatcontainsPCMsamples

(16bitsignedint)oftheprimarysignal(1ms=16samplesat16KHZ).

ptrReference pointertoanarraythatcontainsPCMsamples(16bitsignedint)ofthereference(echo)signal(1ms=16samplesat16KHZ).

ptrBufferOut pointertoanarraythatwillcontainoutputPCMsamples(1msforprocessedchannel=16samplesat16KHZ).

pHandler pointertothehandlerofthecurrentSpeexAECinstancerunning.

Returnvalues1 ifdatacollectionisfinishedandlibSpeexAEC_Processmustbecalled,0otherwise.

NoteInput/outputfunctionreadsandwritesamplesskippingthe

requirednumberofvaluesdependingontheptr_Mx_channelsconfiguration

uint32_tAcousticEC_getConfig ( AcousticEC_Handler_t* pHandler,

AcousticEC_Config_t* pConfig)

FillsthepConfigstructurewiththeactualdynamicparametersastheyareusedinsidethelibrary.

ParameterspHandler AcousticEC_Handler_tfilledwithdesired

parameters.pConfig pointertothedynamicparametershandlerthatwill

befilledwiththecurrentlibraryconfiguration.

Returnvalues0 ifeverythingisok,1otherwise.

uint32_tAcousticEC_GetLibVersion ( char* version )

Tobeusedtoretrieveversioninformation.

Parametersnone

ReturnvaluesVersion Number.

uint32_tAcousticEC_getMemorySize ( AcousticEC_Handler_t* pHandler )

Fillsthe"internal_memory_size"ofthepHandlerparameterpassedasargumentwithavaluerepresentingtherightamountofmemory

neededbythelibrary,dependingonthespecificstaticparametersadopted.

parameters.

Returnvalues0 ifeverythingisfine.

uint32_tAcousticEC_Init ( AcousticEC_Handler_t* pHandler )

Libraryinitialization.

parameters.

Returnvalues0 ifeverythingisfine.differentfrom0iferroneousparametershavebeenpassedtotheInitfunctionandthedefaultvaluehasbeenused.Thespecificerrorcanberecognizedbycheckingtherelativebitinthereturnedword.

uint32_tAcousticEC_Process ( AcousticEC_Handler_t* pHandler )

Libraryrunfunction,performsaudioanalysiswhenallrequireddatahasbeencollected.

ParameterspHandler pointertothehandlerofthecurrentSpeexAEC

instancerunning

uint32_tAcousticEC_setConfig ( AcousticEC_Handler_t* pHandler,

AcousticEC_Config_t* pConfig)

Librarysetupfunction,itsetsthevaluesfordynamicparameters.Itcanbecalledatruntimetochangedynamicparameters.

parameters.pConfig pointertothedynamicparametershandlerthatwill

befilledwiththecurrentlibraryconfiguration.

Generatedby 1.8.11

DataStructures

Herearethedatastructureswithbriefdescriptions:

C AcousticEC_Config_t Librarydynamicconfigurationhandler.Itcontainsdynamicparameters

C AcousticEC_Handler_t Libraryhandler.Itkeepstrackofthestaticparametersandithandlestheinternalstateofthealgorithm

Generatedby 1.8.11

DataStructureIndex

A AcousticEC_Handler_t

AcousticEC_Config_t

Generatedby 1.8.11

All Variables

Hereisalistofalldocumentedstructandunionfieldswithlinkstothestruct/uniondocumentationforeachfield:

AGC_value:AcousticEC_Config_techo_suppress_active:AcousticEC_Config_techo_suppress_default:AcousticEC_Config_tinternal_memory_size:AcousticEC_Handler_tnoise_suppress_default:AcousticEC_Config_tpInternalMemory:AcousticEC_Handler_tpreprocess_init:AcousticEC_Handler_tpreprocess_state:AcousticEC_Config_tptr_output_channels:AcousticEC_Handler_tptr_primary_channels:AcousticEC_Handler_tptr_reference_channels:AcousticEC_Handler_tresidual_echo_remove:AcousticEC_Config_ttail_length:AcousticEC_Handler_t

Generatedby 1.8.11

All Variables

AGC_value:AcousticEC_Config_techo_suppress_active:AcousticEC_Config_techo_suppress_default:AcousticEC_Config_tinternal_memory_size:AcousticEC_Handler_tnoise_suppress_default:AcousticEC_Config_tpInternalMemory:AcousticEC_Handler_tpreprocess_init:AcousticEC_Handler_tpreprocess_state:AcousticEC_Config_tptr_output_channels:AcousticEC_Handler_tptr_primary_channels:AcousticEC_Handler_tptr_reference_channels:AcousticEC_Handler_tresidual_echo_remove:AcousticEC_Config_ttail_length:AcousticEC_Handler_t

Generatedby 1.8.11

Files ProfilingFileList

FileList

Hereisalistofalldocumentedfileswithbriefdescriptions:[detaillevel 1 2 3 4 ]

▼ EchoCancellation ▼ trunk ▼ export acoustic_ec.h

Generatedby 1.8.11

EchoCancellation

EchoCancellationDirectoryReference

Directories

Generatedby 1.8.11

EchoCancellation trunk

trunkDirectoryReference

Directories

Generatedby 1.8.11

EchoCancellation trunk export

exportDirectoryReference

Generatedby 1.8.11

EchoCancellation trunk export

acoustic_ec.h

55 /*Definetopreventrecursiveinclusion---

----------------------------------*/

56 #ifndef__ACOUSTIC_EC_H

57 #define__ACOUSTIC_EC_H

59 /*Includes--------------------------------

----------------------------------*/

60 #include"stdint.h"

61 /*Exportedconstants----------------------

----------------------------------*/

62 /*Exportedmacro--------------------------

----------------------------------*/

63 /*Exporteddefine-------------------------

----------------------------------*/

64 /*Exportedfunctions----------------------

---------------------------------*/

65 /*Exportedtypes--------------------------

----------------------------------*/

83 #defineACOUSTIC_EC_TAIL_LENGTH_ERROR

((uint32_t)0x00000001)

84 #defineACOUSTIC_EC_AEC_LEVEL_ERROR

((uint32_t)0x00000002)

85 #defineACOUSTIC_EC_PTR_CHANNELS_ERROR

((uint32_t)0x00000004)

86 #defineACOUSTIC_EC_PREPROCESS_ERROR

((uint32_t)0x00000010)

88 #ifndefACOUSTIC_LOCK_ERROR

89 #defineACOUSTIC_LOCK_ERROR

((uint32_t)0x10000000)

90 #endif

99 #defineACOUSTIC_EC_PREPROCESS_ENABLE

((uint32_t)0x00000001)

100 #defineACOUSTIC_EC_PREPROCESS_DISABLE

((uint32_t)0x00000000)

117 typedefstruct

119 uint16_ttail_length;

120 uint32_tpreprocess_init;

121 uint16_tptr_primary_channels;

122 uint16_tptr_reference_channels;

123 uint16_tptr_output_channels;

124 uint32_tinternal_memory_size;

127 uint32_t*pInternalMemory;

130 AcousticEC_Handler_t;

135 typedefstruct

137 uint32_tpreprocess_state;

138 uint32_tAGC_value;

139 uint32_tresidual_echo_remove;

140 int32_tnoise_suppress_default;

141 int32_techo_suppress_default;

142 int32_techo_suppress_active;

144 AcousticEC_Config_t;

160 uint32_t

AcousticEC_getMemorySize(AcousticEC_Handler_t

*pHandler);

169 uint32_t

AcousticEC_Init(AcousticEC_Handler_t*

pHandler);

184 uint32_tAcousticEC_Data_Input(void

*ptrPrimary,void*ptrReference,void

*ptrBufferOut,AcousticEC_Handler_t*

pHandler);

191 uint32_t

AcousticEC_Process(AcousticEC_Handler_t*

pHandler);

200 uint32_t

AcousticEC_setConfig(AcousticEC_Handler_t*

pHandler,AcousticEC_Config_t*pConfig);

208 uint32_t

AcousticEC_getConfig(AcousticEC_Handler_t*

pHandler,AcousticEC_Config_t*pConfig);

215 uint32_tAcousticEC_GetLibVersion(char

*version);

230 #endif/*__ACOUSTIC_EC_H*/

STMicroelectronics*****ENDOFFILE****/

Generatedby 1.8.11

Files Profiling

RelatedPages

Hereisalistofallrelateddocumentationpages:

profiling

Generatedby 1.8.11

acoustic ec software library · main page related pages modules data structures files profiling...

Documents

ec type-approval certificate...5.2 scaling operation is not...

ec-5, ec-10, & ec-20 manual

ec entrepreneurship modules

ec type-approval certificate - flintec · annex page 2 of...

resonantacoustic mixing...

guitar world acoustic acoustic rock

xvw æv{ ec plug ... · ebm-papst high performance...

acoustic guitar to acoustic bass conversion

acoustic box overview -...

acoustic louvres - iac-noisecontrol.com...

features - telecom modules – poe modules | telecom modules

open access ec gastroenterology ... - ecronicon open … ·...

› wp-content › uploads › 2017 › ... · hospitality...

ford 1 2 3 4 - iglocar · cougar (ec) cougar (ec) cougar...

acoustic transmission of photovoltaic mini-modules...the set...

codice cognome nome - imaie · 169732 acoustic alchemy...

cl/plus/ec - sodeca worldwidecl/plus/ec — the cl/plus/ec...

thebestcombinationof durability,selectionandvalue. ·...

acoustic louvres · page 4 acoustic louvres overview 6...

modules modules d’extension