fix(2michat-v2): wire CI, guard mixer service, drop dead code

Follow-up to the initial 02-stage-audiodriver-2michat-v2 commit:

- build-all.yml: add build-2michat-v2 and build-2michat-v2-lva jobs and
  include them in generate-rpi-imager-json.needs. Without this the new
  stage exists but no image is ever produced.
- configure_audio.service: add ConditionPathExists=!/var/lib/configure_audio/success
  + ExecStartPost touch marker so mixer tuning runs once on first boot
  and subsequent manual amixer + alsactl store customisations survive
  reboots. Without the guard every boot reset the mixer to the stage's
  canned defaults.
- configure_audio.sh: drop the wpctl block. The service runs as root
  under systemd; wpctl requires the PipeWire user session (uid 1000)
  and the existing `|| true` made it a silent no-op.
- 01-driver/01-packages: drop i2c-tools (no runtime hardware detection
  on v2 — the overlay is fixed) and libasound2-plugins (v2 does not
  install a custom asound.conf that references resample plugins).
- docs/hardware_2mic_v2.md + README.md: add a v2 hardware page and
  two README rows (base + LVA) mirroring the v1 entries.

Author: genericJE

.github/workflows/build-all.yml

@@ -41,6 +41,25 @@ jobs:
       compression-level: 6
       custom-hostname: picompose
 
+  # 2MICHAT-v2
+  build-2michat-v2:
+    uses: ./.github/workflows/build-image-template.yml
+    with:
+      image-name: PiCompose-2MicHat-v2
+      stage-list: stage0 stage1 stage2 ./01-stage-picompose ./02-stage-audiodriver-2michat-v2 ./04-stage-finish
+      compression: xz
+      compression-level: 6
+      custom-hostname: picompose
+
+  build-2michat-v2-lva:
+    uses: ./.github/workflows/build-image-template.yml
+    with:
+      image-name: PiCompose_2MicHat-v2_Linux-Voice-Assistant
+      stage-list: stage0 stage1 stage2 ./01-stage-picompose ./02-stage-audiodriver-2michat-v2 ./03-stage-linux-voice-assistant ./04-stage-finish
+      compression: xz
+      compression-level: 6
+      custom-hostname: picompose
+
   # RESPEAKER-LITE
   build-respeaker_lite:
     uses: ./.github/workflows/build-image-template.yml
@@ -62,5 +81,5 @@ jobs:
 
   # RPI IMAGER JSON
   generate-rpi-imager-json:
-    needs: [build, build-2michat, build-respeaker_lite, build-2michat-lva, build-respeaker_lite-lva]
+    needs: [build, build-2michat, build-2michat-v2, build-respeaker_lite, build-2michat-lva, build-2michat-v2-lva, build-respeaker_lite-lva]
     uses: ./.github/workflows/create-rpi-image-json.yml

02-stage-audiodriver-2michat-v2/01-driver/01-packages

@@ -1,6 +1,4 @@
 git
 build-essential
 device-tree-compiler
-i2c-tools
-libasound2-plugins
 alsa-utils

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

@@ -2,10 +2,13 @@
 Description=PiCompose - Configure Audio volume setting (ReSpeaker 2-Mic HAT V2.0)
 After=sound.target alsa-restore.service
 Wants=sound.target alsa-restore.service
+ConditionPathExists=!/var/lib/configure_audio/success
 
 [Service]
 Type=oneshot
 ExecStart=/usr/bin/configure_audio.sh
+ExecStartPost=/usr/bin/mkdir -p /var/lib/configure_audio
+ExecStartPost=/usr/bin/touch /var/lib/configure_audio/success
 RemainAfterExit=yes
 Restart=on-failure
 RestartSec=30s

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

@@ -72,9 +72,4 @@ set_control_if_exists "$CARD" "Line DAC" 100%
 set_control_if_exists "$CARD" "HP"   100% unmute
 set_control_if_exists "$CARD" "Line" 100% unmute
 
-# Default-route PipeWire sink to max; application-level volume still applies.
-if command -v wpctl >/dev/null 2>&1; then
-  wpctl set-volume @DEFAULT_AUDIO_SINK@ 1.0 || true
-fi
-
 alsactl store

README.md

@@ -52,6 +52,8 @@ 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)**<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

@@ -0,0 +1,41 @@
+# Hardware - ReSpeaker 2-Mics Pi HAT v2.0
+
+<img src="respeaker_2michats.webp" alt="ReSpeaker 2-Mics Pi HAT" style="width: 300px; height: auto;"></img>
+
+The V2.0 is a silent hardware revision of the 2-Mics Pi HAT. Visually identical, electrically different: the WM8960 codec used on v1 (I2C `0x1a`) is replaced with a **TLV320AIC3104** codec (I2C `0x18`). This matters because the v1 driver stage does not produce a working sound card on v2 hardware, and because the mixer defaults differ.
+
+Features (same as v1):
+- Support the Raspberry Pi 3B / 4B / Zero 2 W
+- Two microphones (Mic L and Mic R)
+- Two Grove connectors
+- One User-defined button
+- 3.5 mm audio interface
+- XH2.54-2P audio output interface
+
+## Order
+
+### Base:
+
+- [Raspberry Pi Zero 2 W](https://amzn.to/3M0G4hC)
+- [SD-Card](https://amzn.to/4qfx06l)
+- [US MicroUSB Power Supply](https://amzn.to/4c52mt3)
+- [Cable for Speaker](https://amzn.to/3ZvU0Dz)
+
+### ReSpeaker 2-Mics Pi HAT v2.0
+
+- [Seeed Studio ReSpeaker 2-Mics Pi HAT V2.0](https://wiki.seeedstudio.com/respeaker_2_mics_pi_hat_v2/)
+
+## Technical notes
+
+Unlike v1 — which needs an out-of-tree DKMS kernel module — v2 uses the mainline `snd-soc-tlv320aic3x` driver that already ships with the Raspberry Pi OS kernel. The image only needs:
+
+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.
+
+The PiCompose `02-stage-audiodriver-2michat-v2` stage performs all three steps automatically. The mixer tuning runs once on first boot (guarded by `/var/lib/configure_audio/success`) so that subsequent manual `amixer` adjustments via `alsactl store` are preserved across reboots.
+
+## Additional information
+
+- [Seeed Studio Wiki — ReSpeaker 2-Mics Pi HAT v2.0](https://wiki.seeedstudio.com/respeaker_2_mics_pi_hat_v2/)
+- [seeed-linux-dtoverlays (overlay source)](https://github.com/Seeed-Studio/seeed-linux-dtoverlays)