build/dts/api/bindings/usb/usb-audio-mic.html · build/dts/api/bindings/usb/usb-audio-mic.rst 공식 원문 ↗

Zephyr 3.7.0 · Devicetree · USB Audio · Generic or vendor-independent

USB Audio Microphone Fields 바인딩

Microphone IN sample format·synchronization·channel과 feature flag를 정의하는 25개 property schema입니다.

Official pathbuild/dts/api/bindings/usb/usb-audio-mic.html
Source filebuild/dts/api/bindings/usb/usb-audio-mic.rst
Source versionZephyr 3.7.0
TranslationFull · reviewed

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

Part 1

요약·해설

공식 원문 250줄과 property 25행을 전수 대조해 IN synchronization legal/default/support state·sample defaults·required mute·no base property table 제약을 보존했습니다.

Compatible

usb-audio-mic

Vendor

Generic or vendor-independent

Properties

25 rows

Interface

USB audio microphone IN endpoint fields

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 28B7964B18AADDFF90119C6B203113950D840E68F7CFC59183BF8222BCCE036D
: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:: usb-audio-mic
.. _dtbinding_usb_audio_mic:

usb-audio-mic
#############

Vendor: :ref:`Generic or vendor-independent <dt_no_vendor>`

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



.. code-block:: none

   USB Audio microphone specific fields.

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

         * - ``resolution``
           - ``int``
           - Default value: ``16``

             Legal values: ``8``, ``16``, ``24``, ``32``

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

                Type of endpoint synchronization for IN devices.
                Default value is Synchronous.
                Adaptive is not supported.



             Default value: ``Synchronous``

             Legal values: ``'No Synchronization'``, ``'Asynchronous'``, ``'Adaptive'``, ``'Synchronous'``

         * - ``sample-rate-hz``
           - ``int``
           - Default value: ``48000``

         * - ``polling-interval``
           - ``int``
           - Default value: ``1``

         * - ``channel-l``
           - ``boolean``
           - .. code-block:: none

                Enable (l) channel.


         * - ``channel-r``
           - ``boolean``
           - .. code-block:: none

                Enable (r) channel.


         * - ``channel-c``
           - ``boolean``
           - .. code-block:: none

                Enable (c) channel.


         * - ``channel-lfe``
           - ``boolean``
           - .. code-block:: none

                Enable (lfe) channel.


         * - ``channel-ls``
           - ``boolean``
           - .. code-block:: none

                Enable (ls) channel.


         * - ``channel-rs``
           - ``boolean``
           - .. code-block:: none

                Enable (rs) channel.


         * - ``channel-lc``
           - ``boolean``
           - .. code-block:: none

                Enable (lc) channel.


         * - ``channel-rc``
           - ``boolean``
           - .. code-block:: none

                Enable (rc) channel.


         * - ``channel-s``
           - ``boolean``
           - .. code-block:: none

                Enable (s) channel.


         * - ``channel-sl``
           - ``boolean``
           - .. code-block:: none

                Enable (sl) channel.


         * - ``channel-sr``
           - ``boolean``
           - .. code-block:: none

                Enable (sr) channel.


         * - ``channel-t``
           - ``boolean``
           - .. code-block:: none

                Enable (t) channel.


         * - ``channel-cfg``
           - ``boolean``
           - .. code-block:: none

                Enable (cfg) channel.


         * - ``feature-mute``
           - ``boolean``
           - .. code-block:: none

                Enable Mute feature.


             This property is **required**.

         * - ``feature-volume``
           - ``boolean``
           - .. code-block:: none

                Enable Volume feature.
                Currently not supported.



         * - ``feature-tone-control``
           - ``boolean``
           - .. code-block:: none

                Enable Tone Control (Bass, Mid, Treble) feature.
                Currently not supported.



         * - ``feature-graphic-equalizer``
           - ``boolean``
           - .. code-block:: none

                Enable  Graphic Equalizer feature.
                Currently not supported.



         * - ``feature-automatic-gain-control``
           - ``boolean``
           - .. code-block:: none

                Enable Autoamtic Gain Control feature.
                Currently not supported.



         * - ``feature-delay``
           - ``boolean``
           - .. code-block:: none

                Enable Delay feature.
                Currently not supported.



         * - ``feature-bass-boost``
           - ``boolean``
           - .. code-block:: none

                Enable Bass Boost feature.
                Currently not supported.



         * - ``feature-loudness``
           - ``boolean``
           - .. code-block:: none

                Enable Loudness feature.
                Currently not supported.





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

      (None)


Part 3

한국어 전문 번역

usb-audio-mic

Vendor: Generic or vendor-independent

공식 설명

USB Audio microphone specific fields.

Microphone IN endpoint의 timing과 channel 구성을 선언

Resolution 기본값은 16 bit, sample rate는 48,000 Hz, polling interval은 1입니다. sync-type 기본값은 Synchronous이며 No Synchronization, Asynchronous, Adaptive, Synchronous를 legal value로 나열하지만 Adaptive는 현재 미지원입니다.

Microphone

Audio source

Channel flags

l/r/c/lfe/.../cfg

USB IN endpoint

Sync + polling

Host capture

Receives samples

feature-mute만 필수입니다. Volume과 나머지 effect flag는 선택이지만 모두 현재 미지원입니다. 이 page에는 base property가 없으므로 compatible이나 reg 행을 임의로 추가하지 않았습니다.

속성 전체 번역

공식 node-specific property 25개를 모두 번역했습니다. 이 page의 base property 표는 비어 있습니다.

노드 전용 속성 · 25개
이름형식설명과 제약
resolutionintAudio sample resolution이며 8, 16, 24, 32 bit 중 하나입니다.
기본값: 16 · 허용값: 8, 16, 24, 32
sync-typestringIN endpoint synchronization 유형입니다. 기본값은 Synchronous이고 Adaptive는 legal value로 표시되지만 현재 지원되지 않습니다.
기본값: Synchronous · 허용값: 'No Synchronization', 'Asynchronous', 'Adaptive', 'Synchronous'
sample-rate-hzintAudio sample rate이며 Hz 단위입니다.
기본값: 48000
polling-intervalintUSB audio endpoint polling interval입니다.
기본값: 1
channel-lboolean(l) audio channel을 활성화합니다.
channel-rboolean(r) audio channel을 활성화합니다.
channel-cboolean(c) audio channel을 활성화합니다.
channel-lfeboolean(lfe) audio channel을 활성화합니다.
channel-lsboolean(ls) audio channel을 활성화합니다.
channel-rsboolean(rs) audio channel을 활성화합니다.
channel-lcboolean(lc) audio channel을 활성화합니다.
channel-rcboolean(rc) audio channel을 활성화합니다.
channel-sboolean(s) audio channel을 활성화합니다.
channel-slboolean(sl) audio channel을 활성화합니다.
channel-srboolean(sr) audio channel을 활성화합니다.
channel-tboolean(t) audio channel을 활성화합니다.
channel-cfgboolean(cfg) audio channel을 활성화합니다.
feature-mutebooleanMute 기능을 활성화하는 필수 flag입니다.
필수
feature-volumebooleanVolume 기능을 활성화합니다. 현재 지원되지 않습니다.
feature-tone-controlbooleanBass/Mid/Treble Tone Control 기능을 활성화합니다. 현재 지원되지 않습니다.
feature-graphic-equalizerbooleanGraphic Equalizer 기능을 활성화합니다. 현재 지원되지 않습니다.
feature-automatic-gain-controlbooleanAutomatic Gain Control 기능을 활성화합니다. 현재 지원되지 않습니다.
feature-delaybooleanDelay 기능을 활성화합니다. 현재 지원되지 않습니다.
feature-bass-boostbooleanBass Boost 기능을 활성화합니다. 현재 지원되지 않습니다.
feature-loudnessbooleanLoudness 기능을 활성화합니다. 현재 지원되지 않습니다.

Source

출처

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