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

Zephyr 3.7.0 · Devicetree · GPIO · Nordic Semiconductor

Nordic nPM6001 GPIO Controller 바인딩

nPM6001 PMIC GPIO controller와 hog를 정의하는 11개 property schema입니다.

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

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

Part 1

요약·해설

공식 원문 199줄과 property 11행을 전수 대조해 controller identity·unspecified cell constant·32-slot default·hog 제약을 보존했습니다.

Compatible

nordic,npm6001-gpio

Vendor

Nordic Semiconductor

Properties

11 rows

Interface

nPM6001 child GPIO controller + hog

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 FB67F31B4D0A2A49A5B46CDE28D71DE5F73A379E673CCCB1D95599255FEF2462
: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:: nordic,npm6001-gpio
.. _dtbinding_nordic_npm6001_gpio:

nordic,npm6001-gpio
###################

Vendor: :ref:`Nordic Semiconductor <dt_vendor_nordic>`

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



.. code-block:: none

   nPM6001 GPIO Controller

Properties
**********

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


These property descriptions apply to "nordic,npm6001-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 "nordic,npm6001-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

한국어 전문 번역

nordic,npm6001-gpio

Vendor: Nordic Semiconductor

공식 설명

nPM6001 GPIO Controller

nPM6001 GPIO controller

nPM6001 PMIC 내부 GPIO controller입니다. gpio-controller와 #gpio-cells는 필수지만 cell 수 고정값은 공식 page에 없습니다. ngpios 기본값은 32입니다.

nPM1300 page와 property 행은 같지만 compatible과 PMIC 대상이 다릅니다. 이 page에는 base property 표가 없으므로 parent PMIC의 compatible이나 address를 추가하지 않았습니다.

GPIO hog child

gpio-hog와 gpios가 필수이고 specifier cell 이름은 pin, flags입니다. 공식 page는 #gpio-cells 고정값을 표시하지 않습니다. Direction 우선순위는 input > output-low > output-high입니다.

속성 전체 번역

공식 top-level 5개와 child 6개 property를 모두 번역했습니다. base property 표가 없는 구조를 보존했습니다.

노드 전용 속성 · 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

출처

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