1. arrange the order of profile ID enums 2. add directory "external" and move SBC codec source into it
484 lines
18 KiB
C
484 lines
18 KiB
C
/******************************************************************************
|
|
*
|
|
* Copyright (C) 2014 The Android Open Source Project
|
|
* Copyright 2003 - 2004 Open Interface North America, Inc. All rights reserved.
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at:
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*
|
|
******************************************************************************/
|
|
|
|
/**********************************************************************************
|
|
$Revision: #1 $
|
|
***********************************************************************************/
|
|
|
|
#ifndef _OI_CODEC_SBC_CORE_H
|
|
#define _OI_CODEC_SBC_CORE_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
@file
|
|
Declarations of codec functions, data types, and macros.
|
|
|
|
@ingroup codec_lib
|
|
*/
|
|
|
|
/**
|
|
@addtogroup codec_lib
|
|
@{
|
|
*/
|
|
|
|
/* Non-BM3 users of of the codec must include oi_codec_sbc_bm3defs.h prior to
|
|
* including this file, or else these includes will fail because the BM3 SDK is
|
|
* not in the include path */
|
|
#ifndef _OI_CODEC_SBC_BM3DEFS_H
|
|
#include "oi_stddefs.h"
|
|
#include "oi_status.h"
|
|
#endif
|
|
|
|
#include <stdint.h>
|
|
|
|
#define SBC_MAX_CHANNELS 2
|
|
#define SBC_MAX_BANDS 8
|
|
#define SBC_MAX_BLOCKS 16
|
|
#define SBC_MIN_BITPOOL 2 /**< Minimum size of the bit allocation pool used to encode the stream */
|
|
#define SBC_MAX_BITPOOL 250 /**< Maximum size of the bit allocation pool used to encode the stream */
|
|
#define SBC_MAX_ONE_CHANNEL_BPS 320000
|
|
#define SBC_MAX_TWO_CHANNEL_BPS 512000
|
|
|
|
|
|
#define SBC_WBS_BITRATE 62000
|
|
#define SBC_WBS_BITPOOL 27
|
|
#define SBC_WBS_NROF_BLOCKS 16
|
|
#define SBC_WBS_FRAME_LEN 62
|
|
#define SBC_WBS_SAMPLES_PER_FRAME 128
|
|
|
|
|
|
#define SBC_HEADER_LEN 4
|
|
#define SBC_MAX_FRAME_LEN (SBC_HEADER_LEN + \
|
|
((SBC_MAX_BANDS * SBC_MAX_CHANNELS / 2) + \
|
|
(SBC_MAX_BANDS + SBC_MAX_BLOCKS * SBC_MAX_BITPOOL + 7)/8))
|
|
#define SBC_MAX_SAMPLES_PER_FRAME (SBC_MAX_BANDS * SBC_MAX_BLOCKS)
|
|
|
|
#define SBC_MAX_SCALEFACTOR_BYTES ((4*(SBC_MAX_CHANNELS * SBC_MAX_BANDS) + 7)/8)
|
|
|
|
#define OI_SBC_SYNCWORD 0x9c
|
|
#define OI_SBC_ENHANCED_SYNCWORD 0x9d
|
|
|
|
/**@name Sampling frequencies */
|
|
/**@{*/
|
|
#define SBC_FREQ_16000 0 /**< The sampling frequency is 16 kHz. One possible value for the @a frequency parameter of OI_CODEC_SBC_EncoderConfigure() */
|
|
#define SBC_FREQ_32000 1 /**< The sampling frequency is 32 kHz. One possible value for the @a frequency parameter of OI_CODEC_SBC_EncoderConfigure() */
|
|
#define SBC_FREQ_44100 2 /**< The sampling frequency is 44.1 kHz. One possible value for the @a frequency parameter of OI_CODEC_SBC_EncoderConfigure() */
|
|
#define SBC_FREQ_48000 3 /**< The sampling frequency is 48 kHz. One possible value for the @a frequency parameter of OI_CODEC_SBC_EncoderConfigure() */
|
|
/**@}*/
|
|
|
|
/**@name Channel modes */
|
|
/**@{*/
|
|
#define SBC_MONO 0 /**< The mode of the encoded channel is mono. One possible value for the @a mode parameter of OI_CODEC_SBC_EncoderConfigure() */
|
|
#define SBC_DUAL_CHANNEL 1 /**< The mode of the encoded channel is dual-channel. One possible value for the @a mode parameter of OI_CODEC_SBC_EncoderConfigure() */
|
|
#define SBC_STEREO 2 /**< The mode of the encoded channel is stereo. One possible value for the @a mode parameter of OI_CODEC_SBC_EncoderConfigure() */
|
|
#define SBC_JOINT_STEREO 3 /**< The mode of the encoded channel is joint stereo. One possible value for the @a mode parameter of OI_CODEC_SBC_EncoderConfigure() */
|
|
/**@}*/
|
|
|
|
/**@name Subbands */
|
|
/**@{*/
|
|
#define SBC_SUBBANDS_4 0 /**< The encoded stream has 4 subbands. One possible value for the @a subbands parameter of OI_CODEC_SBC_EncoderConfigure()*/
|
|
#define SBC_SUBBANDS_8 1 /**< The encoded stream has 8 subbands. One possible value for the @a subbands parameter of OI_CODEC_SBC_EncoderConfigure() */
|
|
/**@}*/
|
|
|
|
/**@name Block lengths */
|
|
/**@{*/
|
|
#define SBC_BLOCKS_4 0 /**< A block size of 4 blocks was used to encode the stream. One possible value for the @a blocks parameter of OI_CODEC_SBC_EncoderConfigure() */
|
|
#define SBC_BLOCKS_8 1 /**< A block size of 8 blocks was used to encode the stream is. One possible value for the @a blocks parameter of OI_CODEC_SBC_EncoderConfigure() */
|
|
#define SBC_BLOCKS_12 2 /**< A block size of 12 blocks was used to encode the stream. One possible value for the @a blocks parameter of OI_CODEC_SBC_EncoderConfigure() */
|
|
#define SBC_BLOCKS_16 3 /**< A block size of 16 blocks was used to encode the stream. One possible value for the @a blocks parameter of OI_CODEC_SBC_EncoderConfigure() */
|
|
/**@}*/
|
|
|
|
/**@name Bit allocation methods */
|
|
/**@{*/
|
|
#define SBC_LOUDNESS 0 /**< The bit allocation method. One possible value for the @a loudness parameter of OI_CODEC_SBC_EncoderConfigure() */
|
|
#define SBC_SNR 1 /**< The bit allocation method. One possible value for the @a loudness parameter of OI_CODEC_SBC_EncoderConfigure() */
|
|
/**@}*/
|
|
|
|
/**
|
|
@}
|
|
|
|
@addtogroup codec_internal
|
|
@{
|
|
*/
|
|
|
|
typedef OI_INT16 SBC_BUFFER_T;
|
|
|
|
|
|
/** Used internally. */
|
|
typedef struct {
|
|
OI_UINT16 frequency; /**< The sampling frequency. Input parameter. */
|
|
OI_UINT8 freqIndex;
|
|
|
|
OI_UINT8 nrof_blocks; /**< The block size used to encode the stream. Input parameter. */
|
|
OI_UINT8 blocks;
|
|
|
|
|
|
OI_UINT8 nrof_subbands; /**< The number of subbands of the encoded stream. Input parameter. */
|
|
OI_UINT8 subbands;
|
|
|
|
OI_UINT8 mode; /**< The mode of the encoded channel. Input parameter. */
|
|
OI_UINT8 nrof_channels; /**< The number of channels of the encoded stream. */
|
|
|
|
OI_UINT8 alloc; /**< The bit allocation method. Input parameter. */
|
|
OI_UINT8 bitpool; /**< Size of the bit allocation pool used to encode the stream. Input parameter. */
|
|
OI_UINT8 crc; /**< Parity check byte used for error detection. */
|
|
OI_UINT8 join; /**< Whether joint stereo has been used. */
|
|
OI_UINT8 enhanced;
|
|
OI_UINT8 min_bitpool; /**< This value is only used when encoding. SBC_MAX_BITPOOL if variable
|
|
bitpools are disallowed, otherwise the minimum bitpool size that will
|
|
be used by the bit allocator. */
|
|
|
|
OI_UINT8 cachedInfo; /**< Information about the previous frame */
|
|
} OI_CODEC_SBC_FRAME_INFO;
|
|
|
|
/** Used internally. */
|
|
typedef struct {
|
|
const OI_CHAR *codecInfo;
|
|
OI_CODEC_SBC_FRAME_INFO frameInfo;
|
|
OI_INT8 scale_factor[SBC_MAX_CHANNELS * SBC_MAX_BANDS];
|
|
OI_UINT32 frameCount;
|
|
OI_INT32 *subdata;
|
|
|
|
SBC_BUFFER_T *filterBuffer[SBC_MAX_CHANNELS];
|
|
OI_INT32 filterBufferLen;
|
|
OI_UINT filterBufferOffset;
|
|
|
|
union {
|
|
OI_UINT8 uint8[SBC_MAX_CHANNELS * SBC_MAX_BANDS];
|
|
OI_UINT32 uint32[SBC_MAX_CHANNELS * SBC_MAX_BANDS / 4];
|
|
} bits;
|
|
OI_UINT8 maxBitneed; /**< Running maximum bitneed */
|
|
OI_BYTE formatByte;
|
|
OI_UINT8 pcmStride;
|
|
OI_UINT8 maxChannels;
|
|
} OI_CODEC_SBC_COMMON_CONTEXT;
|
|
|
|
|
|
/*
|
|
* A smaller value reduces RAM usage at the expense of increased CPU usage. Values in the range
|
|
* 27..50 are recommended, beyond 50 there is a diminishing return on reduced CPU usage.
|
|
*/
|
|
#define SBC_CODEC_MIN_FILTER_BUFFERS 16
|
|
#define SBC_CODEC_FAST_FILTER_BUFFERS 27
|
|
|
|
/* Expands to the number of OI_UINT32s needed to ensure enough memory to encode
|
|
* or decode streams of numChannels channels, using numBuffers buffers.
|
|
* Example:
|
|
* OI_UINT32 decoderData[CODEC_DATA_WORDS(SBC_MAX_CHANNELS, SBC_DECODER_FAST_SYNTHESIS_BUFFERS)];
|
|
* */
|
|
#define CODEC_DATA_WORDS(numChannels, numBuffers) \
|
|
((\
|
|
(sizeof(OI_INT32) * SBC_MAX_BLOCKS * numChannels * SBC_MAX_BANDS) \
|
|
+ (sizeof(SBC_BUFFER_T) * SBC_MAX_CHANNELS * SBC_MAX_BANDS * numBuffers) \
|
|
+ (sizeof (OI_UINT32) - 1) \
|
|
) / sizeof(OI_UINT32))
|
|
|
|
/** Opaque parameter to decoding functions; maintains decoder context. */
|
|
typedef struct {
|
|
OI_CODEC_SBC_COMMON_CONTEXT common;
|
|
OI_UINT8 limitFrameFormat; /* Boolean, set by OI_CODEC_SBC_DecoderLimit() */
|
|
OI_UINT8 restrictSubbands;
|
|
OI_UINT8 enhancedEnabled;
|
|
OI_UINT8 bufferedBlocks;
|
|
} OI_CODEC_SBC_DECODER_CONTEXT;
|
|
|
|
typedef struct {
|
|
OI_UINT32 data[CODEC_DATA_WORDS(1, SBC_CODEC_FAST_FILTER_BUFFERS)];
|
|
} OI_CODEC_SBC_CODEC_DATA_MONO;
|
|
|
|
typedef struct {
|
|
OI_UINT32 data[CODEC_DATA_WORDS(2, SBC_CODEC_FAST_FILTER_BUFFERS)];
|
|
} OI_CODEC_SBC_CODEC_DATA_STEREO;
|
|
|
|
/**
|
|
@}
|
|
|
|
@addtogroup codec_lib
|
|
@{
|
|
*/
|
|
|
|
/**
|
|
* This function resets the decoder. The context must be reset when
|
|
* changing streams, or if the following stream parameters change:
|
|
* number of subbands, stereo mode, or frequency.
|
|
*
|
|
* @param context Pointer to the decoder context structure to be reset.
|
|
*
|
|
* @param enhanced If true, enhanced SBC operation is enabled. If enabled,
|
|
* the codec will recognize the alternative syncword for
|
|
* decoding an enhanced SBC stream. Enhancements should not
|
|
* be enabled unless the stream is known to be generated
|
|
* by an enhanced encoder, or there is a small possibility
|
|
* for decoding glitches if synchronization were to be lost.
|
|
*/
|
|
OI_STATUS OI_CODEC_SBC_DecoderReset(OI_CODEC_SBC_DECODER_CONTEXT *context,
|
|
OI_UINT32 *decoderData,
|
|
OI_UINT32 decoderDataBytes,
|
|
OI_UINT8 maxChannels,
|
|
OI_UINT8 pcmStride,
|
|
OI_BOOL enhanced);
|
|
|
|
/**
|
|
* This function restricts the kind of SBC frames that the Decoder will
|
|
* process. Its use is optional. If used, it must be called after
|
|
* calling OI_CODEC_SBC_DecoderReset(). After it is called, any calls
|
|
* to OI_CODEC_SBC_DecodeFrame() with SBC frames that do not conform
|
|
* to the Subband and Enhanced SBC setting will be rejected with an
|
|
* OI_STATUS_INVALID_PARAMETERS return.
|
|
*
|
|
* @param context Pointer to the decoder context structure to be limited.
|
|
*
|
|
* @param enhanced If true, all frames passed to the decoder must be
|
|
* Enhanced SBC frames. If false, all frames must be
|
|
* standard SBC frames.
|
|
*
|
|
* @param subbands May be set to SBC_SUBBANDS_4 or SBC_SUBBANDS_8. All
|
|
* frames passed to the decoder must be encoded with
|
|
* the requested number of subbands.
|
|
*
|
|
*/
|
|
OI_STATUS OI_CODEC_SBC_DecoderLimit(OI_CODEC_SBC_DECODER_CONTEXT *context,
|
|
OI_BOOL enhanced,
|
|
OI_UINT8 subbands);
|
|
|
|
/**
|
|
* This function sets the decoder parameters for a raw decode where the decoder parameters are not
|
|
* available in the sbc data stream. OI_CODEC_SBC_DecoderReset must be called
|
|
* prior to calling this function.
|
|
*
|
|
* @param context Decoder context structure. This must be the context must be
|
|
* used each time a frame is decoded.
|
|
*
|
|
* @param enhanced Set to TRUE to enable Qualcomm proprietary
|
|
* quality enhancements.
|
|
*
|
|
* @param frequency One of SBC_FREQ_16000, SBC_FREQ_32000, SBC_FREQ_44100,
|
|
* SBC_FREQ_48000
|
|
*
|
|
* @param mode One of SBC_MONO, SBC_DUAL_CHANNEL, SBC_STEREO,
|
|
* SBC_JOINT_STEREO
|
|
*
|
|
* @param subbands One of SBC_SUBBANDS_4, SBC_SUBBANDS_8
|
|
*
|
|
* @param blocks One of SBC_BLOCKS_4, SBC_BLOCKS_8, SBC_BLOCKS_12,
|
|
* SBC_BLOCKS_16
|
|
*
|
|
* @param alloc One of SBC_LOUDNESS, SBC_SNR
|
|
*
|
|
* @param maxBitpool The maximum bitpool size for this context
|
|
*/
|
|
OI_STATUS OI_CODEC_SBC_DecoderConfigureRaw(OI_CODEC_SBC_DECODER_CONTEXT *context,
|
|
OI_BOOL enhanced,
|
|
OI_UINT8 frequency,
|
|
OI_UINT8 mode,
|
|
OI_UINT8 subbands,
|
|
OI_UINT8 blocks,
|
|
OI_UINT8 alloc,
|
|
OI_UINT8 maxBitpool);
|
|
|
|
/**
|
|
* Decode one SBC frame. The frame has no header bytes. The context must have been previously
|
|
* initialized by calling OI_CODEC_SBC_DecoderConfigureRaw().
|
|
*
|
|
* @param context Pointer to a decoder context structure. The same context
|
|
* must be used each time when decoding from the same stream.
|
|
*
|
|
* @param bitpool The actual bitpool size for this frame. Must be <= the maxbitpool specified
|
|
* in the call to OI_CODEC_SBC_DecoderConfigureRaw(),
|
|
*
|
|
* @param frameData Address of a pointer to the SBC data to decode. This
|
|
* value will be updated to point to the next frame after
|
|
* successful decoding.
|
|
*
|
|
* @param frameBytes Pointer to a UINT32 containing the number of available
|
|
* bytes of frame data. This value will be updated to reflect
|
|
* the number of bytes remaining after a decoding operation.
|
|
*
|
|
* @param pcmData Address of an array of OI_INT16 pairs, which will be
|
|
* populated with the decoded audio data. This address
|
|
* is not updated.
|
|
*
|
|
* @param pcmBytes Pointer to a UINT32 in/out parameter. On input, it
|
|
* should contain the number of bytes available for pcm
|
|
* data. On output, it will contain the number of bytes
|
|
* written. Note that this differs from the semantics of
|
|
* frameBytes.
|
|
*/
|
|
OI_STATUS OI_CODEC_SBC_DecodeRaw(OI_CODEC_SBC_DECODER_CONTEXT *context,
|
|
OI_UINT8 bitpool,
|
|
const OI_BYTE **frameData,
|
|
OI_UINT32 *frameBytes,
|
|
OI_INT16 *pcmData,
|
|
OI_UINT32 *pcmBytes);
|
|
|
|
/**
|
|
* Decode one SBC frame.
|
|
*
|
|
* @param context Pointer to a decoder context structure. The same context
|
|
* must be used each time when decoding from the same stream.
|
|
*
|
|
* @param frameData Address of a pointer to the SBC data to decode. This
|
|
* value will be updated to point to the next frame after
|
|
* successful decoding.
|
|
*
|
|
* @param frameBytes Pointer to a UINT32 containing the number of available
|
|
* bytes of frame data. This value will be updated to reflect
|
|
* the number of bytes remaining after a decoding operation.
|
|
*
|
|
* @param pcmData Address of an array of OI_INT16 pairs, which will be
|
|
* populated with the decoded audio data. This address
|
|
* is not updated.
|
|
*
|
|
* @param pcmBytes Pointer to a UINT32 in/out parameter. On input, it
|
|
* should contain the number of bytes available for pcm
|
|
* data. On output, it will contain the number of bytes
|
|
* written. Note that this differs from the semantics of
|
|
* frameBytes.
|
|
*/
|
|
OI_STATUS OI_CODEC_SBC_DecodeFrame(OI_CODEC_SBC_DECODER_CONTEXT *context,
|
|
const OI_BYTE **frameData,
|
|
OI_UINT32 *frameBytes,
|
|
OI_INT16 *pcmData,
|
|
OI_UINT32 *pcmBytes);
|
|
|
|
/**
|
|
* Calculate the number of SBC frames but don't decode. CRC's are not checked,
|
|
* but the Sync word is found prior to count calculation.
|
|
*
|
|
* @param frameData Pointer to the SBC data.
|
|
*
|
|
* @param frameBytes Number of bytes avaiable in the frameData buffer
|
|
*
|
|
*/
|
|
OI_UINT8 OI_CODEC_SBC_FrameCount(OI_BYTE *frameData,
|
|
OI_UINT32 frameBytes);
|
|
|
|
/**
|
|
* Analyze an SBC frame but don't do the decode.
|
|
*
|
|
* @param context Pointer to a decoder context structure. The same context
|
|
* must be used each time when decoding from the same stream.
|
|
*
|
|
* @param frameData Address of a pointer to the SBC data to decode. This
|
|
* value will be updated to point to the next frame after
|
|
* successful decoding.
|
|
*
|
|
* @param frameBytes Pointer to a UINT32 containing the number of available
|
|
* bytes of frame data. This value will be updated to reflect
|
|
* the number of bytes remaining after a decoding operation.
|
|
*
|
|
*/
|
|
OI_STATUS OI_CODEC_SBC_SkipFrame(OI_CODEC_SBC_DECODER_CONTEXT *context,
|
|
const OI_BYTE **frameData,
|
|
OI_UINT32 *frameBytes);
|
|
|
|
/* Common functions */
|
|
|
|
/**
|
|
Calculate the frame length.
|
|
|
|
@param frame The frame whose length to calculate
|
|
|
|
@return the length of an individual encoded frame in
|
|
bytes
|
|
*/
|
|
OI_UINT16 OI_CODEC_SBC_CalculateFramelen(OI_CODEC_SBC_FRAME_INFO *frame);
|
|
|
|
|
|
/**
|
|
* Calculate the maximum bitpool size that fits within a given frame length.
|
|
*
|
|
* @param frame The frame to calculate the bitpool size for
|
|
* @param frameLen The frame length to fit the bitpool to
|
|
*
|
|
* @return the maximum bitpool that will fit in the specified frame length
|
|
*/
|
|
OI_UINT16 OI_CODEC_SBC_CalculateBitpool(OI_CODEC_SBC_FRAME_INFO *frame,
|
|
OI_UINT16 frameLen);
|
|
|
|
/**
|
|
Calculate the bit rate.
|
|
|
|
@param frame The frame whose bit rate to calculate
|
|
|
|
@return the approximate bit rate in bits per second,
|
|
assuming that stream parameters are constant
|
|
*/
|
|
OI_UINT32 OI_CODEC_SBC_CalculateBitrate(OI_CODEC_SBC_FRAME_INFO *frame);
|
|
|
|
/**
|
|
Calculate decoded audio data length for one frame.
|
|
|
|
@param frame The frame whose audio data length to calculate
|
|
|
|
@return length of decoded audio data for a
|
|
single frame, in bytes
|
|
*/
|
|
OI_UINT16 OI_CODEC_SBC_CalculatePcmBytes(OI_CODEC_SBC_COMMON_CONTEXT *common);
|
|
|
|
/**
|
|
* Get the codec version text.
|
|
*
|
|
* @return pointer to text string containing codec version text
|
|
*
|
|
*/
|
|
OI_CHAR *OI_CODEC_Version(void);
|
|
|
|
|
|
/**
|
|
@}
|
|
|
|
@addtogroup codec_internal
|
|
@{
|
|
*/
|
|
|
|
extern const OI_CHAR *const OI_CODEC_SBC_FreqText[];
|
|
extern const OI_CHAR *const OI_CODEC_SBC_ModeText[];
|
|
extern const OI_CHAR *const OI_CODEC_SBC_SubbandsText[];
|
|
extern const OI_CHAR *const OI_CODEC_SBC_BlocksText[];
|
|
extern const OI_CHAR *const OI_CODEC_SBC_AllocText[];
|
|
|
|
/**
|
|
@}
|
|
|
|
@addtogroup codec_lib
|
|
@{
|
|
*/
|
|
|
|
#ifdef OI_DEBUG
|
|
void OI_CODEC_SBC_DumpConfig(OI_CODEC_SBC_FRAME_INFO *frameInfo);
|
|
#else
|
|
#define OI_CODEC_SBC_DumpConfig(f)
|
|
#endif
|
|
|
|
/**
|
|
@}
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
|
|
#endif /* _OI_CODEC_SBC_CORE_H */
|
|
|
|
|