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

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

Zephyr UAC2 Audio Streaming Interface 바인딩

Terminal 연결, alternate setting control, implicit feedback와 audio subslot format를 정의하는 12개 property schema입니다.

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

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

Part 1

요약·해설

공식 원문 167줄과 property 12행을 전수 대조해 required linked terminal·Type IV external stream·asynchronous implicit feedback·clock lock and sample format 제약을 보존했습니다.

Compatible

zephyr,uac2-audio-streaming

Vendor

Zephyr-specific binding

Properties

12 rows

Interface

UAC2 Audio Streaming interface

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 42826F3F7238D37AACC255A374DBA8F9B50827EA9AB908728BF12BD4785EE11E
: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-audio-streaming
.. _dtbinding_zephyr_uac2_audio_streaming:

zephyr,uac2-audio-streaming
###########################

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

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



.. code-block:: none

   USB Audio Class 2 Audio Streaming interface

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

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

                Input or Output Terminal to which this interface is connected.



             This property is **required**.

         * - ``active-alternate-setting-control``
           - ``string``
           - .. code-block:: none

                Active Alternate Setting Control capabilities


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

         * - ``valid-alternate-settings-control``
           - ``string``
           - .. code-block:: none

                Valid Alternate Settings Control capabilities


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

         * - ``external-interface``
           - ``boolean``
           - .. code-block:: none

                Enable if audio stream is not transmitted over USB (Type IV Audio Stream).



         * - ``implicit-feedback``
           - ``boolean``
           - .. code-block:: none

                Enable implicit feedback on asynchronous endpoint. For IN endpoints this
                sets endpoint behaviour type to implicit feedback data endpoint. For OUT
                endpoints setting this property removes explicit feedback endpoint.



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

                Pitch Control capabilities


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

         * - ``data-overrun-control``
           - ``string``
           - .. code-block:: none

                Data Overrun capabilities


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

         * - ``data-underrun-control``
           - ``string``
           - .. code-block:: none

                Data Underrun capabilities


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

         * - ``lock-delay``
           - ``int``
           - .. code-block:: none

                Time it takes this endpoint to reliably lock its internal clock recovery
                circuitry. Units depend on the lock-delay-units field. Relevant only if
                linked-terminal's clock is sof-synchronized.



         * - ``lock-delay-units``
           - ``string``
           - .. code-block:: none

                Units for lock-delay parameter.


             Legal values: ``'milliseconds'``, ``'decoded-pcm-samples'``

         * - ``subslot-size``
           - ``int``
           - .. code-block:: none

                Number of bytes occupied by one audio subslot. Can be 1, 2, 3 or 4.



         * - ``bit-resolution``
           - ``int``
           - .. code-block:: none

                Number of effectively used bits in audio subslot.





   .. 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-audio-streaming" compatible.

      (None)


Part 3

한국어 전문 번역

zephyr,uac2-audio-streaming

Vendor: Zephyr-specific binding

공식 설명

USB Audio Class 2 Audio Streaming interface

Streaming interface를 terminal과 clock recovery 동작에 연결

linked-terminal은 stream이 연결되는 Input 또는 Output Terminal이며 유일한 필수 property입니다. external-interface를 설정하면 USB로 audio data를 전달하지 않는 Type IV stream이 됩니다.

Input/Output Terminal

Required linked-terminal

Streaming interface

Alternate setting

Async endpoint

Implicit or explicit feedback

Audio subslot

1..4 bytes + bit resolution

implicit-feedback는 IN endpoint를 implicit-feedback data endpoint로 만들고 OUT endpoint에서는 explicit feedback endpoint를 제거합니다. lock-delay는 연결 terminal의 clock이 SOF-synchronized일 때만 관련되며 단위는 milliseconds 또는 decoded PCM samples입니다.

Pitch는 read-only/host-programmable, 나머지 alternate-setting·overrun·underrun control은 read-only만 허용됩니다.

속성 전체 번역

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

노드 전용 속성 · 12개
이름형식설명과 제약
linked-terminalphandle이 Audio Streaming interface가 연결되는 Input 또는 Output Terminal의 phandle입니다.
필수
active-alternate-setting-controlstring현재 active alternate setting을 읽는 control capability입니다.
허용값: 'read-only'
valid-alternate-settings-controlstring사용 가능한 alternate setting을 읽는 control capability입니다.
허용값: 'read-only'
external-interfaceboolean설정하면 audio stream이 USB로 전송되지 않는 Type IV Audio Stream입니다.
implicit-feedbackbooleanAsynchronous endpoint의 implicit feedback을 활성화합니다. IN에서는 implicit-feedback data endpoint가 되고 OUT에서는 explicit feedback endpoint를 제거합니다.
pitch-controlstringPitch Control capability가 read-only인지 host-programmable인지 지정합니다.
허용값: 'read-only', 'host-programmable'
data-overrun-controlstringData Overrun 상태를 읽는 control capability입니다.
허용값: 'read-only'
data-underrun-controlstringData Underrun 상태를 읽는 control capability입니다.
허용값: 'read-only'
lock-delayintEndpoint의 internal clock recovery circuit이 안정적으로 lock되는 데 걸리는 시간입니다.
lock-delay-unitsstringlock-delay의 단위이며 milliseconds 또는 decoded PCM samples입니다.
허용값: 'milliseconds', 'decoded-pcm-samples'
subslot-sizeintAudio subslot 하나가 차지하는 byte 수이며 1, 2, 3, 4 중 하나입니다.
bit-resolutionintAudio subslot에서 실제로 사용하는 bit 수입니다.

Source

출처

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