| /****************************************************************************** |
| * |
| * 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. |
| ******************************************************************************/ |
| A2D_API extern void A2D_SbcChkFrInit(UINT8 *p_pkt); |
| |
| /****************************************************************************** |
| ** |
| ** Function A2D_SbcDescramble |
| ** |
| ** Description descramble the packet. |
| ** |
| ** Returns nothing. |
| ******************************************************************************/ |
| A2D_API 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. |
| ******************************************************************************/ |
| A2D_API 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. |
| ******************************************************************************/ |
| A2D_API 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. |
| ******************************************************************************/ |
| A2D_API 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. |
| ******************************************************************************/ |
| A2D_API 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 */ |
