:orphan:
.. raw:: html
.. dtcompatible:: nordic,nrf-radio
.. _dtbinding_nordic_nrf_radio:
nordic,nrf-radio
################
Vendor: :ref:`Nordic Semiconductor `
Description
***********
.. code-block:: none
Nordic nRF family RADIO
dfegpio[n]-gpios properties provide GPIO pins to the radio peripheral. These
GPIO pins are used to drive antennas switching by Radio Direction Finding
Extension. E.g. to use 12 antennas 4 GPIO pins must be provided;
4 GPIO pins support switching up to 16 antennas.
The dfegpio[n] properties are used to initialize the PSEL.DFEGPIO[n]
registers. None of the dfegpio[n]-gpios properties are marked required,
since which Radio PSEL.DFEGPIO[n] registers will be used to drive antenna
switches depends on the use case.
Nevertheless, at least two antennas must be available. That means at
least one dfegpio[n]-gpios property must be provided, to give the radio
the possibility to switch between two antennas.
Properties
**********
.. tabs::
.. group-tab:: Node specific properties
Properties not inherited from the base binding file.
.. list-table::
:widths: 1 1 4
:header-rows: 1
* - Name
- Type
- Details
* - ``dfe-antenna-num``
- ``int``
- .. code-block:: none
Number of available antennas.
Value zero means no antenna available. If provided value different than
zero, it must be greater or equal to two.
This property is **required**.
* - ``dfe-pdu-antenna``
- ``int``
- .. code-block:: none
Antenna switch pattern to be used for transmission of PDU before start
of transmission of Constant Tone Extension.
This pattern is stored in SWITCHPATTERN[0] before store actual antenna
switching patterns. This pattern will be also used to drive GPIOs
when Radio releases control of GPIOs used to switch antenna.
This property is **required**.
* - ``dfegpio0-gpios``
- ``phandle-array``
- .. code-block:: none
Pin select for DFE pin 0
Flags cell in the property is not used for GPIO pin initialization
and should be set to zero.
* - ``dfegpio1-gpios``
- ``phandle-array``
- .. code-block:: none
Pin select for DFE pin 1
Flags cell in the property is not used for GPIO pin initialization
and should be set to zero.
* - ``dfegpio2-gpios``
- ``phandle-array``
- .. code-block:: none
Pin select for DFE pin 2
Flags cell in the property is not used for GPIO pin initialization
and should be set to zero.
* - ``dfegpio3-gpios``
- ``phandle-array``
- .. code-block:: none
Pin select for DFE pin 3
Flags cell in the property is not used for GPIO pin initialization
and should be set to zero.
* - ``dfegpio4-gpios``
- ``phandle-array``
- .. code-block:: none
Pin select for DFE pin 4
Flags cell in the property is not used for GPIO pin initialization
and should be set to zero.
* - ``dfegpio5-gpios``
- ``phandle-array``
- .. code-block:: none
Pin select for DFE pin 5
Flags cell in the property is not used for GPIO pin initialization
and should be set to zero.
* - ``dfegpio6-gpios``
- ``phandle-array``
- .. code-block:: none
Pin select for DFE pin 6
Flags cell in the property is not used for GPIO pin initialization
and should be set to zero.
* - ``dfegpio7-gpios``
- ``phandle-array``
- .. code-block:: none
Pin select for DFE pin 7
Flags cell in the property is not used for GPIO pin initialization
and should be set to zero.
.. group-tab:: Deprecated node specific properties
Deprecated properties not inherited from the base binding file.
(None)
.. group-tab:: Base properties
Properties inherited from the base binding file, which defines
common properties that may be set on many nodes. Not all of these
may apply to the "nordic,nrf-radio" compatible.
.. list-table::
:widths: 1 1 4
:header-rows: 1
* - Name
- Type
- Details
* - ``reg``
- ``array``
- .. code-block:: none
register space
This property is **required**.
See :ref:`zephyr:dt-important-props` for more information.
* - ``interrupts``
- ``array``
- .. code-block:: none
interrupts for device
This property is **required**.
See :ref:`zephyr:dt-important-props` for more information.
* - ``status``
- ``string``
- .. code-block:: none
indicates the operational status of a device
Legal values: ``'ok'``, ``'okay'``, ``'disabled'``, ``'reserved'``, ``'fail'``, ``'fail-sss'``
See :ref:`zephyr:dt-important-props` for more information.
* - ``compatible``
- ``string-array``
- .. code-block:: none
compatible strings
This property is **required**.
See :ref:`zephyr:dt-important-props` for more information.
* - ``reg-names``
- ``string-array``
- .. code-block:: none
name of each register space
* - ``interrupts-extended``
- ``compound``
- .. code-block:: none
extended interrupt specifier for device
* - ``interrupt-names``
- ``string-array``
- .. code-block:: none
name of each interrupt
* - ``interrupt-parent``
- ``phandle``
- .. code-block:: none
phandle to interrupt controller node
* - ``label``
- ``string``
- .. code-block:: none
Human readable string describing the device (used as device_get_binding() argument)
See :ref:`zephyr:dt-important-props` for more information.
* - ``clocks``
- ``phandle-array``
- .. code-block:: none
Clock gate information
* - ``clock-names``
- ``string-array``
- .. code-block:: none
name of each clock
* - ``#address-cells``
- ``int``
- .. code-block:: none
number of address cells in reg property
* - ``#size-cells``
- ``int``
- .. code-block:: none
number of size cells in reg property
* - ``dmas``
- ``phandle-array``
- .. code-block:: none
DMA channels specifiers
* - ``dma-names``
- ``string-array``
- .. code-block:: none
Provided names of DMA channel specifiers
* - ``io-channels``
- ``phandle-array``
- .. code-block:: none
IO channels specifiers
* - ``io-channel-names``
- ``string-array``
- .. code-block:: none
Provided names of IO channel specifiers