ALSA: doc: usb-audio: Add doc for QUIRK_FLAG_ALWAYS_SET_RATE

QUIRK_FLAG_ALWAYS_SET_RATE was introduced into usb-audio before without
appropriate documentation, so add it.

There is an odd colon in its comments, so remove it too.

As this is often forgotten, also add a reminder to the end of the
enumeration.

Fixes: 786f91da85 ("ALSA: usb-audio: add QUIRK_FLAG_ALWAYS_SET_RATE for Mackie DLZ Creator XS")
Signed-off-by: Rong Zhang <i@rong.moe>
Signed-off-by: Takashi Iwai <tiwai@suse.de>
Link: https://patch.msgid.link/20260823-uac-demote-sticky-check-v1-1-a8cbe572edff@rong.moe
This commit is contained in:
Rong Zhang
2026-08-23 02:52:28 +08:00
committed by Takashi Iwai
parent af79b081ce
commit f3d14f0a8d
2 changed files with 7 additions and 2 deletions

View File

@@ -2406,6 +2406,11 @@ quirk_flags
works around it by enforcing the fixed max URBs (12) instead of
the dynamic calculation from the buffer size, and passing the
`URB_ISO_ASAP` URB flag.
* bit 32: ``always_set_rate``
Issue SET_CUR for the sample rate even when the clock already reports
the requested rate. A device advertising a single rate is otherwise
never sent the request at all, and some require it before streaming
will start.
This module supports multiple devices, autoprobe and hotplugging.

View File

@@ -260,7 +260,7 @@ extern bool snd_usb_skip_validation;
* to insufficient buffer depth combined with xHCI scheduling variability.
* The larger buffer (MAX_URBS = 12, ~64ms) absorbs system scheduling
* jitter during boot, while URB_ISO_ASAP ensures consistent xHCI scheduling.
* QUIRK_FLAG_ALWAYS_SET_RATE:
* QUIRK_FLAG_ALWAYS_SET_RATE
* Issue SET_CUR for the sample rate even when the clock already reports the
* requested rate. A device advertising a single rate is otherwise never sent
* the request at all, and some require it before streaming will start.
@@ -300,7 +300,7 @@ enum {
QUIRK_TYPE_MIXER_GET_CUR_BROKEN = 30,
QUIRK_TYPE_PLAYBACK_URB_FIXUP = 31,
QUIRK_TYPE_ALWAYS_SET_RATE = 32,
/* Please also edit snd_usb_audio_quirk_flag_names */
/* Please also edit snd_usb_audio_quirk_flag_names and alsa-configuration.rst */
};
#define QUIRK_FLAG(x) BIT_U64(QUIRK_TYPE_ ## x)