blob: 252cf6a8bdfaef33e2aafc1c8ead34d50d537491 [file] [log] [blame]
Vadim Yanitskiy89fc14b2017-06-16 21:00:29 +07001<?xml version="1.0"?>
2<block>
Vadim Yanitskiye601c362017-10-17 08:24:25 +07003 <name>TRX Burst Interface</name>
4 <key>grgsm_trx_burst_if</key>
Vadim Yanitskiy89fc14b2017-06-16 21:00:29 +07005 <import>import grgsm</import>
Vadim Yanitskiye601c362017-10-17 08:24:25 +07006 <make>grgsm.trx_burst_if($remote_addr, $base_port)</make>
Vadim Yanitskiy89fc14b2017-06-16 21:00:29 +07007
8 <param>
9 <name>base_port</name>
10 <key>base_port</key>
11 <value>5700</value>
12 <type>string</type>
13 </param>
14
15 <param>
16 <name>remote_addr</name>
17 <key>remote_addr</key>
18 <value>127.0.0.1</value>
19 <type>string</type>
20 </param>
21
22 <sink>
23 <name>bursts</name>
24 <type>message</type>
Vadim Yanitskiy780816d2017-07-19 03:06:17 +070025 <optional>1</optional>
Vadim Yanitskiy89fc14b2017-06-16 21:00:29 +070026 </sink>
27
Vadim Yanitskiyac3a5272017-07-19 03:05:07 +070028 <source>
29 <name>bursts</name>
30 <type>message</type>
Vadim Yanitskiy780816d2017-07-19 03:06:17 +070031 <optional>1</optional>
Vadim Yanitskiyac3a5272017-07-19 03:05:07 +070032 </source>
33
Vadim Yanitskiy89fc14b2017-06-16 21:00:29 +070034 <doc>
Vadim Yanitskiy25916f32017-10-17 08:46:12 +070035 OsmoTRX like UDP burst interface for external applications.
Vadim Yanitskiy89fc14b2017-06-16 21:00:29 +070036
Vadim Yanitskiy25916f32017-10-17 08:46:12 +070037 There are two UDP connections, where each message carries
38 one radio burst with header. Give a base port B (5700 by default).
39 One connection at port P=B+100+2 is used for sending received bursts
40 to an external application. Another one at port P=B+2 is used to
41 obtain to be transmitted bursts.
Vadim Yanitskiy89fc14b2017-06-16 21:00:29 +070042
Vadim Yanitskiy25916f32017-10-17 08:46:12 +070043 Received burst format:
Vadim Yanitskiy89fc14b2017-06-16 21:00:29 +070044 1 byte timeslot index
45 4 bytes GSM frame number, big endian
46 1 byte RSSI in -dBm
47 2 bytes correlator timing offset in 1/256 symbol steps,
48 2's-comp, big endian
49 148 bytes soft symbol estimates, 0 -&gt; definite "0",
50 255 -&gt; definite "1"
51
Vadim Yanitskiy25916f32017-10-17 08:46:12 +070052 To be transmitted burst format:
Vadim Yanitskiy89fc14b2017-06-16 21:00:29 +070053 1 byte timeslot index
54 4 bytes GSM frame number, big endian
55 1 byte transmit level wrt ARFCN max, -dB (attenuation)
56 148 bytes output symbol values, 0 &amp; 1
57 </doc>
58</block>