Skip to content

Commit 0da8ac9

Browse files
prsi98rlubos
authored andcommitted
doc: nrf: drivers: Add TX power calculation
[SHEL-3276] Add TX power calculation in nrf70 driver documentation. Signed-off-by: Prasun Sinha <[email protected]>
1 parent c32a7da commit 0da8ac9

File tree

4 files changed

+32
-2
lines changed

4 files changed

+32
-2
lines changed

CODEOWNERS

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,7 @@
9999
/doc/nrf/drivers/sensor_sim.rst @nrfconnect/ncs-si-muffin-doc
100100
/doc/nrf/drivers/sensor_stub.rst @nrfconnect/ncs-si-muffin-doc
101101
/doc/nrf/drivers/uart_ipc.rst @nrfconnect/ncs-doc-leads
102-
/doc/nrf/drivers/wifi/ @sachinthegreen @krish2718
102+
/doc/nrf/drivers/wifi/*.rst @nrfconnect/ncs-wifi-doc
103103
/doc/nrf/drivers/wifi.rst @nrfconnect/ncs-wifi-doc
104104
/doc/nrf/drivers/uart_nrf_sw_lpuart.rst @nrfconnect/ncs-doc-leads
105105
/doc/nrf/external_comp/avsystem.rst @nrfconnect/ncs-iot-oulu-tampere-doc

doc/nrf/drivers/wifi/nrf70_native.rst

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -118,3 +118,31 @@ To configure 15 dBm, use the value ``15``.
118118
};
119119
120120
See the DTS binding documentation for more information.
121+
122+
.. _nrf70_wifi_tx_power_calculation:
123+
124+
TX power calculation
125+
********************
126+
127+
This section describes how to determine the accurate transmit (TX) power on the nRF70 Series development platforms.
128+
The driver will always attempt to set the TX power to the maximum supported level, while ensuring the following constraints are met:
129+
130+
* EVM and Spectral Emission Mask (SEM) for the modulation type or data rate (IEEE 802.11 requirement).
131+
* In-band regulatory power limits (FCC and CE certification requirements).
132+
* Out-of-band regulatory power limits (FCC and CE certification requirements).
133+
134+
You can calculate the TX power by using the following formula:
135+
136+
.. math::
137+
\begin{aligned}
138+
\text{TX power} = \min \left( (P_{\text{reg}} - \text{AntGain}), P_{\text{max}} \right) - \text{EdgeBackoff}
139+
\end{aligned}
140+
141+
where the following parameters are used:
142+
143+
* :math:`P_\text{reg}` is the applicable regulatory power limit, as described in :ref:`ug_nrf70_developing_regulatory_support`.
144+
* ``AntGain`` is the compensation for the antenna gain in the TX direction, as described in `Antenna gain compensation`_.
145+
* ``EdgeBackoff`` is the backoff applied to band edge channels, as described in `Band edge compensation`_.
146+
* :math:`P_\text{max} = min (P_\text{ps} , P_\text{max-tx-pwr})`
147+
* :math:`P_\text{ps}` is the maximum power level for the package type, modulation, and band as described in `Electrical specification for nRF7002`_.
148+
* :math:`P_\text{max-tx-pwr}` is the sub-band power limit, dependent on the PCB design.

doc/nrf/links.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -770,6 +770,8 @@
770770
.. _`nRF7002 EB castellated edge holes`: https://docs.nordicsemi.com/bundle/ug_nrf7002_eb/page/UG/nrf7002_EB/castellated_mounting_holes.html
771771
.. _`nRF7002 EK`: https://docs.nordicsemi.com/bundle/ug_nrf7002_ek/page/UG/nrf7002_EK/intro.html
772772
.. _`nRF7002 companion IC`: https://docs.nordicsemi.com/bundle/ug_nrf7002_ek/page/UG/nrf7002_EK/hw_wifi_companion_ic.html
773+
.. _`Antenna gain compensation`: https://docs.nordicsemi.com/bundle/nan_046/page/APP/nan_046/antenna_compensation.html
774+
.. _`Band edge compensation`: https://docs.nordicsemi.com/bundle/nan_046/page/APP/nan_046/band_compensation.html
773775

774776
.. _`Programming SoCs with nrfjprog`: https://docs.nordicsemi.com/bundle/ug_nrf_cltools/page/UG/cltools/nrf_nrfjprogexe.html
775777

doc/nrf/releases_and_maturity/releases/release-notes-changelog.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -487,7 +487,7 @@ This section provides detailed lists of changes by :ref:`driver <drivers>`.
487487
Wi-Fi drivers
488488
-------------
489489

490-
|no_changes_yet_note|
490+
* Added the :ref:`nrf70_wifi_tx_power_calculation` section to the :ref:`nrf70_wifi` page.
491491

492492
Libraries
493493
=========

0 commit comments

Comments
 (0)