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