DRV-33: Add Update entity support

.copier-answers.yml

@@ -0,0 +1,11 @@
+# Changes here will be overwritten by Copier
+_commit: v0.5.0
+_src_path: git@github.com:finitelabs/control4-driver-template.git
+project_name: control4-esphome
+project_description: Integrate ESPHome-based devices into Control4
+github_org: finitelabs
+distributions: drivercentral oss
+readme_driver_slug: esphome
+readme_build: oss
+primary_color: "#17BCF2"
+vendor_modules: json deferred drivers-common-public xml bitn bthome noiseprotocol protobuf

.github/workflows/build.yml

@@ -0,0 +1,101 @@
+name: Build
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: '22'
+
+      - name: Setup Lua
+        uses: leafo/gh-actions-lua@v12
+        with:
+          luaVersion: 'luajit-2.1'
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: '3.x'
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y \
+            libxml2-dev \
+            libxslt-dev \
+            libssl-dev \
+            swig \
+            pandoc \
+            xmlstarlet \
+            xvfb \
+            libnss3 \
+            libatk1.0-0 \
+            libatk-bridge2.0-0 \
+            libcups2 \
+            libdrm2 \
+            libxkbcommon0 \
+            libxcomposite1 \
+            libxdamage1 \
+            libxrandr2 \
+            libgbm1 \
+            libpango-1.0-0 \
+            libcairo2 \
+            libasound2t64
+
+      - name: Initialize project
+        run: make init
+
+      - name: Build
+        run: xvfb-run make build
+        env:
+          ELECTRON_DISABLE_SANDBOX: '1'
+
+      - name: Verify PDFs were generated
+        run: |
+          for build in drivercentral oss; do
+            pdf_count=$(find "dist/$build" -name '*.pdf' 2>/dev/null | wc -l)
+            if [ "$pdf_count" -eq 0 ]; then
+              echo "::error::No PDF files found in dist/$build"
+              ls -la "dist/$build/" || true
+              exit 1
+            fi
+            echo "Found $pdf_count PDF(s) in dist/$build"
+          done
+
+      - name: Check for dirty tree
+        run: |
+          git diff --exit-code || { echo "::error::Uncommitted changes after build"; exit 1; }
+          UNTRACKED=$(git ls-files --others --exclude-standard)
+          if [ -n "$UNTRACKED" ]; then
+            echo "::error::Untracked files after build:"
+            echo "$UNTRACKED"
+            exit 1
+          fi
+
+      - name: Upload drivercentral artifacts
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: drivercentral
+          path: dist/drivercentral/*
+          if-no-files-found: error
+
+      - name: Upload oss artifacts
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: oss
+          path: dist/oss/*
+          if-no-files-found: error

.github/workflows/release.yml

@@ -0,0 +1,57 @@
+name: Release
+
+on:
+  push:
+    tags: ['v*']
+
+permissions:
+  contents: write
+  actions: read
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Wait for build and download oss artifacts
+        run: |
+          echo "Waiting for Build workflow to complete for $GITHUB_SHA..."
+          while true; do
+            run_id=$(gh run list \
+              --repo "$GITHUB_REPOSITORY" \
+              --workflow build.yml \
+              --commit "$GITHUB_SHA" \
+              --json databaseId,status,conclusion \
+              --jq '.[] | select(.status == "completed") | .databaseId' \
+              | head -1)
+            if [ -n "$run_id" ]; then
+              echo "Build run $run_id completed"
+              break
+            fi
+            echo "Build not finished yet, waiting 30s..."
+            sleep 30
+          done
+
+          conclusion=$(gh run view "$run_id" \
+            --repo "$GITHUB_REPOSITORY" \
+            --json conclusion --jq '.conclusion')
+          if [ "$conclusion" != "success" ]; then
+            echo "::error::Build run $run_id finished with: $conclusion"
+            exit 1
+          fi
+
+          gh run download "$run_id" \
+            --repo "$GITHUB_REPOSITORY" \
+            --name oss \
+            --dir dist/oss
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Create release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: |
+            dist/oss/*.c4z
+            dist/oss/*.pdf
+            dist/oss/*.zip

.gitignore

@@ -1,4 +1,6 @@
 /dist
 /build
 /.venv
+/.lua
 /node_modules
+**/http-client.private.env.json

CHANGELOG.md

@@ -1,5 +1,6 @@
 # <span style="color:#17BCF2">Changelog</span>
 
+<!-- prettier-ignore-start -->
 [//]: # "## v[Version] - YYY-MM-DD"
 [//]: # "### Added"
 [//]: # "- Added"
@@ -9,6 +10,128 @@
 [//]: # "- Changed"
 [//]: # "### Removed"
 [//]: # "- Removed"
+<!-- prettier-ignore-end -->
+
+## Unreleased
+
+### Added
+
+- Added Event entity support: stateless triggers (button presses, gestures,
+  doorbell rings) now create Control4 events for programming and track the last
+  event type in a variable
+- Added Date, Time, and Datetime entity support: configurable date/time values
+  on the device are exposed as writable string variables (YYYY-MM-DD, HH:MM:SS,
+  YYYY-MM-DD HH:MM:SS)
+- Added Update entity support: firmware update tracking with current/latest
+  version variables, update available flag, in-progress indicator, and automatic
+  device update option
+
+## v20260328 - 2026-03-28
+
+### Added
+
+- Added Select entity support: STRING variable with current option, writable via
+  programming or variable writes
+- Added "Set Select" programming command with dynamic Select and Option
+  dropdowns
+
+## v20260326 - 2026-03-26
+
+<!-- #ifndef DRIVERCENTRAL -->
+
+### Fixed
+
+- Fixed automatic driver updates not working when the leader instance is removed
+  from the project
+
+<!-- #endif -->
+
+## v20260325 - 2026-03-25
+
+### Fixed
+
+- Fixed cover contact sensors sending duplicate notifications during open/close
+  operations
+- Fixed Yale DoorSense contact sensor sending duplicate "Closed" notifications
+  on every poll cycle by tracking the last known door status and only reporting
+  on actual state changes
+
+## v20260319 - 2026-03-19
+
+### Fixed
+
+- Fixed an issue where entities were no longer being detected reliably on
+  connection
+
+## v20260318 - 2026-03-18
+
+### Fixed
+
+- Fixed Bluetooth Coordinator failing to connect to active BLE devices
+  (SwitchBot, Yale locks) through proxies
+
+## v20260314 - 2026-03-14
+
+### Added
+
+- Added fan support with on/off, speed control (1-6 speed variants), direction,
+  and oscillation
+- Added ESPHome Yale sub-driver for Yale/August BLE smart locks with lock/unlock
+  control, door sense, and battery monitoring
+
+## v20260217 - 2026-02-17
+
+### Added
+
+- Added Bluetooth proxy support with scanner infrastructure, advertisement
+  parsing, and GATT connection management
+- Added ESPHome Bluetooth Coordinator driver for multi-proxy aggregation with
+  RSSI-based routing and connection failover
+- Added room presence tracking with RSSI-based detection, anti-flapping, and
+  contact sensor bindings
+- Added ESPHome BTHome sub-driver for Shelly BLU and BTHome v1/v2 sensors
+- Added ESPHome Govee sub-driver for temperature, humidity, and meat thermometer
+  sensors
+- Added ESPHome SwitchBot sub-driver for Bot, Plug Mini, Meter, Motion, and
+  Contact devices
+- Added device log forwarding to the ESPHome driver
+
+## v20251031 - 2025-10-31
+
+### Fixed
+
+- Fixed compatibility with ESPHome 2025.10.0 for devices configured without
+  passwords
+- Improved password authentication failure detection and error reporting
+
+## v20251022 - 2025-10-22
+
+### Fixed
+
+- Fixed an issue with parsing unknown fields in protobuf messages
+
+## v20251019 - 2025-10-19
+
+### Added
+
+- Added support for OpenSSL with "Encryption Key" authentication mode across all
+  applicable algorithms
+
+### Fixed
+
+- Fixed a bug with the authentication flow in the latest 2025.10.0 firmware
+
+## v20250811 - 2025-08-11
+
+### Fixed
+
+- Fixed switch entities not responding to bound relay proxies
+
+## v20250715 - 2025-07-14
+
+### Fixed
+
+- Fixed bug causing entities to not be discovered on connect
 
 ## v20250714 - 2025-07-14