comparison README @ 6:3ab5e2e17da2 default tip

add README
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 29 Aug 2024 14:56:30 +0000
parents
children
comparison
equal deleted inserted replaced
5:3604828b2f54 6:3ab5e2e17da2
1 The hack program in this repository is intended to run on a lab machine (which
2 can be RPi etc) that drives an E1 BTS by way of an icE1usb adapter and osmo-e1d.
3
4 When a traditional E1 BTS activates a speech or data TCH, it starts transmitting
5 TRAU-UL frames on the E1 subslot corresponding to the activated TDMA ts, and it
6 expects to receive back TRAU-DL frames shortly thereafter. If those TRAU-DL
7 frames don't appear as expected, the BTS declares remote transcoder failure and
8 ends the call attempt - hence a lab test setup has to include a TRAU emulator
9 to keep the BTS happy, even if the only objective is to keep the call open and
10 capture TRAU-UL output.
11
12 The standard solution in Osmocom is to run OsmoMGW in E1 interface mode.
13 However, my primary objective was to capture the byte stream coming from the
14 TRAU-frame-carrying E1 timeslot and record it into a file for later analysis
15 offline - and I found it too difficult to hack this function into OsmoMGW.
16 Therefore, I took a different approach:
17
18 * Because OsmoBSC still needs its associated OsmoMGW, I do run the latter, but
19 I point it at a fake E1 interface (vpair in osmo-e1d) instead of the real one.
20 (OsmoBSC still talks to the real E1 for OML and RSL.)
21
22 * The hack program contained in this repository opens the real timeslot on the
23 real E1 and acts as a fake TRAU, reacting to TRAU-UL output from the BTS and
24 responding with TRAU-DL frames. This faketrau program also implements the
25 recording function.
26
27 The only version currently implemented is faketrau-16k: it opens a single E1 ts
28 and treats it as four 16 kbit/s subslots. It acts like real TRAUs in that it
29 needs to receive TRAU-UL frames from the BTS in order to activate a channel,
30 and the TRAU-UL frame type in bits C1-C5 indicates the codec type (FR or EFR),
31 selecting the type of TRAU-DL frames that need to be sent back to the BTS.
32
33 The stream of TRAU-DL frames sent to the BTS by faketrau-16k consists of
34 GSM 06.11 silence frames in the case of FRv1 or decoder homing frames in the
35 case of EFR.