Skip to content

desktops: install alsa-ucm-conf at minimal tier#923

Merged
igorpecovnik merged 1 commit into
mainfrom
desktops-add-alsa-ucm-conf
May 18, 2026
Merged

desktops: install alsa-ucm-conf at minimal tier#923
igorpecovnik merged 1 commit into
mainfrom
desktops-add-alsa-ucm-conf

Conversation

@igorpecovnik

Copy link
Copy Markdown
Member

Summary

Without `alsa-ucm-conf` installed, PipeWire / wireplumber see complex sound cards (Intel SOF on Lunar/Meteor/Panther Lake laptops, Qualcomm Snapdragon X, AMD ACP DSP, …) but have no per-machine recipe for which PCM device is the speaker output, which controls to unmute, or how to route on jack-insert.

Result: kernel-level audio is fully alive (`aplay -l` shows the Speaker pcm; `speaker-test -D plughw:0,2` plays), but GNOME / KDE Sound shows only "Dummy Output" and the speakers stay silent.

Verified

ThinkPad X9-15 Gen 1 (LNL, CS42L43 SoundWire jack + CS35L56 SPI amps, DMI `21Q6001MGE`). Same kernel + same SOF firmware + same Cirrus blobs + same topology as a working Ubuntu OEM 6.17 boot of the same machine. The only difference between "silent" and "working" was this package.

Scope

  • minimal tier of common.yaml — every desktop / release / arch / DE combo picks it up.
  • Architecture: all package, ~1 MB on disk.
  • Inert on simpler audio chains (HDMI-only SBCs, USB DAC, basic codec setups).

Pairs with

armbian/build#9858 — adds the same package to UEFI image builds via `uefi_common.inc`, so image-built rootfs gets it from the build side. This PR ensures the runtime `armbian-config module_desktops install` path also gets it on every desktop.

Verified across releases / tiers

```
noble/minimal: alsa-ucm-conf
noble/mid: alsa-ucm-conf
resolute/minimal: alsa-ucm-conf
resolute/mid: alsa-ucm-conf
trixie/minimal: alsa-ucm-conf
trixie/mid: alsa-ucm-conf
bookworm/minimal: alsa-ucm-conf
bookworm/mid: alsa-ucm-conf
```

Test plan

  • Install GNOME minimal on noble — `dpkg -l alsa-ucm-conf` shows installed
  • Boot on an SOF-equipped laptop — Sound panel shows real Speaker sink (not Dummy Output)
  • Boot on a non-laptop SBC — no regression, package is inert

@github-actions github-actions Bot added 05 Milestone: Second quarter release size/small PR with less then 50 lines labels May 18, 2026
@coderabbitai

coderabbitai Bot commented May 18, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 17aab1ac-e3ac-46d6-bac6-2a5d1ea79102

📥 Commits

Reviewing files that changed from the base of the PR and between db0d2ce and 5673864.

📒 Files selected for processing (1)
  • tools/modules/desktops/yaml/common.yaml

Disabled knowledge base sources:

  • Jira integration is disabled

You can enable these sources in your CodeRabbit configuration.


Walkthrough

This PR adds the alsa-ucm-conf package to the minimal desktop tier in the common YAML configuration. The change includes documentation comments explaining that this package is required for proper ALSA Use Case Manager behavior when using PipeWire/wireplumber, specifically to avoid the "Dummy Output" audio configuration issue. The addition occurs within the minimal tier's package list and is accompanied by contextual comments clarifying its necessity at this tier level.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

  • armbian/configng#923: Both PRs modify tools/modules/desktops/yaml/common.yaml to add alsa-ucm-conf to tiers.minimal.packages (including the same related comment context).
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately and concisely describes the main change: adding alsa-ucm-conf package to the minimal desktop tier.
Description check ✅ Passed The description is comprehensive and directly related to the changeset, explaining the problem, verification, scope, and test plan.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch desktops-add-alsa-ucm-conf

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Without alsa-ucm-conf installed, PipeWire / wireplumber see complex
sound cards (Intel SOF on Lunar/Meteor/Panther Lake laptops, Qualcomm
Snapdragon X, AMD ACP DSP, ...) but have no per-machine recipe for
which PCM device is the speaker output, which controls to unmute, or
how to route on jack-insert. Result: kernel-level audio is fully
alive (aplay -l shows Speaker pcm; `speaker-test -D plughw:0,2`
plays), but GNOME / KDE Sound shows only "Dummy Output" and the
speakers stay silent.

Verified on a ThinkPad X9-15 Gen 1 (LNL, CS42L43 jack + CS35L56 SPI
amps): same kernel + same SOF firmware + same Cirrus blobs + same
topology as a working Ubuntu OEM 6.17 boot of the same machine - the
only difference between "silent" and "working" was this package.

Mirrored in build's uefi_common.inc (armbian/build#9858) to cover
image builds; here in common.yaml minimal tier so the runtime
`armbian-config module_desktops install` path picks it up on any
desktop / release / arch / DE combo. Inert on simpler audio chains
(HDMI-only SBCs, USB DAC).
@igorpecovnik igorpecovnik force-pushed the desktops-add-alsa-ucm-conf branch from db0d2ce to 5673864 Compare May 18, 2026 15:21
@igorpecovnik igorpecovnik merged commit 0f9363a into main May 18, 2026
1 check was pending
@igorpecovnik igorpecovnik deleted the desktops-add-alsa-ucm-conf branch May 18, 2026 15:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

05 Milestone: Second quarter release size/small PR with less then 50 lines

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant