build/dts/api/bindings/usb/uac2/zephyr,uac2-clock-source.html · build/dts/api/bindings/usb/uac2/zephyr,uac2-clock-source.rst 공식 원문 ↗

Zephyr 3.7.0 · Devicetree · USB Audio Class 2 · Zephyr-specific binding

Zephyr UAC2 Clock Source Entity 바인딩

External/internal clock 유형, SOF 동기화와 지원 sampling frequency 배열를 정의하는 6개 property schema입니다.

Official pathbuild/dts/api/bindings/usb/uac2/zephyr,uac2-clock-source.html
Source filebuild/dts/api/bindings/usb/uac2/zephyr,uac2-clock-source.rst
Source versionZephyr 3.7.0
TranslationFull · reviewed

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

Part 1

요약·해설

공식 원문 120줄과 property 6행을 전수 대조해 required clock type/frequency list·SOF synchronization rule·optional terminal association and controls 제약을 보존했습니다.

Compatible

zephyr,uac2-clock-source

Vendor

Zephyr-specific binding

Properties

6 rows

Interface

UAC2 Clock Source entity

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 A20E9B98EB9901E3E7AED89D72830F7AE994AF16993636802135ABC97C744DE9
: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,uac2-clock-source
.. _dtbinding_zephyr_uac2_clock_source:

zephyr,uac2-clock-source
########################

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

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



.. code-block:: none

   USB Audio Class 2 Clock Source entity

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

         * - ``clock-type``
           - ``string``
           - .. code-block:: none

                Clock Type indicating whether the Clock Source represents an external
                clock or an internal clock with either fixed frequency, variable
                frequency, or programmable frequency.



             This property is **required**.

             Legal values: ``'external'``, ``'internal-fixed'``, ``'internal-variable'``, ``'internal-programmable'``

         * - ``sof-synchronized``
           - ``boolean``
           - .. code-block:: none

                True if clock is synchronized to USB Start of Frame. False if clock is
                free running. External clock must be free running.



         * - ``frequency-control``
           - ``string``
           - .. code-block:: none

                Clock Frequency Control capabilities


             Legal values: ``'read-only'``, ``'host-programmable'``

         * - ``validity-control``
           - ``string``
           - .. code-block:: none

                Clock Validity Control capabilities


             Legal values: ``'read-only'``

         * - ``assoc-terminal``
           - ``phandle``
           - .. code-block:: none

                Input or Output Terminal associated with this Clock Source. Set if clock
                is derived from USB OUT data endpoint (point the handle to respective
                Input Terminal) or from input signal on S/PDIF connector.



         * - ``sampling-frequencies``
           - ``array``
           - .. code-block:: none

                Sampling Frequencies, in Hz, this Clock Source Entity can generate.



             This property is **required**.



   .. 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,uac2-clock-source" compatible.

      (None)


Part 3

한국어 전문 번역

zephyr,uac2-clock-source

Vendor: Zephyr-specific binding

공식 설명

USB Audio Class 2 Clock Source entity

Audio sampling clock의 출처와 host 제어 범위를 선언

clock-type은 external, internal-fixed, internal-variable, internal-programmable 중 하나이고 sampling-frequencies는 생성 가능한 Hz 값을 나열합니다. 두 항목 모두 필수입니다.

Clock source

External or internal

SOF relation

Synchronized or free-running

Sampling frequencies

Required Hz array

Audio terminals

Optional association

External clock은 free-running이어야 하므로 sof-synchronized를 설정하면 안 됩니다. assoc-terminal은 USB OUT data에서 유도한 clock이면 해당 Input Terminal을, 또는 S/PDIF 입력에서 유도하면 그 terminal을 가리킬 수 있습니다.

속성 전체 번역

공식 node-specific property 6개를 모두 번역했습니다. 이 page에는 base property 표가 없습니다.

노드 전용 속성 · 6개
이름형식설명과 제약
clock-typestringClock Source가 external인지, fixed/variable/programmable internal clock인지 지정합니다.
필수 · 허용값: 'external', 'internal-fixed', 'internal-variable', 'internal-programmable'
sof-synchronizedbooleanTrue이면 USB Start of Frame에 동기화되고 false이면 free-running입니다. External clock은 free-running이어야 합니다.
frequency-controlstringClock Frequency Control capability가 read-only인지 host-programmable인지 지정합니다.
허용값: 'read-only', 'host-programmable'
validity-controlstringClock Validity 상태를 읽는 control capability입니다.
허용값: 'read-only'
assoc-terminalphandle양방향 terminal 또는 clock과 연관된 Input/Output Terminal의 phandle입니다.
sampling-frequenciesarray이 Clock Source Entity가 생성할 수 있는 sampling frequency의 Hz 배열입니다.
필수

Source

출처

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