1 /****************************************************************************** 2 * 3 * Copyright 2022 Google LLC 4 * 5 * Licensed under the Apache License, Version 2.0 (the "License"); 6 * you may not use this file except in compliance with the License. 7 * You may obtain a copy of the License at: 8 * 9 * http://www.apache.org/licenses/LICENSE-2.0 10 * 11 * Unless required by applicable law or agreed to in writing, software 12 * distributed under the License is distributed on an "AS IS" BASIS, 13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14 * See the License for the specific language governing permissions and 15 * limitations under the License. 16 * 17 ******************************************************************************/ 18 19 /** 20 * LC3 - Bandwidth detector 21 * 22 * Reference : Low Complexity Communication Codec (LC3) 23 * Bluetooth Specification v1.0 24 */ 25 26 #ifndef __LC3_BWDET_H 27 #define __LC3_BWDET_H 28 29 #include "common.h" 30 #include "bits.h" 31 32 33 /** 34 * Bandwidth detector (cf. 3.3.5) 35 * dt, sr Duration and samplerate of the frame 36 * e Energy estimation per bands 37 * return Return detected bandwitdth 38 */ 39 enum lc3_bandwidth lc3_bwdet_run( 40 enum lc3_dt dt, enum lc3_srate sr, const float *e); 41 42 /** 43 * Return number of bits coding the bandwidth value 44 * sr Samplerate of the frame 45 * return Number of bits coding the bandwidth value 46 */ 47 int lc3_bwdet_get_nbits(enum lc3_srate sr); 48 49 /** 50 * Put bandwidth indication 51 * bits Bitstream context 52 * sr Samplerate of the frame 53 * bw Bandwidth detected 54 */ 55 void lc3_bwdet_put_bw(lc3_bits_t *bits, 56 enum lc3_srate sr, enum lc3_bandwidth bw); 57 58 /** 59 * Get bandwidth indication 60 * bits Bitstream context 61 * sr Samplerate of the frame 62 * bw Return bandwidth indication 63 * return 0: Ok -1: Invalid bandwidth indication 64 */ 65 int lc3_bwdet_get_bw(lc3_bits_t *bits, 66 enum lc3_srate sr, enum lc3_bandwidth *bw); 67 68 69 #endif /* __LC3_BWDET_H */ 70