Part 1
요약·해설
공식 원문 167줄과 property 12행을 전수 대조해 required linked terminal·Type IV external stream·asynchronous implicit feedback·clock lock and sample format 제약을 보존했습니다.
zephyr,uac2-audio-streaming
Zephyr-specific binding
12 rows
UAC2 Audio Streaming interface
Part 2
접을 수 있는 영어 원문 전체
영어 원문 전체 펼치기
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 interfaceStreaming interface를 terminal과 clock recovery 동작에 연결
linked-terminal은 stream이 연결되는 Input 또는 Output Terminal이며 유일한 필수 property입니다. external-interface를 설정하면 USB로 audio data를 전달하지 않는 Type IV stream이 됩니다.
Required linked-terminal
Alternate setting
Implicit or explicit feedback
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-terminal | phandle | 이 Audio Streaming interface가 연결되는 Input 또는 Output Terminal의 phandle입니다. 필수 |
active-alternate-setting-control | string | 현재 active alternate setting을 읽는 control capability입니다. 허용값: 'read-only' |
valid-alternate-settings-control | string | 사용 가능한 alternate setting을 읽는 control capability입니다. 허용값: 'read-only' |
external-interface | boolean | 설정하면 audio stream이 USB로 전송되지 않는 Type IV Audio Stream입니다. |
implicit-feedback | boolean | Asynchronous endpoint의 implicit feedback을 활성화합니다. IN에서는 implicit-feedback data endpoint가 되고 OUT에서는 explicit feedback endpoint를 제거합니다. |
pitch-control | string | Pitch Control capability가 read-only인지 host-programmable인지 지정합니다. 허용값: 'read-only', 'host-programmable' |
data-overrun-control | string | Data Overrun 상태를 읽는 control capability입니다. 허용값: 'read-only' |
data-underrun-control | string | Data Underrun 상태를 읽는 control capability입니다. 허용값: 'read-only' |
lock-delay | int | Endpoint의 internal clock recovery circuit이 안정적으로 lock되는 데 걸리는 시간입니다. |
lock-delay-units | string | lock-delay의 단위이며 milliseconds 또는 decoded PCM samples입니다. 허용값: 'milliseconds', 'decoded-pcm-samples' |
subslot-size | int | Audio subslot 하나가 차지하는 byte 수이며 1, 2, 3, 4 중 하나입니다. |
bit-resolution | int | Audio subslot에서 실제로 사용하는 bit 수입니다. |
Source
출처
영어 원문에는 문단, 문서 지시문, 표, 코드, 코드 심벌, 경로를 그대로 보존했습니다.