Lines Matching +full:system +full:- +full:firmware
1 .. SPDX-License-Identifier: GPL-2.0-only
14 The high-level summary of this document is:
17 working, DO NOT ATTEMPT TO USE FIRMWARE AND SETTINGS FROM ANOTHER LAPTOP,
30 ---------------------------------
45 Firmware chapter
48 The amplifier is controlled and managed by firmware running on the internal
49 DSP. Firmware files are essential to enable the full capabilities of the
52 Firmware is distributed in the linux-firmware repository:
53 https://gitlab.com/kernel-firmware/linux-firmware.git
66 the firmware is *mandatory* to enable receiving the audio from the CS42L43.
68 On HDA systems the firmware is *mandatory* to enable HDA bridge mode. There
69 will not be any audio from the amplifiers without firmware.
71 Cirrus Logic firmware files
72 ---------------------------
74 Each amplifier requires two firmware files. One file has a .wmfw suffix, the
77 The firmware is customized by the OEM to match the hardware of each laptop,
78 and the firmware is specific to that laptop. Because of this, there are many
79 firmware files in linux-firmware for these amplifiers. Firmware files are
82 Cirrus Logic submits files for known laptops to the upstream linux-firmware
84 permission from the manufacturer to publish the firmware, it will be pushed
85 to linux-firmware. You may need to upgrade to a newer release of
86 linux-firmware to obtain the firmware for your laptop.
88 **Important:** the Makefile for linux-firmware creates symlinks that are listed
90 able to load the firmware.
92 How do I know which firmware file I should have?
94 All firmware file names are qualified with a unique "system ID". On normal
100 lspci -v -nn | grep -A2 -i audio
101 0000:00:1f.3 Audio device [0403]: Intel Corporation Meteor Lake-P HD Audio Controller [8086:7e28]
102 Subsystem: Dell Meteor Lake-P HD Audio Controller [1028:0c63]
106 The format of the firmware file names is:
109 cs35lxx-b0-dsp1-misc-SSID[-spkidX]-l?u?
112 cs35lxx-b0-dsp1-misc-SSID[-spkidX]-ampN
114 Non-SoundWire (HDA and I2S):
115 cs35lxx-b0-dsp1-misc-SSID[-spkidX]-ampN
119 * cs35lxx-b0 is the amplifier model and silicon revision. This information
121 * SSID is the 8-digit hexadecimal SSID value.
125 the prefix on the ALSA control names except that it is always lower-case
127 * spkidX is an optional part, used for laptops that have firmware
131 large number of firmware files have already been published with these
134 Sound Open Firmware and ALSA topology files
135 -------------------------------------------
137 All SoundWire systems will require a Sound Open Firmware (SOF) for the
140 The SOF firmware will usually be provided by the manufacturer of the host
141 CPU (i.e. Intel or AMD). The .tplg file is normally part of the SOF firmware
144 SOF binary builds are available from: https://github.com/thesofproject/sof-bin/releases
148 ALSA-ucm configurations
149 -----------------------
150 Typically an appropriate ALSA-ucm configuration file is needed for
151 use-case managers and audio servers such as PipeWire.
153 Configuration files are available from the alsa-ucm-conf repository:
154 https://git.alsa-project.org/?p=alsa-ucm-conf.git
160 ---------
171 …[ 9.242164] cs35l56 sdw:0:0:01fa:3556:01:0: DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx.wmfw: forma…
172 …[ 9.242173] cs35l56 sdw:0:0:01fa:3556:01:0: DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx.wmfw: Tue 0…
173 …[ 9.991709] cs35l56 sdw:0:0:01fa:3556:01:0: DSP1: Firmware: 1a00d6 vendor: 0x2 v3.11.23, 41 algori…
174 …[10.039098] cs35l56 sdw:0:0:01fa:3556:01:0: DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx-amp1.bin: v…
179 ---
183 …[ 6.306475] cs35l56-hda i2c-CSC3556:00-cs35l56-hda.0: Cirrus Logic CS35L56 Rev B0 OTP3 fw:3.4.4 (p…
184 …[ 6.613892] cs35l56-hda i2c-CSC3556:00-cs35l56-hda.0: DSP system name: 'xxxxxxxx', amp name: 'AMP1'
185 …[ 8.266660] snd_hda_codec_cs8409 ehdaudio0D0: bound i2c-CSC3556:00-cs35l56-hda.0 (ops cs35l56_hda_…
186 …[ 8.287525] cs35l56-hda i2c-CSC3556:00-cs35l56-hda.0: DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx.w…
187 …[ 8.287528] cs35l56-hda i2c-CSC3556:00-cs35l56-hda.0: DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx.w…
188 …[ 9.984335] cs35l56-hda i2c-CSC3556:00-cs35l56-hda.0: DSP1: Firmware: 1a00d6 vendor: 0x2 v3.11.23,…
189 …[10.085797] cs35l56-hda i2c-CSC3556:00-cs35l56-hda.0: DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx-a…
190 [10.655237] cs35l56-hda i2c-CSC3556:00-cs35l56-hda.0: Calibration applied
201 reset and is running default ROM firmware.
202 * (patched=1) means that something has previously downloaded firmware
204 signal to be able to replace this preloaded firmware. This is normal
205 for systems where the BIOS downloads firmware to the amplifiers
208 and reloaded on a system where the driver does not have control of
212 DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx.wmfw
213 Shows that a .wmfw firmware file was found and downloaded.
215 DSP1: cirrus/cs35l56-b0-dsp1-misc-xxxxxxxx-amp1.bin
216 Shows that a .bin firmware file was found and downloaded.
226 The version of the .bin file content does not match the loaded firmware.
231 The version of the .bin file content does not match the loaded firmware.
238 Calibration disabled due to missing firmware controls
239 Driver was not able to write EFI calibration data to firmware registers.
243 * The amplifier has already been patched with firmware by something
245 to be able to reset the amplifier and download the firmware files it
250 Same meaning and cause as "Calibration disabled due to missing firmware
270 * The HDA codec driver was built-in to the kernel but the I2C/SPI
280 Indicates an error in ACPI. A SoundWire system should have a Device()
283 Failed to get spk-id-gpios
286 include the correct GPIO or PINCTRL driver for this system.
288 Failed to read spk-id
292 Unexpected spk-id element count
300 Amplifier detected a short-circuit on the speaker output pins and shut
304 The driver tried to wake the amplifier from its power-saving state but
306 by using firmware that does not match the hardware.