Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: wifi: Corrections to Regulatory Testing doc #21125

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
+110 −92
Open

doc: wifi: Corrections to Regulatory Testing doc #21125

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions doc/nrf/app_dev/device_guides/nrf70/power_profiling.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ To measure the power consumption of the nRF7002 DK, complete the following steps
.. code-block:: console

wifi scan
wifi connect <SSID>
wifi connect -s <SSID> -k <key_management> -p <passphrase>

#. Check the connection status using the following Wi-Fi shell command:

Expand All @@ -59,7 +59,7 @@ To measure the power consumption of the nRF7002 DK, complete the following steps
.. code-block:: console

wifi scan
wifi connect <SSID>
wifi connect -s <SSID> -k <key_management> -p <passphrase>

#. Check the connection status using the following Wi-Fi shell command:

Expand Down
2 changes: 1 addition & 1 deletion doc/nrf/protocols/wifi/regulatory_certification/adaptivity_test_procedure.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@ The following test procedure is recommended:

.. code-block:: bash

wifi connect <SSID> <Password>
wifi connect -s <SSID> -k <key_management> -p <passphrase>
wifi_util tx_rate 0 6
zperf udp upload 192.168.1.20 5001 20 1k 20M

Expand Down
18 changes: 9 additions & 9 deletions doc/nrf/protocols/wifi/regulatory_certification/antenna_gain_compensation.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,24 +42,24 @@ The following table shows an example of how to calculate the Kconfig parameter v
+-------------------+---------------------------+----------------------+--------------+--------------+--------------------+
| Bands | Kconfig parameter | Frequency range (MHz)| AntGain (dB) | PCBLoss (dB) | Kconfig value (dB) |
+===================+===========================+======================+==============+==============+====================+
| ANTGAIN_2G | NRF700X_ANT_GAIN_2G | 2402 to 2494 | 3.38 | 0.54 | 3 |
| ANTGAIN_2G | NRF70_ANT_GAIN_2G | 2402 to 2494 | 3.38 | 0.54 | 3 |
+-------------------+---------------------------+----------------------+--------------+--------------+--------------------+
| ANTGAIN_5G_BAND1 | NRF700X_ANT_GAIN_5G_BAND1 | 5150 to 5350 | 2.74 | 1.60 | 2 |
| ANTGAIN_5G_BAND1 | NRF70_ANT_GAIN_5G_BAND1 | 5150 to 5350 | 2.74 | 1.60 | 2 |
+-------------------+---------------------------+----------------------+--------------+--------------+--------------------+
| ANTGAIN_5G_BAND2 | NRF700X_ANT_GAIN_5G_BAND2 | 5470 to 5730 | 2.46 | 1.84 | 1 |
| ANTGAIN_5G_BAND2 | NRF70_ANT_GAIN_5G_BAND2 | 5470 to 5730 | 2.46 | 1.84 | 1 |
+-------------------+---------------------------+----------------------+--------------+--------------+--------------------+
| ANTGAIN_5G_BAND3 | NRF700X_ANT_GAIN_5G_BAND3 | 5730 to 5895 | 1.77 | 1.51 | 1 |
| ANTGAIN_5G_BAND3 | NRF70_ANT_GAIN_5G_BAND3 | 5730 to 5895 | 1.77 | 1.51 | 1 |
+-------------------+---------------------------+----------------------+--------------+--------------+--------------------+

Setting antenna gain parameters
*******************************

The Kconfig parameters and their default values are defined in the :file:`<ncs_repo>/nrf/drivers/wifi/nrf700x/Kconfig` file.
The Kconfig parameters and their default values are defined in the :file:`<ncs_repo>/zephyr/drivers/wifi/nrf_wifi/Kconfig.nrfwifi` file.
To compensate for antenna gains, set the following Kconfig parameters in the project :file:`prj.conf` configuration file.

* :kconfig:option:`CONFIG_NRF700X_ANT_GAIN_2G` = ``<ant gain value>``
* :kconfig:option:`CONFIG_NRF700X_ANT_GAIN_5G_BAND1` = ``<ant gain value>``
* :kconfig:option:`CONFIG_NRF700X_ANT_GAIN_5G_BAND2` = ``<ant gain value>``
* :kconfig:option:`CONFIG_NRF700X_ANT_GAIN_5G_BAND3` = ``<ant gain value>``
* :kconfig:option:`CONFIG_NRF70_ANT_GAIN_2G` = ``<ant gain value>``
* :kconfig:option:`CONFIG_NRF70_ANT_GAIN_5G_BAND1` = ``<ant gain value>``
* :kconfig:option:`CONFIG_NRF70_ANT_GAIN_5G_BAND2` = ``<ant gain value>``
* :kconfig:option:`CONFIG_NRF70_ANT_GAIN_5G_BAND3` = ``<ant gain value>``

The Kconfig parameters can also be set in a relevant overlay file or entered as command-line arguments to the CMake build.
108 changes: 54 additions & 54 deletions doc/nrf/protocols/wifi/regulatory_certification/band_edge_compensation.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ When applying backoff, consider the following:
* Backoff values also vary based on the frame type, affecting the maximum transmit power. Different backoff values are configured for each frame type.

Backoff values, which are expressed in dB, are inputs to the Wi-Fi® firmware driver through Kconfig parameters.
The Kconfig parameters are defined in the :file:`<ncs_repo>/nrf/drivers/wifi/nrf700x/Kconfig` file.
The Kconfig parameters are defined in the :file:`<ncs_repo>/zephyr/drivers/wifi/nrf_wifi/Kconfig.nrfwifi` file.

Set the Kconfig parameter values (which are positive numbers) according to the required backoff in the specific frequency band for the regulatory domain.
The default value of the Kconfig parameter is zero.
Expand All @@ -50,98 +50,98 @@ The following tables show the Kconfig parameters for lower and upper edge backof
+---------+-----------+---------------------------------------------------------------+
| Band | Frame type| Kconfig parameter for lower edge backoff |
+=========+===========+===============================================================+
| 2.4 GHz | DSSS | CONFIG_NRF700X_BAND_2G_LOWER_EDGE_BACKOFF_DSSS |
| 2.4 GHz | DSSS | CONFIG_NRF70_BAND_2G_LOWER_EDGE_BACKOFF_DSSS |
+ +-----------+---------------------------------------------------------------+
| | HT/V HT | CONFIG_NRF700X_BAND_2G_LOWER_EDGE_BACKOFF_HT |
| | HT/V HT | CONFIG_NRF70_BAND_2G_LOWER_EDGE_BACKOFF_HT |
+ +-----------+---------------------------------------------------------------+
| | HE | CONFIG_NRF700X_BAND_2G_LOWER_EDGE_BACKOFF_HE |
| | HE | CONFIG_NRF70_BAND_2G_LOWER_EDGE_BACKOFF_HE |
+---------+-----------+---------------------------------------------------------------+
| UNII-1 | HT/V HT | CONFIG_NRF700X_BAND_UNII_1_LOWER_EDGE_BACKOFF_HT |
| UNII-1 | HT/V HT | CONFIG_NRF70_BAND_UNII_1_LOWER_EDGE_BACKOFF_HT |
+ +-----------+---------------------------------------------------------------+
| | HE | CONFIG_NRF700X_BAND_UNII_1_LOWER_EDGE_BACKOFF_HE |
| | HE | CONFIG_NRF70_BAND_UNII_1_LOWER_EDGE_BACKOFF_HE |
+---------+-----------+---------------------------------------------------------------+
| UNII-2A | HT/V HT | CONFIG_NRF700X_BAND_UNII_2A_LOWER_EDGE_BACKOFF_HT |
| UNII-2A | HT/V HT | CONFIG_NRF70_BAND_UNII_2A_LOWER_EDGE_BACKOFF_HT |
+ +-----------+---------------------------------------------------------------+
| | HE | CONFIG_NRF700X_BAND_UNII_2A_LOWER_EDGE_BACKOFF_HE |
| | HE | CONFIG_NRF70_BAND_UNII_2A_LOWER_EDGE_BACKOFF_HE |
+---------+-----------+---------------------------------------------------------------+
| UNII-2C | HT/V HT | CONFIG_NRF700X_BAND_UNII_2C_LOWER_EDGE_BACKOFF_HT |
| UNII-2C | HT/V HT | CONFIG_NRF70_BAND_UNII_2C_LOWER_EDGE_BACKOFF_HT |
+ +-----------+---------------------------------------------------------------+
| | HE | CONFIG_NRF700X_BAND_UNII_2C_LOWER_EDGE_BACKOFF_HE |
| | HE | CONFIG_NRF70_BAND_UNII_2C_LOWER_EDGE_BACKOFF_HE |
+---------+-----------+---------------------------------------------------------------+
| UNII-3 | HT/V HT | CONFIG_NRF700X_BAND_UNII_3_LOWER_EDGE_BACKOFF_HT |
| UNII-3 | HT/V HT | CONFIG_NRF70_BAND_UNII_3_LOWER_EDGE_BACKOFF_HT |
+ +-----------+---------------------------------------------------------------+
| | HE | CONFIG_NRF700X_BAND_UNII_3_LOWER_EDGE_BACKOFF_HE |
| | HE | CONFIG_NRF70_BAND_UNII_3_LOWER_EDGE_BACKOFF_HE |
+---------+-----------+---------------------------------------------------------------+
| UNII-4 | HT/V HT | CONFIG_NRF700X_BAND_UNII_4_LOWER_EDGE_BACKOFF_HT |
| UNII-4 | HT/V HT | CONFIG_NRF70_BAND_UNII_4_LOWER_EDGE_BACKOFF_HT |
+ +-----------+---------------------------------------------------------------+
| | HE | CONFIG_NRF700X_BAND_UNII_4_LOWER_EDGE_BACKOFF_HE |
| | HE | CONFIG_NRF70_BAND_UNII_4_LOWER_EDGE_BACKOFF_HE |
+---------+-----------+---------------------------------------------------------------+

+---------+-----------+---------------------------------------------------------------+
| Band | Frame type| Kconfig parameter for upper edge backoff |
+=========+===========+===============================================================+
| 2.4 GHz | DSSS | CONFIG_NRF700X_BAND_2G_UPPER_EDGE_BACKOFF_DSSS |
| 2.4 GHz | DSSS | CONFIG_NRF70_BAND_2G_UPPER_EDGE_BACKOFF_DSSS |
+ +-----------+---------------------------------------------------------------+
| | HT/V HT | CONFIG_NRF700X_BAND_2G_UPPER_EDGE_BACKOFF_HT |
| | HT/V HT | CONFIG_NRF70_BAND_2G_UPPER_EDGE_BACKOFF_HT |
+ +-----------+---------------------------------------------------------------+
| | HE | CONFIG_NRF700X_BAND_2G_UPPER_EDGE_BACKOFF_HE |
| | HE | CONFIG_NRF70_BAND_2G_UPPER_EDGE_BACKOFF_HE |
+---------+-----------+---------------------------------------------------------------+
| UNII-1 | HT/V HT | CONFIG_NRF700X_BAND_UNII_1_UPPER_EDGE_BACKOFF_HT |
| UNII-1 | HT/V HT | CONFIG_NRF70_BAND_UNII_1_UPPER_EDGE_BACKOFF_HT |
+ +-----------+---------------------------------------------------------------+
| | HE | CONFIG_NRF700X_BAND_UNII_1_UPPER_EDGE_BACKOFF_HE |
| | HE | CONFIG_NRF70_BAND_UNII_1_UPPER_EDGE_BACKOFF_HE |
+---------+-----------+---------------------------------------------------------------+
| UNII-2A | HT/V HT | CONFIG_NRF700X_BAND_UNII_2A_UPPER_EDGE_BACKOFF_HT |
| UNII-2A | HT/V HT | CONFIG_NRF70_BAND_UNII_2A_UPPER_EDGE_BACKOFF_HT |
+ +-----------+---------------------------------------------------------------+
| | HE | CONFIG_NRF700X_BAND_UNII_2A_UPPER_EDGE_BACKOFF_HE |
| | HE | CONFIG_NRF70_BAND_UNII_2A_UPPER_EDGE_BACKOFF_HE |
+---------+-----------+---------------------------------------------------------------+
| UNII-2C | HT/V HT | CONFIG_NRF700X_BAND_UNII_2C_UPPER_EDGE_BACKOFF_HT |
| UNII-2C | HT/V HT | CONFIG_NRF70_BAND_UNII_2C_UPPER_EDGE_BACKOFF_HT |
+ +-----------+---------------------------------------------------------------+
| | HE | CONFIG_NRF700X_BAND_UNII_2C_UPPER_EDGE_BACKOFF_HE |
| | HE | CONFIG_NRF70_BAND_UNII_2C_UPPER_EDGE_BACKOFF_HE |
+---------+-----------+---------------------------------------------------------------+
| UNII-3 | HT/V HT | CONFIG_NRF700X_BAND_UNII_3_UPPER_EDGE_BACKOFF_HT |
| UNII-3 | HT/V HT | CONFIG_NRF70_BAND_UNII_3_UPPER_EDGE_BACKOFF_HT |
+ +-----------+---------------------------------------------------------------+
| | HE | CONFIG_NRF700X_BAND_UNII_3_UPPER_EDGE_BACKOFF_HE |
| | HE | CONFIG_NRF70_BAND_UNII_3_UPPER_EDGE_BACKOFF_HE |
+---------+-----------+---------------------------------------------------------------+
| UNII-4 | HT/V HT | CONFIG_NRF700X_BAND_UNII_4_UPPER_EDGE_BACKOFF_HT |
| UNII-4 | HT/V HT | CONFIG_NRF70_BAND_UNII_4_UPPER_EDGE_BACKOFF_HT |
+ +-----------+---------------------------------------------------------------+
| | HE | CONFIG_NRF700X_BAND_UNII_4_UPPER_EDGE_BACKOFF_HE |
| | HE | CONFIG_NRF70_BAND_UNII_4_UPPER_EDGE_BACKOFF_HE |
+---------+-----------+---------------------------------------------------------------+

Setting band edge parameters
****************************

Review if the transmission (TX) power of any band-edge channels requires backoff according to the active regulatory domain.
The Kconfig parameters and their default values are defined in the :file:`<ncs_repo>/nrf/drivers/wifi/nrf700x/Kconfig` file.
The Kconfig parameters and their default values are defined in the :file:`<ncs_repo>/zephyr/drivers/wifi/nrf_wifi/Kconfig.nrfwifi` file.
If backoff is needed, set the following Kconfig parameters to ``<backoff_dB>`` in the project :file:`prj.conf` configuration file.

Kconfig parameters for the lower edge backoff:

* :kconfig:option:`CONFIG_NRF700X_BAND_2G_LOWER_EDGE_BACKOFF_DSSS`
* :kconfig:option:`CONFIG_NRF700X_BAND_2G_LOWER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF700X_BAND_2G_LOWER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF700X_BAND_UNII_1_LOWER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF700X_BAND_UNII_1_LOWER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF700X_BAND_UNII_2A_LOWER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF700X_BAND_UNII_2A_LOWER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF700X_BAND_UNII_2C_LOWER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF700X_BAND_UNII_2C_LOWER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF700X_BAND_UNII_3_LOWER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF700X_BAND_UNII_3_LOWER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF700X_BAND_UNII_4_LOWER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF700X_BAND_UNII_4_LOWER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF70_BAND_2G_LOWER_EDGE_BACKOFF_DSSS`
* :kconfig:option:`CONFIG_NRF70_BAND_2G_LOWER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF70_BAND_2G_LOWER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF70_BAND_UNII_1_LOWER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF70_BAND_UNII_1_LOWER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF70_BAND_UNII_2A_LOWER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF70_BAND_UNII_2A_LOWER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF70_BAND_UNII_2C_LOWER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF70_BAND_UNII_2C_LOWER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF70_BAND_UNII_3_LOWER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF70_BAND_UNII_3_LOWER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF70_BAND_UNII_4_LOWER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF70_BAND_UNII_4_LOWER_EDGE_BACKOFF_HE`

Kconfig parameters for the upper edge backoff:

* :kconfig:option:`CONFIG_NRF700X_BAND_2G_UPPER_EDGE_BACKOFF_DSSS`
* :kconfig:option:`CONFIG_NRF700X_BAND_2G_UPPER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF700X_BAND_2G_UPPER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF700X_BAND_UNII_1_UPPER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF700X_BAND_UNII_1_UPPER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF700X_BAND_UNII_2A_UPPER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF700X_BAND_UNII_2A_UPPER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF700X_BAND_UNII_2C_UPPER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF700X_BAND_UNII_2C_UPPER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF700X_BAND_UNII_3_UPPER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF700X_BAND_UNII_3_UPPER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF700X_BAND_UNII_4_UPPER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF700X_BAND_UNII_4_UPPER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF70_BAND_2G_UPPER_EDGE_BACKOFF_DSSS`
* :kconfig:option:`CONFIG_NRF70_BAND_2G_UPPER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF70_BAND_2G_UPPER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF70_BAND_UNII_1_UPPER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF70_BAND_UNII_1_UPPER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF70_BAND_UNII_2A_UPPER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF70_BAND_UNII_2A_UPPER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF70_BAND_UNII_2C_UPPER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF70_BAND_UNII_2C_UPPER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF70_BAND_UNII_3_UPPER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF70_BAND_UNII_3_UPPER_EDGE_BACKOFF_HE`
* :kconfig:option:`CONFIG_NRF70_BAND_UNII_4_UPPER_EDGE_BACKOFF_HT`
* :kconfig:option:`CONFIG_NRF70_BAND_UNII_4_UPPER_EDGE_BACKOFF_HE`
2 changes: 1 addition & 1 deletion ...ification/radio_test_short_range_sample/ble_radio_test_for_per_measurements.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ Configure the transmitting device (DK or EK) to transmit 10000 packets (TX trans

Record the number of successfully received packets on the receiving device (DK or EK).
Repeat as necessary until the count stops incrementing.
RX success count is displayed as ``dsss_crc32_pass_cnt``.
RX success count is displayed as ``Number of packets:``.

.. code-block:: shell

Expand Down
Loading