fix(2michat-v2): align with #42 — add wpctl unity + user@1000 dep

Match the post-#42 pattern already used by 02-stage-audiodriver-2michat-v1:
call `wpctl set-volume @DEFAULT_AUDIO_SINK@ 1.0` after the amixer tune so
the PipeWire default sink lands at unity, and add `After=/Wants=user@1000.service`
+ `Environment=XDG_RUNTIME_DIR=/run/user/1000` to the unit so wpctl can
reach the user PipeWire socket.

Drop the `PCM 85%` amixer set: PipeWire drives PCM as hardware volume
passthrough, so wpctl unity immediately overwrites whatever we set PCM
to. Verified on satellite-bedroom: `amixer set PCM 50%` then
`wpctl set-volume @DEFAULT_AUDIO_SINK@ 1.0` leaves PCM at 100%.
Keeping the line made the intent misleading ("85% for headroom") while
having zero effect on the final state.

The rest of the amixer tuning stays — unlike WM8960 on v1 or the
DSP-driven lite board, the TLV320AIC3104 on the V2.0 HAT ships with
`HP DAC` at -23.5 dB and `HP` at ~89%. Those stages are downstream of
the PipeWire-managed PCM, so wpctl unity on its own still yields a
stuck-quiet card.

Author: genericJE

02-stage-audiodriver-2michat-v2/02-set-audio-volume/files/configure_audio.service

@@ -1,10 +1,11 @@
 [Unit]
 Description=PiCompose - Configure Audio volume setting (ReSpeaker 2-Mic HAT V2.0)
-After=sound.target alsa-restore.service
-Wants=sound.target alsa-restore.service
+After=user@1000.service sound.target alsa-restore.service
+Wants=user@1000.service sound.target alsa-restore.service
 
 [Service]
 Type=oneshot
+Environment=XDG_RUNTIME_DIR=/run/user/1000
 ExecStart=/usr/bin/configure_audio.sh
 RemainAfterExit=yes
 Restart=on-failure

02-stage-audiodriver-2michat-v2/02-set-audio-volume/files/configure_audio.sh

@@ -1,18 +1,10 @@
 #!/bin/bash
 set -u
 
-# TLV320AIC3104 mixer defaults on the V2.0 HAT are extremely quiet: the
-# HP DAC attenuates by -23.5 dB and the HP analog amp sits at ~89%. Without
-# tuning these three separate gain stages, end users report "silent card"
-# even with HA / LVA output at maximum.
-#
-# Runs on every boot via configure_audio.service — PipeWire / WirePlumber
-# manages ALSA mixer state per session and can reset controls to 0% between
-# reboots, so a first-boot-only guard would let users end up stuck silent.
-#
-# Values below are the safe defaults calibrated against JST-connected
-# speakers (peaks clip at 100% PCM). Tune further in-field with `amixer`
-# and persist via `alsactl store`.
+# TLV320AIC3104 on V2.0 ships quiet: HP DAC at -23.5 dB, HP/Line amps at
+# ~89% and muted on some units. PCM is driven by wpctl as hardware-volume
+# passthrough, so only the downstream stages need tuning. Runs every boot
+# because WirePlumber can reset ALSA state between sessions.
 
 wait_for_card_and_control() {
   local card="$1"
@@ -40,10 +32,8 @@ wait_for_card_and_control() {
   return 1
 }
 
-# Returns 0 on success OR when the control is absent (expected on hardware
-# variants without that stage). Returns 1 only when `amixer set` actually
-# failed for a control that exists — so a broken tuning surfaces as a
-# non-zero exit from the script and triggers the systemd retry.
+# Returns 0 on set-success or missing control; 1 on set-failure.
+# Non-zero exit triggers the systemd retry.
 set_control_if_exists() {
   local card="$1"
   local control="$2"
@@ -62,26 +52,17 @@ set_control_if_exists() {
   return 0
 }
 
-# The kernel alias is the same for V1 and V2: `seeed2micvoicec`. The V2 HAT
-# is distinguished by the presence of `PCM`/`HP DAC`/`Line DAC` controls
-# (from tlv320aic3x) rather than V1's `Headphone`/`Speaker` (wm8960).
+# Same kernel alias as V1 (`seeed2micvoicec`); the PCM control distinguishes
+# V2's tlv320aic3x from V1's wm8960.
 if ! wait_for_card_and_control seeed2micvoicec PCM; then
   echo "No TLV320AIC3104-based card became ready; is the V2.0 overlay loaded?"
   exit 1
 fi
 CARD="seeed2micvoicec"
 
 FAIL=0
-
-# Digital pre-DAC attenuator. 100% clips on typical speakers; 85% keeps
-# headroom while still being clearly audible.
-set_control_if_exists "$CARD" "PCM" 85%            || FAIL=1
-
-# DAC output gains (ship at -23.5 dB by default — main source of quietness).
 set_control_if_exists "$CARD" "HP DAC"   100%      || FAIL=1
 set_control_if_exists "$CARD" "Line DAC" 100%      || FAIL=1
-
-# Analog output amps (ship slightly below max and muted on some units).
 set_control_if_exists "$CARD" "HP"   100% unmute   || FAIL=1
 set_control_if_exists "$CARD" "Line" 100% unmute   || FAIL=1
 
@@ -90,4 +71,8 @@ if [ "$FAIL" -ne 0 ]; then
   exit 1
 fi
 
+# Keep PipeWire sink at unity so HA/LVA volume reaches the ALSA stages
+# above. Matches the 2michat-v1 pattern from #42.
+wpctl set-volume @DEFAULT_AUDIO_SINK@ 1.0
+
 alsactl store

README.md

@@ -52,7 +52,7 @@ Here is a Overview for the specific images of each hardware:
 | **[Sattelite1](docs/hardware_sattelite1.md)**<br>**+Linux-Voice-Assistant**<br>**+Snapcast**   | <img src="docs/sattelite1-hat.jpg" alt="ReSpeaker Lite Board" style="width: 200px; height: auto;">         | • Satellite1 Hat Image<br>• Linux-Voice-Assistant (OpenHomeFoundation)<br>• Snapcast MultiRoom Audio Client<br>• Pre-configured for Home Assistant<br><br><span style="color: red;">Image is currently work in progress!</span>                                                                                                                                                                                                                                                |
 | **[ReSpeaker 2-Mic HAT v1](docs/hardware_2mic_v1.md)**                         | <img src="docs/respeaker_2michats.webp" alt="ReSpeaker 2-Mics Pi HAT" style="width: 200px; height: auto;"> | • Base Image<br>• Seeed Voicecard Driver                                                                                                                                                                                                                                                                                                                                                            |
 | **[ReSpeaker 2-Mic HAT v1](docs/hardware_2mic_v1.md)**<br>**+Linux-Voice-Assistant**<br>**+Snapcast** | <img src="docs/respeaker_2michats.webp" alt="ReSpeaker 2-Mics Pi HAT" style="width: 200px; height: auto;"> | • 2-Mic HAT Image<br>• Linux-Voice-Assistant (OpenHomeFoundation)<br>• 2-Mic HAT GPIO LED Control<br>• Snapcast MultiRoom Audio Client<br>• Pre-configured for Home Assistant                                                                                                                                                                                                                        |
-| **[ReSpeaker 2-Mic HAT v2.0](docs/hardware_2mic_v2.md)**                         | <img src="docs/respeaker_2michats.webp" alt="ReSpeaker 2-Mics Pi HAT" style="width: 200px; height: auto;"> | • Base Image<br>• TLV320AIC3104 device-tree overlay<br>• First-boot mixer tuning for the V2.0 codec                                                                                                                                                                                                                                                                                                 |
+| **[ReSpeaker 2-Mic HAT v2.0](docs/hardware_2mic_v2.md)**                         | <img src="docs/respeaker_2michats.webp" alt="ReSpeaker 2-Mics Pi HAT" style="width: 200px; height: auto;"> | • Base Image<br>• TLV320AIC3104 device-tree overlay<br>• Per-boot codec mixer tuning for the V2.0                                                                                                                                                                                                                                                                                                 |
 | **[ReSpeaker 2-Mic HAT v2.0](docs/hardware_2mic_v2.md)**<br>**+Linux-Voice-Assistant**<br>**+Snapcast** | <img src="docs/respeaker_2michats.webp" alt="ReSpeaker 2-Mics Pi HAT" style="width: 200px; height: auto;"> | • 2-Mic HAT v2.0 Image<br>• Linux-Voice-Assistant (OpenHomeFoundation)<br>• Snapcast MultiRoom Audio Client<br>• Pre-configured for Home Assistant                                                                                                                                                                                                                                                |
 | **[ReSpeaker Lite](docs/hardware_respeaker_lite.md)**                                 | <img src="docs/respeaker_lite.jpg" alt="ReSpeaker Lite Board" style="width: 200px; height: auto;">         | • Base Image<br>• Audio keep-alive service<br>• Workaround for connectivity issues in combination with the Pi Zero 2W.<br><br><span style="color: red;">There is a USB connectivity issue with the Pi Zero 2W. I cannot recommend this board if you want to use it with that. Use Pi3 or higher.</span>                                                                                                                                                                                                |
 | **[ReSpeaker Lite](docs/hardware_respeaker_lite.md)**<br>**+Linux-Voice-Assistant**<br>**+Snapcast**         | <img src="docs/respeaker_lite.jpg" alt="ReSpeaker Lite Board" style="width: 200px; height: auto;">         | • ReSpeaker Lite Image<br>• Linux-Voice-Assistant (OpenHomeFoundation)<br>• Snapcast MultiRoom Audio Client<br>• Pre-configured for Home Assistant<br>• Workaround for connectivity issues in combination with the Pi Zero 2W.<br><br><span style="color: red;">There is a USB connectivity issue with the Pi Zero 2W. If you want to use it with that, you need to use Pi3 or higher.</span>                                          |

docs/hardware_2mic_v2.md

@@ -31,9 +31,9 @@ Unlike v1 — which needs an out-of-tree DKMS kernel module — v2 uses the main
 
 1. The device-tree overlay `respeaker-2mic-v2_0.dtbo` (built from [Seeed-Studio/seeed-linux-dtoverlays](https://github.com/Seeed-Studio/seeed-linux-dtoverlays)), enabled via `dtoverlay=respeaker-2mic-v2_0` in `/boot/firmware/config.txt`.
 2. `dtparam=i2c_arm=on` in `/boot/firmware/config.txt`.
-3. Mixer tuning on first boot — the TLV320 ships with three separate attenuators all well below 100 % (`HP DAC` at -23.5 dB in particular), producing a card that appears to work but is inaudible at typical application volumes.
+3. Per-boot mixer tuning — the TLV320 ships with several attenuators well below 100 % (`HP DAC` at -23.5 dB in particular), producing a card that appears to work but is inaudible at typical application volumes.
 
-The PiCompose `02-stage-audiodriver-2michat-v2` stage performs all three steps automatically. The mixer tuning is applied by `configure_audio.service` on every boot: PipeWire / WirePlumber manage ALSA state per session and can reset the mixer between reboots, so a first-boot-only guard would let users end up stuck at 0%. Customization via `amixer` is still possible at runtime — it just won't survive a reboot.
+The PiCompose `02-stage-audiodriver-2michat-v2` stage performs all three steps automatically. The mixer tuning is applied by `configure_audio.service` on every boot, the same pattern other audiodriver stages follow after #42: amixer on the codec-specific controls, then `wpctl set-volume @DEFAULT_AUDIO_SINK@ 1.0` to keep the PipeWire sink at unity. PipeWire / WirePlumber manage ALSA state per session and can reset the mixer between reboots, so a first-boot-only guard would let users end up stuck at 0%. Customization via `amixer` is still possible at runtime — it just won't survive a reboot.
 
 ## Additional information