gsm-codec-lib: doc/FR1-Rx-DTX annotate

annotate doc/FR1-Rx-DTX @ 508:c275e57132f8

libgsmhr1/{pack,unpack}_frame.c: comment fix there is only one unvoiced mode, hence it should be singular

author	Mychaela Falconia <falcon@freecalypso.org>
date	Sat, 17 Aug 2024 21:45:34 +0000
parents	4034c2b06ec8
children

rev	line source
135 22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	1 At the level of provided functionality and architectural structure, ETSI GSM
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	2 specifications for DTX (discontinuous transmission) are very symmetric between
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	3 FR and EFR: the same DTX functionality is specified for both codecs, with the
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	4 same overall architecture. However, there is one important difference: in the
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	5 case of EFR the complete implementation of all DTX functions (for both Tx and
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	6 Rx) forms an integral and inseparable part of the reference codec (implemented
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	7 in C) from the beginning, whereas in the case of FR1 the addition of DTX is
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	8 somewhat of an afterthought. GSM 06.10 defines a "pure" FR codec without any
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	9 DTX functions, and this most basic spec can be and has been implemented in this
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	10 "pure" form - classic Unix libgsm from 1990s is a proper, fully compliant
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	11 implementation of GSM 06.10, but only this spec, without any DTX. In contrast,
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	12 there has never existed a "pure" implementation of GSM 06.60 EFR codec without
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	13 associated Tx and Rx DTX functions. Furthermore, there is an important
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	14 distinction between Tx and Rx DTX handlers for FR1:
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	15
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	16 * Anyone who seeks to implement Tx DTX for FR1 would have to dig into the guts
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	17 of GSM 06.10 encoder and augment it with VAD and SID encoding functions per
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	18 GSM 06.32 and 06.12 specs.
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	19
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	20 * In contrast, the Rx DTX handler for FR1 is modular: the way it is specified
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	21 in GSM 06.11, 06.12 and 06.31 is a front-end to unmodified GSM 06.10 decoder.
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	22 On the Rx side, the interface from the radio subsystem to the Rx DTX handler
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	23 consists of 260 bits of frame plus BFI and TAF flags (the spec also defines a
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	24 SID flag, but it is determined from frame payload bits), and then the
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	25 interface from the Rx DTX handler to the GSM 06.10 decoder is another FR frame
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	26 of 260 bits.
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	27
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	28 What are the implications of this situation for the GSM published-source
303 4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	29 software community? Prior to the present Themyscira offering, there has always
135 22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	30 been libgsm, but no Rx DTX handler. If you are working with a GSM uplink RTP
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	31 stream from a BTS or a GSM downlink frame stream read out of TI Calypso DSP or
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	32 some other GSM MS PHY, feeding that stream directly to libgsm (without passing
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	33 through an Rx DTX handler) is NOT acceptable: a "bare" GSM 06.10 decoder won't
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	34 recognize SID frames and won't produce the expected comfort noise output, and
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	35 what are you going to do in those 20 ms windows in which no good traffic frame
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	36 was received? The situation becomes especially bad (unkind on ears) if you are
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	37 reading received downlink frames out of TI Calypso DSP: the DSP's buffer will
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	38 have some bit content in every 20 ms window, but naturally this bit content
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	39 will be garbage during those frame windows when no good frame was received;
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	40 feeding that garbage to libgsm produces noises that are very unkind on ears.
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	41
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	42 The correct solution is to implement an Rx DTX handler, pass the stream of
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	43 frames and flags from the BTS or the MS PHY to this handler first, and then pass
303 4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	44 the output of this handler to the standard GSM 06.10 decoder (classic libgsm or
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	45 some updated port thereof). Themyscira libgsmfrp was our first Free Software
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	46 implementation of Rx DTX handler for GSM-FR, implementing SID classification,
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	47 comfort noise generation and error concealment. Our new libgsmfr2 offering
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	48 takes the harmonization effort (between GSM-FR and other GSM codecs) one step
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	49 further, eliminating the dependency on old libgsm and putting all GSM-FR codec
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	50 functions "under one roof".
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	51
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	52 libgsmfrp/libgsmfr2 API documentation
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	53 =====================================
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	54
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	55 The Rx DTX component of libgsmfr2 has the same API as our previous libgsmfrp,
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	56 except for dropping the use of <gsm.h> and its types and needing to include our
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	57 new API header <tw_gsmfr.h>. The present article previously contained the full
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	58 description of this API; that description has now been moved to FR1-library-API
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	59 article, where the whole of libgsmfr2 is documented.
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	60
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	61 Standalone exerciser utility
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	62 ============================
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	63
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	64 The present GSM codec libraries and utilities package includes a standalone
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	65 utility that exercises our Rx DTX handler for GSM-FR. This utility is
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	66 gsmfr-preproc, to be run as follows:
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	67
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	68 gsmfr-preproc input.gsmx output.gsm
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	69
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	70 The input is an extended-libgsm file that can contain SIDs and BFI frame gaps
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	71 in addition to regular GSM 06.10 speech frames (see Binary-file-format article);
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	72 the output is GSM 06.10 speech frames only.
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	73
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	74 False SID detection
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	75 ===================
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	76
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	77 The intent of GSM-FR spec authors was that the sets of possible speech frames
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	78 and possible SID frames be disjoint. Prior to introduction of DTX, there were
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	79 only regular speech frames per GSM 06.10, no SID, and a receiver had to deal
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	80 with only two possibilities: either a good speech frame was received, or the
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	81 frame was lost to radio errors or FACCH stealing (unusable frame). When SID
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	82 frames were introduced for the purpose of intentional DTX as distinct from
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	83 radio errors, the intent was that SID was to be a "new animal" not seen before,
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	84 distinct from regular speech frames. There is, however, a small blemish in the
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	85 actual system as realized: if the SID frame detector and the Rx DTX handler
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	86 that follows it in the Rx chain follow the rules of GSM 06.31 sections 6.1.1
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	87 and 6.1.2, respectively (like our implementation does), then some speech frames
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	88 may be mistaken for invalid SID, or perhaps even for valid SID, producing a
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	89 nonzero failure rate in this mechanism.
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	90
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	91 Official test sequence 02 in the set of 5 provided by ETSI exhibits this effect:
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	92 Seq02.inp is a legitimate 13-bit linear PCM input to the speech encoder, and the
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	93 corresponding output of GSM 06.10 encoder is contained in Seq02.cod. However,
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	94 that output contains some frames that are mistakenly classified as SID=1
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	95 (invalid SID) by the rules of GSM 06.31 section 6.1.1! It is true that these
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	96 ancient test sequences chronologically predate the invention of DTX and
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	97 GSM 06.31, but we still need to bear in mind that this problematic Seq02.cod is
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	98 not an artificially constructed sequence of 06.10 codec parameters: it is the
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	99 required output of the prescribed bit-exact encoder given a legitimate PCM
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	100 input! There does not exist a perfect solution to this problem: as usual,
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	101 real-world engineering is all about trade-offs and compromises, and occasionally
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	102 a gear will slip. The best we can do is to model the probability of such
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	103 gear-slip or wrong detection events, and engineer our systems to reduce this
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	104 probability to a level that is deemed acceptable - which is exactly what GSM
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	105 spec designers did here.
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	106
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	107 As of gsm-codec-lib-r3, gsmrec-dump utility shows the SID classification result
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	108 (GSM 06.31 section 6.1.1) in addition to parsed 06.10 codec parameters for each
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	109 frame, thus one can inspect FR-encoded streams and check for this blemish.
135 22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	110
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	111 Effect of extra preprocessing
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	112 =============================
22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	113
303 4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	114 What will happen if the output of our Rx DTX preprocessor (e.g., the output of
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	115 gsmfr-preproc utility) is fed to another utility such as gsmfr-decode that also
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	116 applies the same preprocessor to its input? In other words, what is the effect
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	117 of a secondary preprocessor application to previous preprocessor output?
135 22601ae99434 doc/FR1-Rx-DTX article written Mychaela Falconia <falcon@freecalypso.org> parents: diff changeset	118
303 4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	119 Most of the time, the second preprocessor pass will be an identity transform
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	120 under these conditions, as the input to that second pass will consist entirely
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	121 of good speech frames, no SIDs and no BFIs. Any speech frames in the original
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	122 input that were mistakenly classified as SID (valid or invalid) have already
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	123 been converted to comfort noise (or to the silence frame in one corner case of
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	124 invalid SID), hence they are no longer present in the output to trigger this
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	125 effect a second time. However, there is still a small possibility that a
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	126 second pass will be a non-identity transform: pseudorandom RPE pulse parameters
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	127 in our comfort noise output are uniformly distributed between 1 and 6 (GSM 06.12
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	128 section 6.1), and if PRNG dice roll such that at least 80 out of 95 SID codeword
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	129 bit positions (all in the xMc part of the frame) are all zeros, the resulting
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	130 CN frame will be liable to misinterpretation as SID (invalid SID most of the
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	131 time, or even more rarely valid SID if at least 94 out of 95 SID codeword bit
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	132 positions are all zeros) if fed to the preprocessor a second time. That second
4034c2b06ec8 doc/FR1-Rx-DTX: update for libgsmfr2 and the new landscape Mychaela Falconia <falcon@freecalypso.org> parents: 250 diff changeset	133 pass would then further alter those affected frames, but no others.

FreeCalypso > hg > gsm-codec-lib

annotate doc/FR1-Rx-DTX @ 508:c275e57132f8