Skip to content

Commit 4a1672d

Browse files
committed
ALSA: hda: Update documentation for aliasing via the model option
The previous patch allowed user to specify the aliasing of SSID via model option for applying a quirk. Update the documentation accordingly. Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Takashi Iwai <[email protected]>
1 parent a235d5b commit 4a1672d

File tree

2 files changed

+17
-0
lines changed

2 files changed

+17
-0
lines changed

Documentation/sound/alsa-configuration.rst

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1059,6 +1059,12 @@ The model name ``generic`` is treated as a special case. When this
10591059
model is given, the driver uses the generic codec parser without
10601060
"codec-patch". It's sometimes good for testing and debugging.
10611061

1062+
The model option can be used also for aliasing to another PCI or codec
1063+
SSID. When it's passed in the form of ``model=XXXX:YYYY`` where XXXX
1064+
and YYYY are the sub-vendor and sub-device IDs in hex numbers,
1065+
respectively, the driver will refer to that SSID as a reference to the
1066+
quirk table.
1067+
10621068
If the default configuration doesn't work and one of the above
10631069
matches with your device, report it together with alsa-info.sh
10641070
output (with ``--no-upload`` option) to kernel bugzilla or alsa-devel

Documentation/sound/hd-audio/notes.rst

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -215,6 +215,17 @@ There are a few special model option values:
215215
* when ``generic`` is passed, the codec-specific parser is skipped and
216216
only the generic parser is used.
217217

218+
A new style for the model option that was introduced since 5.15 kernel
219+
is to pass the PCI or codec SSID in the form of ``model=XXXX:YYYY``
220+
where XXXX and YYYY are the sub-vendor and sub-device IDs in hex
221+
numbers, respectively. This is a kind of aliasing to another device;
222+
when this form is given, the driver will refer to that SSID as a
223+
reference to the quirk table. It'd be useful especially when the
224+
target quirk isn't listed in the model table. For example, passing
225+
model=103c:8862 will apply the quirk for HP ProBook 445 G8 (which
226+
isn't found in the model table as of writing) as long as the device is
227+
handled equivalently by the same driver.
228+
218229

219230
Speaker and Headphone Output
220231
----------------------------

0 commit comments

Comments
 (0)