Add LedSC integration

CODEOWNERS

@@ -768,6 +768,7 @@ build.json @home-assistant/supervisor
 /tests/components/leaone/ @bdraco
 /homeassistant/components/led_ble/ @bdraco
 /tests/components/led_ble/ @bdraco
+/homeassistant/components/ledsc/ @PatrikKr010
 /homeassistant/components/lg_netcast/ @Drafteed @splinter98
 /tests/components/lg_netcast/ @Drafteed @splinter98
 /homeassistant/components/lidarr/ @tkdrob

homeassistant/components/ledsc/__init__.py

@@ -0,0 +1,43 @@
+"""Platform for LedSC integration."""
+
+from __future__ import annotations
+
+import logging
+
+import voluptuous as vol
+
+from homeassistant.components.light import PLATFORM_SCHEMA
+from homeassistant.config_entries import ConfigEntry
+from homeassistant.const import CONF_HOST, CONF_PORT
+from homeassistant.core import HomeAssistant
+import homeassistant.helpers.config_validation as cv
+
+from .consts import PLATFORMS
+
+_LOGGER = logging.getLogger(__name__)
+
+# Validation of the user's configuration
+PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend(
+    {
+        vol.Required(CONF_HOST): cv.string,
+        vol.Required(CONF_PORT): cv.string,
+    }
+)
+
+
+async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
+    """Set up LedSC from a config entry."""
+    await hass.config_entries.async_forward_entry_setups(entry, PLATFORMS)
+    entry.async_on_unload(entry.add_update_listener(options_update_listener))
+    return True
+
+
+async def async_unload_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
+    """Unload a config entry."""
+    return await hass.config_entries.async_unload_platforms(entry, PLATFORMS)
+
+
+async def options_update_listener(hass: HomeAssistant, entry: ConfigEntry) -> None:
+    """Handle options update."""
+    _LOGGER.debug("Configuration options updated, reloading LedSC integration")
+    await hass.config_entries.async_reload(entry.entry_id)

homeassistant/components/ledsc/config_flow.py

@@ -0,0 +1,67 @@
+"""Config flow for LedSC integration."""
+
+from __future__ import annotations
+
+import logging
+from typing import Any
+import voluptuous as vol
+from websc_client import WebSClientAsync as WebSClient
+
+from homeassistant import config_entries
+from homeassistant.const import CONF_HOST, CONF_PORT
+from homeassistant.core import HomeAssistant
+from homeassistant.config_entries import ConfigFlowResult
+import homeassistant.helpers.config_validation as cv
+
+from .consts import DEFAULT_HOST, DEFAULT_PORT, DOMAIN
+
+_LOGGER = logging.getLogger(__name__)
+
+DATA_SCHEMA = vol.Schema(
+    {
+        vol.Required(CONF_HOST, default=DEFAULT_HOST): str,
+        vol.Required(CONF_PORT, default=DEFAULT_PORT): cv.port,
+    }
+)
+
+
+async def validate_input(hass: HomeAssistant, data: dict) -> dict[str, Any]:
+    """Validate the user input allows us to connect."""
+    host = data[CONF_HOST]
+    port = data[CONF_PORT]
+
+    client = WebSClient(host, port)
+    await client.connect()
+    await client.disconnect()
+
+    return {"title": f"LedSC server {host}:{port}"}
+
+
+class ConfigFlow(config_entries.ConfigFlow, domain=DOMAIN):
+    """Handle a config flow for LedSC."""
+
+    VERSION = 1
+
+    async def async_step_user(
+            self, user_input: dict[str, Any] | None = None
+    ) -> ConfigFlowResult:
+        """Handle the initial step."""
+        errors: dict[str, str] = {}
+        if user_input:
+            self._async_abort_entries_match(
+                {
+                    CONF_HOST: user_input[CONF_HOST],
+                    CONF_PORT: user_input[CONF_PORT],
+                }
+            )
+
+            try:
+                info = await validate_input(self.hass, user_input)
+            except ConnectionError:
+                errors["base"] = "cannot connect"
+            else:
+                return self.async_create_entry(title=info["title"], data=user_input)
+
+        return self.async_show_form(
+            step_id="user", data_schema=DATA_SCHEMA, errors=errors
+        )

homeassistant/components/ledsc/consts.py

@@ -0,0 +1,8 @@
+"""Constant variables."""
+
+from homeassistant.const import Platform
+
+DOMAIN = "ledsc"
+PLATFORMS: list[str] = [Platform.LIGHT]
+DEFAULT_HOST = "demo.ledsc.eu"
+DEFAULT_PORT = 8443

homeassistant/components/ledsc/light.py

@@ -0,0 +1,166 @@
+"""LedSC light."""
+
+import logging
+from typing import Any
+
+from homeassistant.config_entries import ConfigEntry
+from homeassistant.helpers.entity_platform import AddEntitiesCallback
+from homeassistant.components.light import ColorMode, LightEntity
+from homeassistant.core import HomeAssistant
+
+from websc_client import WebSClientAsync as WebSClient
+from websc_client import WebSCAsync
+
+_LOGGER = logging.getLogger(__name__)
+
+
+def setup_platform(
+    hass: HomeAssistant, config, add_entities: AddEntitiesCallback, discovery_info=None
+):
+    """Redirects to '__setup'."""
+    hass.async_create_task(__setup(hass, dict(config), add_entities))
+
+
+async def async_setup_entry(
+    hass: HomeAssistant, config: ConfigEntry, add_entities: AddEntitiesCallback
+):
+    """Redirects to '__setup'."""
+    await __setup(hass, dict(config.data), add_entities)
+
+
+async def __setup(hass: HomeAssistant, config: dict, add_entities: AddEntitiesCallback):
+    """
+    Connect to WebSC.
+
+    load the configured devices and add them to hass.
+    """
+    host = config["host"]
+    port = config["port"]
+
+    client = WebSClient(host=host, port=port)
+    await client.connect()
+    hass.async_create_background_task(client.observer(), name="ledsc-observer")
+
+    devices: list[LedSC] = list()
+    for websc in client.devices.values():
+        ledsc = LedSC(
+            client_id=f"{host}:{port}",
+            websc=websc,
+            hass=hass,
+        )
+        websc.set_callback(__generate_callback(ledsc))
+        devices.append(ledsc)
+    add_entities(devices, True)
+
+
+class LedSC(LightEntity):
+    """Representation of an Awesome Light."""
+
+    def __init__(
+        self,
+        client_id: str,
+        websc: WebSCAsync,
+        hass: HomeAssistant,
+    ) -> None:
+        """Initialize an AwesomeLight."""
+        self._hass: HomeAssistant = hass
+        self._websc: WebSCAsync = websc
+        self._attr_unique_id = f"{client_id}-{websc.name}"
+        _LOGGER.debug(f"LedSC '%s' initialized!", self.name)
+
+    @property
+    def supported_color_modes(self) -> set[ColorMode] | set[str] | None:
+        """List of supported color modes."""
+        return {ColorMode.RGBW}
+
+    @property
+    def color_mode(self) -> ColorMode | str | None:
+        """Return the current color mode (static)."""
+        return ColorMode.RGBW
+
+    @property
+    def available(self) -> bool:
+        """Check if light is available."""
+        return not self._websc.is_lost
+
+    @property
+    def name(self) -> str:
+        """Return the display name of this light."""
+        return self._websc.name
+
+    @property
+    def brightness(self) -> int | None:
+        """Return the brightness of the light."""
+        return max(self._websc.rgbw)
+
+    @brightness.setter
+    def brightness(self, value: int) -> None:
+        """Set brightness of the light."""
+        actual = self.brightness
+        if actual is None or actual == 0:
+            self.hass.async_create_task(
+                self._websc.set_rgbw(red=value, green=value, blue=value, white=value)
+            )
+        else:
+            diff = value - actual
+            ratio = diff / actual
+            self.hass.async_create_task(
+                self._websc.set_rgbw(
+                    red=round(self._websc.red * (1 + ratio)),
+                    green=round(self._websc.green * (1 + ratio)),
+                    blue=round(self._websc.blue * (1 + ratio)),
+                    white=round(self._websc.white * (1 + ratio)),
+                )
+            )
+
+    @property
+    def rgbw_color(self) -> tuple[int, int, int, int] | None:
+        """Get color."""
+        return self._websc.rgbw
+
+    @rgbw_color.setter
+    def rgbw_color(self, value: tuple[int, int, int, int]) -> None:
+        """Set color to WebSC."""
+        self.hass.async_create_task(
+            self._websc.set_rgbw(
+                red=value[0],
+                green=value[1],
+                blue=value[2],
+                white=value[3],
+            )
+        )
+
+    @property
+    def is_on(self) -> bool | None:
+        """Return true if light is on."""
+        return bool(
+            self._websc.red
+            or self._websc.green
+            or self._websc.blue
+            or self._websc.white
+        )
+
+    async def async_turn_on(self, **kwargs: Any) -> None:
+        """Instruct the light to turn on."""
+        if "brightness" in kwargs:
+            self.brightness = kwargs["brightness"]
+        elif "rgbw_color" in kwargs:
+            self.rgbw_color = kwargs["rgbw_color"]
+        elif not self.is_on:
+            await self.switch()
+
+    async def async_turn_off(self, **kwargs: Any) -> None:
+        """Instruct the light to turn off."""
+        if self.is_on:
+            await self.switch()
+
+    async def switch(self) -> None:
+        """Send switch event to WebSC."""
+        await self._websc.do_px_trigger()
+
+
+def __generate_callback(ledsc: LedSC):
+    async def on_device_change(data: dict[str, int]):
+        await ledsc.async_update_ha_state(force_refresh=True)
+
+    return on_device_change

homeassistant/components/ledsc/manifest.json

@@ -0,0 +1,10 @@
+{
+  "domain": "ledsc",
+  "name": "LedSC",
+  "codeowners": ["@PatrikKr010"],
+  "config_flow": true,
+  "documentation": "https://www.home-assistant.io/integrations/ledsc/",
+  "integration_type": "hub",
+  "iot_class": "local_polling",
+  "requirements": ["websc-client==1.0.1"]
+}

homeassistant/generated/config_flows.py

@@ -294,6 +294,7 @@
         "ld2410_ble",
         "leaone",
         "led_ble",
+        "ledsc",
         "lg_netcast",
         "lg_soundbar",
         "lidarr",

homeassistant/generated/integrations.json

@@ -3193,6 +3193,12 @@
       "config_flow": true,
       "iot_class": "local_polling"
     },
+    "ledsc": {
+      "name": "LedSC",
+      "integration_type": "hub",
+      "config_flow": true,
+      "iot_class": "local_polling"
+    },
     "legrand": {
       "name": "Legrand",
       "integration_type": "virtual",

requirements_all.txt

@@ -2875,6 +2875,9 @@ webmin-xmlrpc==0.0.2
 # homeassistant.components.assist_pipeline
 webrtc-noise-gain==1.2.3
 
+# homeassistant.components.ledsc
+websc-client==1.0.1
+
 # homeassistant.components.whirlpool
 whirlpool-sixth-sense==0.18.8