Change in osmo-gsm-manuals[master]: trx_if: Clarify {SET; ADJ}POWER TRXC commands

[pespin]

pespin has submitted this change. ( https://gerrit.osmocom.org/c/osmo-gsm-manuals/+/18556 )

Change subject: trx_if: Clarify {SET;ADJ}POWER TRXC commands
......................................................................

trx_if: Clarify {SET;ADJ}POWER TRXC commands

Change-Id: I4f1986a1ace3fc9cbef10fc0508407a3d608670b
---
M common/chapters/trx_if.adoc
1 file changed, 11 insertions(+), 10 deletions(-)

Approvals:
  Jenkins Builder: Verified
  neels: Looks good to me, but someone else must approve
  Hoernchen: Looks good to me, but someone else must approve
  pespin: Looks good to me, approved



diff --git a/common/chapters/trx_if.adoc b/common/chapters/trx_if.adoc
index d9f074a..fc42eed 100644
--- a/common/chapters/trx_if.adoc
+++ b/common/chapters/trx_if.adoc
@@ -64,26 +64,27 @@
 RSP POWEROFF <status>
 ----
 
-`POWERON` starts the transmitter and starts the demodulator. Initial power
-level is very low. This command fails if the transmitter and receiver are not
-yet tuned. This command fails if the transmit or receive frequency creates a
-conflict with another ARFCN that is already running. If the transceiver is
-already on, it answers successfully to this command.
+`POWERON` starts the transmitter and starts the demodulator. Initial power level
+is by default very low, unless set explicitly by `SETPOWER`/`ADJPOWER`
+beforehand while in `POWEROFF` state. This command fails if the transmitter and
+receiver are not yet tuned. This command fails if the transmit or receive
+frequency creates a conflict with another ARFCN that is already running. If the
+transceiver is already on, it answers successfully to this command.
 ----
 CMD POWERON
 RSP POWERON <status>
 ----
 
-`SETPOWER` sets output power in dB wrt full scale.
-This command fails if the transmitter and receiver are not running.
+`SETPOWER` sets transmit power attenuation wrt the nominal transmit power of
+the transceiver, in dB.
 ----
 CMD SETPOWER <dB>
 RSP SETPOWER <status> <dB>
 ----
 
-`ADJPOWER` adjusts power by the given dB step.  Response returns resulting power
-level wrt full scale. This command fails if the transmitter and receiver are not
-running.
+`ADJPOWER` adjusts by the given dB the transmit power attenuation of the
+transceiver.  Response returns resulting transmit power attenuation wrt the
+nominal transmit power of the transceiver.
 ----
 CMD ADJPOWER <dBStep>
 RSP ADJPOWER <status> <dBLevel>

-- 
To view, visit https://gerrit.osmocom.org/c/osmo-gsm-manuals/+/18556
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings

Gerrit-Project: osmo-gsm-manuals
Gerrit-Branch: master
Gerrit-Change-Id: I4f1986a1ace3fc9cbef10fc0508407a3d608670b
Gerrit-Change-Number: 18556
Gerrit-PatchSet: 3
Gerrit-Owner: pespin <pespin at sysmocom.de>
Gerrit-Reviewer: Hoernchen <ewild at sysmocom.de>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: neels <nhofmeyr at sysmocom.de>
Gerrit-Reviewer: pespin <pespin at sysmocom.de>
Gerrit-Reviewer: tnt <tnt at 246tNt.com>
Gerrit-CC: laforge <laforge at osmocom.org>
Gerrit-MessageType: merged
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osmocom.org/pipermail/gerrit-log/attachments/20200603/e33fb90a/attachment.htm>