Skip to content

Commit 4883868

Browse files
bjarki-andreasenbjarki-andreasen
committed
[nrf fromlist] boards: shields: add nrf7002eb
Add board support for the nrf7002eb shield. This shield uses the nordic edge-connector to be compatible with multiple boards. Signed-off-by: Bjarki Arge Andreasen <[email protected]> Upstream PR: zephyrproject-rtos/zephyr#78330
1 parent a0f173c commit 4883868

File tree

6 files changed

+154
-0
lines changed

6 files changed

+154
-0
lines changed

‎boards/shields/nrf7002eb/Kconfig.shield‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# Copyright (c) 2024 Nordic Semiconductor ASA
2+
# SPDX-License-Identifier: Apache-2.0
3+
4+
config SHIELD_NRF7002EB
5+
def_bool $(shields_list_contains,nrf7002eb)
6+
7+
config SHIELD_NRF7002EB_COEX
8+
def_bool $(shields_list_contains,nrf7002eb_coex)

‎boards/shields/nrf7002eb/boards/thingy53_nrf5340_cpuapp.overlay‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
/*
2+
* Copyright (c) 2024 Nordic Semiconductor ASA
3+
*
4+
* SPDX-License-Identifier: Apache-2.0
5+
*/
6+
7+
/*
8+
* This uses gpio0 pin 8 which conflicts with STATUS pin of Wi-Fi SR coex
9+
*/
10+
&npm1100_force_pwm_mode {
11+
status = "disabled";
12+
};
13+
14+
/*
15+
* Pins P0.9, P0.10, P0.11, P0.12 conflict with SPI4 and nrf7002 host irq
16+
*/
17+
&uart0 {
18+
status = "disabled";
19+
};

‎boards/shields/nrf7002eb/doc/index.rst‎

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
.. _nrf7002eb:
2+
3+
nRF7002 EB
4+
##########
5+
6+
Overview
7+
********
8+
9+
The nRF7002 EB is a versatile evaluation kit in the form of a thumbstick shield which connects to
10+
compatible Nordic host boards, like the Thingy53, using the Nordic edge-connector.
11+
12+
The nRF7002 EB unlocks low-power Wi-Fi 6 capabilities for your host device. It support dual-band Wi-Fi
13+
2.4GHz and 5GHz, and is based on the nRF7002 SoC.
14+
Seamlessly connect to Wi-Fi networks and leverage Wi-Fi-based locationing, enabling advanced
15+
features such as SSID sniffing of local Wi-Fi hubs
16+
17+
.. figure:: nrf7002eb.jpg
18+
:alt: nRF7002 EB
19+
:align: center
20+
21+
nRF7002 EB
22+
23+
Requirements
24+
************
25+
26+
The nRF7002 EB board is designed to fit straight into a Nordic edge-connector and uses SPI as the
27+
communication interface. Any host board that supports the Nordic edge-connector can be used with
28+
the nRF7002 EB.
29+
30+
Prerequisites
31+
-------------
32+
33+
the nRF70 driver requires firmware binary blobs for Wi-Fi operation. Run the command
34+
below to retrieve those files.
35+
36+
.. code-block:: console
37+
38+
west update
39+
west blobs fetch hal_nordic
40+
41+
Usage
42+
*****
43+
44+
The shield can be used in any application by setting ``--shield nrf7002eb`` when invoking ``west build``.
45+
46+
Shield Variants
47+
###############
48+
49+
The nRF7002 EK has a variant which includes the COEX pins. These pins are not be routed to the
50+
edge-connector on some boards, like earlier revisions of the Thingy53 than v1.0.0.
51+
52+
- ``nrf7002ek``: The default variant.
53+
- ``nrf7002ek_coex``: Variant which includes the COEX pins.
54+
55+
SR Co-existence
56+
###############
57+
58+
The nRF7002 EK supports SR co-existence provided the host board supports it. The SR co-existence
59+
pins are connected to the host board's GPIO pins.
60+
61+
Two Kconfig options are available to enable SR co-existence:
62+
63+
- :kconfig:option:`CONFIG_NRF70_SR_COEX`: Enables SR co-existence.
64+
- :kconfig:option:`CONFIG_NRF70_SR_COEX_RF_SWITCH`: Control SR side RF switch.
65+
66+
References
67+
**********
68+
69+
- `Developing with nRF7002 EB <https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/app_dev/device_guides/nrf70/nrf7002eb_dev_guide.html>`_
70+
- `nRF7002 EB product specification <https://infocenter.nordicsemi.com/topic/ug_nrf7002_eb/UG/nrf7002_EB/intro.html>`_
71+
- `nRF7002 product specification <https://infocenter.nordicsemi.com/index.jsp?topic=%2Fstruct_nrf70%2Fstruct%2Fnrf7002.html&cp=3_0>`_
72+
- `nRF7002 Co-existence <https://infocenter.nordicsemi.com/index.jsp?topic=%2Fps_nrf7002%2Fchapters%2Ffunctional%2Fdoc%2Fcoexistence.html&cp=3_0_0_7>`_

‎boards/shields/nrf7002eb/doc/nrf7002eb.jpg‎

61.2 KB
Loading

‎boards/shields/nrf7002eb/nrf7002eb.overlay‎

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
/*
2+
* Copyright (c) 2024 Nordic Semiconductor ASA
3+
*
4+
* SPDX-License-Identifier: Apache-2.0
5+
*/
6+
7+
#include <freq.h>
8+
9+
/ {
10+
chosen {
11+
zephyr,wifi = &wlan0;
12+
};
13+
};
14+
15+
&edge_connector_spi {
16+
status = "okay";
17+
18+
nrf70: nrf7002@0 {
19+
compatible = "nordic,nrf7002-spi";
20+
status = "okay";
21+
reg = <0>;
22+
spi-max-frequency = <DT_FREQ_M(8)>;
23+
24+
bucken-gpios = <&edge_connector 9 (GPIO_ACTIVE_HIGH | GPIO_PULL_DOWN)>;
25+
iovdd-ctrl-gpios = <&edge_connector 9 (GPIO_ACTIVE_HIGH | GPIO_PULL_DOWN)>;
26+
host-irq-gpios = <&edge_connector 19 GPIO_ACTIVE_HIGH>;
27+
28+
wlan0: wlan0 {
29+
compatible = "nordic,wlan";
30+
};
31+
32+
wifi-max-tx-pwr-2g-dsss = <21>;
33+
wifi-max-tx-pwr-2g-mcs0 = <16>;
34+
wifi-max-tx-pwr-2g-mcs7 = <16>;
35+
wifi-max-tx-pwr-5g-low-mcs0 = <13>;
36+
wifi-max-tx-pwr-5g-low-mcs7 = <13>;
37+
wifi-max-tx-pwr-5g-mid-mcs0 = <13>;
38+
wifi-max-tx-pwr-5g-mid-mcs7 = <13>;
39+
wifi-max-tx-pwr-5g-high-mcs0 = <12>;
40+
wifi-max-tx-pwr-5g-high-mcs7 = <12>;
41+
};
42+
};

‎boards/shields/nrf7002eb/nrf7002eb_coex.overlay‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
/*
2+
* Copyright (c) 2024 Nordic Semiconductor ASA
3+
*
4+
* SPDX-License-Identifier: Apache-2.0
5+
*/
6+
7+
#include "nrf7002eb.overlay"
8+
9+
&nrf70 {
10+
status0-gpios = <&edge_connector 5 GPIO_ACTIVE_HIGH>;
11+
req-gpios = <&edge_connector 6 GPIO_ACTIVE_HIGH>;
12+
grant-gpios = <&edge_connector 15 (GPIO_PULL_DOWN | GPIO_ACTIVE_LOW)>;
13+
};

0 commit comments

Comments
 (0)