Rename integration from luxpower to luxcloud

- Renamed custom_components/luxpower/ → custom_components/luxcloud/
- Updated domain, DOMAIN constant, unique IDs, and device identifiers throughout
- API URLs remain pointed at real luxpowertek.com endpoints
- hacs.json name updated to LuxCloud
- README updated (integration name LuxCloud, app/brand name LuxPower preserved)

https://claude.ai/code/session_01RaoB8Zt3kjJRVZMoV6q56u

Author: claude

README.md

@@ -1,10 +1,10 @@
-# LuxPower — Home Assistant Integration
+# LuxCloud — Home Assistant Integration
 
 [![HACS Badge](https://img.shields.io/badge/HACS-Custom-41BDF5.svg)](https://hacs.xyz)
 [![Validate](https://github.com/BeardedTech0o/ha-solar-integration/actions/workflows/validate.yml/badge.svg)](https://github.com/BeardedTech0o/ha-solar-integration/actions/workflows/validate.yml)
 [![GitHub Release](https://img.shields.io/github/v/release/BeardedTech0o/ha-solar-integration)](https://github.com/BeardedTech0o/ha-solar-integration/releases)
 
-Monitor and control your **LuxPower** solar inverter and battery from Home Assistant.
+Monitor and control your **LuxCloud** solar inverter and battery from Home Assistant.
 
 ---
 
@@ -36,17 +36,17 @@ All entities appear under a single **device** named after your inverter serial n
 1. Open HACS in Home Assistant.
 2. Click the **⋮** menu → **Custom repositories**.
 3. Add `https://github.com/BeardedTech0o/ha-solar-integration` — category **Integration**.
-4. Search for **LuxPower** and click **Download**.
+4. Search for **LuxCloud** and click **Download**.
 5. Restart Home Assistant.
 
 ### Option B — Manual
 
 1. Download the [latest release](https://github.com/BeardedTech0o/ha-solar-integration/releases/latest) zip.
-2. Extract the `luxpower/` folder into your `config/custom_components/` directory:
+2. Extract the `luxcloud/` folder into your `config/custom_components/` directory:
    ```
    config/
    └── custom_components/
-       └── luxpower/
+       └── luxcloud/
            ├── __init__.py
            ├── manifest.json
            └── ...
@@ -58,7 +58,7 @@ All entities appear under a single **device** named after your inverter serial n
 ## Setup
 
 1. Go to **Settings → Devices & Services**.
-2. Click **+ Add Integration** and search for **LuxPower**.
+2. Click **+ Add Integration** and search for **LuxCloud**.
 3. Fill in the form:
 
    | Field | What to enter |
@@ -80,33 +80,33 @@ All entities appear under a single **device** named after your inverter serial n
 
 | Entity | Description |
 |--------|-------------|
-| `sensor.luxpower_SERIAL_solar_power` | Total solar generation in Watts. Positive = producing. |
-| `sensor.luxpower_SERIAL_battery_power` | Battery power in Watts. **Positive = charging**, negative = discharging. |
-| `sensor.luxpower_SERIAL_grid_power` | Grid power in Watts. **Positive = importing**, negative = exporting. |
-| `sensor.luxpower_SERIAL_load_power` | Home consumption in Watts. |
-| `sensor.luxpower_SERIAL_battery_state_of_charge` | Battery charge level (%). |
+| `sensor.luxcloud_SERIAL_solar_power` | Total solar generation in Watts. Positive = producing. |
+| `sensor.luxcloud_SERIAL_battery_power` | Battery power in Watts. **Positive = charging**, negative = discharging. |
+| `sensor.luxcloud_SERIAL_grid_power` | Grid power in Watts. **Positive = importing**, negative = exporting. |
+| `sensor.luxcloud_SERIAL_load_power` | Home consumption in Watts. |
+| `sensor.luxcloud_SERIAL_battery_state_of_charge` | Battery charge level (%). |
 
 ### Daily energy totals (reset at midnight)
 
 | Entity | Description |
 |--------|-------------|
-| `sensor.luxpower_SERIAL_solar_energy_today` | kWh generated by solar panels today |
-| `sensor.luxpower_SERIAL_export_energy_today` | kWh sent to the grid today |
-| `sensor.luxpower_SERIAL_import_energy_today` | kWh taken from the grid today |
-| `sensor.luxpower_SERIAL_battery_charge_today` | kWh charged into the battery today |
-| `sensor.luxpower_SERIAL_battery_discharge_today` | kWh discharged from the battery today |
+| `sensor.luxcloud_SERIAL_solar_energy_today` | kWh generated by solar panels today |
+| `sensor.luxcloud_SERIAL_export_energy_today` | kWh sent to the grid today |
+| `sensor.luxcloud_SERIAL_import_energy_today` | kWh taken from the grid today |
+| `sensor.luxcloud_SERIAL_battery_charge_today` | kWh charged into the battery today |
+| `sensor.luxcloud_SERIAL_battery_discharge_today` | kWh discharged from the battery today |
 
 All energy sensors are compatible with the **Energy Dashboard** (`state_class: total_increasing`).
 
 ### Controls
 
 | Entity | Description |
 |--------|-------------|
-| `switch.luxpower_SERIAL_ac_charge` | Turn grid-to-battery charging on or off |
-| `number.luxpower_SERIAL_ac_charge_current_limit` | Maximum AC charge current (0–80 A) |
-| `number.luxpower_SERIAL_discharge_cutoff_soc` | Minimum SOC before the battery stops discharging (%) |
-| `number.luxpower_SERIAL_charge_cutoff_soc` | SOC at which charging stops (%) |
-| `select.luxpower_SERIAL_work_mode` | Operating mode: Self-use / Feed-in Priority / Backup / Manual |
+| `switch.luxcloud_SERIAL_ac_charge` | Turn grid-to-battery charging on or off |
+| `number.luxcloud_SERIAL_ac_charge_current_limit` | Maximum AC charge current (0–80 A) |
+| `number.luxcloud_SERIAL_discharge_cutoff_soc` | Minimum SOC before the battery stops discharging (%) |
+| `number.luxcloud_SERIAL_charge_cutoff_soc` | SOC at which charging stops (%) |
+| `select.luxcloud_SERIAL_work_mode` | Operating mode: Self-use / Feed-in Priority / Backup / Manual |
 
 ---
 
@@ -127,7 +127,7 @@ Charge the battery from the grid overnight when tomorrow's solar forecast is low
 
 ```yaml
 automation:
-  - alias: "LuxPower: charge overnight if solar forecast is low"
+  - alias: "LuxCloud: charge overnight if solar forecast is low"
     trigger:
       - platform: time
         at: "22:00:00"
@@ -138,15 +138,15 @@ automation:
     action:
       - service: switch.turn_on
         target:
-          entity_id: switch.luxpower_SERIAL_ac_charge
+          entity_id: switch.luxcloud_SERIAL_ac_charge
       - service: number.set_value
         target:
-          entity_id: number.luxpower_SERIAL_ac_charge_current_limit
+          entity_id: number.luxcloud_SERIAL_ac_charge_current_limit
         data:
           value: 50
       - service: select.select_option
         target:
-          entity_id: select.luxpower_SERIAL_work_mode
+          entity_id: select.luxcloud_SERIAL_work_mode
         data:
           option: "Self Use"
 ```
@@ -159,9 +159,9 @@ automation:
 
 **"Invalid auth"** — Double-check your email and password. Note the password is case-sensitive. If you use social login (Google/Apple) in the app, you may need to set a password via *Forgot Password*.
 
-**Entities show "Unavailable"** — The inverter may be offline (no internet, power cut). Check the app. Entities will recover automatically when it comes back.
+**Entities show "Unavailable"** — The inverter may be offline (no internet, power cut). Check the LuxPower app. Entities will recover automatically when it comes back.
 
-**Data is stale** — The integration polls every 30 seconds. If your inverter has poor connectivity, increase the poll interval in `custom_components/luxpower/const.py` (`DEFAULT_SCAN_INTERVAL`).
+**Data is stale** — The integration polls every 30 seconds. If your inverter has poor connectivity, increase the poll interval in `custom_components/luxcloud/const.py` (`DEFAULT_SCAN_INTERVAL`).
 
 ---
 

custom_components/luxpower/__init__.py custom_components/luxcloud/__init__.pycustom_components/luxpower/__init__.py renamed to custom_components/luxcloud/__init__.py

@@ -1,4 +1,4 @@
-"""LuxPower Home Assistant integration."""
+"""LuxCloud Home Assistant integration."""
 from __future__ import annotations
 
 import logging
@@ -9,9 +9,9 @@
 from homeassistant.core import HomeAssistant
 from homeassistant.helpers.aiohttp_client import async_get_clientsession
 
-from .api import LuxPowerApi
+from .api import LuxCloudApi
 from .const import CONF_REGION, CONF_SERIAL, DOMAIN
-from .coordinator import LuxPowerCoordinator
+from .coordinator import LuxCloudCoordinator
 
 _LOGGER = logging.getLogger(__name__)
 
@@ -20,14 +20,14 @@
 
 async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
     session = async_get_clientsession(hass)
-    api = LuxPowerApi(
+    api = LuxCloudApi(
         session=session,
         username=entry.data[CONF_USERNAME],
         password=entry.data[CONF_PASSWORD],
         serial=entry.data[CONF_SERIAL],
         region=entry.data[CONF_REGION],
     )
-    coordinator = LuxPowerCoordinator(hass, api)
+    coordinator = LuxCloudCoordinator(hass, api)
     await coordinator.async_config_entry_first_refresh()
 
     hass.data.setdefault(DOMAIN, {})[entry.entry_id] = coordinator

custom_components/luxpower/api.py custom_components/luxcloud/api.pycustom_components/luxpower/api.py renamed to custom_components/luxcloud/api.py

@@ -1,4 +1,4 @@
-"""LuxPower cloud API client."""
+"""LuxCloud cloud API client."""
 from __future__ import annotations
 
 import asyncio
@@ -15,16 +15,16 @@
 _TOKEN_REFRESH_MARGIN = 300  # seconds before expiry to refresh
 
 
-class LuxPowerAuthError(Exception):
+class LuxCloudAuthError(Exception):
     """Raised when authentication fails."""
 
 
-class LuxPowerApiError(Exception):
+class LuxCloudApiError(Exception):
     """Raised on API communication errors."""
 
 
-class LuxPowerApi:
-    """Async client for the LuxPower cloud API."""
+class LuxCloudApi:
+    """Async client for the LuxCloud cloud API."""
 
     def __init__(
         self,
@@ -66,7 +66,7 @@ async def _login(self) -> None:
         data = await self._post("/web/api/login", payload, auth=False)
         token = data.get("token")
         if not token:
-            raise LuxPowerAuthError("No token returned from login")
+            raise LuxCloudAuthError("No token returned from login")
         self._token = token
         loop = asyncio.get_event_loop()
         # expiration field is in seconds from epoch; fall back to 1 hour
@@ -102,15 +102,15 @@ async def _request(
             ) as resp:
                 if resp.status == 401:
                     self._token = None
-                    raise LuxPowerAuthError("Authentication token rejected (401)")
+                    raise LuxCloudAuthError("Authentication token rejected (401)")
                 resp.raise_for_status()
                 body = await resp.json()
         except aiohttp.ClientError as exc:
-            raise LuxPowerApiError(f"HTTP error talking to LuxPower: {exc}") from exc
+            raise LuxCloudApiError(f"HTTP error talking to LuxCloud: {exc}") from exc
 
         if not body.get("success", True):
             msg = body.get("msg") or body.get("message") or "Unknown API error"
-            raise LuxPowerApiError(f"API error: {msg}")
+            raise LuxCloudApiError(f"API error: {msg}")
         return body
 
     async def _post(self, path: str, payload: dict, *, auth: bool = True) -> dict:

custom_components/luxpower/config_flow.py custom_components/luxcloud/config_flow.pycustom_components/luxpower/config_flow.py renamed to custom_components/luxcloud/config_flow.py

@@ -1,12 +1,12 @@
-"""Config flow for LuxPower integration."""
+"""Config flow for LuxCloud integration."""
 from __future__ import annotations
 
 import voluptuous as vol
 from homeassistant import config_entries
 from homeassistant.const import CONF_PASSWORD, CONF_USERNAME
 from homeassistant.helpers.aiohttp_client import async_get_clientsession
 
-from .api import LuxPowerApi, LuxPowerApiError, LuxPowerAuthError
+from .api import LuxCloudApi, LuxCloudApiError, LuxCloudAuthError
 from .const import (
     CONF_REGION,
     CONF_SERIAL,
@@ -34,8 +34,8 @@
 )
 
 
-class LuxPowerConfigFlow(config_entries.ConfigFlow, domain=DOMAIN):
-    """Handle the LuxPower configuration flow."""
+class LuxCloudConfigFlow(config_entries.ConfigFlow, domain=DOMAIN):
+    """Handle the LuxCloud configuration flow."""
 
     VERSION = 1
 
@@ -44,7 +44,7 @@ async def async_step_user(self, user_input=None):
 
         if user_input is not None:
             session = async_get_clientsession(self.hass)
-            api = LuxPowerApi(
+            api = LuxCloudApi(
                 session=session,
                 username=user_input[CONF_USERNAME],
                 password=user_input[CONF_PASSWORD],
@@ -53,17 +53,17 @@ async def async_step_user(self, user_input=None):
             )
             try:
                 await api.async_validate_credentials()
-            except LuxPowerAuthError:
+            except LuxCloudAuthError:
                 errors["base"] = "invalid_auth"
-            except LuxPowerApiError:
+            except LuxCloudApiError:
                 errors["base"] = "cannot_connect"
             except Exception:  # noqa: BLE001
                 errors["base"] = "unknown"
             else:
                 await self.async_set_unique_id(user_input[CONF_SERIAL])
                 self._abort_if_unique_id_configured()
                 return self.async_create_entry(
-                    title=f"LuxPower {user_input[CONF_SERIAL]}",
+                    title=f"LuxCloud {user_input[CONF_SERIAL]}",
                     data=user_input,
                 )
 
@@ -87,7 +87,7 @@ async def async_step_reauth_confirm(self, user_input=None):
             existing = self._reauth_entry
             merged = {**existing.data, **user_input}
             session = async_get_clientsession(self.hass)
-            api = LuxPowerApi(
+            api = LuxCloudApi(
                 session=session,
                 username=merged[CONF_USERNAME],
                 password=merged[CONF_PASSWORD],
@@ -96,9 +96,9 @@ async def async_step_reauth_confirm(self, user_input=None):
             )
             try:
                 await api.async_validate_credentials()
-            except LuxPowerAuthError:
+            except LuxCloudAuthError:
                 errors["base"] = "invalid_auth"
-            except LuxPowerApiError:
+            except LuxCloudApiError:
                 errors["base"] = "cannot_connect"
             except Exception:  # noqa: BLE001
                 errors["base"] = "unknown"

custom_components/luxpower/const.py custom_components/luxcloud/const.pycustom_components/luxpower/const.py renamed to custom_components/luxcloud/const.py

@@ -1,4 +1,4 @@
-DOMAIN = "luxpower"
+DOMAIN = "luxcloud"
 DEFAULT_SCAN_INTERVAL = 30
 
 CONF_SERIAL = "serial_number"

custom_components/luxpower/coordinator.py custom_components/luxcloud/coordinator.pycustom_components/luxpower/coordinator.py renamed to custom_components/luxcloud/coordinator.py

@@ -1,4 +1,4 @@
-"""DataUpdateCoordinator for LuxPower."""
+"""DataUpdateCoordinator for LuxCloud."""
 from __future__ import annotations
 
 import logging
@@ -9,16 +9,16 @@
 from homeassistant.exceptions import ConfigEntryAuthFailed
 from homeassistant.helpers.update_coordinator import DataUpdateCoordinator, UpdateFailed
 
-from .api import LuxPowerApi, LuxPowerApiError, LuxPowerAuthError
+from .api import LuxCloudApi, LuxCloudApiError, LuxCloudAuthError
 from .const import DEFAULT_SCAN_INTERVAL, DOMAIN
 
 _LOGGER = logging.getLogger(__name__)
 
 
-class LuxPowerCoordinator(DataUpdateCoordinator[dict[str, Any]]):
-    """Polls LuxPower cloud API and distributes data to all entities."""
+class LuxCloudCoordinator(DataUpdateCoordinator[dict[str, Any]]):
+    """Polls LuxCloud cloud API and distributes data to all entities."""
 
-    def __init__(self, hass: HomeAssistant, api: LuxPowerApi) -> None:
+    def __init__(self, hass: HomeAssistant, api: LuxCloudApi) -> None:
         super().__init__(
             hass,
             _LOGGER,
@@ -30,7 +30,7 @@ def __init__(self, hass: HomeAssistant, api: LuxPowerApi) -> None:
     async def _async_update_data(self) -> dict[str, Any]:
         try:
             return await self.api.async_get_runtime()
-        except LuxPowerAuthError as exc:
+        except LuxCloudAuthError as exc:
             raise ConfigEntryAuthFailed from exc
-        except LuxPowerApiError as exc:
+        except LuxCloudApiError as exc:
             raise UpdateFailed(str(exc)) from exc

custom_components/luxpower/manifest.json custom_components/luxcloud/manifest.jsoncustom_components/luxpower/manifest.json renamed to custom_components/luxcloud/manifest.json

@@ -1,6 +1,6 @@
 {
-  "domain": "luxpower",
-  "name": "LuxPower Inverter",
+  "domain": "luxcloud",
+  "name": "LuxCloud Inverter",
   "config_flow": true,
   "documentation": "https://github.com/beardedtech0o/ha-solar-integration",
   "requirements": ["aiohttp>=3.8.0"],