Using the Audio Class Demo Application
Micrium provides a demo application that lets you test and evaluate the class implementation. Source template files are provided.
Note that the demo application provided by Micriµm is only an example and is intended to be used as a starting point to develop your own application.
Configuring Device Application
The audio class provides two demos:
Microphone demo exercises isochronous IN transfers and consequently the record stream and some class-specific requests.
Loopback demo exercises isochronous IN and OUT transfers, that is respectively record and playback streams. Loopback demo can be thought as a headset demo.
The demo application files offering the two audio demos are provided for µC/OS-II and µC/OS-III and should be considered as example that you can modify. The files composing the demo application are:
File | Description | Location |
|---|---|---|
| Contains a few constants to configure its internal tasks. | Not provided in package. |
| Contains constants related to audio class demos. |
|
| Allows to initialize audio class. Refer to section Audio Class Instance Configuration for more details. |
|
| Simulates a microphone and a headset used as a loopback. |
|
| Defines audio data waveforms samples used by the microphone demo. |
|
The use of these constants usually defined in app_cfg.h or app_usbd_cfg.h allow you to use one of the audio demos.
Constant | Description | Demo | File |
|---|---|---|---|
| Priority of the task used by the microphone or loopback demo. Since the microphone or loopback task simulates a hardware behavior, the priority of this task should be greater than the priority of the record, playback and core tasks. Furthermore, the microphone or loopback task uses a 1-ms delay in certain circumstances. You should ensure that the tick rate for µC/OS-II or OS-III is set to 1000 ticks per second. | Both |
|
| Stack size of the tasks used by microphone or loopback demo. A default value can be 512. | Both |
|
| Enables the audio class demo application. Must be set to | Both |
|
| Enables microphone or loopback demo. | Both |
|
| Selects the sound type, that is the waveform used to generate a certain tone. Possible values are: | Microphone |
|
| Selects frequency of the waveform. Possible values are: | Microphone |
|
| Specifies the queue length for playback & record tasks. | Both |
|
| Configures the maximum number of record buffers. | Both |
|
| Configures the record stream built-in correction period in milliseconds. | Both |
|
| Configures the maximum number of playback buffers. | Loopback |
|
| Configures the playback stream built-in correction period in milliseconds. | Loopback |
|
| Configures the number of entities composing the audio function. | Both | app_usbd_cfg.h |
Stream Correction
It is possible to enable the stream correction for the microphone and loopback demos, that is constants USBD_AUDIO_CFG_RECORD_CORR_EN, USBD_AUDIO_CFG_PLAYBACK_CORR_EN and/or USBD_AUDIO_CFG_PLAYBACK_FEEDBACK_EN. But keep in mind that it does NOT represent a real situation of stream correction usage as both demos simulate the codec behavior using a task and consequently does not represent a real audio timing.
Running the Demo Application
For demos explanation purpose, we will consider the operating system Microsoft Windows 7 or later.
Microphone demo
The microphone demo requires the following components on the host PC side:
USB or jack headphone, speaker or headset with built-in speaker.
Sound Manager (accessible via menu Start > Control Panel > Sound).
The microphone demo is built using an audio function topology defined in the file usbd_audio_dev_cfg.c and composed of:
1 Input Terminal of type analog mic IN,
1 Output Terminal of type USB IN,
1 Feature Unit to manage volume and mute controls,
1 record AudioStreaming interface associated to the Input Terminal.
Refer to Figure - usbd_audio_dev_cfg.c - Typical Topologies Example for a visual representation of this audio function.
Figure - Microphone Demo shows the principle of the microphone demo.
(1) The Windows audio driver opens the record stream by selecting the first operational AudioStreaming interface. This step is done automatically when the audio device is connected to the PC.
(2) The microphone task detects that the stream is open and starts sending pre-defined record data to the host. The record data corresponds to the waveform selected with the constant APP_CFG_USBD_AUDIO_DRV_SIMULATION_DATA_WAVEFORM. In fact, the audio class record task will take care of submitting record data via isochronous IN transfers (USBD_IsocTxAsync). The host will forward record data to a headphone for instance. You should hear the waveform (sinus, square, sawtooth or beep beep). If the host sends some requests to change the volume or to mute/unmute the stream, the microphone task will apply the volume or mute change on the record data accordingly.
(3) The Windows audio driver closes the stream by selecting the default AudioStreaming interface. This action is done only if you decide to disable the microphone from the Sound Manager.
Upon connection of your audio device, the simulated microphone device should appear in the recording devices list of the Sound Manager as shown in Figure - Sound Manager - Microphone in Recording Devices List. In this example, the recording device is identified as "Micrium Audio Product" (ProductStrPtr field of USBD_DEV_CFG set to this string).
In order to listen to the waveform signal, you need to ensure that:
the volume level is different from 0 and the microphone is not muted. Select your microphone, click the button "Properties", go to the tab "Levels" and check the settings. It should look like Figure - Sound Manager - Microphone Levels.
the playthrough feature is enabled. Select your microphone, click the button "Properties", go to the tab "Listen" and select "Listen to this device". Ensure that the Windows audio driver will playback the record data through your headphone by looking at the "Playback through this device" list (cf. Figure - Sound Manager - Microphone Playthrough).
Loopback demo
The loopback demo requires the following components on the host PC side:
USB or jack headphone, speaker or headset with built-in speaker.
Music Player (for example, Windows Media Player).
Sound Manager (accessible via menu Start > Control Panel > Sound).
The loopback demo is built using an audio function topology defined in the file usbd_audio_dev_cfg.c and composed of:
Two Input terminals of type analog mic IN and USB OUT,
Two Output terminals of type USB IN and speaker,
Two Feature units to manage volume and mute controls for microphone and speaker parts.
Two AudioStreaming interfaces (one record and one playback). Each associated to one of the Input terminals.
Refer to Figure - usbd_audio_dev_cfg.c - Typical Topologies Example for a visual representation of this audio function.
Figure - Loopback Demo shows the principle of the loopback demo which can be seen as a simulated headset.