build(ci): parameterize release version in image workflows

Introduce a `releaseversion` input to the image building workflow to allow
specifying the OS release (e.g., bookworm, trixie) dynamically. Update
the main build workflow to pass `bookworm` for specific hardware targets
and update README documentation to reflect the pinned OS version for
ReSpeaker 2-Mic HAT v1.

Author: florian-asche

.github/workflows/build-all.yml

@@ -39,6 +39,7 @@ jobs:
       compression: xz
       compression-level: 6
       custom-hostname: picompose
+      releaseversion: bookworm
 
   build-2michat-lva:
     uses: ./.github/workflows/build-image-template.yml
@@ -48,6 +49,7 @@ jobs:
       compression: xz
       compression-level: 6
       custom-hostname: picompose
+      releaseversion: bookworm
 
   # RESPEAKER-LITE
   build-respeaker_lite:

.github/workflows/build-image-template.yml

@@ -31,6 +31,11 @@ on:
         type: boolean
         default: false
         description: "Enable rpi-imager.json snippet generation"
+      releaseversion:
+        required: true
+        type: string
+        default: "trixie"
+        description: "Final image name"
 
 jobs:
   build_images:
@@ -84,7 +89,7 @@ jobs:
           stage-list: ${{ inputs.stage-list }}
 
           # Build configuration
-          release: trixie
+          release: ${{ inputs.releaseversion }}
           compression: ${{ inputs.compression }}
           compression-level: ${{ inputs.compression-level }}
 

README.md

@@ -46,8 +46,8 @@ Here is a Overview for the specific images of each hardware:
 | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | **Base Image**                                     | If you use other hardware...                                                      | • Docker & Docker Compose (piCompose)<br>• Automatic Docker Compose deployment<br>• Pipewire Audio Server<br>• SSH enabled (pi User)                                                                                                                                                                                                                                                              |
 | **[Satellite1](docs/hardware_sattelite1.md)**       | <img src="docs/sattelite1-hat.jpg" alt="ReSpeaker Lite Board" style="width: 200px; height: auto;">         | • * Everything from Base Image<br>• Satellite1 Hat Driver<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;"> | • * Everything from Base Image<br>• Seeed Voicecard Driver<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;">         | • * Everything from Base Image<br>• Audio keep-alive service<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. Use this board with at least Raspberry PI 3.</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;"> | • * Everything from Base Image<br>• Seeed Voicecard Driver<br>• Linux-Voice-Assistant (OpenHomeFoundation)<br>• Snapcast MultiRoom Audio Client<br>• Pre-configured for Home Assistant<br><br><span style="color: yellow;">Pinned on bookworm os-release!</span> See [#41](https://github.com/HinTak/seeed-voicecard/issues/41)                                                                                                                                                                                           |
+| **[ReSpeaker Lite](docs/hardware_respeaker_lite.md)**  | <img src="docs/respeaker_lite.jpg" alt="ReSpeaker Lite Board" style="width: 200px; height: auto;">         | • * Everything from Base Image<br>• Audio keep-alive service<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.
 
 ### Installation