Add lock, cover, and light platform support to HEMS Echonet Lite integration

This commit adds three new platforms for the HEMS Echonet Lite integration:

- Lock platform (class code 0x026F): Electric lock control with main/sub lock
  support and jam detection via alarm status
- Cover platform (class codes 0x0260, 0x0263): Blind and shutter control with
  dynamic feature support based on available EPCs, position and tilt control
- Light platform (class codes 0x0290, 0x0291, 0x02A3, 0x02A4): Support for
  general and mono-functional lighting with brightness, color temperature (only
  0x0290), and lighting mode effects

Also includes updated constants, icon definitions, and localized strings
(English and Japanese) for all new platforms.

Author: sayurin

README.md

@@ -14,49 +14,97 @@ ECHONET Lite protocol integration for Home Assistant, powered by [pyhems](https:
 - **Event-driven updates** — entity state changes are pushed immediately upon frame receipt
 - **Property polling** every 60 seconds for devices that do not send notifications
 - **Runtime health monitoring** — creates repair issues when no frames are received for 5 minutes
-- **9 entity platforms**: Climate, Fan, Water Heater, Binary Sensor, Button, Number, Select, Sensor, Switch
-- **Experimental mode** to enable unverified device classes
+- **12 entity platforms**: Climate, Fan, Water Heater, Lock, Cover, Light, Binary Sensor, Button, Number, Select, Sensor, Switch
+- **Experimental mode** to enable 50+ additional unverified device classes
 
 ## Supported Devices
 
-### Stable Device Classes
+Device classes fall into two categories:
+
+- **Stable** — enabled by default, no extra configuration needed
+- **Experimental** — must be enabled via the integration options; not verified with real hardware
 
-These device classes are enabled by default:
+### Stable Device Classes
 
-| Class Code | Device | Entity Platform |
-|------------|--------|-----------------|
+| Class Code | Device | HA Platform |
+|------------|--------|-------------|
 | 0x0130 | Home Air Conditioner | Climate + generic entities |
+| 0x0133 | Ventilation Fan | Fan + generic entities |
+| 0x0134 | Air Conditioner Ventilation Fan | Fan + generic entities |
 | 0x0135 | Air Cleaner | Fan + generic entities |
 | 0x0279 | Residential Solar Power Generation | Generic entities |
 | 0x027D | Storage Battery | Generic entities |
-| 0x05FD | Switch (supporting JEM-A/HA terminals) | Generic entities |
+| 0x05FD | Switch (JEM-A/HA terminals) | Generic entities |
 | 0x05FF | Controller | Generic entities |
 
-### Climate (0x0130) Features
+### Experimental Device Classes with Dedicated Platforms
+
+The following experimental classes are exposed as fully-featured HA platform entities:
+
+| Class Code | Device | HA Platform |
+|------------|--------|-------------|
+| 0x026B | Electric Heat-Pump Water Heater | Water Heater + generic entities |
+| 0x026F | Electric Lock | Lock + generic entities |
+| 0x0260 | Electrically Operated Blind | Cover + generic entities |
+| 0x0263 | Electrically Operated Shutter | Cover + generic entities |
+| 0x0290 | General Lighting | Light + generic entities |
+| 0x0291 | Mono-Functional Lighting | Light + generic entities |
+| 0x02A3 | Lighting System | Light + generic entities |
+| 0x02A4 | Extended Lighting System | Light + generic entities |
+
+All other experimental classes are supported via generic entities only.
+
+## Platform Details
+
+### Climate (0x0130)
 
 - **HVAC modes**: Off, Auto, Cool, Heat, Dry, Fan Only
 - **Fan modes**: Auto, Low (Level 1) – High (Level 8), 9 speeds
 - **Swing modes**: Off, Vertical, Horizontal, Both
 - **Temperature**: 0–50°C, 1°C step
 
-### Fan (0x0133, 0x0134, 0x0135) Features
+### Fan (0x0133, 0x0134, 0x0135)
 
 - **Speed**: 8 levels mapped to percentage
 - **Preset modes**: Auto, Manual
 
-### Water Heater (0x026B) Features
+### Water Heater (0x026B)
 
-The electric heat-pump water heater class is exposed as a high-level `WaterHeaterEntity` that aggregates operation status (EPC 0x80), operation mode (EPC 0xB0) and target temperature (EPC 0xB3) into a single entity.
+Aggregates operation status (EPC 0x80), operation mode (EPC 0xB0) and target temperature (EPC 0xB3) into a single entity.
 
 - **Operations**: `auto` (automatic water heating), `manual` (manual water heating), `manual_off` (manual heating stopped / away), `off`
-- **Target temperature**: setpoint via EPC 0xB3 (range derived from the device's MRA definition, 1 °C step)
-- **Current temperature**: measured water temperature (EPC 0xC1) — also exposed as a standalone sensor, mirroring the climate platform's room-temperature convention
+- **Target temperature**: setpoint via EPC 0xB3 (range derived from the device's MRA definition, 1°C step)
+- **Current temperature**: measured water temperature (EPC 0xC1) — also exposed as a standalone sensor
+
+### Lock (0x026F)
+
+- **Locked state**: requires both main lock (EPC 0xE0) and sub-lock (EPC 0xE1, if advertised) to be locked
+- **Jammed state**: indicated when alarm status (EPC 0xE5) reports an abnormality
+- **Lock / Unlock**: writes to main lock (EPC 0xE0) only
 
-> **Note**: 0x026B is currently part of the **experimental** device class set (see below) and must be enabled via the integration options. The dedicated water heater entity is created only after the device is discovered with experimental mode on.
+### Cover (0x0260 Blind, 0x0263 Shutter)
+
+- **Commands**: Open, Close, Stop (always available)
+- **Position control** (EPC 0xE1): available when the device supports set operations, 0–100%
+- **Tilt control** (EPC 0xE2): available when the device supports set operations, 0–100% mapped to 0–180°
+- **State** (EPC 0xEA): Open, Closed, Opening, Closing, Stopped; falls back to position percentage when not advertised
+
+### Light (0x0290, 0x0291, 0x02A3, 0x02A4)
+
+| Feature | 0x0290 General | 0x0291 Mono | 0x02A3 System | 0x02A4 Extended |
+|---------|:-:|:-:|:-:|:-:|
+| On / Off | ✓ | ✓ | ✓ | ✓ |
+| Brightness (EPC 0xB0, 0–100%) | ✓ | ✓ | ✓ | ✓ |
+| Color temperature (EPC 0xB1) | ✓ | — | — | — |
+| Lighting mode effect (EPC 0xB6) | ✓ | — | — | — |
+
+**Color temperature presets** (0x0290 only): Incandescent (2700 K), White (4000 K), Daylight White (5000 K), Daylight Color (6500 K). Arbitrary kelvin values are snapped to the nearest preset.
+
+**Lighting mode effects** (0x0290 only): `auto`, `normal` (main lighting), `night` (night lighting), `color` (color lighting).
 
 ### Generic Entity Platforms
 
-Properties are automatically mapped to entity platforms based on the ECHONET Lite property definition:
+All remaining properties are automatically mapped based on the ECHONET Lite property definition:
 
 | Condition | Writable | Read-only |
 |-----------|----------|-----------|
@@ -65,14 +113,6 @@ Properties are automatically mapped to entity platforms based on the ECHONET Lit
 | 1-value enum | Button | — |
 | Numeric | Number | Sensor |
 
-### Experimental Device Classes
-
-Enable **"Enable experimental device classes"** in the integration options to access 50+ additional device classes, including:
-
-Electric water heaters (0x026B, with the dedicated Water Heater entity described above), electric locks, lighting, refrigerators, washing machines, smart meters, EV chargers, bathroom dryers, and more.
-
-> **Note**: Experimental device classes have not been verified with real hardware. Some entities may behave unexpectedly.
-
 ## Installation
 
 ### HACS (Recommended)
@@ -107,6 +147,8 @@ After setup, configure in **Settings → Devices & Services → HEMS → Configu
 |--------|-------------|---------|
 | Enable experimental device classes | Include unverified device classes | Off |
 
+> Enabling experimental mode is required for Water Heater, Lock, Cover, Light, and all other non-stable device classes.
+
 ### Reconfiguration
 
 The network interface can be changed at any time via **Settings → Devices & Services → HEMS → Reconfigure**.

custom_components/echonet_lite/__init__.py

@@ -79,7 +79,10 @@
     Platform.BINARY_SENSOR,
     Platform.BUTTON,
     Platform.CLIMATE,
+    Platform.COVER,
     Platform.FAN,
+    Platform.LIGHT,
+    Platform.LOCK,
     Platform.NUMBER,
     Platform.SELECT,
     Platform.SENSOR,

custom_components/echonet_lite/const.py

@@ -52,9 +52,16 @@
 CLASS_CODE_VENTILATION_FAN = 0x0133
 CLASS_CODE_AIR_CONDITIONER_VENTILATION_FAN = 0x0134
 CLASS_CODE_AIR_CLEANER = 0x0135
+CLASS_CODE_ELECTRICALLY_OPERATED_BLIND = 0x0260
+CLASS_CODE_ELECTRICALLY_OPERATED_SHUTTER = 0x0263
 CLASS_CODE_ELECTRIC_WATER_HEATER = 0x026B
+CLASS_CODE_ELECTRIC_LOCK = 0x026F
 CLASS_CODE_HOUSEHOLD_SOLAR_POWER_GENERATION = 0x0279
 CLASS_CODE_STORAGE_BATTERY = 0x027D
+CLASS_CODE_GENERAL_LIGHTING = 0x0290
+CLASS_CODE_MONO_FUNCTIONAL_LIGHTING = 0x0291
+CLASS_CODE_LIGHTING_SYSTEM = 0x02A3
+CLASS_CODE_EXTENDED_LIGHTING_SYSTEM = 0x02A4
 CLASS_CODE_SWITCH = 0x05FD  # Switch (supporting JEM-A/HA terminals)
 CLASS_CODE_CONTROLLER = 0x05FF
 
@@ -95,6 +102,22 @@
 EPC_ROOM_TEMPERATURE = 0xBB
 EPC_MEASURED_WATER_TEMPERATURE = 0xC1
 
+# Class-specific EPCs used by the light platform.
+EPC_LIGHT_LEVEL = 0xB0
+EPC_LIGHT_COLOR = 0xB1
+EPC_LIGHTING_MODE = 0xB6
+
+# Class-specific EPCs used by the cover platform.
+EPC_COVER_OPEN_CLOSE = 0xE0
+EPC_COVER_POSITION = 0xE1
+EPC_COVER_ANGLE = 0xE2
+EPC_COVER_OPEN_CLOSED_STATUS = 0xEA
+
+# Class-specific EPCs used by the lock platform.
+EPC_LOCK_SETTING_1 = 0xE0
+EPC_LOCK_SETTING_2 = 0xE1
+EPC_LOCK_ALARM_STATUS = 0xE5
+
 # Stable (non-experimental) device class codes
 # These device classes have been verified with real hardware.
 # Other device classes are considered experimental.
@@ -148,6 +171,55 @@
             EPC_TARGET_TEMPERATURE,
         }
     ),
+    CLASS_CODE_ELECTRIC_LOCK: frozenset(
+        {
+            EPC_LOCK_SETTING_1,
+            EPC_LOCK_SETTING_2,
+            EPC_LOCK_ALARM_STATUS,
+        }
+    ),
+    CLASS_CODE_ELECTRICALLY_OPERATED_BLIND: frozenset(
+        {
+            EPC_COVER_OPEN_CLOSE,
+            EPC_COVER_POSITION,
+            EPC_COVER_ANGLE,
+            EPC_COVER_OPEN_CLOSED_STATUS,
+        }
+    ),
+    CLASS_CODE_ELECTRICALLY_OPERATED_SHUTTER: frozenset(
+        {
+            EPC_COVER_OPEN_CLOSE,
+            EPC_COVER_POSITION,
+            EPC_COVER_ANGLE,
+            EPC_COVER_OPEN_CLOSED_STATUS,
+        }
+    ),
+    CLASS_CODE_MONO_FUNCTIONAL_LIGHTING: frozenset(
+        {
+            EPC_OPERATION_STATUS,
+            EPC_LIGHT_LEVEL,
+        }
+    ),
+    CLASS_CODE_GENERAL_LIGHTING: frozenset(
+        {
+            EPC_OPERATION_STATUS,
+            EPC_LIGHT_LEVEL,
+            EPC_LIGHT_COLOR,
+            EPC_LIGHTING_MODE,
+        }
+    ),
+    CLASS_CODE_LIGHTING_SYSTEM: frozenset(
+        {
+            EPC_OPERATION_STATUS,
+            EPC_LIGHT_LEVEL,
+        }
+    ),
+    CLASS_CODE_EXTENDED_LIGHTING_SYSTEM: frozenset(
+        {
+            EPC_OPERATION_STATUS,
+            EPC_LIGHT_LEVEL,
+        }
+    ),
 }
 
 
@@ -382,8 +454,16 @@ def infer_entity_registry_enabled_default(
     "CLASS_CODE_AIR_CLEANER",
     "CLASS_CODE_AIR_CONDITIONER_VENTILATION_FAN",
     "CLASS_CODE_CONTROLLER",
+    "CLASS_CODE_ELECTRICALLY_OPERATED_BLIND",
+    "CLASS_CODE_ELECTRICALLY_OPERATED_SHUTTER",
+    "CLASS_CODE_ELECTRIC_LOCK",
+    "CLASS_CODE_ELECTRIC_WATER_HEATER",
+    "CLASS_CODE_EXTENDED_LIGHTING_SYSTEM",
+    "CLASS_CODE_GENERAL_LIGHTING",
     "CLASS_CODE_HOME_AIR_CONDITIONER",
     "CLASS_CODE_HOUSEHOLD_SOLAR_POWER_GENERATION",
+    "CLASS_CODE_LIGHTING_SYSTEM",
+    "CLASS_CODE_MONO_FUNCTIONAL_LIGHTING",
     "CLASS_CODE_STORAGE_BATTERY",
     "CLASS_CODE_SWITCH",
     "CLASS_CODE_VENTILATION_FAN",
@@ -396,6 +476,10 @@ def infer_entity_registry_enabled_default(
     "DOMAIN",
     "ENTITY_CATEGORY_BY_EPC",
     "EPC_AIR_FLOW_LEVEL",
+    "EPC_COVER_ANGLE",
+    "EPC_COVER_OPEN_CLOSE",
+    "EPC_COVER_OPEN_CLOSED_STATUS",
+    "EPC_COVER_POSITION",
     "EPC_CUMULATIVE_OPERATING_TIME",
     "EPC_CURRENT_DATE",
     "EPC_CURRENT_LIMIT",
@@ -406,6 +490,12 @@ def infer_entity_registry_enabled_default(
     "EPC_GET_PROPERTY_MAP",
     "EPC_INF_PROPERTY_MAP",
     "EPC_INSTALLATION_LOCATION",
+    "EPC_LIGHTING_MODE",
+    "EPC_LIGHT_COLOR",
+    "EPC_LIGHT_LEVEL",
+    "EPC_LOCK_ALARM_STATUS",
+    "EPC_LOCK_SETTING_1",
+    "EPC_LOCK_SETTING_2",
     "EPC_MANUFACTURER_CODE",
     "EPC_MANUFACTURER_FAULT_CODE",
     "EPC_OPERATION_MODE",