-
Notifications
You must be signed in to change notification settings - Fork 1.2k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
This adds support for FEM in Zigbee examples. This is mainly docs updates plus a few overlay files for nRF21540. Edited FEM section in Thread samples to match Zigbee. Replaced tag-based resure sections with an include tag. Signed-off-by: Wojciech Bober <wojciech.bober@nordicsemi.no>
- Loading branch information
Showing
14 changed files
with
133 additions
and
47 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,31 @@ | ||
.. note:: | ||
Software FEM support is not present on nRF53 Series devices yet. | ||
For now, it also cannot be combined with multiprotocol operation. | ||
|
||
You can add support for the nRF21540 front-end module to the sample. | ||
See :ref:`ug_radio_fem` for more information. | ||
|
||
To add support for the nRF21540 FEM, add the provided :file:`dts-nrf21540-fem.overlay` devicetree overlay file when building. | ||
The file is located in the |fem_file_path| folder. | ||
Make sure that the GPIOs in the file correspond to those in which your front-end module is connected. | ||
|
||
.. note:: | ||
You must add the provided overlay file if you use the nRF21540 EK. | ||
If you use the nRF21540 DK, build your application for the :ref:`nrf21540dk_nrf52840 <zephyr:nrf21540dk_nrf52840>` board. | ||
The devicetree for the nRF21540 DK already contains the required FEM configuration, so you do not need to add the overlay file. | ||
|
||
See :ref:`zephyr:set-devicetree-overlays` for different ways of adding the overlay file. | ||
|
||
The easiest way to add the file when building is to set it in the ``DTC_OVERLAY_FILE`` variable. | ||
However, doing so will override the default settings. | ||
For some boards, this sample requires additional overlay files, which are automatically included when building with the default settings. | ||
When you set the ``DTC_OVERLAY_FILE`` variable, you must specify all overlay files that are needed for building. | ||
Check the :file:`boards` folder to see the additional overlay files. | ||
|
||
Follow the instructions in :ref:`cmake_options` to specify the ``DTC_OVERLAY_FILE`` variable. | ||
For example, to build the sample from the command line for an nRF52833 DK with an attached nRF21540 EK, invoke the following command within the sample directory: | ||
``west build -b nrf52833dk_nrf52833 -- -DDTC_OVERLAY_FILE="boards/nrf52833dk_nrf52833.overlay;../common/dts-nrf21540-fem.overlay"`` | ||
|
||
Alternatively, you can copy the contents of :file:`dts-nrf21540-fem.overlay` to the board's overlay file. | ||
|
||
To add support for other front-end modules, add the respective overlay files in the same way. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,14 @@ | ||
/* Copyright (c) 2021 Nordic Semiconductor ASA | ||
* | ||
* SPDX-License-Identifier: LicenseRef-BSD-5-Clause-Nordic | ||
*/ | ||
|
||
/ { | ||
nrf_radio_fem: nrf21540_fem { | ||
compatible = "nordic,nrf21540-fem"; | ||
tx-en-gpios = <&gpio1 4 GPIO_ACTIVE_HIGH>; | ||
rx-en-gpios = <&gpio1 5 GPIO_ACTIVE_HIGH>; | ||
pdn-gpios = <&gpio1 6 GPIO_ACTIVE_HIGH>; | ||
ant-sel-gpios = <&gpio1 7 GPIO_ACTIVE_HIGH>; | ||
}; | ||
}; |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
11 changes: 11 additions & 0 deletions
11
samples/zigbee/light_bulb/boards/nrf21540dk_nrf52840.overlay
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,11 @@ | ||
/* | ||
* Copyright (c) 2021 Nordic Semiconductor ASA | ||
* | ||
* SPDX-License-Identifier: LicenseRef-BSD-5-Clause-Nordic | ||
*/ | ||
|
||
/ { | ||
chosen { | ||
zephyr,entropy = &rng; | ||
}; | ||
}; |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
11 changes: 11 additions & 0 deletions
11
samples/zigbee/light_switch/boards/nrf21540dk_nrf52840.overlay
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,11 @@ | ||
/* | ||
* Copyright (c) 2021 Nordic Semiconductor ASA | ||
* | ||
* SPDX-License-Identifier: LicenseRef-BSD-5-Clause-Nordic | ||
*/ | ||
|
||
/ { | ||
chosen { | ||
zephyr,entropy = &rng; | ||
}; | ||
}; |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
11 changes: 11 additions & 0 deletions
11
samples/zigbee/network_coordinator/boards/nrf21540dk_nrf52840.overlay
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,11 @@ | ||
/* | ||
* Copyright (c) 2021 Nordic Semiconductor ASA | ||
* | ||
* SPDX-License-Identifier: LicenseRef-BSD-5-Clause-Nordic | ||
*/ | ||
|
||
/ { | ||
chosen { | ||
zephyr,entropy = &rng; | ||
}; | ||
}; |