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

Zephyr 3.7.0 · Devicetree · Power · Zephyr-specific binding

Zephyr Power State 바인딩

Zephyr system power state의 표준 이름·platform substate·체류시간·복귀지연·device PM 정책를 정의하는 5개 property schema입니다.

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

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

Part 1

요약·해설

공식 원문 105줄과 property 5행을 전수 대조해 seven legal power-state names·platform-specific substate ID·minimum useful residency including entry time·worst-case exit latency·optional device-suspend bypass 제약을 보존했습니다.

Compatible

zephyr,power-state

Vendor

Zephyr-specific binding

Properties

5 rows

Interface

Generic power-state identity, timing and device-PM policy

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 753EC3254A65E270315D3099B297700F17F1C975E8DD010E0BFDEB29D3C8FF68
: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:: zephyr,power-state
.. _dtbinding_zephyr_power_state:

zephyr,power-state
##################

Vendor: :ref:`Zephyr-specific binding <dt_vendor_zephyr>`

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



.. code-block:: none

   Properties for power management state

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.





   .. 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 "zephyr,power-state" compatible.

      (None)


Part 3

한국어 전문 번역

zephyr,power-state

Vendor: Zephyr-specific binding

공식 설명

Power management state용 property입니다.

PM policy가 state를 비교할 수 있는 공통 기술자

power-state-name은 active부터 soft-off까지 7개 표준 이름 중 하나이며 필수입니다. Platform별 variation은 substate-id로 구분합니다.

Idle prediction

Expected sleep duration

Residency gate

min-residency-us

Wake budget

exit-latency-us

Selected state

Name + optional substate

최소 체류시간에는 state 진입 시간이 포함되고, exit latency는 최악 조건의 복귀 시간입니다. zephyr,pm-device-disabled가 있으면 진입 전에 device suspend를 생략합니다.

속성 전체 번역

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

노드 전용 속성 · 5개
이름형식설명과 제약
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하지 않습니다.

Source

출처

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