Skip to content

Commit

Permalink
doc: add support for nrf21540_gpio for nrf54l
Browse files Browse the repository at this point in the history
The documentation regarding nRF21540 in GPIO mode is updated to mention
support for the nRF54L SoCs.

Signed-off-by: Andrzej Kuros <[email protected]>
  • Loading branch information
ankuns committed Feb 17, 2025
1 parent d9da6b5 commit 45e5950
Show file tree
Hide file tree
Showing 3 changed files with 44 additions and 2 deletions.
43 changes: 42 additions & 1 deletion doc/nrf/app_dev/device_guides/fem/fem_nrf21540_gpio.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
Enabling GPIO mode support for nRF21540
#######################################

The `nRF21540`_ device is a range extender that you can use with nRF52 and nRF53 Series devices.
The `nRF21540`_ device is a range extender that you can use with nRF52, nRF53 and nRF54L Series devices.
The nRF21540 GPIO mode implementation of FEM is compatible with the nRF21540 device and implements the 3-pin PA/LNA interface.

.. ncs_implementation_desc_start
Expand Down Expand Up @@ -74,3 +74,44 @@ To use nRF21540 in GPIO mode, complete the following steps:
};
The pins defined in the GPIO forwarder node in the application core's devicetree file must match the pins defined in the FEM nodes in the network core's devicetree file.

#. On nRF54L devices, the GPIO pins of the SoC selected to control ``tx-en-gpios``, ``rx-en-gpios`` and ``pdn-gpios`` must support GPIOTE.
For example, on the nRF54L15 device, only pins belonging to GPIO P1 or GPIO P0 can be used and GPIO P2 pins cannot be used due to lack of related GPIOTE peripheral.
It is recommended for mentioned purpose to use these GPIO pins that belong to the PERI Power Domain of the nRF54L device.
For example, on the nRF54L15, these are pins belonging to GPIO P1.
Using pins belonging to Low Power Domain (GPIO P0 on nRF54L15) is supported but requires more DPPI and PPIB channels of the SoC.
The nRF54L devices contain only four PPIB channels between PERI Power Domain and Low Power Domain.
Due to this limitation, only two out of three pins from group ``tx-en-gpios``, ``rx-en-gpios`` and ``pdn-gpios`` (for example, ``tx-en-gpios`` and ``rx-en-gpios``) can be controlled by GPIO P0.
The one remaining pin of the pin group (for example ``pdn-gpios``) must be controlled by other GPIO port.
To ensure proper timing set the ``tx-en-settle-time-us`` and ``rx-en-settle-time-us`` devicetree properties of the ``nrf_radio_fem`` node to the value ``12``.
You must also enable appropriate instances of ``DPPIC`` and ``PPIB`` peripherals in the devicetree file:

.. code-block:: devicetree
&dppic10 {
status = "okay";
};
&ppib11 {
status = "okay";
};
&ppib21 {
status = "okay";
};
&dppic20 {
status = "okay";
};
&ppib22 {
status = "okay";
};
&ppib30 {
status = "okay";
};
&dppic30 {
status = "okay";
};
2 changes: 1 addition & 1 deletion doc/nrf/app_dev/device_guides/fem/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Zephyr and the |NCS| provides support for developing applications with the follo
- nRF52, nRF53, nRF54L
* - nRF21540
- nRF21540 GPIO
- nRF52, nRF53
- nRF52, nRF53, nRF54L
* - nRF21540
- nRF21540 GPIO+SPI
- nRF52, nRF53
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -96,6 +96,7 @@ Developing with Front-End Modules

* :ref:`nRF2220 Front-End Module <ug_radio_fem_nrf2220>`.
* :ref:`nRF2220 EK shield <ug_radio_fem_nrf2220ek>`.
* :ref:`nRF21540 Front-End Module in GPIO mode <ug_radio_fem_nrf21540_gpio>` for the nRF54L Series devices.

Developing with PMICs
=====================
Expand Down

0 comments on commit 45e5950

Please sign in to comment.