build/dts/api/bindings/gpio/adi,sdp-120.html · build/dts/api/bindings/gpio/adi,sdp-120.rst 공식 원문 ↗

Zephyr 3.7.0 · Devicetree · GPIO · Analog Devices, Inc.

ADI 120-pin SDP GPIO Nexus 바인딩

SDP 120-pin signal layout·GPIO nexus translation를 정의하는 28개 property schema입니다.

Official pathbuild/dts/api/bindings/gpio/adi,sdp-120.html
Source filebuild/dts/api/bindings/gpio/adi,sdp-120.rst
Source versionZephyr 3.7.0
TranslationFull · reviewed

본문 기준: Zephyr 3.7.0 LTS3 · 이후 유지보수 패치는 별도입니다.

Part 1

요약·해설

공식 원문 350줄과 property 28행을 전수 대조해 120 physical pins·parallel/SPORT/SPI/I2C/GPIO/UART signals·nexus mapping 제약을 보존했습니다.

Compatible

adi,sdp-120

Vendor

Analog Devices, Inc.

Properties

28 rows

Interface

120-pin SDP nexus

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 05E8038D8F525AAE96CB6C7E4D9AD1BEB87A9F974242DB75A1CB722ADF424932
:orphan:

.. raw:: html

    <!--
    FIXME: do not limit page width until content uses another representation
    format other than tables
    -->
    <style>.wy-nav-content { max-width: none; !important }</style>

.. dtcompatible:: adi,sdp-120
.. _dtbinding_adi_sdp_120:

adi,sdp-120
###########

Vendor: :ref:`Analog Devices, Inc. <dt_vendor_adi>`

Description
***********



.. code-block:: none

   GPIO pins exposed on a Analog devices SDP interface.

   120-pin SDP interface:

        1  VIN                                NC  120
        2  NC                                 NC  119
        3  GND                               GND  118
        4  GND                               GND  117
        5  USB_VBUS                          VIO  116
        6  GND                               GND  115
        7  PAR_D23                       PAR_D22  114
        8  PAR_D21                       PAR_D20  113
        9  PAR_D19                       PAR_D18  112
       10  PAR_D17                       PAR_D16  111
       11  GND                           PAR_D15  110
       12  PAR_D14                           GND  109
       13  PAR_D13                       PAR_D12  108
       14  PAR_D11                       PAR_D10  107
       15  PAR_D9                         PAR_D8  106
       16  PAR_D7                         PAR_D6  105
       17  GND                               GND  104
       18  PAR_D5                         PAR_D4  103
       19  PAR_D3                         PAR_D2  102
       20  PAR_D1                         PAR_D0  101
       21  PAR_RD_N                     PAR_WR_N  100
       22  PAR_CS_N                      PAR_INT  99
       23  GND                               GND  98
       24  PAR_A3                         PAR_A2  97
       25  PAR_A1                         PAR_A0  96
       26  PAR_FS3                       PAR_FS2  95
       27  PAR_FS1                       PAR_CLK  94
       28  GND                               GND  93
       29  SPORT_TDV0                SPORT_RSCLK  92
       30  SPORT_TDV1                  SPORT_DR0  91
       31  SPORT_DR1                   SPORT_RFS  90
       32  SPORT_DT1                   SPORT_TFS  89
       33  SPI_D2                      SPORT_DT0  88
       34  SPI_D3                    SPORT_TSCLK  87
       35  SERIAL_INT                        GND  86
       36  GND                       SPI_SEL_A_N  85
       37  SPI_SEL_B_N                  SPI_MOSI  84
       38  SPI_SEL_C_N                  SPI_MISO  83
       39  SPI_SEL1/SPI_SS_N             SPI_CLK  82
       40  GND                               GND  81
       41  SDA_1                           SDA_0  80
       42  SCL_1                           SCL_0  79
       43  GPIO0                           GPIO1  78
       44  GPIO2                           GPIO3  77
       45  GPIO4                           GPIO5  76
       46  GND                               GND  75
       47  GPIO6                           GPIO7  74
       48  TMR_A                           TMR_B  73
       49  TMR_C                           TMR_D  72
       50  NC                             CLKOUT  71
       51  NC                                 NC  70
       52  GND                               GND  69
       53  NC                                 NC  68
       54  NC                                 NC  67
       55  NC                                 NC  66
       56  EEPROM_A0                      WAKE_N  65
       57  RESET_OUT_N                   SLEEP_N  64
       58  GND                               GND  63
       59  UART_RX                       UART_TX  62
       60  RESET_IN_N                     BMODE1  61

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

         * - ``gpio-map``
           - ``compound``
           - This property is **required**.

         * - ``gpio-map-mask``
           - ``compound``
           - 

         * - ``gpio-map-pass-thru``
           - ``compound``
           - 

         * - ``#gpio-cells``
           - ``int``
           - .. code-block:: none

                Number of items to expect in a GPIO specifier


             This property is **required**.



   .. 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 "adi,sdp-120" compatible.

      .. list-table::
         :widths: 1 1 4
         :header-rows: 1

         * - Name
           - Type
           - Details

         * - ``wakeup-source``
           - ``boolean``
           - .. code-block:: none

                Property to identify that a device can be used as wake up source.

                When this property is provided a specific flag is set into the
                device that tells the system that the device is capable of
                wake up the system.

                Wake up capable devices are disabled (interruptions will not wake up
                the system) by default but they can be enabled at runtime if necessary.



         * - ``power-domain``
           - ``phandle``
           - .. code-block:: none


                Power domain the device belongs to.

                The device will be notified when the power domain it belongs to is either
                suspended or resumed.



         * - ``zephyr,pm-device-runtime-auto``
           - ``boolean``
           - .. code-block:: none

                Automatically configure the device for runtime power management after the
                init function runs.



         * - ``zephyr,disabling-power-states``
           - ``phandles``
           - .. code-block:: none

                List of power states that will disable this device power.



         * - ``status``
           - ``string``
           - .. code-block:: none

                indicates the operational status of a device


             Legal values: ``'ok'``, ``'okay'``, ``'disabled'``, ``'reserved'``, ``'fail'``, ``'fail-sss'``

             See :ref:`dt-important-props` for more information.

         * - ``compatible``
           - ``string-array``
           - .. code-block:: none

                compatible strings


             This property is **required**.

             See :ref:`dt-important-props` for more information.

         * - ``reg``
           - ``array``
           - .. code-block:: none

                register space


             See :ref:`dt-important-props` for more information.

         * - ``reg-names``
           - ``string-array``
           - .. code-block:: none

                name of each register space


         * - ``interrupts``
           - ``array``
           - .. code-block:: none

                interrupts for device


             See :ref:`dt-important-props` for more information.

         * - ``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:`dt-important-props` for more information.

             This property is **deprecated**.

         * - ``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


         * - ``mboxes``
           - ``phandle-array``
           - .. code-block:: none

                mailbox / IPM channels specifiers


         * - ``mbox-names``
           - ``string-array``
           - .. code-block:: none

                Provided names of mailbox / IPM channel specifiers


         * - ``zephyr,deferred-init``
           - ``boolean``
           - .. code-block:: none

                Do not initialize device automatically on boot. Device should be manually
                initialized using device_init().






Part 3

한국어 전문 번역

adi,sdp-120

Vendor: Analog Devices, Inc.

공식 설명

GPIO pins exposed on a Analog devices SDP interface.

120-pin SDP interface:

     1  VIN                                NC  120
     2  NC                                 NC  119
     3  GND                               GND  118
     4  GND                               GND  117
     5  USB_VBUS                          VIO  116
     6  GND                               GND  115
     7  PAR_D23                       PAR_D22  114
     8  PAR_D21                       PAR_D20  113
     9  PAR_D19                       PAR_D18  112
    10  PAR_D17                       PAR_D16  111
    11  GND                           PAR_D15  110
    12  PAR_D14                           GND  109
    13  PAR_D13                       PAR_D12  108
    14  PAR_D11                       PAR_D10  107
    15  PAR_D9                         PAR_D8  106
    16  PAR_D7                         PAR_D6  105
    17  GND                               GND  104
    18  PAR_D5                         PAR_D4  103
    19  PAR_D3                         PAR_D2  102
    20  PAR_D1                         PAR_D0  101
    21  PAR_RD_N                     PAR_WR_N  100
    22  PAR_CS_N                      PAR_INT  99
    23  GND                               GND  98
    24  PAR_A3                         PAR_A2  97
    25  PAR_A1                         PAR_A0  96
    26  PAR_FS3                       PAR_FS2  95
    27  PAR_FS1                       PAR_CLK  94
    28  GND                               GND  93
    29  SPORT_TDV0                SPORT_RSCLK  92
    30  SPORT_TDV1                  SPORT_DR0  91
    31  SPORT_DR1                   SPORT_RFS  90
    32  SPORT_DT1                   SPORT_TFS  89
    33  SPI_D2                      SPORT_DT0  88
    34  SPI_D3                    SPORT_TSCLK  87
    35  SERIAL_INT                        GND  86
    36  GND                       SPI_SEL_A_N  85
    37  SPI_SEL_B_N                  SPI_MOSI  84
    38  SPI_SEL_C_N                  SPI_MISO  83
    39  SPI_SEL1/SPI_SS_N             SPI_CLK  82
    40  GND                               GND  81
    41  SDA_1                           SDA_0  80
    42  SCL_1                           SCL_0  79
    43  GPIO0                           GPIO1  78
    44  GPIO2                           GPIO3  77
    45  GPIO4                           GPIO5  76
    46  GND                               GND  75
    47  GPIO6                           GPIO7  74
    48  TMR_A                           TMR_B  73
    49  TMR_C                           TMR_D  72
    50  NC                             CLKOUT  71
    51  NC                                 NC  70
    52  GND                               GND  69
    53  NC                                 NC  68
    54  NC                                 NC  67
    55  NC                                 NC  66
    56  EEPROM_A0                      WAKE_N  65
    57  RESET_OUT_N                   SLEEP_N  64
    58  GND                               GND  63
    59  UART_RX                       UART_TX  62
    60  RESET_IN_N                     BMODE1  61

Analog Devices SDP 120-pin interface

이 binding은 SDP connector에 노출된 신호를 실제 GPIO controller specifier로 넘기는 nexus입니다. gpio-map과 #gpio-cells, base compatible가 필수이고 mask와 pass-through는 선택입니다.

120-pin SDP connector: 원문 왼쪽 1→60, 오른쪽 120→61
왼쪽 pin왼쪽 신호오른쪽 신호오른쪽 pin
1VINNC120
2NCNC119
3GNDGND118
4GNDGND117
5USB_VBUSVIO116
6GNDGND115
7PAR_D23PAR_D22114
8PAR_D21PAR_D20113
9PAR_D19PAR_D18112
10PAR_D17PAR_D16111
11GNDPAR_D15110
12PAR_D14GND109
13PAR_D13PAR_D12108
14PAR_D11PAR_D10107
15PAR_D9PAR_D8106
16PAR_D7PAR_D6105
17GNDGND104
18PAR_D5PAR_D4103
19PAR_D3PAR_D2102
20PAR_D1PAR_D0101
21PAR_RD_NPAR_WR_N100
22PAR_CS_NPAR_INT99
23GNDGND98
24PAR_A3PAR_A297
25PAR_A1PAR_A096
26PAR_FS3PAR_FS295
27PAR_FS1PAR_CLK94
28GNDGND93
29SPORT_TDV0SPORT_RSCLK92
30SPORT_TDV1SPORT_DR091
31SPORT_DR1SPORT_RFS90
32SPORT_DT1SPORT_TFS89
33SPI_D2SPORT_DT088
34SPI_D3SPORT_TSCLK87
35SERIAL_INTGND86
36GNDSPI_SEL_A_N85
37SPI_SEL_B_NSPI_MOSI84
38SPI_SEL_C_NSPI_MISO83
39SPI_SEL1/SPI_SS_NSPI_CLK82
40GNDGND81
41SDA_1SDA_080
42SCL_1SCL_079
43GPIO0GPIO178
44GPIO2GPIO377
45GPIO4GPIO576
46GNDGND75
47GPIO6GPIO774
48TMR_ATMR_B73
49TMR_CTMR_D72
50NCCLKOUT71
51NCNC70
52GNDGND69
53NCNC68
54NCNC67
55NCNC66
56EEPROM_A0WAKE_N65
57RESET_OUT_NSLEEP_N64
58GNDGND63
59UART_RXUART_TX62
60RESET_IN_NBMODE161

NC와 전원·접지는 GPIO로 임의 변환하지 않았습니다. PAR, SPORT, SPI, I2C, timer, UART 신호 이름도 원문 symbol 그대로 보존했습니다.

속성 전체 번역

공식 nexus property 4개와 base property 24개를 모두 번역했습니다. 1~120번 pin의 좌우 배치는 원문과 같은 60개 행으로 재구성했습니다.

노드 전용 속성 · 4개
이름형식설명과 제약
gpio-mapcompoundNexus의 child GPIO specifier를 실제 parent GPIO specifier로 변환하는 필수 mapping입니다.
필수
gpio-map-maskcompoundGPIO nexus mapping lookup에서 비교할 cell bit를 제한하는 mask입니다.
gpio-map-pass-thrucompoundGPIO nexus translation 뒤 parent specifier로 그대로 전달할 bit를 지정합니다.
#gpio-cellsintGPIO specifier 하나에 포함될 cell 수입니다.
필수
Base binding property · 24개

공통 기본 바인딩에서 상속한 속성입니다. 이 compatible에서 사용하지 않는 속성도 공식 참조 문서에 실려 있으면 함께 표시합니다.

이름형식설명과 제약
wakeup-sourceboolean이 장치를 시스템 깨우기에 사용할 수 있음을 나타냅니다. 이 속성이 있으면 깨우기 지원 플래그가 설정됩니다. 기본 상태에서는 장치의 인터럽트로 시스템을 깨우지 않으며, 실행 중에 깨우기 기능을 활성화할 수 있습니다.
power-domainphandle장치가 속한 전원 도메인의 phandle입니다. 해당 전원 도메인이 일시 중단되거나 다시 동작하면 장치에 알림이 전달됩니다.
zephyr,pm-device-runtime-autoboolean초기화 함수 실행 후 장치의 런타임 전원 관리를 자동으로 설정합니다.
zephyr,disabling-power-statesphandles이 장치의 전원이 꺼지는 전원 상태 목록입니다.
statusstring장치의 동작 상태를 나타냅니다.
허용값: 'ok', 'okay', 'disabled', 'reserved', 'fail', 'fail-sss'
compatiblestring-array이 노드에 적용할 바인딩과 드라이버를 식별하는 compatible 문자열 목록입니다.
필수
regarray장치 레지스터의 주소 범위를 지정합니다.
reg-namesstring-array각 register space의 이름입니다.
interruptsarray장치에서 사용하는 인터럽트를 지정하는 목록입니다.
interrupts-extendedcompound인터럽트 컨트롤러의 phandle을 함께 지정하는 확장 형식의 인터럽트 명세입니다.
interrupt-namesstring-array각 interrupt의 이름입니다.
interrupt-parentphandle인터럽트 컨트롤러 노드를 가리키는 phandle입니다.
labelstring사람이 장치를 알아볼 수 있도록 붙이는 이름입니다. 과거에는 device_get_binding()의 인자로 사용했습니다.
사용 중단됨
clocksphandle-array클록 게이트 또는 클록 공급원을 지정하는 phandle 배열입니다.
clock-namesstring-array각 clock의 이름입니다.
#address-cellsint하위 노드의 reg 속성에서 주소를 나타내는 데 쓰는 셀 수입니다.
#size-cellsint하위 노드의 reg 속성에서 크기를 나타내는 데 쓰는 셀 수입니다.
dmasphandle-arrayDMA 채널을 지정하는 phandle 배열입니다.
dma-namesstring-array지정한 DMA 채널의 이름입니다.
io-channelsphandle-arrayI/O 채널을 지정하는 phandle 배열입니다.
io-channel-namesstring-array지정한 I/O 채널의 이름입니다.
mboxesphandle-array메일박스/IPM 채널을 지정하는 phandle 배열입니다.
mbox-namesstring-array지정한 메일박스/IPM 채널의 이름입니다.
zephyr,deferred-initboolean부팅할 때 장치를 자동으로 초기화하지 않습니다. 이후 device_init()를 호출해 직접 초기화해야 합니다.

Source

출처

영어 원문에는 문단, 문서 지시문, 표, 코드, 코드 심벌, 경로를 그대로 보존했습니다.