# Copyright (c) 2021 Nordic Semiconductor ASA
# SPDX-License-Identifier: Apache-2.0

# NOTE: This file is replicated in nrf9160dk_nrf9160 and nrf9160dk_nrf52840.
#       Any changes should be done in both instances.

description: |
    nRF9160 DK GPIO interface between nRF9160 and nRF52840

    This interface can be used for inter-SoC communication on the DK.
    The connections are as follows:

    | nRF9160 |                            |    nRF52840    |
    |   P0.17 | -- nRF interface line 0 -- | P0.17          |
    |   P0.18 | -- nRF interface line 1 -- | P0.20          |
    |   P0.19 | -- nRF interface line 2 -- | P0.15          |
    |   P0.21 | -- nRF interface line 3 -- | P0.22          |
    |   P0.22 | -- nRF interface line 4 -- | P1.04          |
    |   P0.23 | -- nRF interface line 5 -- | P1.02          |
    |   COEX0 | -- nRF interface line 6 -- | P1.13          |
    |   COEX1 | -- nRF interface line 7 -- | P1.11          |
    |   COEX2 | -- nRF interface line 8 -- | P1.15          |
    |   P0.24 | -- nRF interface line 9 -- | P0.18 (nRESET) | (in v0.14.0 or later)

    Before particular lines of this interface can be used, the corresponding
    analog switches that control the routing of involved nRF9160 pins must be
    configured to provide the optional routing (i.e. to nRF52840). To achieve
    this, set the status of respective devicetree nodes in the firmware for
    the nrf9160dk_nrf52840 board to "okay":
    - `nrf_interface_pins_0_2_routing` to enable lines 0-2
    - `nrf_interface_pins_3_5_routing` to enable lines 3-5
    - `nrf_interface_pins_6_8_routing` to enable lines 6-8
    - `nrf_interface_pin_9_routing` to enable line 9 (this line is only
      available in nRF9160 DK v0.14.0 or later)

    NOTE: In nRF9160 DK revisions earlier than v0.14.0, when the above signals
          from nRF9160 are routed to nRF52840, they are not available on the DK
          connectors.

compatible: "nordic,nrf9160dk-nrf52840-interface"

include: [gpio-nexus.yaml, base.yaml]