Skip to content

Commit febfded

Browse files
bama-nordicnordicjm
bama-nordic
authored and
nordicjm
committed
doc: shield: initial EB II documentation
documenation of the Wi-Fi EB II shield for nRF54 series DKs Signed-off-by: Bansidhar Mangalwedhekar <[email protected]>
1 parent 3b3b01f commit febfded

File tree

4 files changed

+141
-2
lines changed

4 files changed

+141
-2
lines changed

‎doc/nrf/app_dev/device_guides/nrf70/images/nRF7002eb2.png‎

192 KB
Loading

‎doc/nrf/app_dev/device_guides/nrf70/index.rst‎

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,6 @@ Zephyr and the |NCS| provide support for developing networking applications with
8585
| :ref:`Developing with nRF54L Series <ug_nrf54l15_gs>`
8686
8787

88-
8988
The following nRF70 Series shields are available and defined in the :file:`nrf/boards/shields` folder:
9089

9190
.. list-table::
@@ -110,11 +109,15 @@ The following nRF70 Series shields are available and defined in the :file:`nrf/b
110109
- ``nrf7002ek/nrf7000``
111110
- | :ref:`Development guide <ug_nrf7002ek_gs>`
112111
| `User Guide <nRF7002 EK User Guide_>`_
113-
* - nRF7002 :term:`Expansion Board (EB)`
112+
* - nRF7002 :term:`Expansion Board (EB)` (Deprecated)
114113
- PCA63561
115114
- ``nrf7002eb``, ``nrf7002eb_interposer_p1`` (nRF54 Series)
116115
- | :ref:`Development guide <ug_nrf7002eb_gs>`
117116
| `User Guide <nRF7002 EB User Guide_>`_
117+
* - nRF7002-EB II
118+
- PCA63571
119+
- ``nrf7002eb2`` (nRF54 Series, supersedes ``nrf7002eb`` for nRF54 Series DKs)
120+
- | :ref:`Development guide <ug_nrf7002eb2_gs>`
118121

119122
Applications can be developed on the nRF7002 DK (PCA10143), which includes the nRF7002 companion IC, or on boards compatible with the nRF7002 EK (PCA63556) or the nRF7002 EB (PCA63561).
120123

@@ -132,4 +135,5 @@ The following subpages cover topics related to developing applications with the
132135
power_profiling
133136
nrf7002ek_dev_guide
134137
nrf7002eb_dev_guide
138+
nrf7002eb2_dev_guide
135139
wifi_advanced_security_modes

‎doc/nrf/app_dev/device_guides/nrf70/nrf7002eb2_dev_guide.rst‎

Lines changed: 130 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,130 @@
1+
.. _ug_nrf7002eb2_gs:
2+
3+
Developing with nRF7002-EB II
4+
#############################
5+
6+
.. contents::
7+
:local:
8+
:depth: 2
9+
10+
The nRF7002 :term:`Expansion Board (EB)` II (PCA63571), part of the `nRF70 Series Family <nRF70 Series product page_>`_, can be used to provide Wi-Fi® connectivity to compatible development or evaluation boards through the nRF7002 Wi-Fi 6 companion IC.
11+
12+
You can use the nRF7002-EB II to provide Wi-Fi connectivity to the :ref:`zephyr:nrf54h20dk_nrf54h20` and :ref:`zephyr:nrf54l15dk_nrf54l15` board targets.
13+
14+
.. figure:: images/nRF7002eb2.png
15+
:alt: nRF7002-EB II
16+
17+
nRF7002-EB II
18+
19+
Pin mapping for the nRF54H20 DK and the nRF54L15 DK
20+
***************************************************
21+
22+
For nRF54H20 DK and nRF54L15 DK, refer to the following tables for the pin mapping for these kits.
23+
The board is mounted on the **P1** connector of these DKs
24+
25+
.. tabs::
26+
27+
.. group-tab:: nRF54L15 DK
28+
29+
+-----------------------------------+-------------------+-----------------------------------------------+
30+
| nRF70 Series pin name (EB name) | nRF54L15 DK pins | Function |
31+
+===================================+===================+===============================================+
32+
| CLK (CLK) | P1.04 | SPI Clock |
33+
+-----------------------------------+-------------------+-----------------------------------------------+
34+
| CS (CS) | P1.07 | SPI Chip Select |
35+
+-----------------------------------+-------------------+-----------------------------------------------+
36+
| MOSI (D0) | P1.06 | SPI MOSI |
37+
+-----------------------------------+-------------------+-----------------------------------------------+
38+
| MISO (D1) | P1.06 | SPI MISO |
39+
+-----------------------------------+-------------------+-----------------------------------------------+
40+
| BUCKEN (EN) | P1.12 | Enable Buck regulator |
41+
+-----------------------------------+-------------------+-----------------------------------------------+
42+
| IOVDDEN | P1.11 | Enable IOVDD regulator |
43+
+-----------------------------------+-------------------+-----------------------------------------------+
44+
| IRQ (IRQ) | P1.10 | Interrupt from nRF7002 |
45+
+-----------------------------------+-------------------+-----------------------------------------------+
46+
| GRANT (GRT) | P1.13 | Coexistence grant from nRF7002 |
47+
+-----------------------------------+-------------------+-----------------------------------------------+
48+
| REQ (REQ) | P1.09 | Coexistence request to nRF7002 |
49+
+-----------------------------------+-------------------+-----------------------------------------------+
50+
| STATUS (ST0) | P1.08 | Coexistence status from nRF7002 |
51+
+-----------------------------------+-------------------+-----------------------------------------------+
52+
53+
.. group-tab:: nRF54H20 DK
54+
55+
+-----------------------------------+-------------------+-----------------------------------------------+
56+
| nRF70 Series pin name (EB name) | nRF54H20 DK pins | Function |
57+
+===================================+===================+===============================================+
58+
| CLK (CLK) | P1.01 | SPI Clock |
59+
+-----------------------------------+-------------------+-----------------------------------------------+
60+
| CS (CS) | P1.07 | SPI Chip Select |
61+
+-----------------------------------+-------------------+-----------------------------------------------+
62+
| MOSI (D0) | P1.06 | SPI MOSI |
63+
+-----------------------------------+-------------------+-----------------------------------------------+
64+
| MISO (D1) | P1.05 | SPI MISO |
65+
+-----------------------------------+-------------------+-----------------------------------------------+
66+
| BUCKEN (EN) | P1.02 | Enable Buck regulator |
67+
+-----------------------------------+-------------------+-----------------------------------------------+
68+
| IOVDDEN | P1.04 | Enable IOVDD regulator |
69+
+-----------------------------------+-------------------+-----------------------------------------------+
70+
| IRQ (IRQ) | P1.10 | Interrupt from nRF7002 |
71+
+-----------------------------------+-------------------+-----------------------------------------------+
72+
| GRANT (GRT) | P1.03 | Coexistence grant from nRF7002 |
73+
+-----------------------------------+-------------------+-----------------------------------------------+
74+
| REQ (REQ) | P1.09 | Coexistence request to nRF7002 |
75+
+-----------------------------------+-------------------+-----------------------------------------------+
76+
| STATUS (ST0) | P1.08 | Coexistence status from nRF7002 |
77+
+-----------------------------------+-------------------+-----------------------------------------------+
78+
79+
DIP switch settings for nRF54L15 DK and nRF54H20 DK
80+
***************************************************
81+
82+
The **GPIO MAP SEL** switch on the nRF7002-EB II can be used to select the GPIO mapping for the nRF54H20 DK and the nRF54L15 DK.
83+
84+
* **nRF54L15 DK**: Set the switch towards MAP1 (the LED will glow at the **MAP1** end).
85+
* **nRF54H20 DK**: Set the switch towards MAP2 (the LED will glow at the **MAP2** end).
86+
87+
.. _nrf7002eb2_building_programming:
88+
89+
Building and programming with nRF7002-EB II
90+
*******************************************
91+
92+
To build for the nRF7002-EB II, use a compatible :ref:`board target <app_boards_names>` with the CMake ``SHIELD`` option set to the corresponding shield name.
93+
See :ref:`cmake_options` for instructions on how to provide CMake options.
94+
95+
For example, if you build the :ref:`wifi_shell_sample` sample for nRF54L15 DK on the command line, use the following command:
96+
97+
.. code-block:: console
98+
99+
west build -p -b nrf54l15dk/nrf54l15/cpuapp -- -Dshell_SHIELD="nrf7002eb2" -Dshell_SNIPPET=nrf70-wifi
100+
101+
If you use the |nRFVSC|, specify ``-DSHIELD=nrf7002eb2`` in the **Extra Cmake arguments** field when `setting up a build configuration <How to work with build configurations_>`_.
102+
103+
Alternatively, add the shield in the project's :file:`CMakeLists.txt` file by using the following command:
104+
105+
.. code-block:: console
106+
107+
set(SHIELD nrf7002eb2)
108+
109+
To build for the nRF7002-EB II with nRF54H20 DK, use the ``nrf54h20dk/nrf54h20/cpuapp`` board target with the CMake ``SHIELD`` variable set to ``nrf7002eb2``.
110+
To build for a custom target, set ``-DSHIELD="nrf7002eb2"`` when you invoke ``west build`` or ``cmake`` in your |NCS| application.
111+
112+
Alternatively, you can add the shield in the project's :file:`CMakeLists.txt` file by using the ``set(SHIELD nrf7002eb2)`` command.
113+
114+
To build for the nRF7002-EB II with the nRF54L15 DK, use the ``nrf54l15dk/nrf54l15/cpuapp`` board target with the CMake ``SHIELD`` variable set to ``nrf7002eb2``.
115+
To build for a custom target, set ``-DSHIELD="nrf7002eb2"`` when you invoke ``west build`` or ``cmake`` in your |NCS| application.
116+
117+
Alternatively, you can add the shield in the project's :file:`CMakeLists.txt` file by using the ``set(SHIELD nrf7002eb2)`` command.
118+
119+
To build with coexistence mode enabled, set ``-DSHIELD="nrf7002eb2;nrf7002eb2_coex"`` when you invoke ``west build`` or ``cmake`` in your |NCS| application.
120+
For optimal build configuration, use the ``nrf70-wifi`` snippet.
121+
122+
Limitations when building with nRF54H20 DK and nRF54L15 DK
123+
**********************************************************
124+
125+
The Wi-Fi support is experimental and has the following limitations:
126+
127+
* It is suitable only for low-throughput applications.
128+
* The Wi-Fi performance is not optimized.
129+
* Limited number of Wi-Fi samples are supported on nRF54H20 DK.
130+
Refer to the :ref:`wifi_samples` documentation for the supported samples.

‎doc/nrf/app_dev/device_guides/nrf70/nrf7002eb_dev_guide.rst‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,11 @@ Developing with nRF7002 EB
1212
The nRF7002 :term:`Expansion Board (EB)` (PCA63561), part of the `nRF70 Series Family <nRF70 Series product page_>`_, can be used to provide Wi-Fi® connectivity to compatible development or evaluation boards through the nRF7002 Wi-Fi 6 companion IC.
1313
For example, you can use it with the :ref:`Nordic Thingy:53 <ug_thingy53>`, an IoT prototyping platform from Nordic Semiconductor.
1414

15+
.. note::
16+
.. deprecated:: v3.0.0
17+
Support for the nRF7002 EB is deprecated for all boards except the Thingy:53.
18+
This support will be removed in the next major release of the |NCS|.
19+
1520
You can also use the nRF7002 EB to provide Wi-Fi connectivity to the :ref:`zephyr:nrf54h20dk_nrf54h20` and :ref:`zephyr:nrf54l15dk_nrf54l15`.
1621

1722
.. figure:: images/nRF7002eb.png

0 commit comments

Comments
 (0)