Update waveshare-va.yaml

Date the changelog entry for the mic gain fixes and move the pinned release tag
in the example config and README from v1.0.0 to v1.0.1.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [1.0.1] - 2026-09-20
+
+Patch release fixing the mic gain control. Tagged `v1.0.1`; the example config
+now pins this tag.
+
+### Fixed
+- **Mic gain slider snapped back to its old value in Home Assistant.** The
+  `Mic gain (ES7210)` number had a `set_action` but was not `optimistic`, so the
+  new value was never published back. The ES7210 was reprogrammed correctly (the
+  device log showed the new gain), but HA kept displaying the previous value and
+  reset the slider on the next visit. The number now publishes its state after
+  every change.
+- **A saved mic gain was not applied to the ES7210 after a reboot.** A template
+  number restores its value from flash in `setup()` and publishes it, but does
+  not run `set_action`, so HA showed the saved gain while the codec started at
+  the default from `audio_adc`. `on_boot` (priority -100) now pushes the restored
+  value to the ES7210. `set_mic_gain()` is safe to call there because the driver
+  stores the value even before its own setup completes.
+
 ## [1.0.0] - 2026-07-18
 
 First stable release. The full voice assistant is confirmed on hardware, the

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Michał Zaniewicz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -8,13 +8,29 @@ the little AI smart-speaker devkit with a dual-mic array, an ES8311 codec, three
 buttons and a 7-LED RGB ring. Pure ESPHome, no custom C firmware: an always-on
 core you pull as a package, plus one thin config file you actually edit.
 
-> **Status: stable (v1.0.0).** Wake word, STT/TTS, clean playback and the LED
+<div align="center">
+  <video src="https://github.com/user-attachments/assets/0eae0230-de47-4f20-a6ea-47f65af35f86" controls width="400"></video>
+</div>
+
+> **Status: stable (v1.0.1).** Wake word, STT/TTS, clean playback and the LED
 > ring are confirmed on-device. Full docs are in the
 > [Wiki](https://github.com/MichalZaniewicz/esphome-waveshare-esp32-s3-audio-va/wiki);
 > the release history is in [CHANGELOG.md](CHANGELOG.md).
 
+```
+You  ──▶  Waveshare ESP32-S3  ──▶  Home Assistant Assist
+         (wake word + audio)      (STT / LLM / TTS)
+```
+
+> [!TIP]
+> ⭐ **Enjoying this project?** Every star is real motivation to keep it going.
+>
+> [![Star this repo](https://img.shields.io/github/stars/MichalZaniewicz/esphome-waveshare-esp32-s3-audio-va?style=social)](https://github.com/MichalZaniewicz/esphome-waveshare-esp32-s3-audio-va)
+
 ## What it does
 
+![Home Assistant entities, the LED ring animation picker, the media player and the wake-word controls](docs/features.jpg)
+
 - **Voice assistant**: on-device wake word (`alexa`, `okay_nabu`) via
   `micro_wake_word`, the full Home Assistant Assist pipeline (STT / LLM / TTS),
   a wake beep and music ducking while it listens.
@@ -24,8 +40,8 @@ core you pull as a package, plus one thin config file you actually edit.
 - **LED ring**: one state machine drives it. Boot, no-Wi-Fi, no-HA, listening,
   thinking, replying, timer counting, ringing, volume changed - each a distinct
   colour/effect. Brightness and the animation for the listening / thinking /
-  replying phases are pickable from HA, from 15 effects: solid, pulses, breathe,
+  replying phases are pickable from HA: solid plus 14 animations - pulses,
-  wipe, scan, spinner, comet, twinkle, fireworks, fire, rainbows.
+  breathe, wipe, scan, spinner, comet, twinkle, fireworks, fire, rainbows.
 - **Timers**: set by voice, with an on-ring countdown and a "Next timer" sensor
   in HA. (A daily-alarm engine is present but its entities are hidden by default.)
 - **Buttons**: the three onboard keys do volume down, play-pause, volume up.
@@ -55,7 +71,7 @@ core you pull as a package, plus one thin config file you actually edit.
    assign an Assist pipeline.
 5. Say "Alexa" (or "OK Nabu"). The ring should go violet.
 
-The example config pins the `v1.0.0` release tag, so a build is reproducible. To
+The example config pins the `v1.0.1` release tag, so a build is reproducible. To
 move to a newer release, bump `ref:` in the `packages:` block to a later tag (or
 `main` to track the latest), then `esphome clean waveshare-va.yaml` (clears the
 package cache) and `esphome run waveshare-va.yaml`.
@@ -68,7 +84,7 @@ has the full guide:
 - **[Installation](https://github.com/MichalZaniewicz/esphome-waveshare-esp32-s3-audio-va/wiki/Installation)**: first flash, Home Assistant setup, updating.
 - **[Configuration](https://github.com/MichalZaniewicz/esphome-waveshare-esp32-s3-audio-va/wiki/Configuration)**: every substitution and every Home Assistant entity.
 - **[Audio architecture](https://github.com/MichalZaniewicz/esphome-waveshare-esp32-s3-audio-va/wiki/Audio-architecture)**: the shared-I2S two-bus design, in depth.
-- **[LED ring](https://github.com/MichalZaniewicz/esphome-waveshare-esp32-s3-audio-va/wiki/LED-ring)**: the state machine and all 15 effects.
+- **[LED ring](https://github.com/MichalZaniewicz/esphome-waveshare-esp32-s3-audio-va/wiki/LED-ring)**: the state machine and every ring effect.
 - **[Hardware](https://github.com/MichalZaniewicz/esphome-waveshare-esp32-s3-audio-va/wiki/Hardware)**: pinout, I2C map, and sourced gotchas.
 - **[Troubleshooting](https://github.com/MichalZaniewicz/esphome-waveshare-esp32-s3-audio-va/wiki/Troubleshooting)** and **[FAQ](https://github.com/MichalZaniewicz/esphome-waveshare-esp32-s3-audio-va/wiki/FAQ)**.
 

base/core.yaml

@@ -104,6 +104,11 @@ esphome:
         - lambda: |-
             setenv("TZ", id(saved_time_zone).c_str(), 1);
             tzset();
+        # Push the mic gain restored from flash into the ES7210. The codec boots
+        # with `mic_gain` from audio_adc, so without this a saved value would show
+        # in HA while the hardware sat at the default.
+        - lambda: |-
+            id(adc_mic).set_mic_gain(id(mic_gain_db).state);
         # Diagnostics: an explicit OFF switch that silences the mic completely.
         # ON = microphone disabled. (This used to be inverted, so the mic was
         # stopped on every boot with the switch in its default OFF position.)
@@ -1286,6 +1291,12 @@ number:
     restore_value: true
     initial_value: 24
     mode: slider
+    # Without `optimistic`, a template number with only a set_action never
+    # publishes the new value back: the slider snapped back to 24 dB in HA even
+    # though the ES7210 had already been reprogrammed. The restored value is
+    # applied to the codec in on_boot (-100), since TemplateNumber::setup() only
+    # publishes it and does not run set_action.
+    optimistic: true
     set_action:
       - lambda: |-
           id(adc_mic).set_mic_gain(x);

skill/waveshare-esp32-s3-audio/SKILL.md

@@ -170,6 +170,15 @@ word. The ESP-mastered two-bus layout needs no patched component.
   leaves `media_player.is_announcing` stuck true, and `on_wake_word_detected`
   then only ever stops that phantom announcement instead of starting Assist
   (wake word detected, nothing happens).
+- **HTTPS-only Home Assistant stalls the pipeline.** If HA serves port 8123 over
+  HTTPS with a certificate that does not cover the LAN address the device reaches
+  it by, every announcement/TTS fetch fails certificate verification and the
+  device holds in `STREAMING_MICROPHONE` with no `Starting STT by VAD` line. In
+  the log this is **identical** to a too-tight `vad` threshold; the tell is
+  `esp-x509-crt-bundle: Failed to verify certificate` /
+  `mbedtls_ssl_handshake returned -0x3000` / `Connection failed, sock < 0`. The
+  fix is HA-side, not firmware: set the HA Internal URL to `http://<ip>:8123`, or
+  terminate TLS at a reverse proxy and keep HA's own `http:` server plain.
 - **Battery monitoring is effectively unavailable**: the divider needs a 0 Ω
   resistor soldered (depopulated by default) and **enabling it kills the camera**.
   Ratio 3.0. Pin is GPIO1 per schematic, not GPIO8, which is stale demo code.

waveshare-va.yaml

@@ -43,8 +43,8 @@ substitutions:
 
 packages:
   core:
-    url: https://github.com/MichalZaniewicz/esphome-waveshare-esp32-s3-audio-va
+    url: https://git.i3omb.com/gronod/esphome-waveshare-esp32-s3-audio-va
-    ref: v1.0.0     # pinned release; bump to a newer tag, or use 'main' to track latest
+    ref: v1.0.1     # pinned release; bump to a newer tag, or use 'main' to track latest
     files:
       - base/core.yaml
     refresh: 1d      # re-check the ref daily (a pinned tag never moves anyway)