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 #ifndef __LC3_BWDET_H
20 #define __LC3_BWDET_H
21 
22 #include "common.h"
23 #include "bits.h"
24 
25 
26 /**
27  * Bandwidth detector
28  * dt, sr          Duration and samplerate of the frame
29  * e               Energy estimation per bands
30  * return          Return detected bandwitdth
31  */
32 enum lc3_bandwidth lc3_bwdet_run(
33     enum lc3_dt dt, enum lc3_srate sr, const float *e);
34 
35 /**
36  * Return number of bits coding the bandwidth value
37  * sr              Samplerate of the frame
38  * return          Number of bits coding the bandwidth value
39  */
40 int lc3_bwdet_get_nbits(enum lc3_srate sr);
41 
42 /**
43  * Put bandwidth indication
44  * bits            Bitstream context
45  * sr              Samplerate of the frame
46  * bw              Bandwidth detected
47  */
48 void lc3_bwdet_put_bw(lc3_bits_t *bits,
49     enum lc3_srate sr, enum lc3_bandwidth bw);
50 
51 /**
52  * Get bandwidth indication
53  * bits            Bitstream context
54  * sr              Samplerate of the frame
55  * bw              Return bandwidth indication
56  * return          0: Ok  -1: Invalid bandwidth indication
57  */
58 int lc3_bwdet_get_bw(lc3_bits_t *bits,
59     enum lc3_srate sr, enum lc3_bandwidth *bw);
60 
61 
62 #endif /* __LC3_BWDET_H */
63