nn::mic::CTR Namespace

Description

Namespace for the CTR's microphone.
(This namespace can also be written without the ::CTR portion.)

Enumerated Types

SamplingType Enumerated type that indicates the microphone sampling type.
SamplingRate Enumerated type that indicates the microphone sampling rate.

Constants

AMP_GAIN_MAX Constant that indicates the maximum gain for the microphone amp. Defined as 119 (70.0 dB).
AMP_GAIN_MIN Constant that indicates the maximum gain for the microphone amp. Defined as 0 (10.5 dB).
BUFFER_ALIGNMENT_ADDRESS Constant that indicates the alignment of the address of the memory region set using SetBuffer. It is defined as 4096 bytes.
BUFFER_ALIGNMENT_SIZE Constant that indicates the alignment of the size of the memory region set using SetBuffer. It is defined as 4096 bytes.
SAMPLING_TYPE_8BIT_SILENT_DATA Constant representing the silence value for SAMPLING_TYPE_8BIT.
SAMPLING_TYPE_16BIT_SILENT_DATA Constant representing the silence value for SAMPLING_TYPE_16BIT.
SAMPLING_TYPE_SIGNED_8BIT_SILENT_DATA Constant representing the silence value for SAMPLING_TYPE_SIGNED_8BIT.
SAMPLING_TYPE_SIGNED_16BIT_SILENT_DATA Constant representing the silence value for SAMPLING_TYPE_SIGNED_16BIT.
TYPE_8BIT_GUARANTEED_INPUT_MIN Constant representing the minimum value of the guaranteed input range for microphone input values obtained with SAMPLING_TYPE_8BIT. It has a value of 27.
TYPE_8BIT_GUARANTEED_INPUT_MAX Constant representing the maximum value of the guaranteed input range for microphone input values obtained with SAMPLING_TYPE_8BIT. It has a value of 228.
TYPE_16BIT_GUARANTEED_INPUT_MIN Constant representing the minimum value of the guaranteed input range for microphone input values obtained with SAMPLING_TYPE_16BIT. It has a value of 7105.
TYPE_16BIT_GUARANTEED_INPUT_MAX Constant representing the maximum value of the guaranteed input range for microphone input values obtained with SAMPLING_TYPE_16BIT. It has a value of 58415.
TYPE_SIGNED_8BIT_GUARANTEED_INPUT_MIN Constant representing the minimum value of the guaranteed input range for microphone input values obtained with SAMPLING_TYPE_SIGNED_8BIT. It has a value of -101.
TYPE_SIGNED_8BIT_GUARANTEED_INPUT_MAX Constant representing the maximum value of the guaranteed input range for microphone input values obtained with SAMPLING_TYPE_SIGNED_8BIT. It has a value of 100.
TYPE_SIGNED_16BIT_GUARANTEED_INPUT_MIN Constant representing the minimum value of the guaranteed input range for microphone input values obtained with SAMPLING_TYPE_SIGNED_16BIT. It has a value of -25663.
TYPE_SIGNED_16BIT_GUARANTEED_INPUT_MAX Constant representing the maximum value of the guaranteed input range for microphone input values obtained with SAMPLING_TYPE_SIGNED_16BIT. It has a value of 25647.
AMP_GAIN_DEFAULT_VALUE Constant that indicates the initial value configured for microphone amp gain. Defined as 43 (32 dB). This value is configured even after calling the nn::mic::CTR::Finalize function.

Functions

Other
Initialize Initializes the MIC library and enables the microphone for use.
Finalize Finalizes the MIC library.
SetBuffer Sets the memory region in which to store the sampling results.
ResetBuffer Prevents the memory region that was set using nn::mic::CTR::SetBuffer from being used by the mic library.
GetSamplingBufferSize Returns the size of the sampling results that will be saved within the memory region set using nn::mic::CTR::SetBuffer.
StartSampling Starts microphone auto-sampling.
StopSampling Stops microphone auto-sampling.
AdjustSampling Changes sampling rate in microphone auto-sampling.
IsSampling Determines whether microphone sampling is currently under way.
GetLastSamplingAddress Gets the address at which the most recent microphone sampling results are stored.
GetBufferFullEvent Gets the manually resetting event used to detect when the microphone buffer is full.
SetAmpGain Sets the microphone amp's gain.
GetAmpGain Gets the microphone amp's gain.
SetAmp Sets the ON/OFF setting for power to the microphone.
GetAmp Gets the ON/OFF setting for power to the microphone.
GetForbiddenArea Gets the maximum and minimum values for the region within which it is prohibited to determine if there is microphone input. Avoid determining microphone input between these limits.
SetLowPassFilter Sets the low-pass filter to apply to microphone input data.
SetClamp Configures whether microphone data will be clamped.
GetClamp Gets the clamping settings for microphone data.

Revision History

2010/10/15
Added SetClamp, GetClamp.
2010/06/23
Deleted AllocateBuffer and FreeBuffer. Added SetBuffer, ResetBuffer, and GetSamplingBufferSize.
2010/01/07
Initial version.

CONFIDENTIAL