build/dts/api/bindings/power/nxp,pdcfg-power.html · build/dts/api/bindings/power/nxp,pdcfg-power.rst 공식 원문 ↗

Zephyr 3.7.0 · Devicetree · Power · NXP Semiconductors

NXP PDCFG Power State 바인딩

NXP PDCFG register로 구성하는 power state 이름·timing·deep-sleep block power 값를 정의하는 6개 property schema입니다.

Official pathbuild/dts/api/bindings/power/nxp,pdcfg-power.html
Source filebuild/dts/api/bindings/power/nxp,pdcfg-power.rst
Source versionZephyr 3.7.0
TranslationFull · reviewed

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

Part 1

요약·해설

공식 원문 116줄과 property 6행을 전수 대조해 seven standard power-state names·platform substate ID·minimum profitable residency·worst-case exit latency·optional device-PM bypass·PDSLEEPCFG programming array 제약을 보존했습니다.

Compatible

nxp,pdcfg-power

Vendor

NXP Semiconductors

Properties

6 rows

Interface

Power-state timing + PDSLEEPCFG register value array

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 CD0245C8FAF6490887C63CB350301F28A52A89BE3E2C95C716D94F76D290A88E
: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:: nxp,pdcfg-power
.. _dtbinding_nxp_pdcfg_power:

nxp,pdcfg-power
###############

Vendor: :ref:`NXP Semiconductors <dt_vendor_nxp>`

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



.. code-block:: none

   Properties for NXP power management through the PDCFG register

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

         * - ``power-state-name``
           - ``string``
           - .. code-block:: none

                indicates a power state


             This property is **required**.

             Legal values: ``'active'``, ``'runtime-idle'``, ``'suspend-to-idle'``, ``'standby'``, ``'suspend-to-ram'``, ``'suspend-to-disk'``, ``'soft-off'``

         * - ``substate-id``
           - ``int``
           - .. code-block:: none

                Platform specific identification.


         * - ``min-residency-us``
           - ``int``
           - .. code-block:: none

                Minimum residency duration in microseconds. It is the minimum time for a
                given idle state to be worthwhile energywise. It includes the time to enter
                in this state.



         * - ``exit-latency-us``
           - ``int``
           - .. code-block:: none

                Worst case latency in microseconds required to exit the idle state.



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

                Disable system managed device power management for this state. When set,
                the power management subsystem will not suspend devices before entering
                this state.



         * - ``deep-sleep-config``
           - ``array``
           - .. code-block:: none

                An array of values written to the PDSLEEPCFG registers that controls the
                power to various blocks while the CPU is in deep sleep mode. These values
                are programmed to the sleep configuration registers before entering deep
                sleep mode.





   .. 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 "nxp,pdcfg-power" compatible.

      (None)


Part 3

한국어 전문 번역

nxp,pdcfg-power

Vendor: NXP Semiconductors

공식 설명

PDCFG register를 통한 NXP power management용 property입니다.

표준 power-state 선택 기준에 NXP register image 추가

power-state-name은 7개 표준 이름 중 하나이며 필수입니다. Scheduler나 PM policy는 최소 체류시간과 복귀 지연을 비교하고, 실제 진입 전에는 deep-sleep-config 값을 PDSLEEPCFG register에 기록합니다.

PM policy

Expected idle duration

State economics

min-residency-us · exit-latency-us

NXP config

PDSLEEPCFG value array

CPU

Enter deep sleep

min-residency-us는 state 진입 시간을 포함합니다. zephyr,pm-device-disabled가 있으면 이 state에 들어가기 전에 device suspend를 수행하지 않습니다.

속성 전체 번역

공식 node-specific 6개 property를 모두 번역했으며 base property 표는 없습니다.

노드 전용 속성 · 6개
이름형식설명과 제약
power-state-namestringPower management state의 표준 이름입니다.
필수 · 허용값: 'active', 'runtime-idle', 'suspend-to-idle', 'standby', 'suspend-to-ram', 'suspend-to-disk', 'soft-off'
substate-idintPlatform이 같은 표준 power state 안의 세부 state를 식별하는 값입니다.
min-residency-usint이 idle state를 선택했을 때 energy 측면에서 이득이 되기 위한 최소 체류시간이며 진입 시간도 포함합니다. Microsecond 단위입니다.
exit-latency-usintIdle state에서 빠져나오는 데 필요한 최악 조건의 latency이며 microsecond 단위입니다.
zephyr,pm-device-disabledboolean이 state에서 system-managed device power management를 끕니다. 설정하면 진입 전에 PM subsystem이 device를 suspend하지 않습니다.
deep-sleep-configarrayCPU가 deep sleep mode에 있는 동안 여러 block의 power를 제어하도록 PDSLEEPCFG register에 쓸 값 배열입니다. Deep sleep에 들어가기 전에 sleep configuration register에 기록됩니다.

Source

출처

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