annotate libgsmhr1/paramval_dec.c @ 545:b07dba7b8a4f

doc/EFR-library-API: document RTP input wrapper
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 03 Oct 2024 09:26:04 +0000
parents 67b13a6a63c9
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
513
03a40ac2e931 libgsmhr1: implement validation for *.cod frames
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 /*
514
67b13a6a63c9 libgsmhr1: implement validation for *.dec frames
Mychaela Falconia <falcon@freecalypso.org>
parents: 513
diff changeset
2 * The function implemented in this module examines a frame of 22 int16_t words
67b13a6a63c9 libgsmhr1: implement validation for *.dec frames
Mychaela Falconia <falcon@freecalypso.org>
parents: 513
diff changeset
3 * that corresponds to GSM-HR decoder input format, and checks if the unused
513
03a40ac2e931 libgsmhr1: implement validation for *.cod frames
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 * upper bits of each int16_t word are cleared as they should be.
514
67b13a6a63c9 libgsmhr1: implement validation for *.dec frames
Mychaela Falconia <falcon@freecalypso.org>
parents: 513
diff changeset
5 * This function should be used when reading from ETSI-format *.dec files,
513
03a40ac2e931 libgsmhr1: implement validation for *.cod frames
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 * to guard against reading garbage or wrong endian.
03a40ac2e931 libgsmhr1: implement validation for *.cod frames
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7 */
03a40ac2e931 libgsmhr1: implement validation for *.cod frames
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8
03a40ac2e931 libgsmhr1: implement validation for *.cod frames
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 #include <stdint.h>
03a40ac2e931 libgsmhr1: implement validation for *.cod frames
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 #include "tw_gsmhr.h"
03a40ac2e931 libgsmhr1: implement validation for *.cod frames
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11
514
67b13a6a63c9 libgsmhr1: implement validation for *.dec frames
Mychaela Falconia <falcon@freecalypso.org>
parents: 513
diff changeset
12 int gsmhr_check_decoder_params(const int16_t *params)
513
03a40ac2e931 libgsmhr1: implement validation for *.cod frames
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13 {
514
67b13a6a63c9 libgsmhr1: implement validation for *.dec frames
Mychaela Falconia <falcon@freecalypso.org>
parents: 513
diff changeset
14 if (params[18] < 0 || params[18] > 2) /* BFI */
67b13a6a63c9 libgsmhr1: implement validation for *.dec frames
Mychaela Falconia <falcon@freecalypso.org>
parents: 513
diff changeset
15 return -1;
67b13a6a63c9 libgsmhr1: implement validation for *.dec frames
Mychaela Falconia <falcon@freecalypso.org>
parents: 513
diff changeset
16 if (params[19] < 0 || params[19] > 1) /* UFI */
513
03a40ac2e931 libgsmhr1: implement validation for *.cod frames
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 return -1;
514
67b13a6a63c9 libgsmhr1: implement validation for *.dec frames
Mychaela Falconia <falcon@freecalypso.org>
parents: 513
diff changeset
18 if (params[20] < 0 || params[20] > 2) /* SID */
67b13a6a63c9 libgsmhr1: implement validation for *.dec frames
Mychaela Falconia <falcon@freecalypso.org>
parents: 513
diff changeset
19 return -1;
67b13a6a63c9 libgsmhr1: implement validation for *.dec frames
Mychaela Falconia <falcon@freecalypso.org>
parents: 513
diff changeset
20 if (params[21] < 0 || params[21] > 1) /* TAF */
513
03a40ac2e931 libgsmhr1: implement validation for *.cod frames
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 return -1;
03a40ac2e931 libgsmhr1: implement validation for *.cod frames
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22 return gsmhr_check_common_params(params);
03a40ac2e931 libgsmhr1: implement validation for *.cod frames
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 }