Skip to content

Commit cb56beb

Browse files
prsi98rlubos
authored andcommitted
doc: wifi: Update TX power calculation
[SHEL-3277]: Update sample description with TX power equations Signed-off-by: Prasun Sinha <[email protected]>
1 parent 94fa39e commit cb56beb

File tree

1 file changed

+29
-0
lines changed

1 file changed

+29
-0
lines changed

samples/wifi/radio_test/sample_description.rst

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -144,6 +144,7 @@ Testing
144144
.. code-block:: console
145145
146146
wifi_radio_test init 11
147+
wifi_radio_test bypass_reg_domain 1
147148
wifi_radio_test tx_pkt_rate 12
148149
wifi_radio_test tx_pkt_len 4000
149150
wifi_radio_test tx_power 4
@@ -191,6 +192,7 @@ Testing
191192
.. code-block:: console
192193
193194
wifi_radio_test init 14
195+
wifi_radio_test bypass_reg_domain 1
194196
wifi_radio_test tx_pkt_preamble 0
195197
wifi_radio_test tx_pkt_rate 1
196198
wifi_radio_test tx_pkt_len 1024
@@ -560,8 +562,35 @@ Testing
560562

561563
If ``bypass_reg_domain`` is ``0``, then TX power of the channel will be configured to the minimum value of the user configured TX power value and maximum power supported in the configured regulatory domain.
562564

565+
You can calculate the TX power when ``tx_power`` command is issued, by using the following formula:
566+
567+
.. math::
568+
\begin{aligned}
569+
\text{TX power} = \min \left(P_{\text{rt}} , P_{\text{reg}} \right) - \text{AntGain} - \text{EdgeBackoff}
570+
\end{aligned}
571+
572+
* :math:`P_\text{reg}` is the applicable regulatory power limit, as described in :ref:`ug_nrf70_developing_regulatory_support`.
573+
* :math:`P_\text{rt}` is the power set via the ``tx_power`` command when using Radio Test sample, as described in :ref:`wifi_radio_subcommands`.
574+
* ``AntGain`` is the compensation for the antenna gain in the TX direction, as described in `Antenna gain compensation`_.
575+
``AntGain`` can be set to ``0`` using ``wifi_radio_test set_ant_gain`` command.
576+
* ``EdgeBackoff`` is the backoff applied to band edge channels, as described in `Band edge compensation`_.
577+
``EdgeBackoff`` can be set to ``0`` using ``wifi_radio_test set_edge_bo`` command.
578+
579+
.. note::
580+
563581
If ``bypass_reg_domain`` is ``1``, then user configured TX power value will be set overriding current configured regulatory domain maximum TX power for the channel.
564582

583+
You can calculate the TX power when ``bypass_reg_domain`` is ``1`` and the ``tx_power`` command is issued, by using the following formula:
584+
585+
.. math::
586+
\begin{aligned}
587+
\text{TX power} = P_{\text{rt}} - \text{EdgeBackoff}
588+
\end{aligned}
589+
590+
* To achieve expected TX power ``EdgeBackoff`` should be set to ``0`` before issuing ``tx_power`` command.
591+
592+
To calculate the TX power without issuing ``tx_power`` command, see :ref:`nrf70_wifi_tx_power_calculation`.
593+
565594
.. group-tab:: FICR/OTP programming
566595

567596
* Use the following reference command interface to read or write the OTP params:

0 commit comments

Comments
 (0)