Page Comparison

...

The audio class provides several structures that can be used to build an audio function topology. These structures relate to units, terminals and streams. They will be declared and initialized in usbd_audio_dev_cfg.h and usbd_audio_dev_cfg.c files.  presents Table - User Configurable Structures for Creating Audio Function Topology presents all configurable structures and the associated function that will use the structure. Functions are described in Class Instance Configuration section.

...

• Two Inputs terminals
• Two Ouput terminals
• Two Feature units 
• Two AudioStreaming interfaces

 gives Figure - usbd_audio_dev_cfg.c - Typical Topologies Example gives a visual representation of the possible topologies that can be built with the 6 terminals and units.

Terminals

Input Terminal

 presents Table - USBD_AUDIO_IT_CFG Structure Fields Description presents the Input terminal structure. Refer to audio 1.0 specification, section "4.3.2.1 Input Terminal Descriptor" for more details about certain fields.

...

Output Terminal

Output Terminal

Table - USBD_AUDIO_OT_CFG Structure Fields Description presents the Output terminal structure. Refer to audio 1.0 specification, section "4.3.2.2 Output Terminal Descriptor" for more details about certain fields.

Units

Feature Unit

 presents Table - USBD_AUDIO_FU_CFG Structure Fields Description presents the Feature Unit structure. Refer to audio 1.0 specification, section "4.3.2.5 Feature Unit Descriptor" for more details about certain fields.

LogChCtrlPtr points to a table of 16-bit unsigned integers. These integers are used as bitmaps to describe which Feature Unit controls are supported by a certain logical channel. Refer to  for to Table - Units and Terminals Description, Controls and Requests for the complete list of Feature Unit controls. An audio stream encodes several logical channels forming a cluster. For instance, in a stereo stream, left and right channel are two logical channels. Each Feature Unit can apply a certain control to a specific logical channel or to all channels at once. The master channel is used to designate all channels. The code snippet below shows an example of Feature Unit controls table. The table index represents the logical channel number. 

CPU_INT16U  FU_LogChCtrlTbl[] = {
   (USBD_AUDIO_FU_CTRL_MUTE | USBD_AUDIO_FU_CTRL_VOL),          (1)
    USBD_AUDIO_FU_CTRL_NONE,                                    (2)
    USBD_AUDIO_FU_CTRL_NONE                                     (3)
};

Mixer Unit

...

Mixer Unit

Table - USBD_AUDIO_MU_CFG Structure Fields Description presents the Mixer Unit structure. Refer to audio 1.0 specification, section "4.3.2.3 Mixer Unit Descriptor" for more details about certain fields.

The total number of logical input channels ( LogInChNbr ) is equal to the addition of all logical input channels that composes each input pin. For instance, if a Mixer Unit has 3 inputs pins with the following logical input channels characteristics:

...

Selector Unit

 presents 106037317 presents the Selector Unit structure. Refer to audio 1.0 specification, section "4.3.2.4 Selector Unit Descriptor" for more details about certain fields.

Streams

General Stream Configuration

 presents Table - USBD_AUDIO_STREAM_CFG Structure Fields Description presents the general stream configuration structure. .

AudioStreaming Interface

 presents 106037317 presents the AudioStreaming interface configuration structure. Each AudioStreaming interface has one unique associated isochronous endpoint. Hence, there is a one-to-one relation between an AudioStreaming interface and its associated endpoint.

The table pointed by SamplingFreqTblPtr can be declared as shown below:

CPU_INT32U  AS_SamFreqTbl[] = {
    USBD_AUDIO_FMT_TYPE_I_SAMFREQ_44_1KHZ,
    USBD_AUDIO_FMT_TYPE_I_SAMFREQ_48KHZ
};

Table pointed by AS_CfgPtrTbl can be declared as shown below:

USBD_AUDIO_AS_ALT_CFG  *USBD_AS_IF1_Alt_SpeakerCfgTbl[] = {     (1)
   &USBD_AS_IF1_Alt1_SpeakerCfg,    
   &USBD_AS_IF1_Alt2_SpeakerCfg,    
   &USBD_AS_IF1_Alt3_SpeakerCfg,    
};