
В предыдущей части цикла мы разобрали устройство виртуального COM‑порта USB на базе микроконтроллера AT32F403ACGT7 производства компании Artery Technology и дополнили его функциональность.
В этой части мы проведём анализ примера реализации звукового устройства USB из архива с пакетом драйверов для MCU AT32F403A и адаптируем этот пример для запуска на нашей самодельной отладочной плате.
Данный цикл публикаций состоит из четырёх частей:
Составное устройство USB на AT32. Часть 1: Подготовка
Составное устройство USB на AT32F403A. Часть 2: Виртуальный COM‑порт и его доработки
Составное устройство USB на AT32F403A. Часть 3: Звуковое устройство и его доработки <‑- Вы тут
Составное устройство USB на AT32F403A. Часть 4: Составное устройство Audio + CDC
Исходный код проекта можно получить по ссылке: https://gitflic.ru/project/selenite_pro/at32f403acgt7_composite
Пример реализации звукового устройства USB расположен в папке с программным обеспечением для отладочной платы AT‑START‑F403A. Для запуска примера необходимо наличие платы расширения AT32-Audio‑EV V2.0 с кодеком W8988 на борту. Звуковое устройство в примере сконфигурировано так, что изменение уровня сигналов производится аппаратными средствами кодека, и обработкой запросов на это занята большая часть программы примера.
Снова читаем дескрипторы
И снова начнём с дескриптора устройства USB: открываем файл audio_desc.c и находим там массив g_usbd_descriptor[USB_DEVICE_DESC_LEN]. Видим, что значения байта 4 (bDeviceClass), байта 5 (bDeviceSubClass) и байта 6 (bDeviceProtocol) равны нулю, то есть класс устройства определяется на уровне описания интерфейсов, как и должно быть для звуковых устройств USB согласно данным раздела 4.1 на странице 36 документа [3].
audio_desc.c
...
USB_DEVICE_DESC_LEN, /* bLength */
USB_DESCIPTOR_TYPE_DEVICE, /* bDescriptorType */
0x00, /* bcdUSB */
0x02,
0x00, /* bDeviceClass */
0x00, /* bDeviceSubClass */
0x00, /* bDeviceProtocol */
USB_MAX_EP0_SIZE, /* bMaxPacketSize */
LBYTE(USBD_AUDIO_VENDOR_ID), /* idVendor */
HBYTE(USBD_AUDIO_VENDOR_ID), /* idVendor */
LBYTE(USBD_AUDIO_PRODUCT_ID), /* idProduct */
HBYTE(USBD_AUDIO_PRODUCT_ID), /* idProduct */
0x00, /* bcdDevice rel. 2.00 */
0x02,
USB_MFC_STRING, /* Index of manufacturer string */
USB_PRODUCT_STRING, /* Index of product string */
USB_SERIAL_STRING, /* Index of serial number string */
0x01 /* bNumConfigurations */
Переходим к дескриптору конфигурации (файл audio_desc.c, g_usbd_configuration[USBD_CDC_CONFIG_DESC_SIZE]) и определяем по значению байта 4 (bNumInterfaces = 0×03), что конфигурация содержит три интерфейса интерфейс управления, интерфейс ввода и интерфейс вывода.
Дескриптор интерфейса управления (AudioControl Interface Descriptor) всегда идёт первым, и номер интерфейса управления (байт 11, bInterfaceNumber = 0×00) обязан быть меньше, чем у других интерфейсов устройства. По значениям байта 14 (bInterfaceClass = 0×01, Audio interface class code) и байта 15 (bInterfaceSubClass = 0×01, Audio control interface subclass code) определяем, что это — на самом деле интерфейс управления звукового устройства (см. таблицы Приложения А на странице 99 документа [3]).
Дальнейшие 78 байт дескриптора конфигурации, начиная с байта 18 (запомним это смещение), описывают структуру звукового устройства USB, представленную на рисунке ниже:

Чтобы не пересказывать большую часть разделов 3.5 и 4.3 [3], опишем составные части, изображённые на рисунке и их дескрипторы, очень кратко.
Интерфейсу управления подчинены два других интерфейса: ввода и вывода. Каждый из них содержит в своём составе терминал ввода (Input Terminal, IT), функциональный блок (Feature Unit, FU) и терминал вывода (Output Terminal, OT). Каждая составная часть интерфейса (IT, FU, OT) имеет свой отдельный дескриптор для описания характеристик и функциональности.
Для интерфейса ввода в качестве IT с присвоенным ему идентификатором ID1 выступает стереофонический (двухканальный) микрофон (wTerminalType = 0×0201; bNrChannels = 0×02; wChannelConfig = 0×0003, left front and right front). К выходу терминала ID1 подключён блок FU с идентификатором ID2. Два байта дескриптора функционального блока bmaControls0 = 0×0003 назначают блоку функцию регулировки громкости и отключения звука в основном канале. Запомним наименование этих двух байтов и перейдём к подключённому к выходу блока ID2 терминалу OT с идентификатором ID3, через который наше звуковое устройство выводит поток данных по стыку USB.
Для интерфейса вывода направление потока противоположное. Данные из хоста подаются на разъём USB (терминал ввода, ID4; wTerminalType = 0×0101; bNrChannels = 0×02; wChannelConfig = 0×0003, left front and right front) звукового устройства, передаются в функциональный блок с идентификатором ID5 и затем поступают на терминал вывода ID6, в качестве которого выступают стереофонические телефоны или динамики (wTerminalType = 0×0301). Блок обработки в этом интерфейсе так же, как и в интерфейсе ввода, имеет функцию регулировки громкости и отключения звука.
Далее, когда топология звукового устройства USB уже описана, следуют дескрипторы интерфейсов. Каждый из интерфейсов имеет два состояния: bAlternateSetting = 0, когда конечная точка (Endpoint, EP) от интерфейса отключена и поток данных через интерфейс не идёт, и bAlternateSetting = 1, когда через интерфейс идёт поток данных через подключённую конечную точку. Подробно дескрипторы интерфейсов ввода и вывода (AudioStreaming Interface Descriptors) и связанных с ними конечных точек описаны в разделах 4.5 и 4.6 [3].
Отдельно нужно отметить, что интерфейс вывода в рассматриваемом примере имеет возможность подключения дополнительной конечной точки (AS Isochronous Synch Endpoint) для синхронизации скорости потока данных через интерфейс. Потребность в синхронизации возникает из‑за неполного совпадения частот дискретизации на стороне устройства USB и хоста.
Разбираем обработчики
Как нетрудно догадаться, код обработчиков (handlers) размещён в файле audio_class.c. При включённой опции автоматического распределения памяти буфера USB в коде функций инициализации и деинициализации устройства ничего интересного не происходит.
Понять, как происходит обработка прерываний от связанных с интерфейсами конечных точек USBD_AUDIO_MIC_IN_EPT и USBD_AUDIO_SPK_OUT_EPT, тоже несложно. Обработчики этих событий просто обеспечивают обмен данными между буферами этих конечных точек и буфером кодека.
Перейдёт к обработчику setup‑запросов. По сравнению с обработчиком таких же запросов для виртуального COM‑порта функция class_setup_handler() даже на вид кажется гораздо сложней, но это только на вид. Помимо обработки стандартных запросов USB_STD_REQ_GET_INTERFACE и USB_STD_REQ_SET_INTERFACE добавилась обработка запроса USB_STD_REQ_GET_DESCRIPTOR:
audio_class.c
...
static usb_sts_type class_setup_handler(void udev, usb_setup_type setup)
{
usb_sts_type status = USB_OK;
usbd_core_type pudev = (usbd_core_type )udev;
uint16_t len;
switch(setup->bmRequestType & USB_REQ_TYPE_RESERVED)
{
/* class request */
case USB_REQ_TYPE_CLASS:
...
break;
/* standard request */
case USB_REQ_TYPE_STANDARD:
switch(setup->bRequest)
{
case USB_STD_REQ_GET_DESCRIPTOR:
if((setup->wValue >> 8) == AUDIO_DESCRIPTOR_TYPE)
{
usbd_desc_t *config = pudev->desc_handler->get_device_configuration();
len = MIN(AUDIO_DESCRIPTOR_SIZE, setup->wLength);
usbd_ctrl_send(pudev, config->descriptor + 18, len);
}
else
{
usbd_ctrl_unsupport(pudev);
}
break;
case USB_STD_REQ_GET_INTERFACE:
audio_get_interface(udev, setup);
break;
case USB_STD_REQ_SET_INTERFACE:
audio_set_interface(udev, setup);
usbd_ctrl_send_status(pudev);
break;
case USB_STD_REQ_CLEAR_FEATURE:
break;
case USB_STD_REQ_SET_FEATURE:
break;
default:
usbd_ctrl_unsupport(pudev);
break;
}
break;
default:
usbd_ctrl_unsupport(pudev);
break;
}
return status;
}
В результате обработки этого setup‑запроса хосту передаётся указатель (config→descriptor + 18) на начало описания структуры звукового устройства, которое смещено на 18 байтов от начала дескриптора конфигурации, как мы и выяснили ранее.
На фрагменте кода, представленном выше, исключена часть, связанная с обработкой запросов, специфических для класса устройства. Это сделано намеренно, так как аппаратного кодека у нас нет, и производить регулировку громкости и отключение звука нечем физически. Тем не менее, значительная часть кода в файле audio_class.c для этого и предназначена, как, кстати, и код в составе входящего в пример файла audio_codec.c.
Производим доработки
При адаптации примера реализации звукового устройства USB я старался вносить в существующий код минимальные изменения. Тем не менее, из функций в составе драйвера кодека пришлось исключить практически всё. Для организации «эха» в составе виртуального кодека был создан кольцевой буфер длиной в два пакета обмена данными по USB. Работа с буфером строится таким образом, что в одну его половину пишутся принятые звуковым устройством данные, в то время как из другой половины принятые ранее звуковым устройством данные передаются назад в хост. Синхронизация скорости потоков данных в этом случае не требуется, поэтому конечная точка обратной связи USBD_AUDIO_FEEDBACK_EPT отключена.
При доработке драйвера звукового устройства были введены четыре макроса:
audio_desc.h
...
#ifndef AUDIO_FEATURE_UNIT_MUTE_CTRL
#define AUDIO_FEATURE_UNIT_MUTE_CTRL 0x01
#endif
#ifndef AUDIO_FEATURE_UNIT_VOL_CTRL
#define AUDIO_FEATURE_UNIT_VOL_CTRL 0x01
#endif
#ifndef AUDIO_FEATURE_UNIT_CONTROLS
#define AUDIO_FEATURE_UNIT_CONTROLS (AUDIO_FEATURE_UNIT_MUTE_CTRL + (AUDIO_FEATURE_UNIT_VOL_CTRL << 1))
#endif
#ifndef AUDIO_CTRL_INTERFACE_NUMBER
#define AUDIO_CTRL_INTERFACE_NUMBER 0x00
#endif
Макрос AUDIO_CTRL_INTERFACE_NUMBER нужен для того, чтобы интерфейс управления звуковым устройством не был в дескрипторе «прибит» к номеру 0×00.
Остальные макросы служат для настройки свойств функциональных блоков (FU) и для внедрения в код команд препроцессора для отключения функций обработки запросов на регулировку уровня громкости и/или отключения звука, чтобы убрать нагромождения, мешающие пониманию связной картины работы драйвера.
Неочевидный нюанс: при отключении в дескрипторах функциональных блоков всего, что можно (bmaControls0 = 0×0000) Windows начинает определять подключённый интерфейс микрофона (wTerminalType = 0×0201), как интерфейс линейного входа. Почему, не понятно…
Краткие выводы и дальнейшие действия
В данной части цикла нам удалось понять в общих чертах принципы организации двунаправленного стереофонического звукового устройства USB на микроконтроллере AT32F403ACGT7 производства компании Artery Technology, добавить «абстракции» в дескрипторы этого устройства, «отвязать» драйвер устройства от аппаратного кодека и организовать «эхо» исходящего потока данных.
Далее мы реализуем драйвер составного устройства USB на основе доработанных драйверов виртуального COM‑порта и звукового устройства USB для нашей самодельной отладочной платы.
Список использованной литературы:
-
Universal Serial Bus Class Definitions for Communications Devices. Revision 1.2 (Errata 1), November 3, 2010
-
Universal Serial Bus Communications Class Subclass Specification for PSTN Devices. Revision 1.2, February 9, 2007
-
Universal Serial Bus Device Class Definition for Audio Devices. Release 1.0, March 18, 1998
-
USB Interface Association Descriptor Device Class Code and Use Model. Revision 1.0, July 23, 2003
© 2026 ООО «МТ ФИНАНС»
Автор: dmitriyrudnev
