aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorVadim Yanitskiy <vyanitskiy@sysmocom.de>2021-04-16 07:43:40 +0200
committerfixeria <vyanitskiy@sysmocom.de>2021-10-13 20:01:08 +0000
commit72d9981cd0e5a87b22e45df99a71e86a4dd2190e (patch)
tree6e3f0627b5829dace80e3d02158b6eb8acd570f0 /doc
parent0e2a20bfb4e842d91bd14291d4304ab024b3c6cf (diff)
osmo-bts-trx: refactor 'maxdly' / 'maxdlynb' commands
* Move way too verbose command description to the manuals. * None of these commands apply immediately, correct the attributes. ** Remove meaningless call to l1if_provision_transceiver_trx(). * Make 'maxdlynb' hidden, so it only appears in the expert mode. * One GMSK symbol actually corresponds to 550m. Change-Id: I46839cf56bba2dcdc70303cd393e86d35aa2f3f5
Diffstat (limited to 'doc')
-rw-r--r--doc/manuals/vty/bts_vty_additions.xml27
1 files changed, 26 insertions, 1 deletions
diff --git a/doc/manuals/vty/bts_vty_additions.xml b/doc/manuals/vty/bts_vty_additions.xml
index 519c4b48..2d22b41d 100644
--- a/doc/manuals/vty/bts_vty_additions.xml
+++ b/doc/manuals/vty/bts_vty_additions.xml
@@ -1 +1,26 @@
-<vtydoc xmlns='urn:osmocom:xml:libosmocore:vty:doc:1.0'/>
+<!-- ex:ts=2:sw=2:et -->
+<vtydoc xmlns='urn:osmocom:xml:libosmocore:vty:doc:1.0'>
+ <node id='phy-inst'>
+ <!-- FIXME: This command appears twice for some reason. -->
+ <command id='osmotrx maxdly &lt;0-63&gt;'>
+ <description>
+ Access Burst is the first burst a mobile transmits in order to establish a connection and it
+ is used to estimate Timing Advance (TA) which is then applied to Normal Bursts to compensate
+ for signal delay due to distance. So changing this setting effectively changes maximum range
+ of the cell, because Access Bursts with a delay higher than this value will be ignored.
+ </description>
+ </command>
+ <!-- FIXME: This command appears unconditionally, despite being hidden. -->
+ <command id='osmotrx maxdlynb &lt;0-63&gt;'>
+ <description>
+ USE FOR TESTING ONLY, DO NOT CHANGE IN PRODUCTION USE!
+ During the normal operation, delay of Normal Bursts is controlled by the Timing Advance loop
+ and thus Normal Bursts arrive to a BTS with no more than a couple GSM symbols, which is
+ already taken into account in osmo-trx. Changing this setting will have no effect in
+ production installations except increasing osmo-trx CPU load. This setting is only useful
+ when testing with a transmitter which cannot precisely synchronize to the BTS downlink
+ signal, like R&amp;S CMD57.
+ </description>
+ </command>
+ </node>
+</vtydoc>