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

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

Zephyr UAC2 Input Terminal Entity 바인딩

28개 channel-location flag와 terminal type·clock source·read-only control capability를 정의하는 37개 property schema입니다.

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

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

Part 1

요약·해설

공식 원문 337줄과 property 37행을 전수 대조해 full spatial channel cluster·raw-data mutual exclusion·required terminal type/clock source·optional controls 제약을 보존했습니다.

Compatible

zephyr,uac2-input-terminal

Vendor

Zephyr-specific binding

Properties

37 rows

Interface

UAC2 Input Terminal entity and channel cluster

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 DF82BCCA93C5F196B004833E5F10D7F605B88D455E695A6392242CECE8CEED1D
: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-input-terminal
.. _dtbinding_zephyr_uac2_input_terminal:

zephyr,uac2-input-terminal
##########################

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

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



.. code-block:: none

   USB Audio Class 2 Input Terminal 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

         * - ``front-left``
           - ``boolean``
           - .. code-block:: none

                Front Left channel present in the cluster


         * - ``front-right``
           - ``boolean``
           - .. code-block:: none

                Front Right channel present in the cluster


         * - ``front-center``
           - ``boolean``
           - .. code-block:: none

                Front Center channel present in the cluster


         * - ``low-frequency-effects``
           - ``boolean``
           - .. code-block:: none

                Low Frequency Effects channel present in the cluster


         * - ``back-left``
           - ``boolean``
           - .. code-block:: none

                Back Left channel present in the cluster


         * - ``back-right``
           - ``boolean``
           - .. code-block:: none

                Back Right channel present in the cluster


         * - ``front-left-of-center``
           - ``boolean``
           - .. code-block:: none

                Front Left of Center channel present in the cluster


         * - ``front-right-of-center``
           - ``boolean``
           - .. code-block:: none

                Front Right of Center channel present in the cluster


         * - ``back-center``
           - ``boolean``
           - .. code-block:: none

                Back Center channel present in the cluster


         * - ``side-left``
           - ``boolean``
           - .. code-block:: none

                Side Left channel present in the cluster


         * - ``side-right``
           - ``boolean``
           - .. code-block:: none

                Side Right channel present in the cluster


         * - ``top-center``
           - ``boolean``
           - .. code-block:: none

                Top Center channel present in the cluster


         * - ``top-front-left``
           - ``boolean``
           - .. code-block:: none

                Top Front Left channel present in the cluster


         * - ``top-front-center``
           - ``boolean``
           - .. code-block:: none

                Top Front Center channel present in the cluster


         * - ``top-front-right``
           - ``boolean``
           - .. code-block:: none

                Top Front Right channel present in the cluster


         * - ``top-back-left``
           - ``boolean``
           - .. code-block:: none

                Top Back Left channel present in the cluster


         * - ``top-back-center``
           - ``boolean``
           - .. code-block:: none

                Top Back Center channel present in the cluster


         * - ``top-back-right``
           - ``boolean``
           - .. code-block:: none

                Top Back Right channel present in the cluster


         * - ``top-front-left-of-center``
           - ``boolean``
           - .. code-block:: none

                Top Front Left of Center channel present in the cluster


         * - ``top-front-right-of-center``
           - ``boolean``
           - .. code-block:: none

                Top Front Right of Center channel present in the cluster


         * - ``left-low-frequency-effects``
           - ``boolean``
           - .. code-block:: none

                Left Low Frequency Effects channel present in the cluster


         * - ``right-low-frequency-effects``
           - ``boolean``
           - .. code-block:: none

                Right Low Frequency Effects channel present in the cluster


         * - ``top-side-left``
           - ``boolean``
           - .. code-block:: none

                Top Side Left channel present in the cluster


         * - ``top-side-right``
           - ``boolean``
           - .. code-block:: none

                Top Side Right channel present in the cluster


         * - ``bottom-center``
           - ``boolean``
           - .. code-block:: none

                Bottom Center channel present in the cluster


         * - ``back-left-of-center``
           - ``boolean``
           - .. code-block:: none

                Back Left of Center channel present in the cluster


         * - ``back-right-of-center``
           - ``boolean``
           - .. code-block:: none

                Back Right of Center channel present in the cluster


         * - ``raw-data``
           - ``boolean``
           - .. code-block:: none

                Raw Data, mutually exclusive with all other spatial locations


         * - ``terminal-type``
           - ``int``
           - .. code-block:: none

                Terminal Type constant specified in USB Audio Terminal Types



             This property is **required**.

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

                Associated terminal for bi-directional terminal types.



         * - ``clock-source``
           - ``phandle``
           - .. code-block:: none

                Connected clock entity



             This property is **required**.

         * - ``copy-protect-control``
           - ``string``
           - .. code-block:: none

                Copy Protect Control capabilities


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

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

                Connector Control capabilities


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

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

                Overload Control capabilities


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

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

                Cluster Control capabilities


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

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

                Underflow Control capabilities


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

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

                Overflow Control capabilities


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



   .. 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-input-terminal" compatible.

      (None)


Part 3

한국어 전문 번역

zephyr,uac2-input-terminal

Vendor: Zephyr-specific binding

공식 설명

USB Audio Class 2 Input Terminal entity

Input Terminal이 제공하는 channel cluster를 위치별 flag로 구성

Front/Back/Side/Top/Bottom과 LFE를 포함한 27개 spatial location flag가 channel cluster의 speaker 위치를 표현합니다. raw-data는 비공간 raw channel이며 다른 모든 spatial location과 상호배제입니다.

Physical/USB input

Terminal type

Input Terminal

Required clock source

Channel cluster

Spatial flags or raw-data

Downstream unit

Consumes audio channels

terminal-type은 USB Audio Terminal Types의 constant이고 clock-source는 연결된 Clock Source phandle이며 둘 다 필수입니다. 양방향 terminal은 assoc-terminal로 반대 terminal을 연결할 수 있습니다.

Copy protect, connector, overload, cluster, underflow, overflow control은 이 page에서 모두 선택적 read-only capability입니다.

속성 전체 번역

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

노드 전용 속성 · 37개
이름형식설명과 제약
front-leftbooleanAudio channel cluster에 Front Left channel이 있음을 표시합니다.
front-rightbooleanAudio channel cluster에 Front Right channel이 있음을 표시합니다.
front-centerbooleanAudio channel cluster에 Front Center channel이 있음을 표시합니다.
low-frequency-effectsbooleanAudio channel cluster에 Low Frequency Effects channel이 있음을 표시합니다.
back-leftbooleanAudio channel cluster에 Back Left channel이 있음을 표시합니다.
back-rightbooleanAudio channel cluster에 Back Right channel이 있음을 표시합니다.
front-left-of-centerbooleanAudio channel cluster에 Front Left of Center channel이 있음을 표시합니다.
front-right-of-centerbooleanAudio channel cluster에 Front Right of Center channel이 있음을 표시합니다.
back-centerbooleanAudio channel cluster에 Back Center channel이 있음을 표시합니다.
side-leftbooleanAudio channel cluster에 Side Left channel이 있음을 표시합니다.
side-rightbooleanAudio channel cluster에 Side Right channel이 있음을 표시합니다.
top-centerbooleanAudio channel cluster에 Top Center channel이 있음을 표시합니다.
top-front-leftbooleanAudio channel cluster에 Top Front Left channel이 있음을 표시합니다.
top-front-centerbooleanAudio channel cluster에 Top Front Center channel이 있음을 표시합니다.
top-front-rightbooleanAudio channel cluster에 Top Front Right channel이 있음을 표시합니다.
top-back-leftbooleanAudio channel cluster에 Top Back Left channel이 있음을 표시합니다.
top-back-centerbooleanAudio channel cluster에 Top Back Center channel이 있음을 표시합니다.
top-back-rightbooleanAudio channel cluster에 Top Back Right channel이 있음을 표시합니다.
top-front-left-of-centerbooleanAudio channel cluster에 Top Front Left of Center channel이 있음을 표시합니다.
top-front-right-of-centerbooleanAudio channel cluster에 Top Front Right of Center channel이 있음을 표시합니다.
left-low-frequency-effectsbooleanAudio channel cluster에 Left Low Frequency Effects channel이 있음을 표시합니다.
right-low-frequency-effectsbooleanAudio channel cluster에 Right Low Frequency Effects channel이 있음을 표시합니다.
top-side-leftbooleanAudio channel cluster에 Top Side Left channel이 있음을 표시합니다.
top-side-rightbooleanAudio channel cluster에 Top Side Right channel이 있음을 표시합니다.
bottom-centerbooleanAudio channel cluster에 Bottom Center channel이 있음을 표시합니다.
back-left-of-centerbooleanAudio channel cluster에 Back Left of Center channel이 있음을 표시합니다.
back-right-of-centerbooleanAudio channel cluster에 Back Right of Center channel이 있음을 표시합니다.
raw-databooleanRaw Data channel을 표시합니다. 다른 모든 spatial location과 동시에 사용할 수 없습니다.
terminal-typeintUSB Audio Terminal Types에 정의된 Terminal Type constant입니다.
필수
assoc-terminalphandle양방향 terminal 또는 clock과 연관된 Input/Output Terminal의 phandle입니다.
clock-sourcephandle연결된 Clock Source entity의 phandle입니다.
필수
copy-protect-controlstringCopy Protect Control capability입니다.
허용값: 'read-only'
connector-controlstringConnector Control capability입니다.
허용값: 'read-only'
overload-controlstringOverload Control capability입니다.
허용값: 'read-only'
cluster-controlstringCluster Control capability입니다.
허용값: 'read-only'
underflow-controlstringUnderflow Control capability입니다.
허용값: 'read-only'
overflow-controlstringOverflow Control capability입니다.
허용값: 'read-only'

Source

출처

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