aboutsummaryrefslogtreecommitdiffstats
path: root/doc/control_interface.txt
blob: acbc5b47664ee1f2d6b40e18879ba4d1f8c2c357 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
The osmo-bts control interface is currently supporting the following operations:

h2. generic

h3. trx.0.thermal-attenuation

The idea of this paramter is to attenuate the system output power as part of
thermal management.  In some cases the PA might be passing a critical level,
so an external control process can use this attribute to reduce the system
output power.

<pre>
bsc_control.py -d localhost -p 4238 -s trx.0.thermal-attenuation 3
Got message: SET_REPLY 1 trx.0.thermal-attenuation 3
</pre>

<pre>
bsc_control.py -d localhost -p 4238 -g trx.0.thermal-attenuation
Got message: GET_REPLY 1 trx.0.thermal-attenuation 3
</pre>


h2. sysmobts specific

h3. trx.0.clock-info

obtain information on the current clock status:

<pre>
bsc_control.py -d localhost -p 4238 -g trx.0.clock-info
Got message: GET_REPLY 1 trx.0.clock-info -100,ocxo,0,0,gps
</pre>

which is to be interpreted as:
* current clock correction value is -100 ppb
* current clock source is OCXO
* deviation between clock source and calibration source is 0 ppb
* resolution of clock error measurement is 0 ppt (0 means no result yet)
* current calibration source is GPS

When this attribute is set, any value passed on is discarded, but the clock
calibration process is re-started.


h3. trx.0.clock-correction

This attribute can get and set the current clock correction value:

<pre>
bsc_control.py -d localhost -p 4238 -g trx.0.clock-correction
Got message: GET_REPLY 1 trx.0.clock-correction -100
</pre>

<pre>
bsc_control.py -d localhost -p 4238 -s trx.0.clock-correction -- -99
Got message: SET_REPLY 1 trx.0.clock-correction success
</pre>