various tidyups

packages/robotdyn_dimmers.yaml

@@ -1,3 +1,33 @@
+#:########################################################################################:#
+# Package: RobotDyn MQTT Dimmer
+# File:    robotdyn_dimmers.yaml
+# Version: v1.1.0
+# Date:    2026-02-05
+#
+# Purpose:
+#   Provides a brightness-only Home Assistant light entity for the lounge
+#   RobotDyn dimmer through its JSON MQTT interface.
+#
+# Behaviour:
+#   - Reads JSON state updates from the dimmer state topic.
+#   - Publishes power and brightness commands to the dimmer command topic.
+#   - Uses a separate MQTT availability topic for online/offline status.
+#
+# Dependency:
+#   - Home Assistant MQTT integration and the external RobotDyn MQTT publisher.
+#
+# Known Limitations:
+#   - P013-F027 records that command messages are retained and may replay after
+#     reconnecting.
+#   - The configured availability topic contains "availablity"; confirm whether
+#     that spelling matches the publisher before correcting it.
+#
+# Version History:
+#   - v1.1.0 (2026-02-05): Added the current name, default entity ID, explicit
+#     availability payloads, and block-style color modes.
+#   - v1.0.0 (2025-09-10): Initial lounge MQTT dimmer package.
+#:########################################################################################:#
+
 mqtt:
   - light:
       schema: json