€•„äŒsphinx.addnodes”Œdocument”“”)�”}”(Œ rawsource”Œ”Œchildren”]”(Œ translations”Œ LanguagesNode”“”)�”}”(hhh]”(hŒ pending_xref”“”)�”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…”�”}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ(/translations/zh_CN/sound/codecs/cs35l56”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)�”}”(hhh]”hŒChinese (Traditional)”…”�”}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/zh_TW/sound/codecs/cs35l56”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)�”}”(hhh]”hŒItalian”…”�”}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/it_IT/sound/codecs/cs35l56”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)�”}”(hhh]”hŒJapanese”…”�”}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/ja_JP/sound/codecs/cs35l56”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)�”}”(hhh]”hŒKorean”…”�”}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/ko_KR/sound/codecs/cs35l56”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)�”}”(hhh]”hŒPortuguese (Brazilian)”…”�”}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/pt_BR/sound/codecs/cs35l56”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)�”}”(hhh]”hŒSpanish”…”�”}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/sp_SP/sound/codecs/cs35l56”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒcomment”“”)�”}”(hŒ%SPDX-License-Identifier: GPL-2.0-only”h]”hŒ%SPDX-License-Identifier: GPL-2.0-only”…”�”}”hh·sbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh1hµhhh²hh³ŒB/var/lib/git/docbuild/linux/Documentation/sound/codecs/cs35l56.rst”h´KubhŒsection”“”)�”}”(hhh]”(hŒtitle”“”)�”}”(hŒHAudio drivers for Cirrus Logic CS35L54/56/57/63 Boosted Smart Amplifiers”h]”hŒHAudio drivers for Cirrus Logic CS35L54/56/57/63 Boosted Smart Amplifiers”…”�”}”(hhÏh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhÊh²hh³hÇh´KubhŒ field_list”“”)�”}”(hhh]”hŒfield”“”)�”}”(hhh]”(hŒ field_name”“”)�”}”(hŒ Copyright”h]”hŒ Copyright”…”�”}”(hhéh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hçhhäh³hÇh´KubhŒ field_body”“”)�”}”(hŒJ2025 Cirrus Logic, Inc. and Cirrus Logic International Semiconductor Ltd. ”h]”hŒ paragraph”“”)�”}”(hŒI2025 Cirrus Logic, Inc. and Cirrus Logic International Semiconductor Ltd.”h]”hŒI2025 Cirrus Logic, Inc. and Cirrus Logic International Semiconductor Ltd.”…”�”}”(hhÿh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Khhùubah}”(h]”h ]”h"]”h$]”h&]”uh1h÷hhäubeh}”(h]”h ]”h"]”h$]”h&]”uh1hâh³hÇh´Khhßh²hubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝhhÊh²hh³hÇh´Kubhþ)�”}”(hŒ&Contact: patches@opensource.cirrus.com”h]”(hŒ Contact: ”…”�”}”(hjh²hh³Nh´NubhŒ reference”“”)�”}”(hŒpatches@opensource.cirrus.com”h]”hŒpatches@opensource.cirrus.com”…”�”}”(hj)h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œ$mailto:patches@opensource.cirrus.com”uh1j'hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K hhÊh²hubhÉ)�”}”(hhh]”(hÎ)�”}”(hŒSummary”h]”hŒSummary”…”�”}”(hjBh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj?h²hh³hÇh´K ubhþ)�”}”(hŒ+The high-level summary of this document is:”h]”hŒ+The high-level summary of this document is:”…”�”}”(hjPh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Khj?h²hubhþ)�”}”(hŒ¼**If you have a laptop that uses CS35L54/56/57/63 amplifiers but audio is not working, DO NOT ATTEMPT TO USE FIRMWARE AND SETTINGS FROM ANOTHER LAPTOP, EVEN IF THAT LAPTOP SEEMS SIMILAR.**”h]”hŒstrong”“”)�”}”(hj`h]”hŒ¸If you have a laptop that uses CS35L54/56/57/63 amplifiers but audio is not working, DO NOT ATTEMPT TO USE FIRMWARE AND SETTINGS FROM ANOTHER LAPTOP, EVEN IF THAT LAPTOP SEEMS SIMILAR.”…”�”}”(hjdh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jbhj^ubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Khj?h²hubhþ)�”}”(hŒ·The CS35L54/56/57/63 amplifiers must be correctly configured for the power supply voltage, speaker impedance, maximum speaker voltage/current, and other external hardware connections.”h]”hŒ·The CS35L54/56/57/63 amplifiers must be correctly configured for the power supply voltage, speaker impedance, maximum speaker voltage/current, and other external hardware connections.”…”�”}”(hjwh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Khj?h²hubhþ)�”}”(hXThe amplifiers feature advanced boost technology that increases the voltage used to drive the speakers, while proprietary speaker protection algorithms allow these boosted amplifiers to push the limits of the speakers without causing damage. These **must** be configured correctly.”h]”(hŒøThe amplifiers feature advanced boost technology that increases the voltage used to drive the speakers, while proprietary speaker protection algorithms allow these boosted amplifiers to push the limits of the speakers without causing damage. These ”…”�”}”(hj…h²hh³Nh´Nubjc)�”}”(hŒ**must**”h]”hŒmust”…”�”}”(hj�h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jbhj…ubhŒ be configured correctly.”…”�”}”(hj…h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Khj?h²hubhÉ)�”}”(hhh]”(hÎ)�”}”(hŒ!Supported Cirrus Logic amplifiers”h]”hŒ!Supported Cirrus Logic amplifiers”…”�”}”(hj¨h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj¥h²hh³hÇh´Kubhþ)�”}”(hŒThe cs35l56 drivers support:”h]”hŒThe cs35l56 drivers support:”…”�”}”(hj¶h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K hj¥h²hubhŒ bullet_list”“”)�”}”(hhh]”(hŒ list_item”“”)�”}”(hŒCS35L54”h]”hþ)�”}”(hjÍh]”hŒCS35L54”…”�”}”(hjÏh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K"hjËubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhjÆh²hh³hÇh´NubjÊ)�”}”(hŒCS35L56”h]”hþ)�”}”(hjäh]”hŒCS35L56”…”�”}”(hjæh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K#hjâubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhjÆh²hh³hÇh´NubjÊ)�”}”(hŒCS35L57”h]”hþ)�”}”(hjûh]”hŒCS35L57”…”�”}”(hjýh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K$hjùubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhjÆh²hh³hÇh´NubjÊ)�”}”(hŒCS35L63 ”h]”hþ)�”}”(hŒCS35L63”h]”hŒCS35L63”…”�”}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K%hjubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhjÆh²hh³hÇh´Nubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ*”uh1jÄh³hÇh´K"hj¥h²hubhþ)�”}”(hŒ#There are two drivers in the kernel”h]”hŒ#There are two drivers in the kernel”…”�”}”(hj0h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K'hj¥h²hubhþ)�”}”(hŒN*For systems using SoundWire*: sound/soc/codecs/cs35l56.c and associated files”h]”(hŒemphasis”“”)�”}”(hŒ*For systems using SoundWire*”h]”hŒFor systems using SoundWire”…”�”}”(hjDh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jBhj>ubhŒ1: sound/soc/codecs/cs35l56.c and associated files”…”�”}”(hj>h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K)hj¥h²hubhþ)�”}”(hŒC*For systems using HDA*: sound/hda/codecs/side-codecs/cs35l56_hda.c”h]”(jC)�”}”(hŒ*For systems using HDA*”h]”hŒFor systems using HDA”…”�”}”(hj`h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jBhj\ubhŒ,: sound/hda/codecs/side-codecs/cs35l56_hda.c”…”�”}”(hj\h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K+hj¥h²hubeh}”(h]”Œ!supported-cirrus-logic-amplifiers”ah ]”h"]”Œ!supported cirrus logic amplifiers”ah$]”h&]”uh1hÈhj?h²hh³hÇh´Kubeh}”(h]”Œsummary”ah ]”h"]”Œsummary”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´K ubhÉ)�”}”(hhh]”(hÎ)�”}”(hŒFirmware”h]”hŒFirmware”…”�”}”(hj‹h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjˆh²hh³hÇh´K.ubhþ)�”}”(hŒŸThe amplifier is controlled and managed by firmware running on the internal DSP. Firmware files are essential to enable the full capabilities of the amplifier.”h]”hŒŸThe amplifier is controlled and managed by firmware running on the internal DSP. Firmware files are essential to enable the full capabilities of the amplifier.”…”�”}”(hj™h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K0hjˆh²hubhþ)�”}”(hŒoFirmware is distributed in the linux-firmware repository: https://gitlab.com/kernel-firmware/linux-firmware.git”h]”(hŒ:Firmware is distributed in the linux-firmware repository: ”…”�”}”(hj§h²hh³Nh´Nubj()�”}”(hŒ5https://gitlab.com/kernel-firmware/linux-firmware.git”h]”hŒ5https://gitlab.com/kernel-firmware/linux-firmware.git”…”�”}”(hj¯h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j±uh1j'hj§ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K4hjˆh²hubhþ)�”}”(hŒoOn most SoundWire systems the amplifier has a default minimum capability to produce audio. However this will be”h]”hŒoOn most SoundWire systems the amplifier has a default minimum capability to produce audio. However this will be”…”�”}”(hjÄh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K7hjˆh²hubjÅ)�”}”(hhh]”(jÊ)�”}”(hŒoat low volume, to protect the speakers, since the speaker specifications and power supply voltages are unknown.”h]”hþ)�”}”(hŒoat low volume, to protect the speakers, since the speaker specifications and power supply voltages are unknown.”h]”hŒoat low volume, to protect the speakers, since the speaker specifications and power supply voltages are unknown.”…”�”}”(hjÙh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K:hjÕubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhjÒh²hh³hÇh´NubjÊ)�”}”(hŒ'a mono mix of left and right channels. ”h]”hþ)�”}”(hŒ&a mono mix of left and right channels.”h]”hŒ&a mono mix of left and right channels.”…”�”}”(hjñh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KOn some SoundWire systems that have both CS42L43 and CS35L56/57 the CS35L56/57 receive their audio from the CS42L43 instead of directly from the host SoundWire interface. These systems can be identified by the CS42L43 showing in dmesg as a SoundWire device, but the CS35L56/57 as SPI. On these systems the firmware is ”…”�”}”(hj h²hh³Nh´NubjC)�”}”(hŒ *mandatory*”h]”hŒ mandatory”…”�”}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jBhj ubhŒ0 to enable receiving the audio from the CS42L43.”…”�”}”(hj h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K>hjˆh²hubhþ)�”}”(hŒ‡On HDA systems the firmware is *mandatory* to enable HDA bridge mode. There will not be any audio from the amplifiers without firmware.”h]”(hŒOn HDA systems the firmware is ”…”�”}”(hj+h²hh³Nh´NubjC)�”}”(hŒ *mandatory*”h]”hŒ mandatory”…”�”}”(hj3h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jBhj+ubhŒ] to enable HDA bridge mode. There will not be any audio from the amplifiers without firmware.”…”�”}”(hj+h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KDhjˆh²hubhÉ)�”}”(hhh]”(hÎ)�”}”(hŒCirrus Logic firmware files”h]”hŒCirrus Logic firmware files”…”�”}”(hjNh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjKh²hh³hÇh´KHubhþ)�”}”(hŒeEach amplifier requires two firmware files. One file has a .wmfw suffix, the other has a .bin suffix.”h]”hŒeEach amplifier requires two firmware files. One file has a .wmfw suffix, the other has a .bin suffix.”…”�”}”(hj\h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KJhjKh²hubhþ)�”}”(hX The firmware is customized by the OEM to match the hardware of each laptop, and the firmware is specific to that laptop. Because of this, there are many firmware files in linux-firmware for these amplifiers. Firmware files are **not interchangeable between laptops**.”h]”(hŒãThe firmware is customized by the OEM to match the hardware of each laptop, and the firmware is specific to that laptop. Because of this, there are many firmware files in linux-firmware for these amplifiers. Firmware files are ”…”�”}”(hjjh²hh³Nh´Nubjc)�”}”(hŒ'**not interchangeable between laptops**”h]”hŒ#not interchangeable between laptops”…”�”}”(hjrh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jbhjjubhŒ.”…”�”}”(hjjh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KMhjKh²hubhþ)�”}”(hXZCirrus Logic submits files for known laptops to the upstream linux-firmware repository. Providing Cirrus Logic is aware of a particular laptop and has permission from the manufacturer to publish the firmware, it will be pushed to linux-firmware. You may need to upgrade to a newer release of linux-firmware to obtain the firmware for your laptop.”h]”hXZCirrus Logic submits files for known laptops to the upstream linux-firmware repository. Providing Cirrus Logic is aware of a particular laptop and has permission from the manufacturer to publish the firmware, it will be pushed to linux-firmware. You may need to upgrade to a newer release of linux-firmware to obtain the firmware for your laptop.”…”�”}”(hjŠh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KRhjKh²hubhþ)�”}”(hŒ·**Important:** the Makefile for linux-firmware creates symlinks that are listed in the WHENCE file. These symlinks are required for the CS35L56 driver to be able to load the firmware.”h]”(jc)�”}”(hŒ**Important:**”h]”hŒ Important:”…”�”}”(hjœh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jbhj˜ubhŒ© the Makefile for linux-firmware creates symlinks that are listed in the WHENCE file. These symlinks are required for the CS35L56 driver to be able to load the firmware.”…”�”}”(hj˜h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KXhjKh²hubhÉ)�”}”(hhh]”(hÎ)�”}”(hŒ0How do I know which firmware file I should have?”h]”hŒ0How do I know which firmware file I should have?”…”�”}”(hj·h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj´h²hh³hÇh´K]ubhþ)�”}”(hŒ©All firmware file names are qualified with a unique "system ID". On normal x86 PCs with PCI audio this is the Vendor Subsystem ID (SSID) of the host PCI audio interface.”h]”hŒ­All firmware file names are qualified with a unique “system IDâ€�. On normal x86 PCs with PCI audio this is the Vendor Subsystem ID (SSID) of the host PCI audio interface.”…”�”}”(hjÅh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K^hj´h²hubhþ)�”}”(hŒ-The SSID can be viewed using the lspci tool::”h]”hŒ,The SSID can be viewed using the lspci tool:”…”�”}”(hjÓh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Kbhj´h²hubhŒ literal_block”“”)�”}”(hŒÀlspci -v -nn | grep -A2 -i audio 0000:00:1f.3 Audio device [0403]: Intel Corporation Meteor Lake-P HD Audio Controller [8086:7e28] Subsystem: Dell Meteor Lake-P HD Audio Controller [1028:0c63]”h]”hŒÀlspci -v -nn | grep -A2 -i audio 0000:00:1f.3 Audio device [0403]: Intel Corporation Meteor Lake-P HD Audio Controller [8086:7e28] Subsystem: Dell Meteor Lake-P HD Audio Controller [1028:0c63]”…”�”}”hjãsbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1jáh³hÇh´Kdhj´h²hubhþ)�”}”(hŒ%In this example the SSID is 10280c63.”h]”hŒ%In this example the SSID is 10280c63.”…”�”}”(hjñh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Khhj´h²hubhþ)�”}”(hŒ)The format of the firmware file names is:”h]”hŒ)The format of the firmware file names is:”…”�”}”(hjÿh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Kjhj´h²hubhŒdefinition_list”“”)�”}”(hhh]”(hŒdefinition_list_item”“”)�”}”(hŒ3SoundWire: cs35lxx-b0-dsp1-misc-SSID[-spkidX]-l?u? ”h]”(hŒterm”“”)�”}”(hŒ SoundWire:”h]”hŒ SoundWire:”…”�”}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´KmhjubhŒ definition”“”)�”}”(hhh]”hþ)�”}”(hŒ'cs35lxx-b0-dsp1-misc-SSID[-spkidX]-l?u?”h]”hŒ'cs35lxx-b0-dsp1-misc-SSID[-spkidX]-l?u?”…”�”}”(hj-h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Kmhj*ubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Kmhjubj)�”}”(hŒoSoundWire CS35L56 Rev B0 firmware released before kernel version 6.16: cs35lxx-b0-dsp1-misc-SSID[-spkidX]-ampN ”h]”(j)�”}”(hŒFSoundWire CS35L56 Rev B0 firmware released before kernel version 6.16:”h]”hŒFSoundWire CS35L56 Rev B0 firmware released before kernel version 6.16:”…”�”}”(hjKh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´KphjGubj))�”}”(hhh]”hþ)�”}”(hŒ'cs35lxx-b0-dsp1-misc-SSID[-spkidX]-ampN”h]”hŒ'cs35lxx-b0-dsp1-misc-SSID[-spkidX]-ampN”…”�”}”(hj\h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KphjYubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hjGubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Kphjh²hubj)�”}”(hŒENon-SoundWire (HDA and I2S): cs35lxx-b0-dsp1-misc-SSID[-spkidX]-ampN ”h]”(j)�”}”(hŒNon-SoundWire (HDA and I2S):”h]”hŒNon-SoundWire (HDA and I2S):”…”�”}”(hjzh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Kshjvubj))�”}”(hhh]”hþ)�”}”(hŒ'cs35lxx-b0-dsp1-misc-SSID[-spkidX]-ampN”h]”hŒ'cs35lxx-b0-dsp1-misc-SSID[-spkidX]-ampN”…”�”}”(hj‹h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Kshjˆubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hjvubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Kshjh²hubeh}”(h]”h ]”h"]”h$]”h&]”uh1j hj´h²hh³hÇh´Nubhþ)�”}”(hŒWhere:”h]”hŒWhere:”…”�”}”(hj«h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Kuhj´h²hubhŒ block_quote”“”)�”}”(hX/* cs35lxx-b0 is the amplifier model and silicon revision. This information is logged by the driver during initialization. * SSID is the 8-digit hexadecimal SSID value. * l?u? is the physical address on the SoundWire bus of the amp this file applies to. * ampN is the amplifier number (for example amp1). This is the same as the prefix on the ALSA control names except that it is always lower-case in the file name. * spkidX is an optional part, used for laptops that have firmware configurations for different makes and models of internal speakers. ”h]”jÅ)�”}”(hhh]”(jÊ)�”}”(hŒwcs35lxx-b0 is the amplifier model and silicon revision. This information is logged by the driver during initialization.”h]”hþ)�”}”(hŒwcs35lxx-b0 is the amplifier model and silicon revision. This information is logged by the driver during initialization.”h]”hŒwcs35lxx-b0 is the amplifier model and silicon revision. This information is logged by the driver during initialization.”…”�”}”(hjÆh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KwhjÂubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhj¿ubjÊ)�”}”(hŒ+SSID is the 8-digit hexadecimal SSID value.”h]”hþ)�”}”(hjÜh]”hŒ+SSID is the 8-digit hexadecimal SSID value.”…”�”}”(hjÞh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KyhjÚubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhj¿ubjÊ)�”}”(hŒRl?u? is the physical address on the SoundWire bus of the amp this file applies to.”h]”hþ)�”}”(hŒRl?u? is the physical address on the SoundWire bus of the amp this file applies to.”h]”hŒRl?u? is the physical address on the SoundWire bus of the amp this file applies to.”…”�”}”(hjõh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Kzhjñubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhj¿ubjÊ)�”}”(hŒŸampN is the amplifier number (for example amp1). This is the same as the prefix on the ALSA control names except that it is always lower-case in the file name.”h]”hþ)�”}”(hŒŸampN is the amplifier number (for example amp1). This is the same as the prefix on the ALSA control names except that it is always lower-case in the file name.”h]”hŒŸampN is the amplifier number (for example amp1). This is the same as the prefix on the ALSA control names except that it is always lower-case in the file name.”…”�”}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K|hj ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhj¿ubjÊ)�”}”(hŒ„spkidX is an optional part, used for laptops that have firmware configurations for different makes and models of internal speakers. ”h]”hþ)�”}”(hŒƒspkidX is an optional part, used for laptops that have firmware configurations for different makes and models of internal speakers.”h]”hŒƒspkidX is an optional part, used for laptops that have firmware configurations for different makes and models of internal speakers.”…”�”}”(hj%h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Khj!ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhj¿ubeh}”(h]”h ]”h"]”h$]”h&]”j.j/uh1jÄh³hÇh´Kwhj»ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¹h³hÇh´Kwhj´h²hubhþ)�”}”(hŒ‘Early firmware for CS35L56 Rev B0 used the ALSA prefix (ampN) as the filename qualifier. Support for the l?u? qualifier was added in kernel 6.16.”h]”hŒ‘Early firmware for CS35L56 Rev B0 used the ALSA prefix (ampN) as the filename qualifier. Support for the l?u? qualifier was added in kernel 6.16.”…”�”}”(hjEh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K‚hj´h²hubeh}”(h]”Œ/how-do-i-know-which-firmware-file-i-should-have”ah ]”h"]”Œ0how do i know which firmware file i should have?”ah$]”h&]”uh1hÈhjKh²hh³hÇh´K]ubeh}”(h]”Œcirrus-logic-firmware-files”ah ]”h"]”Œcirrus logic firmware files”ah$]”h&]”uh1hÈhjˆh²hh³hÇh´KHubhÉ)�”}”(hhh]”(hÎ)�”}”(hŒ+Sound Open Firmware and ALSA topology files”h]”hŒ+Sound Open Firmware and ALSA topology files”…”�”}”(hjfh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjch²hh³hÇh´K†ubhþ)�”}”(hŒ‡All SoundWire systems will require a Sound Open Firmware (SOF) for the host CPU audio DSP, together with an ALSA topology file (.tplg).”h]”hŒ‡All SoundWire systems will require a Sound Open Firmware (SOF) for the host CPU audio DSP, together with an ALSA topology file (.tplg).”…”�”}”(hjth²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Kˆhjch²hubhþ)�”}”(hŒŸThe SOF firmware will usually be provided by the manufacturer of the host CPU (i.e. Intel or AMD). The .tplg file is normally part of the SOF firmware release.”h]”hŒŸThe SOF firmware will usually be provided by the manufacturer of the host CPU (i.e. Intel or AMD). The .tplg file is normally part of the SOF firmware release.”…”�”}”(hj‚h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K‹hjch²hubhþ)�”}”(hŒWSOF binary builds are available from: https://github.com/thesofproject/sof-bin/releases”h]”(hŒ&SOF binary builds are available from: ”…”�”}”(hj�h²hh³Nh´Nubj()�”}”(hŒ1https://github.com/thesofproject/sof-bin/releases”h]”hŒ1https://github.com/thesofproject/sof-bin/releases”…”�”}”(hj˜h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jšuh1j'hj�ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K�hjch²hubhþ)�”}”(hŒ=The main SOF source is here: https://github.com/thesofproject”h]”(hŒThe main SOF source is here: ”…”�”}”(hj­h²hh³Nh´Nubj()�”}”(hŒ https://github.com/thesofproject”h]”hŒ https://github.com/thesofproject”…”�”}”(hjµh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j·uh1j'hj­ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K‘hjch²hubeh}”(h]”Œ+sound-open-firmware-and-alsa-topology-files”ah ]”h"]”Œ+sound open firmware and alsa topology files”ah$]”h&]”uh1hÈhjˆh²hh³hÇh´K†ubhÉ)�”}”(hhh]”(hÎ)�”}”(hŒALSA-ucm configurations”h]”hŒALSA-ucm configurations”…”�”}”(hjÕh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjÒh²hh³hÇh´K”ubhþ)�”}”(hŒxTypically an appropriate ALSA-ucm configuration file is needed for use-case managers and audio servers such as PipeWire.”h]”hŒxTypically an appropriate ALSA-ucm configuration file is needed for use-case managers and audio servers such as PipeWire.”…”�”}”(hjãh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K•hjÒh²hubhþ)�”}”(hŒvConfiguration files are available from the alsa-ucm-conf repository: https://git.alsa-project.org/?p=alsa-ucm-conf.git”h]”(hŒEConfiguration files are available from the alsa-ucm-conf repository: ”…”�”}”(hjñh²hh³Nh´Nubj()�”}”(hŒ1https://git.alsa-project.org/?p=alsa-ucm-conf.git”h]”hŒ1https://git.alsa-project.org/?p=alsa-ucm-conf.git”…”�”}”(hjùh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jûuh1j'hjñubeh}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K˜hjÒh²hubeh}”(h]”Œalsa-ucm-configurations”ah ]”h"]”Œalsa-ucm configurations”ah$]”h&]”uh1hÈhjˆh²hh³hÇh´K”ubeh}”(h]”Œfirmware”ah ]”h"]”Œfirmware”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´K.ubhÉ)�”}”(hhh]”(hÎ)�”}”(hŒKernel log messages”h]”hŒKernel log messages”…”�”}”(hj!h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjh²hh³hÇh´KœubhÉ)�”}”(hhh]”(hÎ)�”}”(hŒ SoundWire”h]”hŒ SoundWire”…”�”}”(hj2h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj/h²hh³hÇh´KŸubhþ)�”}”(hŒ\A successful initialization will look like this (this will be repeated for each amplifier)::”h]”hŒ[A successful initialization will look like this (this will be repeated for each amplifier):”…”�”}”(hj@h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K hj/h²hubjâ)�”}”(hXð[ 7.568374] cs35l56 sdw:0:0:01fa:3556:01:0: supply VDD_P not found, using dummy regulator [ 7.605208] cs35l56 sdw:0:0:01fa:3556:01:0: supply VDD_IO not found, using dummy regulator [ 7.605313] cs35l56 sdw:0:0:01fa:3556:01:0: supply VDD_A not found, using dummy regulator [ 7.939279] cs35l56 sdw:0:0:01fa:3556:01:0: Cirrus Logic CS35L56 Rev B0 OTP3 fw:3.4.4 (patched=0) [ 7.947844] cs35l56 sdw:0:0:01fa:3556:01:0: Slave 4 state check1: UNATTACHED, status was 1 [ 8.740280] cs35l56 sdw:0:0:01fa:3556:01:0: supply VDD_B not found, using dummy regulator [ 8.740552] cs35l56 sdw:0:0:01fa:3556:01:0: supply VDD_AMP not found, using dummy regulator [ 9.242164] cs35l56 sdw:0:0:01fa:3556:01:0: DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx.wmfw: format 3 timestamp 0x66b2b872 [ 9.242173] cs35l56 sdw:0:0:01fa:3556:01:0: DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx.wmfw: Tue 05 Dec 2023 21:37:21 GMT Standard Time [ 9.991709] cs35l56 sdw:0:0:01fa:3556:01:0: DSP1: Firmware: 1a00d6 vendor: 0x2 v3.11.23, 41 algorithms [10.039098] cs35l56 sdw:0:0:01fa:3556:01:0: DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx-amp1.bin: v3.11.23 [10.879235] cs35l56 sdw:0:0:01fa:3556:01:0: Slave 4 state check1: UNATTACHED, status was 1 [11.401536] cs35l56 sdw:0:0:01fa:3556:01:0: Calibration applied”h]”hXð[ 7.568374] cs35l56 sdw:0:0:01fa:3556:01:0: supply VDD_P not found, using dummy regulator [ 7.605208] cs35l56 sdw:0:0:01fa:3556:01:0: supply VDD_IO not found, using dummy regulator [ 7.605313] cs35l56 sdw:0:0:01fa:3556:01:0: supply VDD_A not found, using dummy regulator [ 7.939279] cs35l56 sdw:0:0:01fa:3556:01:0: Cirrus Logic CS35L56 Rev B0 OTP3 fw:3.4.4 (patched=0) [ 7.947844] cs35l56 sdw:0:0:01fa:3556:01:0: Slave 4 state check1: UNATTACHED, status was 1 [ 8.740280] cs35l56 sdw:0:0:01fa:3556:01:0: supply VDD_B not found, using dummy regulator [ 8.740552] cs35l56 sdw:0:0:01fa:3556:01:0: supply VDD_AMP not found, using dummy regulator [ 9.242164] cs35l56 sdw:0:0:01fa:3556:01:0: DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx.wmfw: format 3 timestamp 0x66b2b872 [ 9.242173] cs35l56 sdw:0:0:01fa:3556:01:0: DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx.wmfw: Tue 05 Dec 2023 21:37:21 GMT Standard Time [ 9.991709] cs35l56 sdw:0:0:01fa:3556:01:0: DSP1: Firmware: 1a00d6 vendor: 0x2 v3.11.23, 41 algorithms [10.039098] cs35l56 sdw:0:0:01fa:3556:01:0: DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx-amp1.bin: v3.11.23 [10.879235] cs35l56 sdw:0:0:01fa:3556:01:0: Slave 4 state check1: UNATTACHED, status was 1 [11.401536] cs35l56 sdw:0:0:01fa:3556:01:0: Calibration applied”…”�”}”hjNsbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1jáh³hÇh´K£hj/h²hubeh}”(h]”Œ soundwire”ah ]”h"]”Œ soundwire”ah$]”h&]”uh1hÈhjh²hh³hÇh´KŸubhÉ)�”}”(hhh]”(hÎ)�”}”(hŒHDA”h]”hŒHDA”…”�”}”(hjgh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjdh²hh³hÇh´K²ubhþ)�”}”(hŒ\A successful initialization will look like this (this will be repeated for each amplifier)::”h]”hŒ[A successful initialization will look like this (this will be repeated for each amplifier):”…”�”}”(hjuh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K³hjdh²hubjâ)�”}”(hXš[ 6.306475] cs35l56-hda i2c-CSC3556:00-cs35l56-hda.0: Cirrus Logic CS35L56 Rev B0 OTP3 fw:3.4.4 (patched=0) [ 6.613892] cs35l56-hda i2c-CSC3556:00-cs35l56-hda.0: DSP system name: 'xxxxxxxx', amp name: 'AMP1' [ 8.266660] snd_hda_codec_cs8409 ehdaudio0D0: bound i2c-CSC3556:00-cs35l56-hda.0 (ops cs35l56_hda_comp_ops [snd_hda_scodec_cs35l56]) [ 8.287525] cs35l56-hda i2c-CSC3556:00-cs35l56-hda.0: DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx.wmfw: format 3 timestamp 0x66b2b872 [ 8.287528] cs35l56-hda i2c-CSC3556:00-cs35l56-hda.0: DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx.wmfw: Tue 05 Dec 2023 21:37:21 GMT Standard Time [ 9.984335] cs35l56-hda i2c-CSC3556:00-cs35l56-hda.0: DSP1: Firmware: 1a00d6 vendor: 0x2 v3.11.23, 41 algorithms [10.085797] cs35l56-hda i2c-CSC3556:00-cs35l56-hda.0: DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx-amp1.bin: v3.11.23 [10.655237] cs35l56-hda i2c-CSC3556:00-cs35l56-hda.0: Calibration applied”h]”hXš[ 6.306475] cs35l56-hda i2c-CSC3556:00-cs35l56-hda.0: Cirrus Logic CS35L56 Rev B0 OTP3 fw:3.4.4 (patched=0) [ 6.613892] cs35l56-hda i2c-CSC3556:00-cs35l56-hda.0: DSP system name: 'xxxxxxxx', amp name: 'AMP1' [ 8.266660] snd_hda_codec_cs8409 ehdaudio0D0: bound i2c-CSC3556:00-cs35l56-hda.0 (ops cs35l56_hda_comp_ops [snd_hda_scodec_cs35l56]) [ 8.287525] cs35l56-hda i2c-CSC3556:00-cs35l56-hda.0: DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx.wmfw: format 3 timestamp 0x66b2b872 [ 8.287528] cs35l56-hda i2c-CSC3556:00-cs35l56-hda.0: DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx.wmfw: Tue 05 Dec 2023 21:37:21 GMT Standard Time [ 9.984335] cs35l56-hda i2c-CSC3556:00-cs35l56-hda.0: DSP1: Firmware: 1a00d6 vendor: 0x2 v3.11.23, 41 algorithms [10.085797] cs35l56-hda i2c-CSC3556:00-cs35l56-hda.0: DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx-amp1.bin: v3.11.23 [10.655237] cs35l56-hda i2c-CSC3556:00-cs35l56-hda.0: Calibration applied”…”�”}”hjƒsbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1jáh³hÇh´K¶hjdh²hubhÉ)�”}”(hhh]”(hÎ)�”}”(hŒImportant messages”h]”hŒImportant messages”…”�”}”(hj”h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj‘h²hh³hÇh´KÀubj)�”}”(hhh]”(j)�”}”(hXÞCirrus Logic CS35L56 Rev B0 OTP3 fw:3.4.4 (patched=0) Shows that the driver has been able to read device ID registers from the amplifier. * The actual amplifier type and silicon revision (CS35L56 B0 in this example) is shown, as read from the amplifier identification registers. * (patched=0) is normal, and indicates that the amplifier has been hard reset and is running default ROM firmware. * (patched=1) means that something has previously downloaded firmware to the amplifier and the driver does not have control of the RESET signal to be able to replace this preloaded firmware. This is normal for systems where the BIOS downloads firmware to the amplifiers before OS boot. This status can also be seen if the cs35l56 kernel module is unloaded and reloaded on a system where the driver does not have control of RESET. SoundWire systems typically do not give the driver control of RESET and only a BIOS (re)boot can reset the amplifiers. ”h]”(j)�”}”(hŒ5Cirrus Logic CS35L56 Rev B0 OTP3 fw:3.4.4 (patched=0)”h]”hŒ5Cirrus Logic CS35L56 Rev B0 OTP3 fw:3.4.4 (patched=0)”…”�”}”(hj©h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´KÑhj¥ubj))�”}”(hhh]”(hþ)�”}”(hŒSShows that the driver has been able to read device ID registers from the amplifier.”h]”hŒSShows that the driver has been able to read device ID registers from the amplifier.”…”�”}”(hjºh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KÂhj·ubjº)�”}”(hX9* The actual amplifier type and silicon revision (CS35L56 B0 in this example) is shown, as read from the amplifier identification registers. * (patched=0) is normal, and indicates that the amplifier has been hard reset and is running default ROM firmware. * (patched=1) means that something has previously downloaded firmware to the amplifier and the driver does not have control of the RESET signal to be able to replace this preloaded firmware. This is normal for systems where the BIOS downloads firmware to the amplifiers before OS boot. This status can also be seen if the cs35l56 kernel module is unloaded and reloaded on a system where the driver does not have control of RESET. SoundWire systems typically do not give the driver control of RESET and only a BIOS (re)boot can reset the amplifiers. ”h]”jÅ)�”}”(hhh]”(jÊ)�”}”(hŒŠThe actual amplifier type and silicon revision (CS35L56 B0 in this example) is shown, as read from the amplifier identification registers.”h]”hþ)�”}”(hŒŠThe actual amplifier type and silicon revision (CS35L56 B0 in this example) is shown, as read from the amplifier identification registers.”h]”hŒŠThe actual amplifier type and silicon revision (CS35L56 B0 in this example) is shown, as read from the amplifier identification registers.”…”�”}”(hjÓh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KÅhjÏubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhjÌubjÊ)�”}”(hŒp(patched=0) is normal, and indicates that the amplifier has been hard reset and is running default ROM firmware.”h]”hþ)�”}”(hŒp(patched=0) is normal, and indicates that the amplifier has been hard reset and is running default ROM firmware.”h]”hŒp(patched=0) is normal, and indicates that the amplifier has been hard reset and is running default ROM firmware.”…”�”}”(hjëh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KÇhjçubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhjÌubjÊ)�”}”(hX#(patched=1) means that something has previously downloaded firmware to the amplifier and the driver does not have control of the RESET signal to be able to replace this preloaded firmware. This is normal for systems where the BIOS downloads firmware to the amplifiers before OS boot. This status can also be seen if the cs35l56 kernel module is unloaded and reloaded on a system where the driver does not have control of RESET. SoundWire systems typically do not give the driver control of RESET and only a BIOS (re)boot can reset the amplifiers. ”h]”hþ)�”}”(hX"(patched=1) means that something has previously downloaded firmware to the amplifier and the driver does not have control of the RESET signal to be able to replace this preloaded firmware. This is normal for systems where the BIOS downloads firmware to the amplifiers before OS boot. This status can also be seen if the cs35l56 kernel module is unloaded and reloaded on a system where the driver does not have control of RESET. SoundWire systems typically do not give the driver control of RESET and only a BIOS (re)boot can reset the amplifiers.”h]”hX"(patched=1) means that something has previously downloaded firmware to the amplifier and the driver does not have control of the RESET signal to be able to replace this preloaded firmware. This is normal for systems where the BIOS downloads firmware to the amplifiers before OS boot. This status can also be seen if the cs35l56 kernel module is unloaded and reloaded on a system where the driver does not have control of RESET. SoundWire systems typically do not give the driver control of RESET and only a BIOS (re)boot can reset the amplifiers.”…”�”}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KÉhjÿubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhjÌubeh}”(h]”h ]”h"]”h$]”h&]”j.j/uh1jÄh³hÇh´KÅhjÈubah}”(h]”h ]”h"]”h$]”h&]”uh1j¹h³hÇh´KÅhj·ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j(hj¥ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´KÑhj¢ubj)�”}”(hŒkDSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx.wmfw Shows that a .wmfw firmware file was found and downloaded. ”h]”(j)�”}”(hŒ/DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx.wmfw”h]”hŒ/DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx.wmfw”…”�”}”(hj3h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´KÔhj/ubj))�”}”(hhh]”hþ)�”}”(hŒ:Shows that a .wmfw firmware file was found and downloaded.”h]”hŒ:Shows that a .wmfw firmware file was found and downloaded.”…”�”}”(hjDh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KÔhjAubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hj/ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´KÔhj¢h²hubj)�”}”(hŒnDSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx-amp1.bin Shows that a .bin firmware file was found and downloaded. ”h]”(j)�”}”(hŒ3DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx-amp1.bin”h]”hŒ3DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx-amp1.bin”…”�”}”(hjbh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K×hj^ubj))�”}”(hhh]”hþ)�”}”(hŒ9Shows that a .bin firmware file was found and downloaded.”h]”hŒ9Shows that a .bin firmware file was found and downloaded.”…”�”}”(hjsh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´K×hjpubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hj^ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K×hj¢h²hubj)�”}”(hŒRCalibration applied Factory calibration data in EFI was written to the amplifier. ”h]”(j)�”}”(hŒCalibration applied”h]”hŒCalibration applied”…”�”}”(hj‘h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´KÚhj�ubj))�”}”(hhh]”hþ)�”}”(hŒ=Factory calibration data in EFI was written to the amplifier.”h]”hŒ=Factory calibration data in EFI was written to the amplifier.”…”�”}”(hj¢h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KÚhjŸubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hj�ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´KÚhj¢h²hubeh}”(h]”h ]”h"]”h$]”h&]”uh1j hj‘h²hh³hÇh´Nubeh}”(h]”Œimportant-messages”ah ]”h"]”Œimportant messages”ah$]”h&]”uh1hÈhjdh²hh³hÇh´KÀubeh}”(h]”Œhda”ah ]”h"]”Œhda”ah$]”h&]”uh1hÈhjh²hh³hÇh´K²ubeh}”(h]”Œkernel-log-messages”ah ]”h"]”Œkernel log messages”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KœubhÉ)�”}”(hhh]”(hÎ)�”}”(hŒError messages”h]”hŒError messages”…”�”}”(hjÝh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjÚh²hh³hÇh´KÝubhþ)�”}”(hŒIThis section explains some of the error messages that the driver can log.”h]”hŒIThis section explains some of the error messages that the driver can log.”…”�”}”(hjëh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´KÞhjÚh²hubj)�”}”(hhh]”(j)�”}”(hŒÚAlgorithm coefficient version %d.%d.%d but expected %d.%d.%d The version of the .bin file content does not match the loaded firmware. Caused by mismatched .wmfw and .bin file, or .bin file was found but .wmfw was not. ”h]”(j)�”}”(hŒ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Kýhj; ubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hj) ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Kÿhjùh²hubj)�”}”(hXNo calibration for silicon ID The factory calibration data in EFI does not match this hardware. The most likely cause is that an amplifier has been replaced on the motherboard without going through manufacturer calibration process to generate calibration data for the new amplifier. ”h]”(j)�”}”(hŒNo calibration for silicon ID”h]”hŒNo calibration for silicon ID”…”�”}”(hj\ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´MhjX ubj))�”}”(hhh]”hþ)�”}”(hŒüThe factory calibration data in EFI does not match this hardware. The most likely cause is that an amplifier has been replaced on the motherboard without going through manufacturer calibration process to generate calibration data for the new amplifier.”h]”hŒüThe factory calibration data in EFI does not match this hardware. The most likely cause is that an amplifier has been replaced on the motherboard without going through manufacturer calibration process to generate calibration data for the new amplifier.”…”�”}”(hjm h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Mhjj ubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hjX ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Mhjùh²hubj)�”}”(hXÓDid not find any buses for CSCxxxx Only on HDA systems. The HDA codec driver found an ACPI entry for Cirrus Logic companion amps, but could not enumerate the ACPI entries for the I2C/SPI buses. The most likely cause of this is that: * The relevant bus driver (I2C or SPI) is not part of the kernel. * The HDA codec driver was built-in to the kernel but the I2C/SPI bus driver is a module and so the HDA codec driver cannot call the bus driver functions. ”h]”(j)�”}”(hŒ"Did not find any buses for CSCxxxx”h]”hŒ"Did not find any buses for CSCxxxx”…”�”}”(hj‹ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Mhj‡ ubj))�”}”(hhh]”(hþ)�”}”(hŒÅOnly on HDA systems. The HDA codec driver found an ACPI entry for Cirrus Logic companion amps, but could not enumerate the ACPI entries for the I2C/SPI buses. The most likely cause of this is that:”h]”hŒÅOnly on HDA systems. The HDA codec driver found an ACPI entry for Cirrus Logic companion amps, but could not enumerate the ACPI entries for the I2C/SPI buses. The most likely cause of this is that:”…”�”}”(hjœ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Mhj™ ubjº)�”}”(hŒá* The relevant bus driver (I2C or SPI) is not part of the kernel. * The HDA codec driver was built-in to the kernel but the I2C/SPI bus driver is a module and so the HDA codec driver cannot call the bus driver functions. ”h]”jÅ)�”}”(hhh]”(jÊ)�”}”(hŒ?The relevant bus driver (I2C or SPI) is not part of the kernel.”h]”hþ)�”}”(hj³ h]”hŒ?The relevant bus driver (I2C or SPI) is not part of the kernel.”…”�”}”(hjµ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´M hj± ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhj® ubjÊ)�”}”(hŒ™The HDA codec driver was built-in to the kernel but the I2C/SPI bus driver is a module and so the HDA codec driver cannot call the bus driver functions. ”h]”hþ)�”}”(hŒ˜The HDA codec driver was built-in to the kernel but the I2C/SPI bus driver is a module and so the HDA codec driver cannot call the bus driver functions.”h]”hŒ˜The HDA codec driver was built-in to the kernel but the I2C/SPI bus driver is a module and so the HDA codec driver cannot call the bus driver functions.”…”�”}”(hjÌ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´M hjÈ ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhj® ubeh}”(h]”h ]”h"]”h$]”h&]”j.j/uh1jÄh³hÇh´M hjª ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¹h³hÇh´M hj™ ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j(hj‡ ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Mhjùh²hubj)�”}”(hŒËinit_completion timed out The SoundWire bus controller (host end) did not enumerate the amplifier. In other words, the ACPI says there is an amplifier but for some reason it was not detected on the bus. ”h]”(j)�”}”(hŒinit_completion timed out”h]”hŒinit_completion timed out”…”�”}”(hjü h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Mhjø ubj))�”}”(hhh]”hþ)�”}”(hŒ°The SoundWire bus controller (host end) did not enumerate the amplifier. In other words, the ACPI says there is an amplifier but for some reason it was not detected on the bus.”h]”hŒ°The SoundWire bus controller (host end) did not enumerate the amplifier. In other words, the ACPI says there is an amplifier but for some reason it was not detected on the bus.”…”�”}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Mhj ubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hjø ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Mhjùh²hubj)�”}”(hŒ{No AF01 node Indicates an error in ACPI. A SoundWire system should have a Device() node named "AF01" but it was not found. ”h]”(j)�”}”(hŒ No AF01 node”h]”hŒ No AF01 node”…”�”}”(hj+ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Mhj' ubj))�”}”(hhh]”hþ)�”}”(hŒmIndicates an error in ACPI. A SoundWire system should have a Device() node named "AF01" but it was not found.”h]”hŒqIndicates an error in ACPI. A SoundWire system should have a Device() node named “AF01â€� but it was not found.”…”�”}”(hj< h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Mhj9 ubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hj' ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Mhjùh²hubj)�”}”(hŒçFailed to get spk-id-gpios ACPI says that the driver should request a GPIO but the driver was not able to get that GPIO. The most likely cause is that the kernel does not include the correct GPIO or PINCTRL driver for this system. ”h]”(j)�”}”(hŒFailed to get spk-id-gpios”h]”hŒFailed to get spk-id-gpios”…”�”}”(hjZ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´MhjV ubj))�”}”(hhh]”hþ)�”}”(hŒËACPI says that the driver should request a GPIO but the driver was not able to get that GPIO. The most likely cause is that the kernel does not include the correct GPIO or PINCTRL driver for this system.”h]”hŒËACPI says that the driver should request a GPIO but the driver was not able to get that GPIO. The most likely cause is that the kernel does not include the correct GPIO or PINCTRL driver for this system.”…”�”}”(hjk h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´Mhjh ubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hjV ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Mhjùh²hubj)�”}”(hŒuFailed to read spk-id ACPI says that the driver should request a GPIO but the driver was not able to read that GPIO. ”h]”(j)�”}”(hŒFailed to read spk-id”h]”hŒFailed to read spk-id”…”�”}”(hj‰ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´M!hj… ubj))�”}”(hhh]”hþ)�”}”(hŒ^ACPI says that the driver should request a GPIO but the driver was not able to read that GPIO.”h]”hŒ^ACPI says that the driver should request a GPIO but the driver was not able to read that GPIO.”…”�”}”(hjš h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´M hj— ubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hj… ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´M!hjùh²hubj)�”}”(hŒdUnexpected spk-id element count AF01 contains more speaker ID GPIO entries than the driver supports ”h]”(j)�”}”(hŒUnexpected spk-id element count”h]”hŒUnexpected spk-id element count”…”�”}”(hj¸ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´M$hj´ ubj))�”}”(hhh]”hþ)�”}”(hŒCAF01 contains more speaker ID GPIO entries than the driver supports”h]”hŒCAF01 contains more speaker ID GPIO entries than the driver supports”…”�”}”(hjÉ h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´M$hjÆ ubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hj´ ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´M$hjùh²hubj)�”}”(hŒjOvertemp error Amplifier overheat protection was triggered and the amplifier shut down to protect itself. ”h]”(j)�”}”(hŒOvertemp error”h]”hŒOvertemp error”…”�”}”(hjç h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´M(hjã ubj))�”}”(hhh]”hþ)�”}”(hŒZAmplifier overheat protection was triggered and the amplifier shut down to protect itself.”h]”hŒZAmplifier overheat protection was triggered and the amplifier shut down to protect itself.”…”�”}”(hjø h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´M'hjõ ubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hjã ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´M(hjùh²hubj)�”}”(hŒœAmp short error Amplifier detected a short-circuit on the speaker output pins and shut down for protection. This would normally indicate a damaged speaker. ”h]”(j)�”}”(hŒAmp short error”h]”hŒAmp short error”…”�”}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´M,hj ubj))�”}”(hhh]”hþ)�”}”(hŒ‹Amplifier detected a short-circuit on the speaker output pins and shut down for protection. This would normally indicate a damaged speaker.”h]”hŒ‹Amplifier detected a short-circuit on the speaker output pins and shut down for protection. This would normally indicate a damaged speaker.”…”�”}”(hj' h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´M+hj$ ubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hj ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´M,hjùh²hubj)�”}”(hŒÚHibernate wake failed The driver tried to wake the amplifier from its power-saving state but did not see the expected responses from the amplifier. This can be caused by using firmware that does not match the hardware.”h]”(j)�”}”(hŒHibernate wake failed”h]”hŒHibernate wake failed”…”�”}”(hjE h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´M0hjA ubj))�”}”(hhh]”hþ)�”}”(hŒÄThe driver tried to wake the amplifier from its power-saving state but did not see the expected responses from the amplifier. This can be caused by using firmware that does not match the hardware.”h]”hŒÄThe driver tried to wake the amplifier from its power-saving state but did not see the expected responses from the amplifier. This can be caused by using firmware that does not match the hardware.”…”�”}”(hjV h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hýh³hÇh´M/hjS ubah}”(h]”h ]”h"]”h$]”h&]”uh1j(hjA ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´M0hjùh²hubeh}”(h]”h ]”h"]”h$]”h&]”uh1j hjÚh²hh³hÇh´Nubeh}”(h]”Œerror-messages”ah ]”h"]”Œerror messages”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KÝubeh}”(h]”ŒHaudio-drivers-for-cirrus-logic-cs35l54-56-57-63-boosted-smart-amplifiers”ah ]”h"]”ŒHaudio drivers for cirrus logic cs35l54/56/57/63 boosted smart amplifiers”ah$]”h&]”uh1hÈhhh²hh³hÇh´Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hÇuh1hŒcurrent_source”NŒ current_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)�”}”(hÍNŒ generator”NŒ datestamp”NŒ source_link”NŒ source_url”NŒ toc_backlinks”Œentry”Œfootnote_backlinks”KŒ sectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒ strip_classes”NŒ report_level”KŒ halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ traceback”ˆŒinput_encoding”Œ utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j© Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œ language_code”Œen”Œrecord_dependencies”NŒconfig”NŒ id_prefix”hŒauto_id_prefix”Œid”Œ dump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”hÇŒ _destination”NŒ _config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒ raw_enabled”KŒline_length_limit”M'Œpep_references”NŒ pep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒ rfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œ smart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œ docinfo_xform”KŒsectsubtitle_xform”‰Œ image_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jƒ j€ j…j‚j}jzjjj`j]jXjUjÏjÌjjj×jÔjaj^jÏjÌjÇjÄj{ jx uŒ nametypes”}”(jƒ ‰j…‰j}‰j‰j`‰jX‰jωj‰j׉ja‰jωjljj{ ‰uh}”(j€ hÊj‚j?jzj¥jjˆj]jKjUj´jÌjcjjÒjÔjj^j/jÌjdjÄj‘jx jÚuŒ footnote_refs”}”Œ citation_refs”}”Œ autofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”Œ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒ id_counter”Œ collections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œ transformer”NŒ include_log”]”Œ decoration”Nh²hub.