211 lines
8.6 KiB
C
211 lines
8.6 KiB
C
/******************************************************************************
|
|
*
|
|
* Copyright (C) 2000-2012 Broadcom Corporation
|
|
*
|
|
* 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.
|
|
*
|
|
******************************************************************************/
|
|
|
|
/******************************************************************************
|
|
*
|
|
* nterface to low complexity subband codec (SBC)
|
|
*
|
|
******************************************************************************/
|
|
#ifndef A2D_SBC_H
|
|
#define A2D_SBC_H
|
|
|
|
/*****************************************************************************
|
|
** Constants
|
|
*****************************************************************************/
|
|
/* the length of the SBC Media Payload header. */
|
|
#define A2D_SBC_MPL_HDR_LEN 1
|
|
|
|
/* the LOSC of SBC media codec capabilitiy */
|
|
#define A2D_SBC_INFO_LEN 6
|
|
|
|
/* for Codec Specific Information Element */
|
|
#define A2D_SBC_IE_SAMP_FREQ_MSK 0xF0 /* b7-b4 sampling frequency */
|
|
#define A2D_SBC_IE_SAMP_FREQ_16 0x80 /* b7:16 kHz */
|
|
#define A2D_SBC_IE_SAMP_FREQ_32 0x40 /* b6:32 kHz */
|
|
#define A2D_SBC_IE_SAMP_FREQ_44 0x20 /* b5:44.1kHz */
|
|
#define A2D_SBC_IE_SAMP_FREQ_48 0x10 /* b4:48 kHz */
|
|
|
|
#define A2D_SBC_IE_CH_MD_MSK 0x0F /* b3-b0 channel mode */
|
|
#define A2D_SBC_IE_CH_MD_MONO 0x08 /* b3: mono */
|
|
#define A2D_SBC_IE_CH_MD_DUAL 0x04 /* b2: dual */
|
|
#define A2D_SBC_IE_CH_MD_STEREO 0x02 /* b1: stereo */
|
|
#define A2D_SBC_IE_CH_MD_JOINT 0x01 /* b0: joint stereo */
|
|
|
|
#define A2D_SBC_IE_BLOCKS_MSK 0xF0 /* b7-b4 number of blocks */
|
|
#define A2D_SBC_IE_BLOCKS_4 0x80 /* 4 blocks */
|
|
#define A2D_SBC_IE_BLOCKS_8 0x40 /* 8 blocks */
|
|
#define A2D_SBC_IE_BLOCKS_12 0x20 /* 12blocks */
|
|
#define A2D_SBC_IE_BLOCKS_16 0x10 /* 16blocks */
|
|
|
|
#define A2D_SBC_IE_SUBBAND_MSK 0x0C /* b3-b2 number of subbands */
|
|
#define A2D_SBC_IE_SUBBAND_4 0x08 /* b3: 4 */
|
|
#define A2D_SBC_IE_SUBBAND_8 0x04 /* b2: 8 */
|
|
|
|
#define A2D_SBC_IE_ALLOC_MD_MSK 0x03 /* b1-b0 allocation mode */
|
|
#define A2D_SBC_IE_ALLOC_MD_S 0x02 /* b1: SNR */
|
|
#define A2D_SBC_IE_ALLOC_MD_L 0x01 /* b0: loundess */
|
|
|
|
#define A2D_SBC_IE_MIN_BITPOOL 2
|
|
#define A2D_SBC_IE_MAX_BITPOOL 250
|
|
|
|
/* for media payload header */
|
|
#define A2D_SBC_HDR_F_MSK 0x80
|
|
#define A2D_SBC_HDR_S_MSK 0x40
|
|
#define A2D_SBC_HDR_L_MSK 0x20
|
|
#define A2D_SBC_HDR_NUM_MSK 0x0F
|
|
|
|
/*****************************************************************************
|
|
** Type Definitions
|
|
*****************************************************************************/
|
|
|
|
/* data type for the SBC Codec Information Element*/
|
|
typedef struct {
|
|
UINT8 samp_freq; /* Sampling frequency */
|
|
UINT8 ch_mode; /* Channel mode */
|
|
UINT8 block_len; /* Block length */
|
|
UINT8 num_subbands; /* Number of subbands */
|
|
UINT8 alloc_mthd; /* Allocation method */
|
|
UINT8 max_bitpool; /* Maximum bitpool */
|
|
UINT8 min_bitpool; /* Minimum bitpool */
|
|
} tA2D_SBC_CIE;
|
|
|
|
|
|
/*****************************************************************************
|
|
** External Function Declarations
|
|
*****************************************************************************/
|
|
#ifdef __cplusplus
|
|
extern "C"
|
|
{
|
|
#endif
|
|
/******************************************************************************
|
|
**
|
|
** Function A2D_SbcChkFrInit
|
|
**
|
|
** Description check if need to init the descramble control block.
|
|
**
|
|
** Returns nothing.
|
|
******************************************************************************/
|
|
extern void A2D_SbcChkFrInit(UINT8 *p_pkt);
|
|
|
|
/******************************************************************************
|
|
**
|
|
** Function A2D_SbcDescramble
|
|
**
|
|
** Description descramble the packet.
|
|
**
|
|
** Returns nothing.
|
|
******************************************************************************/
|
|
extern void A2D_SbcDescramble(UINT8 *p_pkt, UINT16 len);
|
|
|
|
/******************************************************************************
|
|
**
|
|
** Function A2D_BldSbcInfo
|
|
**
|
|
** Description This function is called by an application to build
|
|
** the SBC Media Codec Capabilities byte sequence
|
|
** beginning from the LOSC octet.
|
|
** Input Parameters:
|
|
** media_type: Indicates Audio, or Multimedia.
|
|
**
|
|
** p_ie: The SBC Codec Information Element information.
|
|
**
|
|
** Output Parameters:
|
|
** p_result: the resulting codec info byte sequence.
|
|
**
|
|
** Returns A2D_SUCCESS if function execution succeeded.
|
|
** Error status code, otherwise.
|
|
******************************************************************************/
|
|
extern tA2D_STATUS A2D_BldSbcInfo(UINT8 media_type, tA2D_SBC_CIE *p_ie,
|
|
UINT8 *p_result);
|
|
|
|
/******************************************************************************
|
|
**
|
|
** Function A2D_ParsSbcInfo
|
|
**
|
|
** Description This function is called by an application to parse
|
|
** the SBC Media Codec Capabilities byte sequence
|
|
** beginning from the LOSC octet.
|
|
** Input Parameters:
|
|
** p_info: the byte sequence to parse.
|
|
**
|
|
** for_caps: TRUE, if the byte sequence is for get capabilities response.
|
|
**
|
|
** Output Parameters:
|
|
** p_ie: The SBC Codec Information Element information.
|
|
**
|
|
** Returns A2D_SUCCESS if function execution succeeded.
|
|
** Error status code, otherwise.
|
|
******************************************************************************/
|
|
extern tA2D_STATUS A2D_ParsSbcInfo(tA2D_SBC_CIE *p_ie, UINT8 *p_info,
|
|
BOOLEAN for_caps);
|
|
|
|
/******************************************************************************
|
|
**
|
|
** Function A2D_BldSbcMplHdr
|
|
**
|
|
** Description This function is called by an application to parse
|
|
** the SBC Media Payload header.
|
|
** Input Parameters:
|
|
** frag: 1, if fragmented. 0, otherwise.
|
|
**
|
|
** start: 1, if the starting packet of a fragmented frame.
|
|
**
|
|
** last: 1, if the last packet of a fragmented frame.
|
|
**
|
|
** num: If frag is 1, this is the number of remaining fragments
|
|
** (including this fragment) of this frame.
|
|
** If frag is 0, this is the number of frames in this packet.
|
|
**
|
|
** Output Parameters:
|
|
** p_dst: the resulting media payload header byte sequence.
|
|
**
|
|
** Returns void.
|
|
******************************************************************************/
|
|
extern void A2D_BldSbcMplHdr(UINT8 *p_dst, BOOLEAN frag, BOOLEAN start,
|
|
BOOLEAN last, UINT8 num);
|
|
|
|
/******************************************************************************
|
|
**
|
|
** Function A2D_ParsSbcMplHdr
|
|
**
|
|
** Description This function is called by an application to parse
|
|
** the SBC Media Payload header.
|
|
** Input Parameters:
|
|
** p_src: the byte sequence to parse..
|
|
**
|
|
** Output Parameters:
|
|
** frag: 1, if fragmented. 0, otherwise.
|
|
**
|
|
** start: 1, if the starting packet of a fragmented frame.
|
|
**
|
|
** last: 1, if the last packet of a fragmented frame.
|
|
**
|
|
** num: If frag is 1, this is the number of remaining fragments
|
|
** (including this fragment) of this frame.
|
|
** If frag is 0, this is the number of frames in this packet.
|
|
**
|
|
** Returns void.
|
|
******************************************************************************/
|
|
extern void A2D_ParsSbcMplHdr(UINT8 *p_src, BOOLEAN *p_frag,
|
|
BOOLEAN *p_start, BOOLEAN *p_last,
|
|
UINT8 *p_num);
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* A2D_SBC_H */
|