build/dts/api/bindings/gpio/x-powers,axp192-gpio.html · build/dts/api/bindings/gpio/x-powers,axp192-gpio.rst 공식 원문 ↗

Zephyr 3.7.0 · Devicetree · GPIO · X-Powers

X-Powers AXP192 GPIO Controller 바인딩

AXP192의 native GPIO 5개와 EXTEN line를 정의하는 11개 property schema입니다.

Official pathbuild/dts/api/bindings/gpio/x-powers,axp192-gpio.html
Source filebuild/dts/api/bindings/gpio/x-powers,axp192-gpio.rst
Source versionZephyr 3.7.0
TranslationFull · reviewed

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

Part 1

요약·해설

공식 원문 199줄과 property 11행을 전수 대조해 fixed six-line mapping·zero base properties·GPIO hog 제약을 보존했습니다.

Compatible

x-powers,axp192-gpio

Vendor

X-Powers

Properties

11 rows

Interface

AXP192 child GPIO controller + fixed 6 lines

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 B86D7DBF5865B8A5341F3A280FA1BF7BB78A25C53E4267696C91687CAAF49D18
: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:: x-powers,axp192-gpio
.. _dtbinding_x_powers_axp192_gpio:

x-powers,axp192-gpio
####################

Vendor: :ref:`X-Powers <dt_vendor_x-powers>`

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



.. code-block:: none

   AXP192 GPIO Controller
   AX192 features 5 native GPIOs. In addition the EXTEN pin can be configured to be used as an IO as well.
   Pin-Mapping is as follows [0] GPIO0 [1] GPIO1 [2] GPIO2 [3] GPIO3 [4] GPIO4 [5] EXTEN

Properties
**********

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


These property descriptions apply to "x-powers,axp192-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**.

             Constant value: ``2``

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

                Number of GPIOs available on axp192.



             This property is **required**.

             Default value: ``32``

             Constant value: ``6``

         * - ``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 "x-powers,axp192-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

한국어 전문 번역

x-powers,axp192-gpio

Vendor: X-Powers

공식 설명

AXP192 GPIO Controller
AX192 features 5 native GPIOs. In addition the EXTEN pin can be configured to be used as an IO as well.
Pin-Mapping is as follows [0] GPIO0 [1] GPIO1 [2] GPIO2 [3] GPIO3 [4] GPIO4 [5] EXTEN

AXP192 내부 GPIO 6개

AXP192에는 native GPIO 5개가 있고 EXTEN pin도 I/O로 설정할 수 있습니다. 공식 mapping은 parent index 0~4가 GPIO0~GPIO4, index 5가 EXTEN입니다.

AXP192 parent GPIO index
IndexPin
0GPIO0
1GPIO1
2GPIO2
3GPIO3
4GPIO4
5EXTEN

gpio-controller, 2-cell #gpio-cells, ngpios가 필수이고 ngpios는 상속 기본값 32와 고정값 6을 함께 보존합니다. 이 page에는 base property 표가 없으므로 compatible·reg를 번역 표에 새로 만들지 않았습니다.

GPIO hog child

gpio-hog와 gpios가 필수이고 2-cell specifier 이름은 pin·flags입니다. Direction 우선순위는 input > output-low > output-high입니다.

속성 전체 번역

공식 node 5개와 child 6개 property를 모두 번역했습니다. Base property 표는 없습니다.

노드 전용 속성 · 5개
이름형식설명과 제약
gpio-controllerboolean이 노드가 GPIO 컨트롤러임을 나타냅니다.
필수
#gpio-cellsintGPIO specifier 하나에 포함될 cell 수입니다.
필수 · 고정값: 2
ngpiosint컨트롤러가 제공하는 GPIO 번호 범위의 크기입니다. 중간에 빠진 번호가 있어도 마지막 번호에 1을 더한 값을 사용합니다.
필수 · 고정값: 6 · 기본값: 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

출처

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