annotate README @ 52:626180a15857 default tip

ater play-d144: emit E-data frames manually, osmo_trau_frame_encode() is currently broken for this frame type
author Mychaela Falconia <falcon@freecalypso.org>
date Wed, 25 Sep 2024 06:40:43 +0000
parents 12415d7ce262
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
38
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
1 The test programs in this Hg repository are intended to run on a Raspberry Pi 5
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
2 driving an icE1usb adapter, which is in turn connected to Nokia TCSM2
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
3 bank-of-TRAUs apparatus via PCM and Ater interfaces. Both E1 ports on icE1usb
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
4 have to be used (one E1 circuit for PCM, the other for Ater), and RPi5 has to
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
5 be used as the driving host because it is one of the few host machine types
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
6 that can successfully operate icE1usb with both E1 interfaces.
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
7
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
8 The test programs in the present suite use Osmocom libraries and work through
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
9 osmo-e1d, opening individual E1 timeslots as needed. The test programs are:
13
949cfb0bf403 add README
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10
38
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
11 * itt-ater-16 operates on a single E1 ts on Ater and treats it as consisting of
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
12 four 16 kbit/s subslots, corresponding to PCM circuit type A on TCSM2. Each
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
13 individual TRAU channel comes to life when TRAU-UL frames appear in the
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
14 corresponding subslot on Ater, thus itt-ater-16 can activate up to 4 TRAU
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
15 channels that share the same E1 ts. For each channel it activates, our test
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
16 program can feed any desired UL frame stream to the TRAU, thereby facilitating
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
17 functional experimentation.
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
18
46
12415d7ce262 README: document itt-ater-8
Mychaela Falconia <falcon@freecalypso.org>
parents: 38
diff changeset
19 * itt-ater-8 is the 8 kbit/s submultiplexing counterpart to itt-ater-16,
12415d7ce262 README: document itt-ater-8
Mychaela Falconia <falcon@freecalypso.org>
parents: 38
diff changeset
20 corresponding to PCM circuit type B on TCSM2.
12415d7ce262 README: document itt-ater-8
Mychaela Falconia <falcon@freecalypso.org>
parents: 38
diff changeset
21
38
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
22 * itt-pcm-one operates on a single E1 ts on A interface, aka PCM. It can
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
23 display and record PCM output from the TRAU, and it can feed different PCM
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
24 byte patterns to the TRAU.
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
25
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
26 * itt-pcm-br (PCM bridge) opens two different E1 timeslots on the PCM side of
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
27 the TRAU apparatus and bridges them together, forwarding all bytes from A to
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
28 B and from B to A. This bridging function is needed in order to exercise TFO,
f7a1a2765e21 README: update for current state
Mychaela Falconia <falcon@freecalypso.org>
parents: 13
diff changeset
29 involving two TRAU channels in the TCSM2 bank-of-TRAUs apparatus.