blob: 49979a362da4d9d889931fb75cb0db1aec430164 [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>
Vadim Yanitskiy8e9b3072017-10-17 09:24:26 +07004 <key>gsm_trx_burst_if</key>
Vadim Yanitskiy89fc14b2017-06-16 21:00:29 +07005 <import>import grgsm</import>
Vadim Yanitskiy5394c602018-08-10 00:01:26 +07006 <make>grgsm.trx_burst_if($bind_addr, $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>
Vadim Yanitskiy5394c602018-08-10 00:01:26 +070016 <name>bind_addr</name>
17 <key>bind_addr</key>
18 <value>0.0.0.0</value>
19 <type>string</type>
20 </param>
21
22 <param>
Vadim Yanitskiy89fc14b2017-06-16 21:00:29 +070023 <name>remote_addr</name>
24 <key>remote_addr</key>
25 <value>127.0.0.1</value>
26 <type>string</type>
27 </param>
28
29 <sink>
30 <name>bursts</name>
31 <type>message</type>
Vadim Yanitskiy780816d2017-07-19 03:06:17 +070032 <optional>1</optional>
Vadim Yanitskiy89fc14b2017-06-16 21:00:29 +070033 </sink>
34
Vadim Yanitskiyac3a5272017-07-19 03:05:07 +070035 <source>
36 <name>bursts</name>
37 <type>message</type>
Vadim Yanitskiy780816d2017-07-19 03:06:17 +070038 <optional>1</optional>
Vadim Yanitskiyac3a5272017-07-19 03:05:07 +070039 </source>
40
Vadim Yanitskiy89fc14b2017-06-16 21:00:29 +070041 <doc>
Vadim Yanitskiy25916f32017-10-17 08:46:12 +070042 OsmoTRX like UDP burst interface for external applications.
Vadim Yanitskiy89fc14b2017-06-16 21:00:29 +070043
Vadim Yanitskiy25916f32017-10-17 08:46:12 +070044 There are two UDP connections, where each message carries
45 one radio burst with header. Give a base port B (5700 by default).
46 One connection at port P=B+100+2 is used for sending received bursts
47 to an external application. Another one at port P=B+2 is used to
48 obtain to be transmitted bursts.
Vadim Yanitskiy89fc14b2017-06-16 21:00:29 +070049
Vadim Yanitskiy25916f32017-10-17 08:46:12 +070050 Received burst format:
Vadim Yanitskiy89fc14b2017-06-16 21:00:29 +070051 1 byte timeslot index
52 4 bytes GSM frame number, big endian
53 1 byte RSSI in -dBm
54 2 bytes correlator timing offset in 1/256 symbol steps,
55 2's-comp, big endian
56 148 bytes soft symbol estimates, 0 -&gt; definite "0",
57 255 -&gt; definite "1"
58
Vadim Yanitskiy25916f32017-10-17 08:46:12 +070059 To be transmitted burst format:
Vadim Yanitskiy89fc14b2017-06-16 21:00:29 +070060 1 byte timeslot index
61 4 bytes GSM frame number, big endian
62 1 byte transmit level wrt ARFCN max, -dB (attenuation)
63 148 bytes output symbol values, 0 &amp; 1
64 </doc>
65</block>