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

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

ADI AD559x GPIO 컨트롤러 바인딩

AD559x의 GPIO 번호 범위, 예약 구간, 자동 확보할 GPIO의 설정 우선순위를 정의합니다. 스키마에는 속성 11개가 있습니다.

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

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

Part 1

요약·해설

공식 원문 199줄과 속성 11개를 대조했습니다. GPIO 컨트롤러 표시, GPIO 번호 범위, 자동 확보할 하위 GPIO의 입출력 방향 조건을 유지했습니다.

Compatible

adi,ad559x-gpio

Vendor

Analog Devices, Inc.

Properties

11 rows

Interface

GPIO controller + hog child

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 F6B09F2AD2F0A08DA5A040FB80611451DCE485BACAB2FF945FF0C8BDEA7CAE2F
: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,ad559x-gpio
.. _dtbinding_adi_ad559x_gpio:

adi,ad559x-gpio
###############

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

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



.. code-block:: none

   AD559x GPIO Controller

Properties
**********

Top level properties
====================


These property descriptions apply to "adi,ad559x-gpio"
nodes themselves. This page also describes child node
properties in the following sections.

.. 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-controller``
           - ``boolean``
           - .. code-block:: none

                Convey's this node is a GPIO controller


             This property is **required**.

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

                Number of items to expect in a GPIO specifier


             This property is **required**.

         * - ``ngpios``
           - ``int``
           - .. code-block:: none

                This property indicates the number of in-use slots of available slots
                for GPIOs. The typical example is something like this: the hardware
                register is 32 bits wide, but only 18 of the bits have a physical
                counterpart. The driver is generally written so that all 32 bits can
                be used, but the IP block is reused in a lot of designs, some using
                all 32 bits, some using 18 and some using 12. In this case, setting
                "ngpios = <18>;" informs the driver that only the first 18 GPIOs, at
                local offset 0 .. 17, are in use.  For cases in which there might be
                holes in the slot range, this value should be the max slot number+1.



             Default value: ``32``

         * - ``gpio-reserved-ranges``
           - ``array``
           - .. code-block:: none

                If not all the GPIOs at offsets 0...N-1 are usable for ngpios = <N>, then
                this property contains an additional set of tuples which specify which GPIOs
                are unusable. This property indicates the start and size of the GPIOs
                that can't be used.

                For example, setting "gpio-reserved-ranges = <3 2>, <10 1>;" means that
                GPIO offsets 3, 4, and 10 are not usable, even if ngpios = <18>.



         * - ``gpio-line-names``
           - ``string-array``
           - .. code-block:: none

                This is an array of strings defining the names of the GPIO lines
                going out of the GPIO controller





   .. 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,ad559x-gpio" compatible.

      (None)


Child node properties
=====================

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

   * - Name
     - Type
     - Details

   * - ``gpio-hog``
     - ``boolean``
     - .. code-block:: none

          Conveys this node is a GPIO hog.



       This property is **required**.

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

          This is an array of GPIO specifiers (e.g. pin, flags) to be hogged. The number of array
          entries must be an integer multiple of the number of GPIO specifier cells for the parent
          GPIO controller.



       This property is **required**.

   * - ``input``
     - ``boolean``
     - .. code-block:: none

          If this property is set, the GPIO is configured as an input. This property takes
          precedence over the output-low and output-high properties.



   * - ``output-low``
     - ``boolean``
     - .. code-block:: none

          If this property is set, the GPIO is configured as an output set to logical low. This
          property takes precedence over the output-high property.



   * - ``output-high``
     - ``boolean``
     - .. code-block:: none

          If this property is set, the GPIO is configured as an output set to logical high.



   * - ``line-name``
     - ``string``
     - .. code-block:: none

          Optional GPIO line name.



Specifier cell names
********************

- gpio cells: pin, flags

Part 3

한국어 전문 번역

adi,ad559x-gpio

Vendor: Analog Devices, Inc.

공식 설명

AD559x GPIO Controller

AD559x GPIO controller

gpio-controller와 #gpio-cells가 필수입니다. ngpios 기본값은 32이고 hole은 gpio-reserved-ranges의 시작·개수 tuple로 제외합니다.

이 공식 page에는 base property 표가 없으며 #gpio-cells의 constant도 표시하지 않습니다. Cell 이름이 pin·flags라는 사실만 보존하고 compatible이나 cell 수를 표에 새로 만들지 않았습니다.

GPIO hog child

각 child는 gpio-hog와 gpios가 필수입니다. Direction 우선순위는 input > output-low > output-high이며 line-name은 선택입니다. 지정자 셀 이름은 pin, flags입니다.

속성 전체 번역

공식 문서의 최상위 속성 5개와 하위 노드 속성 6개를 모두 번역했습니다. 원문에 없는 기본 속성이나 셀 고정값은 추가하지 않았습니다.

노드 전용 속성 · 5개
이름형식설명과 제약
gpio-controllerboolean이 노드가 GPIO 컨트롤러임을 나타냅니다.
필수
#gpio-cellsintGPIO specifier 하나에 포함될 cell 수입니다.
필수
ngpiosint컨트롤러가 제공하는 GPIO 번호 범위의 크기입니다. 중간에 빠진 번호가 있어도 마지막 번호에 1을 더한 값을 사용합니다.
기본값: 32
gpio-reserved-rangesarrayngpios 범위에서 사용할 수 없는 구간을 지정합니다. 각 구간은 시작 오프셋과 GPIO 개수의 쌍으로 나타냅니다.
gpio-line-namesstring-arrayGPIO 컨트롤러의 각 신호선에 붙인 이름 배열입니다.
하위 노드 속성 · 6개

각 하위 노드에 적용되는 속성입니다.

이름형식설명과 제약
gpio-hogboolean부팅할 때 자동으로 확보할 GPIO를 하위 노드에 지정합니다(GPIO hog).
필수
gpiosarray자동으로 확보할 GPIO를 지정하는 배열입니다. 셀 수는 상위 노드에서 정한 GPIO 셀 수의 정수배여야 합니다.
필수
inputboolean자동 확보한 GPIO를 입력으로 설정합니다. output-low와 output-high보다 우선합니다.
output-lowboolean자동 확보한 GPIO를 논리 Low 출력으로 설정합니다. output-high보다 우선합니다.
output-highboolean자동 확보한 GPIO를 논리 High 출력으로 설정합니다.
line-namestringGPIO hog line의 선택 이름입니다.

Source

출처

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