Adding upstream version 1:017.upstream/1%017upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 1131 insertions, 0 deletions

diff --git a/desc-defs.c b/desc-defs.c
new file mode 100644
index 0000000..4cad9e7
--- /dev/null
+++ b/desc-defs.c
@@ -0,0 +1,1131 @@
+// SPDX-License-Identifier: GPL-2.0-or-later
+/*
+ * USB descriptor definitions
+ *
+ * Copyright (C) 2017-2018 Michael Drake <michael.drake@codethink.co.uk>
+ */
+
+#include "config.h"
+
+#include <stdbool.h>
+#include <stdlib.h>
+#include <stdio.h>
+
+#include "desc-defs.h"
+
+/** Macro for computing number of elements in array. */
+#define ARRAY_LEN(a) ((sizeof(a)) / (sizeof(a[0])))
+
+/**
+ * Undefined descriptor
+ *
+ * Ensures remaining data is dumped as garbage at end of descriptor.
+ */
+const struct desc desc_undefined[] = {
+	{ .field = NULL }
+};
+
+/** USB Audio Device Class 1 Channel Names.  (Note: Order matters.) */
+static const char * const uac1_channel_names[] = {
+	"Left Front (L)", "Right Front (R)", "Center Front (C)",
+	"Low Frequency Enhancement (LFE)", "Left Surround (LS)",
+	"Right Surround (RS)", "Left of Center (LC)", "Right of Center (RC)",
+	"Surround (S)", "Side Left (SL)", "Side Right (SR)", "Top (T)"
+};
+
+/** USB Audio Device Class 2 Channel Names.  (Note: Order matters.) */
+static const char * const uac2_channel_names[] = {
+	"Front Left (FL)", "Front Right (FR)", "Front Center (FC)",
+	"Low Frequency Effects (LFE)", "Back Left (BL)", "Back Right (BR)",
+	"Front Left of Center (FLC)", "Front Right of Center (FRC)",
+	"Back Center (BC)", "Side Left (SL)", "Side Right (SR)",
+	"Top Center (TC)", "Top Front Left (TFL)", "Top Front Center (TFC)",
+	"Top Front Right (TFR)", "Top Back Left (TBL)", "Top Back Center (TBC)",
+	"Top Back Right (TBR)", "Top Front Left of Center (TFLC)",
+	"Top Front Right of Center (TFRC)", "Left Low Frequency Effects (LLFE)",
+	"Right Low Frequency Effects (RLFE)", "Top Side Left (TSL)",
+	"Top Side Right (TSR)", "Bottom Center (BC)",
+	"Back Left of Center (BLC)", "Back Right of Center (BRC)"
+};
+
+/** Audio Control Interface Header bmControls; Human readable bit meanings. */
+static const char * const uac2_interface_header_bmcontrols[] = {
+	[0] = "Latency control",
+	[1] = NULL
+};
+
+/** UAC1: 4.3.2 Class-Specific AC Interface Descriptor; Table 4-2. */
+static const struct desc desc_audio_1_ac_header[] = {
+	{ .field = "bcdADC",        .size = 2, .type = DESC_BCD },
+	{ .field = "wTotalLength",  .size = 2, .type = DESC_CONSTANT },
+	{ .field = "bInCollection", .size = 1, .type = DESC_CONSTANT },
+	{ .field = "baInterfaceNr", .size = 1, .type = DESC_NUMBER,
+			.array = { .array = true } },
+	{ .field = NULL }
+};
+
+/** UAC2: 4.7.2 Class-Specific AC Interface Descriptor; Table 4-5. */
+static const struct desc desc_audio_2_ac_header[] = {
+	{ .field = "bcdADC",       .size = 2, .type = DESC_BCD },
+	{ .field = "bCategory",    .size = 1, .type = DESC_CONSTANT },
+	{ .field = "wTotalLength", .size = 2, .type = DESC_NUMBER },
+	{ .field = "bmControls",   .size = 1, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac2_interface_header_bmcontrols },
+	{ .field = NULL }
+};
+
+/** UAC3: 4.5.2 Class-Specific AC Interface Descriptor; Table 4-15. */
+static const struct desc desc_audio_3_ac_header[] = {
+	{ .field = "bCategory",    .size = 1, .type = DESC_CONSTANT },
+	{ .field = "wTotalLength", .size = 2, .type = DESC_NUMBER },
+	{ .field = "bmControls",   .size = 4, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac2_interface_header_bmcontrols },
+	{ .field = NULL }
+};
+
+/** AudioControl Header descriptor definitions for the three Audio Device Class protocols */
+const struct desc * const desc_audio_ac_header[3] = {
+	desc_audio_1_ac_header,
+	desc_audio_2_ac_header,
+	desc_audio_3_ac_header,
+};
+
+/** UAC2: 4.7.2.10 Effect Unit Descriptor; Table 4-15. */
+static const struct desc desc_audio_2_ac_effect_unit[] = {
+	{ .field = "bUnitID",     .size = 1, .type = DESC_NUMBER },
+	{ .field = "wEffectType", .size = 2, .type = DESC_CONSTANT },
+	{ .field = "bSourceID",   .size = 1, .type = DESC_CONSTANT },
+	{ .field = "bmaControls", .size = 4, .type = DESC_BITMAP,
+			.array = { .array = true } },
+	{ .field = "iEffects",    .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = NULL }
+};
+
+/** UAC3: 4.5.2.9 Effect Unit Descriptor; Table 4-33. */
+static const struct desc desc_audio_3_ac_effect_unit[] = {
+	{ .field = "bUnitID",          .size = 1, .type = DESC_NUMBER },
+	{ .field = "wEffectType",      .size = 2, .type = DESC_CONSTANT },
+	{ .field = "bSourceID",        .size = 1, .type = DESC_CONSTANT },
+	{ .field = "bmaControls",      .size = 4, .type = DESC_BITMAP,
+			.array = { .array = true } },
+	{ .field = "wEffectsDescrStr", .size = 2, .type = DESC_CS_STR_DESC_ID },
+	{ .field = NULL }
+};
+
+/** Effect Unit descriptor definitions for the three Audio Device Class protocols */
+const struct desc * const desc_audio_ac_effect_unit[3] = {
+	NULL, /* UAC1 not supported */
+	desc_audio_2_ac_effect_unit,
+	desc_audio_3_ac_effect_unit,
+};
+
+/** UAC2 Input Terminal bmControls; Human readable bit meanings. */
+static const char * const uac2_input_term_bmcontrols[] = {
+	[0] = "Copy Protect",
+	[1] = "Connector",
+	[2] = "Overload",
+	[3] = "Cluster",
+	[4] = "Underflow",
+	[5] = "Overflow",
+	[6] = NULL
+};
+
+/** UAC3 Input Terminal bmControls; Human readable bit meanings. */
+static const char * const uac3_input_term_bmcontrols[] = {
+	[0] = "Insertion",
+	[1] = "Overload",
+	[2] = "Underflow",
+	[3] = "Overflow",
+	[4] = "Underflow",
+	[5] = NULL
+};
+
+/** UAC1: 4.3.2.1 Input Terminal Descriptor; Table 4-3. */
+static const struct desc desc_audio_1_ac_input_terminal[] = {
+	{ .field = "bTerminalID",    .size = 1, .type = DESC_NUMBER },
+	{ .field = "wTerminalType",  .size = 2, .type = DESC_TERMINAL_STR },
+	{ .field = "bAssocTerminal", .size = 1, .type = DESC_CONSTANT },
+	{ .field = "bNrChannels",    .size = 1, .type = DESC_NUMBER },
+	{ .field = "wChannelConfig", .size = 2, .type = DESC_BITMAP_STRINGS,
+			.bitmap_strings = { .strings = uac1_channel_names, .count = 12 } },
+	{ .field = "iChannelNames",  .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = "iTerminal",      .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = NULL }
+};
+
+/** UAC2: 4.7.2.4 Input Terminal Descriptor; Table 4-9. */
+static const struct desc desc_audio_2_ac_input_terminal[] = {
+	{ .field = "bTerminalID",     .size = 1, .type = DESC_NUMBER },
+	{ .field = "wTerminalType",   .size = 2, .type = DESC_TERMINAL_STR },
+	{ .field = "bAssocTerminal",  .size = 1, .type = DESC_CONSTANT },
+	{ .field = "bCSourceID",      .size = 1, .type = DESC_CONSTANT },
+	{ .field = "bNrChannels",     .size = 1, .type = DESC_NUMBER },
+	{ .field = "bmChannelConfig", .size = 4, .type = DESC_BITMAP_STRINGS,
+			.bitmap_strings = { .strings = uac2_channel_names, .count = 26 } },
+	{ .field = "iChannelNames",   .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = "bmControls",      .size = 2, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac2_input_term_bmcontrols },
+	{ .field = "iTerminal",       .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = NULL }
+};
+
+/** UAC3: 4.5.2.1 Input Terminal Descriptor; Table 4-16. */
+static const struct desc desc_audio_3_ac_input_terminal[] = {
+	{ .field = "bTerminalID",        .size = 1, .type = DESC_NUMBER },
+	{ .field = "wTerminalType",      .size = 2, .type = DESC_TERMINAL_STR },
+	{ .field = "bAssocTerminal",     .size = 1, .type = DESC_NUMBER },
+	{ .field = "bCSourceID",         .size = 1, .type = DESC_NUMBER },
+	{ .field = "bmControls",         .size = 4, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac3_input_term_bmcontrols },
+	{ .field = "wClusterDescrID",    .size = 2, .type = DESC_NUMBER },
+	{ .field = "wExTerminalDescrID", .size = 2, .type = DESC_NUMBER },
+	{ .field = "wConnectorsDescrID", .size = 2, .type = DESC_NUMBER },
+	{ .field = "wTerminalDescrStr",  .size = 2, .type = DESC_CS_STR_DESC_ID },
+	{ .field = NULL }
+};
+
+/** Input Terminal descriptor definitions for the three Audio Device Class protocols */
+const struct desc * const desc_audio_ac_input_terminal[3] = {
+	desc_audio_1_ac_input_terminal,
+	desc_audio_2_ac_input_terminal,
+	desc_audio_3_ac_input_terminal,
+};
+
+/** UAC2 Output Terminal bmControls; Human readable bit meanings. */
+static const char * const uac2_output_term_bmcontrols[] = {
+	[0] = "Copy Protect",
+	[1] = "Connector",
+	[2] = "Overload",
+	[3] = "Underflow",
+	[4] = "Overflow",
+	[5] = NULL
+};
+
+/** UAC3 Output Terminal bmControls; Human readable bit meanings. */
+static const char * const uac3_output_term_bmcontrols[] = {
+	[0] = "Insertion",
+	[1] = "Overload",
+	[2] = "Underflow",
+	[3] = "Overflow",
+	[4] = NULL
+};
+
+/** UAC1: 4.3.2.2 Output Terminal Descriptor; Table 4-4. */
+static const struct desc desc_audio_1_ac_output_terminal[] = {
+	{ .field = "bTerminalID",    .size = 1, .type = DESC_NUMBER },
+	{ .field = "wTerminalType",  .size = 2, .type = DESC_TERMINAL_STR },
+	{ .field = "bAssocTerminal", .size = 1, .type = DESC_NUMBER },
+	{ .field = "bSourceID",      .size = 1, .type = DESC_NUMBER },
+	{ .field = "iTerminal",      .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = NULL }
+};
+
+/** UAC2: 4.7.2.5 Output Terminal Descriptor; Table 4-10. */
+static const struct desc desc_audio_2_ac_output_terminal[] = {
+	{ .field = "bTerminalID",    .size = 1, .type = DESC_NUMBER },
+	{ .field = "wTerminalType",  .size = 2, .type = DESC_TERMINAL_STR },
+	{ .field = "bAssocTerminal", .size = 1, .type = DESC_NUMBER },
+	{ .field = "bSourceID",      .size = 1, .type = DESC_NUMBER },
+	{ .field = "bCSourceID",     .size = 1, .type = DESC_NUMBER },
+	{ .field = "bmControls",     .size = 2, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac2_output_term_bmcontrols },
+	{ .field = "iTerminal",      .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = NULL }
+};
+
+/** UAC3: 4.5.2.2 Output Terminal Descriptor; Table 4-17. */
+static const struct desc desc_audio_3_ac_output_terminal[] = {
+	{ .field = "bTerminalID",        .size = 1, .type = DESC_NUMBER },
+	{ .field = "wTerminalType",      .size = 2, .type = DESC_TERMINAL_STR },
+	{ .field = "bAssocTerminal",     .size = 1, .type = DESC_NUMBER },
+	{ .field = "bSourceID",          .size = 1, .type = DESC_NUMBER },
+	{ .field = "bCSourceID",         .size = 1, .type = DESC_NUMBER },
+	{ .field = "bmControls",         .size = 4, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac3_output_term_bmcontrols },
+	{ .field = "wExTerminalDescrID", .size = 2, .type = DESC_NUMBER },
+	{ .field = "wConnectorsDescrID", .size = 2, .type = DESC_NUMBER },
+	{ .field = "wTerminalDescrStr",  .size = 2, .type = DESC_CS_STR_DESC_ID },
+	{ .field = NULL }
+};
+
+/** Output Terminal descriptor definitions for the three Audio Device Class protocols */
+const struct desc * const desc_audio_ac_output_terminal[3] = {
+	desc_audio_1_ac_output_terminal,
+	desc_audio_2_ac_output_terminal,
+	desc_audio_3_ac_output_terminal,
+};
+
+/** UAC3: 4.5.2.3.1 Extended Terminal Header Descriptor; Table 4-18. */
+static const struct desc desc_audio_3_ac_extended_terminal_header[] = {
+	{ .field = "wDescriptorID", .size = 2, .type = DESC_NUMBER },
+	{ .field = "bNrChannels",   .size = 1, .type = DESC_NUMBER },
+	{ .field = NULL }
+};
+
+/** Extended Terminal descriptor definitions for the three Audio Device Class protocols */
+const struct desc * const desc_audio_ac_extended_terminal[3] = {
+	NULL, /* UAC1 not supported */
+	NULL, /* UAC2 not supported */
+	desc_audio_3_ac_extended_terminal_header,
+};
+
+/** UAC3: 4.5.2.15 Power Domain Descriptor; Table 4-46. */
+static const struct desc desc_audio_3_ac_power_domain[] = {
+	{ .field = "bPowerDomainID",    .size = 1, .type = DESC_NUMBER },
+	{ .field = "waRecoveryTime(1)", .size = 2, .type = DESC_NUMBER },
+	{ .field = "waRecoveryTime(2)", .size = 2, .type = DESC_NUMBER },
+	{ .field = "bNrEntities",       .size = 1, .type = DESC_NUMBER },
+	{ .field = "baEntityID",        .size = 1, .type = DESC_NUMBER,
+			.array = { .array = true, .length_field1 = "bNrEntities" } },
+	{ .field = "wPDomainDescrStr",  .size = 2, .type = DESC_CS_STR_DESC_ID },
+	{ .field = NULL }
+};
+
+/** Power Domain descriptor definitions for the three Audio Device Class protocols */
+const struct desc * const desc_audio_ac_power_domain[3] = {
+	NULL, /* UAC1 not supported */
+	NULL, /* UAC2 not supported */
+	desc_audio_3_ac_power_domain,
+};
+
+/** UAC2 Mixer Unit bmControls; Human readable bit meanings. */
+static const char * const uac2_mixer_unit_bmcontrols[] = {
+	[0] = "Cluster",
+	[1] = "Underflow",
+	[2] = "Overflow",
+	[3] = NULL
+};
+
+/** UAC3 Mixer Unit bmControls; Human readable bit meanings. */
+static const char * const uac3_mixer_unit_bmcontrols[] = {
+	[0] = "Underflow",
+	[1] = "Overflow",
+	[2] = NULL
+};
+
+/** UAC1: 4.3.2.3 Mixer Unit Descriptor; Table 4-5. */
+static const struct desc desc_audio_1_ac_mixer_unit[] = {
+	{ .field = "bUnitID",        .size = 1, .type = DESC_NUMBER },
+	{ .field = "bNrInPins",      .size = 1, .type = DESC_NUMBER },
+	{ .field = "baSourceID",     .size = 1, .type = DESC_NUMBER,
+			.array = { .array = true, .length_field1 = "bNrInPins" } },
+	{ .field = "bNrChannels",    .size = 1, .type = DESC_NUMBER },
+	{ .field = "wChannelConfig", .size = 2, .type = DESC_BITMAP_STRINGS,
+			.bitmap_strings = { .strings = uac1_channel_names, .count = 12 } },
+	{ .field = "iChannelNames",  .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = "bmControls",     .size = 1, .type = DESC_BITMAP,
+			.array = { .array = true, .bits = true,
+					.length_field1 = "bNrInPins",
+					.length_field2 = "bNrChannels" } },
+	{ .field = "iMixer",         .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = NULL }
+};
+
+/** UAC2: 4.7.2.6 Mixer Unit Descriptor; Table 4-11. */
+static const struct desc desc_audio_2_ac_mixer_unit[] = {
+	{ .field = "bUnitID",        .size = 1, .type = DESC_NUMBER },
+	{ .field = "bNrInPins",      .size = 1, .type = DESC_NUMBER },
+	{ .field = "baSourceID",     .size = 1, .type = DESC_NUMBER,
+			.array = { .array = true, .length_field1 = "bNrInPins" } },
+	{ .field = "bNrChannels",    .size = 1, .type = DESC_NUMBER },
+	{ .field = "bmChannelConfig",.size = 4, .type = DESC_BITMAP_STRINGS,
+			.bitmap_strings = { .strings = uac2_channel_names, .count = 26 } },
+	{ .field = "iChannelNames",  .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = "bmMixerControls",.size = 1, .type = DESC_BITMAP,
+			.array = { .array = true, .bits = true,
+					.length_field1 = "bNrInPins",
+					.length_field2 = "bNrChannels" } },
+	{ .field = "bmControls",     .size = 1, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac2_mixer_unit_bmcontrols },
+	{ .field = "iMixer",         .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = NULL }
+};
+
+/** UAC3: 4.5.2.5 Mixer Unit Descriptor; Table 4-29. */
+static const struct desc desc_audio_3_ac_mixer_unit[] = {
+	{ .field = "bUnitID",        .size = 1, .type = DESC_NUMBER },
+	{ .field = "bNrInPins",      .size = 1, .type = DESC_NUMBER },
+	{ .field = "baSourceID",     .size = 1, .type = DESC_NUMBER,
+			.array = { .array = true, .length_field1 = "bNrInPins" } },
+	{ .field = "wClusterDescrID",.size = 2, .type = DESC_NUMBER },
+	{ .field = "bmMixerControls",.size = 1, .type = DESC_BITMAP,
+			.array = { .array = true } },
+	{ .field = "bmControls",     .size = 4, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac3_mixer_unit_bmcontrols },
+	{ .field = "wMixerDescrStr", .size = 2, .type = DESC_CS_STR_DESC_ID },
+	{ .field = NULL }
+};
+
+/** Mixer Unit descriptor definitions for the three Audio Device Class protocols */
+const struct desc * const desc_audio_ac_mixer_unit[3] = {
+	desc_audio_1_ac_mixer_unit,
+	desc_audio_2_ac_mixer_unit,
+	desc_audio_3_ac_mixer_unit,
+};
+
+/** Selector Unit bmControls; Human readable bit meanings. */
+static const char * const uac2_selector_unit_bmcontrols[] = {
+	[0] = "Selector",
+	[1] = NULL
+};
+
+/** UAC1: 4.3.2.4 Selector Unit Descriptor; Table 4-6. */
+static const struct desc desc_audio_1_ac_selector_unit[] = {
+	{ .field = "bUnitID",    .size = 1, .type = DESC_NUMBER },
+	{ .field = "bNrInPins",  .size = 1, .type = DESC_NUMBER },
+	{ .field = "baSourceID", .size = 1, .type = DESC_NUMBER,
+			.array = { .array = true, .length_field1 = "bNrInPins" } },
+	{ .field = "iSelector",  .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = NULL }
+};
+
+/** UAC2: 4.7.2.7 Selector Unit Descriptor; Table 4-12. */
+static const struct desc desc_audio_2_ac_selector_unit[] = {
+	{ .field = "bUnitID",    .size = 1, .type = DESC_NUMBER },
+	{ .field = "bNrInPins",  .size = 1, .type = DESC_NUMBER },
+	{ .field = "baSourceID", .size = 1, .type = DESC_NUMBER,
+			.array = { .array = true, .length_field1 = "bNrInPins" } },
+	{ .field = "bmControls", .size = 1, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac2_selector_unit_bmcontrols },
+	{ .field = "iSelector",  .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = NULL }
+};
+
+/** UAC3: 4.5.2.6 Selector Unit Descriptor; Table 4-30. */
+static const struct desc desc_audio_3_ac_selector_unit[] = {
+	{ .field = "bUnitID",           .size = 1, .type = DESC_NUMBER },
+	{ .field = "bNrInPins",         .size = 1, .type = DESC_NUMBER },
+	{ .field = "baSourceID",        .size = 1, .type = DESC_NUMBER,
+			.array = { .array = true, .length_field1 = "bNrInPins" } },
+	{ .field = "bmControls",        .size = 4, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac2_selector_unit_bmcontrols },
+	{ .field = "wSelectorDescrStr", .size = 2, .type = DESC_CS_STR_DESC_ID },
+	{ .field = NULL }
+};
+
+/** Selector Unit descriptor definitions for the three Audio Device Class protocols */
+const struct desc * const desc_audio_ac_selector_unit[3] = {
+	desc_audio_1_ac_selector_unit,
+	desc_audio_2_ac_selector_unit,
+	desc_audio_3_ac_selector_unit,
+};
+
+/** UAC1: Table A-7: Processing Unit Process Types */
+static const char * const uac1_proc_unit_types[] = {
+	[0] = "Undefined",
+	[1] = "Up/Down-mix",
+	[2] = "Dolby Prologic",
+	[3] = "3D Stereo Extender",
+	[4] = "Reverberation",
+	[5] = "Chorus",
+	[6] = "Dyn Range Comp",
+	[7] = NULL
+};
+
+/** UAC1: Up/Down-mix and Dolby Prologic proc unit descriptor extensions Table 4-9, Table 4-10. */
+static const struct desc desc_audio_1_ac_proc_unit_extended[] = {
+	{ .field = "bNrModes",         .size = 1, .type = DESC_NUMBER },
+	{ .field = "waModes",          .size = 2, .type = DESC_BITMAP,
+			.array = { .array = true, .length_field1 = "bNrModes" } },
+	{ .field = NULL }
+};
+
+/** UAC1: Table A-7: Processing Unit Process Types */
+static const struct desc_ext desc_audio_1_ac_proc_unit_specific[] = {
+	{ .type = 1, .desc = desc_audio_1_ac_proc_unit_extended },
+	{ .type = 2, .desc = desc_audio_1_ac_proc_unit_extended },
+	{ .desc = NULL }
+};
+
+/** UAC1: 4.3.2.6 Processing Unit Descriptor; Table 4-8. */
+static const struct desc desc_audio_1_ac_processing_unit[] = {
+	{ .field = "bUnitID",          .size = 1, .type = DESC_NUMBER },
+	{ .field = "wProcessType",     .size = 2, .type = DESC_NUMBER_STRINGS,
+			.number_strings = uac1_proc_unit_types },
+	{ .field = "bNrInPins",        .size = 1, .type = DESC_NUMBER },
+	{ .field = "baSourceID",       .size = 1, .type = DESC_NUMBER,
+			.array = { .array = true, .length_field1 = "bNrInPins" } },
+	{ .field = "bNrChannels",      .size = 1, .type = DESC_NUMBER },
+	{ .field = "wChannelConfig",   .size = 2, .type = DESC_BITMAP_STRINGS,
+			.bitmap_strings = { .strings = uac1_channel_names, .count = 12 } },
+	{ .field = "iChannelNames",    .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = "bControlSize",     .size = 1, .type = DESC_NUMBER },
+	{ .field = "bmControls",       .size = 1, .type = DESC_BITMAP,
+			.array = { .array = true, .length_field1 = "bControlSize" } },
+	{ .field = "iProcessing",      .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = "Process-specific", .size = 1, .type = DESC_EXTENSION,
+		.extension = { .type_field = "wProcessType", .d = desc_audio_1_ac_proc_unit_specific } },
+	{ .field = NULL }
+};
+
+/** UAC2: 4.7.2.11.1 Up/Down-mix Processing Unit Descriptor; Table 4-21. */
+static const struct desc desc_audio_2_ac_proc_unit_up_down_mix[] = {
+	{ .field = "bNrModes",         .size = 1, .type = DESC_NUMBER },
+	{ .field = "daModes",          .size = 4, .type = DESC_BITMAP,
+			.array = { .array = true, .length_field1 = "bNrModes" } },
+	{ .field = NULL }
+};
+
+/** UAC2: 4.7.2.11.2 Dolby prologic Processing Unit Descriptor; Table 4-22. */
+static const struct desc desc_audio_2_ac_proc_unit_dolby_prologic[] = {
+	{ .field = "bNrModes",         .size = 1, .type = DESC_NUMBER },
+	{ .field = "daModes",          .size = 4, .type = DESC_BITMAP,
+			.array = { .array = true, .length_field1 = "bNrModes" } },
+	{ .field = NULL }
+};
+
+/** UAC2: Table A-12: Processing Unit Process Types */
+static const struct desc_ext desc_audio_2_ac_proc_unit_specific[] = {
+	{ .type = 1, .desc = desc_audio_2_ac_proc_unit_up_down_mix },
+	{ .type = 2, .desc = desc_audio_2_ac_proc_unit_dolby_prologic },
+	{ .desc = NULL }
+};
+
+/** UAC2: Table A-12: Processing Unit Process Types */
+static const char * const uac2_proc_unit_types[] = {
+	[0] = "Undefined",
+	[1] = "Up/Down-mix",
+	[2] = "Dolby Prologic",
+	[3] = "Stereo Extender",
+	[4] = NULL
+};
+
+/** UAC2: 4.7.2.11 Processing Unit Descriptor; Table 4-20. */
+static const struct desc desc_audio_2_ac_processing_unit[] = {
+	{ .field = "bUnitID",          .size = 1, .type = DESC_NUMBER },
+	{ .field = "wProcessType",     .size = 2, .type = DESC_NUMBER_STRINGS,
+			.number_strings = uac2_proc_unit_types },
+	{ .field = "bNrInPins",        .size = 1, .type = DESC_NUMBER },
+	{ .field = "baSourceID",       .size = 1, .type = DESC_NUMBER,
+			.array = { .array = true, .length_field1 = "bNrInPins" } },
+	{ .field = "bNrChannels",      .size = 1, .type = DESC_NUMBER },
+	{ .field = "bmChannelConfig",  .size = 4, .type = DESC_BITMAP_STRINGS,
+			.bitmap_strings = { .strings = uac2_channel_names, .count = 26 } },
+	{ .field = "iChannelNames",    .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = "bmControls",       .size = 2, .type = DESC_BITMAP },
+	{ .field = "iProcessing",      .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = "Process-specific", .size = 1, .type = DESC_EXTENSION,
+		.extension = { .type_field = "wProcessType", .d = desc_audio_2_ac_proc_unit_specific } },
+	{ .field = NULL }
+};
+
+/** Processor unit Up/Down-mix bmControls; Human readable bit meanings. */
+static const char * const uac3_proc_unit_up_down_mix_bmcontrols[] = {
+	[0] = "Mode Select",
+	[1] = "Underflow",
+	[2] = "Overflow",
+	[3] = NULL
+};
+
+/** UAC3: 4.5.2.10.1 Up/Down-mix Processing Unit Descriptor; Table 4-39. */
+static const struct desc desc_audio_3_ac_proc_unit_up_down_mix[] = {
+	{ .field = "bmControls",       .size = 4, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac3_proc_unit_up_down_mix_bmcontrols },
+	{ .field = "bNrModes",         .size = 1, .type = DESC_NUMBER },
+	{ .field = "waClusterDescrID", .size = 2, .type = DESC_NUMBER,
+			.array = { .array = true, .length_field1 = "bNrModes" } },
+	{ .field = NULL }
+};
+
+/** Processor unit stereo extender bmControls; Human readable bit meanings. */
+static const char * const uac3_proc_unit_stereo_extender_bmcontrols[] = {
+	[0] = "Width",
+	[1] = "Underflow",
+	[2] = "Overflow",
+	[3] = NULL
+};
+
+/** UAC3: 4.5.2.10.2 Stereo Extender Processing Unit Descriptor; Table 4-40. */
+static const struct desc desc_audio_3_ac_proc_unit_stereo_extender[] = {
+	{ .field = "bmControls", .size = 4, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac3_proc_unit_stereo_extender_bmcontrols },
+	{ .field = NULL }
+};
+
+/** UAC3: 4.5.2.10.3 Multi Func Proc Unit Descriptor; Algorithms; Table 4-41. */
+static const char *uac3_proc_unit_multi_func_algorithms[] = {
+	[0] = "Algorithm Undefined.",
+	[1] = "Beam Forming.",
+	[2] = "Acoustic Echo Cancellation.",
+	[3] = "Active Noise Cancellation.",
+	[4] = "Blind Source Separation.",
+	[5] = "Noise Suppression/Reduction.",
+	[6] = NULL
+};
+
+/** Processor unit Multi Func bmControls; Human readable bit meanings. */
+static const char * const uac3_proc_unit_multi_func_bmcontrols[] = {
+	[0] = "Underflow",
+	[1] = "Overflow",
+	[2] = NULL
+};
+
+/** UAC3: 4.5.2.10.3 Multi Function Processing Unit Descriptor; Table 4-41. */
+static const struct desc desc_audio_3_ac_proc_unit_multi_function[] = {
+	{ .field = "bmControls",       .size = 4, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac3_proc_unit_multi_func_bmcontrols },
+	{ .field = "wClusterDescrID",  .size = 2, .type = DESC_NUMBER, },
+	{ .field = "bmAlgorithms", .size = 4, .type = DESC_BITMAP_STRINGS,
+			.bitmap_strings = {
+				.strings = uac3_proc_unit_multi_func_algorithms,
+				.count = 6
+			} },
+	{ .field = NULL }
+};
+
+/** UAC3: Table A-20: Processing Unit Process Types */
+static const char * const uac3_proc_unit_types[] = {
+	[0] = "Undefined",
+	[1] = "Up/Down-mix",
+	[2] = "Stereo Extender",
+	[3] = "Multi-Function",
+	[4] = NULL
+};
+
+/** UAC3: Table A-20: Processing Unit Process Types */
+static const struct desc_ext desc_audio_3_ac_proc_unit_specific[] = {
+	{ .type = 1, .desc = desc_audio_3_ac_proc_unit_up_down_mix },
+	{ .type = 2, .desc = desc_audio_3_ac_proc_unit_stereo_extender },
+	{ .type = 3, .desc = desc_audio_3_ac_proc_unit_multi_function },
+	{ .desc = NULL }
+};
+
+/** UAC3: 4.5.2.10 Processing Unit Descriptor; Table 4-38. */
+static const struct desc desc_audio_3_ac_processing_unit[] = {
+	{ .field = "bUnitID",             .size = 1, .type = DESC_NUMBER },
+	{ .field = "wProcessType",        .size = 2, .type = DESC_NUMBER_STRINGS,
+			.number_strings = uac3_proc_unit_types },
+	{ .field = "bNrInPins",           .size = 1, .type = DESC_NUMBER },
+	{ .field = "baSourceID",          .size = 1, .type = DESC_NUMBER,
+			.array = { .array = true, .length_field1 = "bNrInPins" } },
+	{ .field = "wProcessingDescrStr", .size = 2, .type = DESC_CS_STR_DESC_ID },
+	{ .field = "Process-specific",    .size = 1, .type = DESC_EXTENSION,
+		.extension = { .type_field = "wProcessType", .d = desc_audio_3_ac_proc_unit_specific } },
+	{ .field = NULL }
+};
+
+/** Processing Unit descriptor definitions for the three Audio Device Class protocols */
+const struct desc * const desc_audio_ac_processing_unit[3] = {
+	desc_audio_1_ac_processing_unit,
+	desc_audio_2_ac_processing_unit,
+	desc_audio_3_ac_processing_unit,
+};
+
+/** Audio Control Feature Unit bmControls; Human readable bit meanings. */
+static const char * const uac_feature_unit_bmcontrols[] = {
+	[ 0] = "Mute",
+	[ 1] = "Volume",
+	[ 2] = "Bass",
+	[ 3] = "Mid",
+	[ 4] = "Treble",
+	[ 5] = "Graphic Equalizer",
+	[ 6] = "Automatic Gain",
+	[ 7] = "Delay",
+	[ 8] = "Bass Boost",
+	[ 9] = "Loudness",
+	[10] = "Input gain",
+	[11] = "Input gain pad",
+	[12] = "Phase inverter",
+	[13] = NULL
+};
+
+/** UAC1: 4.3.2.5 Feature Unit Descriptor; Table 4-7. */
+static const struct desc desc_audio_1_ac_feature_unit[] = {
+	{ .field = "bUnitID",      .size = 1,                    .type = DESC_NUMBER },
+	{ .field = "bSourceID",    .size = 1,                    .type = DESC_CONSTANT },
+	{ .field = "bControlSize", .size = 1,                    .type = DESC_NUMBER },
+	{ .field = "bmaControls",  .size_field = "bControlSize", .type = DESC_BMCONTROL_1,
+			.bmcontrol = uac_feature_unit_bmcontrols, .array = { .array = true } },
+	{ .field = "iFeature",     .size = 1,                    .type = DESC_STR_DESC_INDEX },
+	{ .field = NULL }
+};
+
+/** UAC2: 4.7.2.8 Feature Unit Descriptor; Table 4-13. */
+static const struct desc desc_audio_2_ac_feature_unit[] = {
+	{ .field = "bUnitID",     .size = 1, .type = DESC_NUMBER },
+	{ .field = "bSourceID",   .size = 1, .type = DESC_CONSTANT },
+	{ .field = "bmaControls", .size = 4, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac_feature_unit_bmcontrols, .array = { .array = true } },
+	{ .field = "iFeature",    .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = NULL }
+};
+
+/** UAC3: 4.5.2.7 Feature Unit Descriptor; Table 4-31. */
+static const struct desc desc_audio_3_ac_feature_unit[] = {
+	{ .field = "bUnitID",          .size = 1, .type = DESC_NUMBER },
+	{ .field = "bSourceID",        .size = 1, .type = DESC_NUMBER },
+	{ .field = "bmaControls",      .size = 4, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac_feature_unit_bmcontrols, .array = { .array = true } },
+	{ .field = "wFeatureDescrStr", .size = 2, .type = DESC_CS_STR_DESC_ID },
+	{ .field = NULL }
+};
+
+/** Feature Unit descriptor definitions for the three Audio Device Class protocols */
+const struct desc * const desc_audio_ac_feature_unit[3] = {
+	desc_audio_1_ac_feature_unit,
+	desc_audio_2_ac_feature_unit,
+	desc_audio_3_ac_feature_unit,
+};
+
+/** UAC2 Extension Unit bmControls; Human readable bit meanings. */
+static const char * const uac2_extension_unit_bmcontrols[] = {
+	[0] = "Enable",
+	[1] = "Cluster",
+	[2] = "Underflow",
+	[3] = "Overflow",
+	[4] = NULL
+};
+
+/** UAC3 Extension Unit bmControls; Human readable bit meanings. */
+static const char * const uac3_extension_unit_bmcontrols[] = {
+	[0] = "Underflow",
+	[1] = "Overflow",
+	[2] = NULL
+};
+
+/** UAC1: 4.3.2.7 Extension Unit Descriptor; Table 4-15. */
+static const struct desc desc_audio_1_ac_extension_unit[] = {
+	{ .field = "bUnitID",        .size = 1, .type = DESC_NUMBER },
+	{ .field = "wExtensionCode", .size = 2, .type = DESC_CONSTANT },
+	{ .field = "bNrInPins",      .size = 1, .type = DESC_NUMBER },
+	{ .field = "baSourceID",     .size = 1, .type = DESC_NUMBER,
+			.array = { .array = true, .length_field1 = "bNrInPins" } },
+	{ .field = "bNrChannels",    .size = 1, .type = DESC_NUMBER },
+	{ .field = "wChannelConfig", .size = 2, .type = DESC_BITMAP_STRINGS,
+			.bitmap_strings = { .strings = uac1_channel_names, .count = 12 } },
+	{ .field = "iChannelNames",  .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = "bControlSize",   .size = 1, .type = DESC_NUMBER },
+	{ .field = "bmControls",     .size = 1, .type = DESC_BITMAP,
+			.array = { .array = true, .length_field1 = "bControlSize" } },
+	{ .field = "iExtension",     .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = NULL }
+};
+
+/** UAC2: 4.7.2.12 Extension Unit Descriptor; Table 4-24. */
+static const struct desc desc_audio_2_ac_extension_unit[] = {
+	{ .field = "bUnitID",         .size = 1, .type = DESC_NUMBER },
+	{ .field = "wExtensionCode",  .size = 2, .type = DESC_CONSTANT },
+	{ .field = "bNrInPins",       .size = 1, .type = DESC_NUMBER },
+	{ .field = "baSourceID",      .size = 1, .type = DESC_NUMBER,
+			.array = { .array = true, .length_field1 = "bNrInPins" } },
+	{ .field = "bNrChannels",     .size = 1, .type = DESC_NUMBER },
+	{ .field = "bmChannelConfig", .size = 4, .type = DESC_BITMAP_STRINGS,
+			.bitmap_strings = { .strings = uac2_channel_names, .count = 26 } },
+	{ .field = "iChannelNames",   .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = "bmControls",      .size = 1, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac2_extension_unit_bmcontrols },
+	{ .field = "iExtension",      .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = NULL }
+};
+
+/** UAC3: 4.5.2.11 Extension Unit Descriptor; Table 4-42. */
+static const struct desc desc_audio_3_ac_extension_unit[] = {
+	{ .field = "bUnitID",            .size = 1, .type = DESC_NUMBER },
+	{ .field = "wExtensionCode",     .size = 2, .type = DESC_CONSTANT },
+	{ .field = "bNrInPins",          .size = 1, .type = DESC_NUMBER },
+	{ .field = "baSourceID",         .size = 1, .type = DESC_NUMBER,
+			.array = { .array = true, .length_field1 = "bNrInPins" } },
+	{ .field = "wExtensionDescrStr", .size = 2, .type = DESC_CS_STR_DESC_ID },
+	{ .field = "bmControls",         .size = 4, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac3_extension_unit_bmcontrols },
+	{ .field = "wClusterDescrID",    .size = 2, .type = DESC_NUMBER },
+	{ .field = NULL }
+};
+
+/** Extension Unit descriptor definitions for the three Audio Device Class protocols */
+const struct desc * const desc_audio_ac_extension_unit[3] = {
+	desc_audio_1_ac_extension_unit,
+	desc_audio_2_ac_extension_unit,
+	desc_audio_3_ac_extension_unit,
+};
+
+/** UAC2 Clock Source bmControls; Human readable bit meanings. */
+static const char * const uac2_clock_source_bmcontrols[] = {
+	[0] = "Clock Frequency",
+	[1] = "Clock Validity",
+	[2] = NULL
+};
+
+static const char * const uac2_clk_src_bmattr[] = {
+	[0] = "External",
+	[1] = "Internal fixed",
+	[2] = "Internal variable",
+	[3] = "Internal programmable"
+};
+
+static const char * const uac3_clk_src_bmattr[] = {
+	[0] = "External",
+	[1] = "Internal",
+	[2] = "(asynchronous)",
+	[3] = "(synchronized to SOF)"
+};
+
+/** Special rendering function for UAC2 clock source bmAttributes */
+static void desc_snowflake_dump_uac2_clk_src_bmattr(
+		unsigned long long value,
+		unsigned int indent)
+{
+	printf(" %s clock %s\n",
+			uac2_clk_src_bmattr[value & 0x3],
+			(value & 0x4) ? uac3_clk_src_bmattr[3] : "");
+}
+
+/** Special rendering function for UAC3 clock source bmAttributes */
+static void desc_snowflake_dump_uac3_clk_src_bmattr(
+		unsigned long long value,
+		unsigned int indent)
+{
+	printf(" %s clock %s\n",
+			uac3_clk_src_bmattr[(value & 0x1)],
+			uac3_clk_src_bmattr[0x2 | ((value & 0x2) >> 1)]);
+}
+
+/** UAC2: 4.7.2.1 Clock Source Descriptor; Table 4-6. */
+static const struct desc desc_audio_2_ac_clock_source[] = {
+	{ .field = "bClockID",       .size = 1, .type = DESC_CONSTANT },
+	{ .field = "bmAttributes",   .size = 1, .type = DESC_SNOWFLAKE,
+			.snowflake = desc_snowflake_dump_uac2_clk_src_bmattr },
+	{ .field = "bmControls",     .size = 1, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac2_clock_source_bmcontrols },
+	{ .field = "bAssocTerminal", .size = 1, .type = DESC_CONSTANT },
+	{ .field = "iClockSource",   .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = NULL }
+};
+
+/** UAC3: 4.5.2.12 Clock Source Descriptor; Table 4-43. */
+static const struct desc desc_audio_3_ac_clock_source[] = {
+	{ .field = "bClockID",           .size = 1, .type = DESC_NUMBER },
+	{ .field = "bmAttributes",       .size = 1, .type = DESC_SNOWFLAKE,
+			.snowflake = desc_snowflake_dump_uac3_clk_src_bmattr },
+	{ .field = "bmControls",         .size = 4, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac2_clock_source_bmcontrols },
+	{ .field = "bReferenceTerminal", .size = 1, .type = DESC_NUMBER },
+	{ .field = "wClockSourceStr",    .size = 2, .type = DESC_CS_STR_DESC_ID },
+	{ .field = NULL }
+};
+
+/** Clock Source descriptor definitions for the three Audio Device Class protocols */
+const struct desc * const desc_audio_ac_clock_source[3] = {
+	NULL, /* UAC1 not supported */
+	desc_audio_2_ac_clock_source,
+	desc_audio_3_ac_clock_source,
+};
+
+/** UAC2 Clock Selector bmControls; Human readable bit meanings. */
+static const char * const uac2_clock_selector_bmcontrols[] = {
+	[0] = "Clock Selector",
+	[1] = NULL
+};
+
+/** UAC2: 4.7.2.2 Clock Selector Descriptor; Table 4-7. */
+static const struct desc desc_audio_2_ac_clock_selector[] = {
+	{ .field = "bClockID",       .size = 1, .type = DESC_NUMBER },
+	{ .field = "bNrInPins",      .size = 1, .type = DESC_NUMBER },
+	{ .field = "baCSourceID",    .size = 1, .type = DESC_NUMBER,
+			.array = { .array = true, .length_field1 = "bNrInPins" } },
+	{ .field = "bmControls",     .size = 1, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac2_clock_selector_bmcontrols },
+	{ .field = "iClockSelector", .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = NULL }
+};
+
+/** UAC3: 4.5.2.13 Clock Selector Descriptor; Table 4-44. */
+static const struct desc desc_audio_3_ac_clock_selector[] = {
+	{ .field = "bClockID",           .size = 1, .type = DESC_NUMBER },
+	{ .field = "bNrInPins",          .size = 1, .type = DESC_NUMBER },
+	{ .field = "baCSourceID",        .size = 1, .type = DESC_NUMBER,
+			.array = { .array = true, .length_field1 = "bNrInPins" } },
+	{ .field = "bmControls",         .size = 4, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac2_clock_selector_bmcontrols },
+	{ .field = "wCSelectorDescrStr", .size = 2, .type = DESC_CS_STR_DESC_ID },
+	{ .field = NULL }
+};
+
+/** Clock Selector descriptor definitions for the three Audio Device Class protocols */
+const struct desc * const desc_audio_ac_clock_selector[3] = {
+	NULL, /* UAC1 not supported */
+	desc_audio_2_ac_clock_selector,
+	desc_audio_3_ac_clock_selector,
+};
+
+/** UAC2 Clock Multiplier bmControls; Human readable bit meanings. */
+static const char * const uac2_clock_multiplier_bmcontrols[] = {
+	[0] = "Clock Numerator",
+	[1] = "Clock Denominator",
+	[2] = NULL
+};
+
+/** UAC2: 4.7.2.3 Clock Multiplier Descriptor; Table 4-8. */
+static const struct desc desc_audio_2_ac_clock_multiplier[] = {
+	{ .field = "bClockID",         .size = 1, .type = DESC_CONSTANT },
+	{ .field = "bCSourceID",       .size = 1, .type = DESC_NUMBER },
+	{ .field = "bmControls",       .size = 1, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac2_clock_multiplier_bmcontrols },
+	{ .field = "iClockMultiplier", .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = NULL }
+};
+
+/** UAC3: 4.5.2.14 Clock Multiplier Descriptor; Table 4-45. */
+static const struct desc desc_audio_3_ac_clock_multiplier[] = {
+	{ .field = "bClockID",             .size = 1, .type = DESC_NUMBER },
+	{ .field = "bCSourceID",           .size = 1, .type = DESC_NUMBER },
+	{ .field = "bmControls",           .size = 4, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac2_clock_multiplier_bmcontrols },
+	{ .field = "wCMultiplierDescrStr", .size = 2, .type = DESC_CS_STR_DESC_ID },
+	{ .field = NULL }
+};
+
+/** Clock Multiplier descriptor definitions for the three Audio Device Class protocols */
+const struct desc * const desc_audio_ac_clock_multiplier[3] = {
+	NULL, /* UAC1 not supported */
+	desc_audio_2_ac_clock_multiplier,
+	desc_audio_3_ac_clock_multiplier,
+};
+
+/** UAC2: 4.7.2.9 Sampling Rate Converter Descriptor; Table 4-14. */
+static const struct desc desc_audio_2_ac_sample_rate_converter[] = {
+	{ .field = "bUnitID",       .size = 1, .type = DESC_CONSTANT },
+	{ .field = "bSourceID",     .size = 1, .type = DESC_CONSTANT },
+	{ .field = "bCSourceInID",  .size = 1, .type = DESC_CONSTANT },
+	{ .field = "bCSourceOutID", .size = 1, .type = DESC_CONSTANT },
+	{ .field = "iSRC",          .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = NULL }
+};
+
+/** UAC3: 4.5.2.8 Sampling Rate Converter Descriptor; Table 4-32. */
+static const struct desc desc_audio_3_ac_sample_rate_converter[] = {
+	{ .field = "bUnitID",       .size = 1, .type = DESC_NUMBER },
+	{ .field = "bSourceID",     .size = 1, .type = DESC_NUMBER },
+	{ .field = "bCSourceInID",  .size = 1, .type = DESC_NUMBER },
+	{ .field = "bCSourceOutID", .size = 1, .type = DESC_NUMBER },
+	{ .field = "wSRCDescrStr",  .size = 2, .type = DESC_CS_STR_DESC_ID },
+	{ .field = NULL }
+};
+
+/** Sample Rate Converter descriptor definitions for the three Audio Device Class protocols */
+const struct desc * const desc_audio_ac_sample_rate_converter[3] = {
+	NULL, /* UAC1 not supported */
+	desc_audio_2_ac_sample_rate_converter,
+	desc_audio_3_ac_sample_rate_converter,
+};
+
+/** UAC2 AudioStreaming Interface bmControls; Human readable bit meanings. */
+static const char * const uac2_as_interface_bmcontrols[] = {
+	[0] = "Active Alternate Setting",
+	[1] = "Valid Alternate Setting",
+	[2] = NULL
+};
+
+/** UAC3 AudioStreaming Interface bmControls; Human readable bit meanings. */
+static const char * const uac3_as_interface_bmcontrols[] = {
+	[0] = "Active Alternate Setting",
+	[1] = "Valid Alternate Setting",
+	[2] = "Audio Data Format Control",
+	[3] = NULL
+};
+
+/* wFormatTag hex prefix for format type */
+#define UAC_FORMAT_TYPE_I   0x0
+#define UAC_FORMAT_TYPE_II  0x1
+#define UAC_FORMAT_TYPE_III 0x2
+
+/** Format type I codes; Human-readable values. */
+static const char * const audio_data_format_type_i[] = {
+	[0] = "TYPE_I_UNDEFINED",
+	[1] = "PCM",
+	[2] = "PCM8",
+	[3] = "IEEE_FLOAT",
+	[4] = "ALAW",
+	[5] = "MULAW"
+};
+
+/** Format type II codes; Human-readable values. */
+static const char * const audio_data_format_type_ii[] = {
+	[0] = "TYPE_II_UNDEFINED",
+	[1] = "MPEG",
+	[2] = "AC-3"
+};
+
+/** Format type III codes; Human-readable values. */
+static const char * const audio_data_format_type_iii[] = {
+	[0] = "TYPE_III_UNDEFINED",
+	[1] = "IEC1937_AC-3",
+	[2] = "IEC1937_MPEG-1_Layer1",
+	[3] = "IEC1937_MPEG-Layer2/3/NOEXT",
+	[4] = "IEC1937_MPEG-2_EXT",
+	[5] = "IEC1937_MPEG-2_Layer1_LS",
+	[6] = "IEC1937_MPEG-2_Layer2/3_LS"
+};
+
+/** Special rendering function for UAC1 AS interface wFormatTag */
+static void desc_snowflake_dump_uac1_as_interface_wformattag(
+		unsigned long long value,
+		unsigned int indent)
+{
+	const char *format_string = "undefined";
+
+	/* Format codes are 0xTNNN, where T=Type prefix, NNN = format code. */
+
+	if (value < ((UAC_FORMAT_TYPE_I << 12) +
+	              ARRAY_LEN(audio_data_format_type_i))) {
+		format_string = audio_data_format_type_i[value];
+
+	} else if ((value >=  (UAC_FORMAT_TYPE_II << 12)) &&
+	           (value <= ((UAC_FORMAT_TYPE_II << 12) +
+	                      ARRAY_LEN(audio_data_format_type_ii)))) {
+		format_string = audio_data_format_type_ii[value & 0xfff];
+
+	} else if ((value >=  (UAC_FORMAT_TYPE_III << 12)) &&
+	           (value <= ((UAC_FORMAT_TYPE_III << 12) +
+	                      ARRAY_LEN(audio_data_format_type_iii)))) {
+		format_string = audio_data_format_type_iii[value & 0xfff];
+	}
+
+	printf(" %s\n", format_string);
+}
+
+/** Special rendering function for UAC2 AS interface bmFormats */
+static void desc_snowflake_dump_uac2_as_interface_bmformats(
+		unsigned long long value,
+		unsigned int indent)
+{
+	unsigned int i;
+
+	printf("\n");
+	for (i = 0; i < 5; i++) {
+		if ((value >> i) & 0x1) {
+			printf("%*s%s\n", indent * 2, "",
+					audio_data_format_type_i[i + 1]);
+		}
+	}
+
+}
+
+/** UAC1: 4.5.2 Class-Specific AS Interface Descriptor; Table 4-19. */
+static const struct desc desc_audio_1_as_interface[] = {
+	{ .field = "bTerminalLink", .size = 1, .type = DESC_CONSTANT },
+	{ .field = "bDelay",        .size = 1, .type = DESC_NUMBER_POSTFIX,
+			.number_postfix = " frames" },
+	{ .field = "wFormatTag",    .size = 2, .type = DESC_SNOWFLAKE,
+			.snowflake = desc_snowflake_dump_uac1_as_interface_wformattag },
+	{ .field = NULL }
+};
+
+/** UAC2: 4.9.2 Class-Specific AS Interface Descriptor; Table 4-27. */
+static const struct desc desc_audio_2_as_interface[] = {
+	{ .field = "bTerminalLink",   .size = 1, .type = DESC_NUMBER },
+	{ .field = "bmControls",      .size = 1, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac2_as_interface_bmcontrols },
+	{ .field = "bFormatType",     .size = 1, .type = DESC_CONSTANT },
+	{ .field = "bmFormats",       .size = 4, .type = DESC_SNOWFLAKE,
+			.snowflake = desc_snowflake_dump_uac2_as_interface_bmformats },
+	{ .field = "bNrChannels",     .size = 1, .type = DESC_NUMBER },
+	{ .field = "bmChannelConfig", .size = 4, .type = DESC_BITMAP_STRINGS,
+			.bitmap_strings = { .strings = uac2_channel_names, .count = 26 } },
+	{ .field = "iChannelNames",   .size = 1, .type = DESC_STR_DESC_INDEX },
+	{ .field = NULL }
+};
+
+/** UAC3: 4.7.2 Class-Specific AS Interface Descriptor; Table 4-49. */
+static const struct desc desc_audio_3_as_interface[] = {
+	{ .field = "bTerminalLink",   .size = 1, .type = DESC_NUMBER },
+	{ .field = "bmControls",      .size = 4, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac3_as_interface_bmcontrols },
+	{ .field = "wClusterDescrID", .size = 2, .type = DESC_NUMBER },
+	{ .field = "bmFormats",       .size = 8, .type = DESC_BITMAP },
+	{ .field = "bSubslotSize",    .size = 1, .type = DESC_NUMBER },
+	{ .field = "bBitResolution",  .size = 1, .type = DESC_NUMBER },
+	{ .field = "bmAuxProtocols",  .size = 2, .type = DESC_BITMAP },
+	{ .field = "bControlSize",    .size = 1, .type = DESC_NUMBER },
+	{ .field = NULL }
+};
+
+/** AudioStreaming Interface descriptor definitions for the three Audio Device Class protocols */
+const struct desc * const desc_audio_as_interface[3] = {
+	desc_audio_1_as_interface,
+	desc_audio_2_as_interface,
+	desc_audio_3_as_interface,
+};
+
+/** UAC1: Data Endpoint bmAttributes; Human readable bit meanings. */
+static const char * const uac1_as_endpoint_bmattributes[] = {
+	[0] = "Sampling Frequency",
+	[1] = "Pitch",
+	[2] = "Audio Data Format Control",
+	[7] = "MaxPacketsOnly"
+};
+
+/** UAC2: Data Endpoint bmAttributes; Human readable bit meanings. */
+static const char * const uac2_as_endpoint_bmattributes[] = {
+	[7] = "MaxPacketsOnly",
+};
+
+/** UAC2 AudioStreaming Interface bmControls; Human readable bit meanings. */
+static const char * const uac2_as_isochronous_audio_data_endpoint_bmcontrols[] = {
+	[0] = "Pitch",
+	[1] = "Data Overrun",
+	[2] = "Data Underrun",
+	[3] = NULL
+};
+
+/** Audio Data Endpoint bLockDelayUnits; Human readable value meanings. */
+static const char * const uac_as_isochronous_audio_data_endpoint_blockdelayunits[] = {
+	[0] = "Undefined",
+	[1] = "Milliseconds",
+	[2] = "Decoded PCM samples",
+	[3] = NULL
+};
+
+/** UAC1: 4.6.1.2 Class-Specific AS Isochronous Audio Data Endpoint Descriptor; Table 4-21. */
+static const struct desc desc_audio_1_as_isochronous_audio_data_endpoint[] = {
+	{ .field = "bmAttributes",    .size = 1, .type = DESC_BITMAP_STRINGS,
+			.bitmap_strings = { .strings = uac1_as_endpoint_bmattributes, .count = 8 } },
+	{ .field = "bLockDelayUnits", .size = 1, .type = DESC_NUMBER_STRINGS,
+			.number_strings = uac_as_isochronous_audio_data_endpoint_blockdelayunits },
+	{ .field = "wLockDelay",      .size = 2, .type = DESC_NUMBER },
+	{ .field = NULL }
+};
+
+/** UAC2: 4.10.1.2 Class-Specific AS Isochronous Audio Data Endpoint Descriptor; Table 4-34. */
+static const struct desc desc_audio_2_as_isochronous_audio_data_endpoint[] = {
+	{ .field = "bmAttributes",    .size = 1, .type = DESC_BITMAP_STRINGS,
+			.bitmap_strings = { .strings = uac2_as_endpoint_bmattributes, .count = 8 } },
+	{ .field = "bmControls",      .size = 1, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac2_as_isochronous_audio_data_endpoint_bmcontrols },
+	{ .field = "bLockDelayUnits", .size = 1, .type = DESC_NUMBER_STRINGS,
+			.number_strings = uac_as_isochronous_audio_data_endpoint_blockdelayunits },
+	{ .field = "wLockDelay",      .size = 2, .type = DESC_NUMBER },
+	{ .field = NULL }
+};
+
+/** UAC3: 4.8.1.2 Class-Specific AS Isochronous Audio Data Endpoint Descriptor; Table 4-52. */
+static const struct desc desc_audio_3_as_isochronous_audio_data_endpoint[] = {
+	{ .field = "bmControls",      .size = 4, .type = DESC_BMCONTROL_2,
+			.bmcontrol = uac2_as_isochronous_audio_data_endpoint_bmcontrols },
+	{ .field = "bLockDelayUnits", .size = 1, .type = DESC_NUMBER_STRINGS,
+			.number_strings = uac_as_isochronous_audio_data_endpoint_blockdelayunits },
+	{ .field = "wLockDelay",      .size = 2, .type = DESC_NUMBER },
+	{ .field = NULL }
+};
+
+/** Isochronous Audio Data Endpoint descriptor definitions for the three Audio Device Class protocols */
+const struct desc * const desc_audio_as_isochronous_audio_data_endpoint[3] = {
+	desc_audio_1_as_isochronous_audio_data_endpoint,
+	desc_audio_2_as_isochronous_audio_data_endpoint,
+	desc_audio_3_as_isochronous_audio_data_endpoint,
+};
+
+/** USB3: 9.6.2.7 Configuration Summary Descriptor; Table 9-21. */
+const struct desc desc_usb3_dc_configuration_summary[] = {
+	{ .field = "bLength",             .size = 1, .type = DESC_NUMBER },
+	{ .field = "bDescriptorType",     .size = 1, .type = DESC_CONSTANT },
+	{ .field = "bDevCapabilityType",  .size = 1, .type = DESC_NUMBER },
+	{ .field = "bcdVersion",          .size = 2, .type = DESC_BCD },
+	{ .field = "bClass",              .size = 1, .type = DESC_NUMBER },
+	{ .field = "bSubClass",           .size = 1, .type = DESC_NUMBER },
+	{ .field = "bProtocol",           .size = 1, .type = DESC_NUMBER },
+	{ .field = "bConfigurationCount", .size = 1, .type = DESC_NUMBER },
+	{ .field = "bConfigurationIndex", .size = 1, .type = DESC_NUMBER,
+			.array = { .array = true, .length_field1 = "bConfigurationCount" } },
+	{ .field = NULL }
+};