Bollywood HungamaSCOOP: Ramayana's BLOCKBUSTER run creates IMAX show-sharing hurdles for Godzilla Minus Zero; The Hunger Games may skip IMAX releaseThe Jerusalem PostTargeted killing of Hamas officials 'makes it easier for soldiers on front lines,' says IDF officerSky TG24Tour nei teatri, musica ed emozioni: Arisa si racconta in scenaPunchADC rejects claim it sponsored attack on Tinubu’s convoyInquirerGatchalian warns about minors’ gun access after foiled school shootingDaily MaverickIran attacks US bases in Gulf countries despite diplomatic effortsCNN TürkRooney'den çarpıcı itiraf: Manchester United’da oynarken intiharı düşündümZDF heuteAktuelle Pressemitteilungen des ZDFIl Fatto QuotidianoIran, raid con droni sulle basi militari Usa in Bahrein e Kuwait. Media Teheran: “Feriti diversi militari americani”South China Morning PostKey takeaways from speeches at Apec CEO Summit, including Xi and Putin addressesObservador Desporto“Esta reunião só serve para os líderes afirmarem estatuto”n-tvWas ist Scherhant passiert?: Eine DFB-Sensationsgeschichte, die fast niemand für möglich hielt
The Daily Newsstand · Free, Always
Wednesday, November 18, 2026

Составное устройство USB на AT32F403A. Часть 3: Звуковое устройство и его доработки

Translate

В предыдущей части цикла мы разобрали устройство виртуального 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 = 0x03), что конфигурация содержит три интерфейса интерфейс управления, интерфейс ввода и интерфейс вывода.

Дескриптор интерфейса управления (AudioControl Interface Descriptor) всегда идёт первым, и номер интерфейса управления (байт 11, bInterfaceNumber = 0x00) обязан быть меньше, чем у других интерфейсов устройства. По значениям байта 14 (bInterfaceClass = 0x01, Audio interface class code) и байта 15 (bInterfaceSubClass = 0x01, 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 = 0x0201; bNrChannels = 0x02; wChannelConfig = 0x0003, left front and right front). К выходу терминала ID1 подключён блок FU с идентификатором ID2. Два байта дескриптора функционального блока bmaControls0 = 0x0003 назначают блоку функцию регулировки громкости и отключения звука в основном канале. Запомним наименование этих двух байтов и перейдём к подключённому к выходу блока ID2 терминалу OT с идентификатором ID3, через который наше звуковое устройство выводит поток данных по стыку USB.

Для интерфейса вывода направление потока противоположное. Данные из хоста подаются на разъём USB (терминал ввода, ID4; wTerminalType = 0x0101; bNrChannels = 0x02; wChannelConfig = 0x0003, left front and right front) звукового устройства, передаются в функциональный блок с идентификатором ID5 и затем поступают на терминал вывода ID6, в качестве которого выступают стереофонические телефоны или динамики (wTerminalType = 0x0301). Блок обработки в этом интерфейсе так же, как и в интерфейсе ввода, имеет функцию регулировки громкости и отключения звука.

Далее, когда топология звукового устройства 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 нужен для того, чтобы интерфейс управления звуковым устройством не был в дескрипторе «прибит» к номеру 0x00.

Остальные макросы служат для настройки свойств функциональных блоков (FU) и для внедрения в код команд препроцессора для отключения функций обработки запросов на регулировку уровня громкости и/или отключения звука, чтобы убрать нагромождения, мешающие пониманию связной картины работы драйвера.

Неочевидный нюанс: при отключении в дескрипторах функциональных блоков всего, что можно (bmaControls0 = 0x0000) Windows начинает определять подключённый интерфейс микрофона (wTerminalType = 0x0201), как интерфейс линейного входа. Почему, не понятно…

Краткие выводы и дальнейшие действия

В данной части цикла нам удалось понять в общих чертах принципы организации двунаправленного стереофонического звукового устройства USB на микроконтроллере AT32F403ACGT7 производства компании Artery Technology, добавить «абстракции» в дескрипторы этого устройства, «отвязать» драйвер устройства от аппаратного кодека и организовать «эхо» исходящего потока данных.

Далее мы реализуем драйвер составного устройства USB на основе доработанных драйверов виртуального COM-порта и звукового устройства USB для нашей самодельной отладочной платы.

Список использованной литературы:

1. Universal Serial Bus Class Definitions for Communications Devices. Revision 1.2 (Errata 1), November 3, 2010

2. Universal Serial Bus Communications Class Subclass Specification for PSTN Devices. Revision 1.2, February 9, 2007

3. Universal Serial Bus Device Class Definition for Audio Devices. Release 1.0, March 18, 1998

4. USB Interface Association Descriptor Device Class Code and Use Model. Revision 1.0, July 23, 2003

© 2026 ООО «МТ ФИНАНС»

Если эта публикация вас вдохновила и вы хотите поддержать автора — не стесняйтесь нажать на кнопку

View the original on Хабр →

KioskNews shows a cleaned-up reading view extracted from the publisher’s page — the original always lives on their site, not ours.