summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPau Espin Pedrol <pespin@sysmocom.de>2020-05-28 18:30:46 +0200
committerPau Espin Pedrol <pespin@sysmocom.de>2020-06-02 14:26:15 +0200
commitd78c670ee90a58eb073a72de0c17ddb144896500 (patch)
treefcb24cc294547ea881200c43759297f944c9f59a
parentb01306c59a1d60bae3bf286f397065cde817dca0 (diff)
trx_if: Clarify {SET;ADJ}POWER TRXC commands
-rw-r--r--common/chapters/trx_if.adoc21
1 files changed, 11 insertions, 10 deletions
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 @@ CMD POWEROFF
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>