Final version!

Author: mkuthan

README.md

@@ -2,210 +2,63 @@
 
 This is very initial version of the Solis Cloud Control API integration for Home Assistant.
 It allows you to read and control various settings of your Solis inverter.
-Doesn't support sensors, switches, or other entities yet - only basic read and control actions crafted for automations.
 
 See [issue tracker](https://github.com/mkuthan/solis-cloud-control/issues) for further plans.
 
-## Local run
+## Installation
 
-Configure Solis Cloud Control API credentials in `secrets.yaml`:
+The integration is not currently available in [HACS](https://www.hacs.xyz/). However, you can install it manually by following these steps:
 
-```yaml
-solis_api_key: "YOUR_API_KEY_HERE"
-solis_token: "YOUR_TOKEN_HERE"
-solis_inverter_sn: "YOUR_INVERTER_SN_HERE"
-```
-
-Install dependencies (once):
+Clone the repository into your Home Assistant filesystem:
 
 ```bash
-uv sync
+git clone https://github.com/mkuthan/solis-cloud-control.git
 ```
 
-Run the integration locally:
+Create a symlink to the `custom_components` directory:
 
 ```bash
-./scripts/run
-```
-
-## Read inverter settings
-
-Storage Mode
-
-```yaml
-action: solis_cloud_control.read
-data:
-  cid: 636
+ln -s solis-cloud-control/custom_components custom_components/solis_cloud_control
 ```
 
-Charge Time Slot 1
-
-```yaml
-action: solis_cloud_control.read
-data:
-  cid: 5946
-```
+Restart Home Assistant and search for "Solis Cloud Control" in the integrations page.
 
-Charge Time Slot 1 Current
+> [!TIP]
+> For updates on HACS availability, see [issue #7](https://github.com/mkuthan/solis-cloud-control/issues/7).
 
-```yaml
-action: solis_cloud_control.read
-data:
-  cid: 5948
-```
+## Configuration
 
-Charge Time Slot 1 Battery SOC
+Configure Solis Cloud Control integration with:
 
-```yaml
-action: solis_cloud_control.read
-data:
-  cid: 5928
-```
+* Solis API key
+* Solis Token
+* Solis Inverter Serial Number
 
-Discharge Time Slot 1
+## Features
 
-```yaml
-action: solis_cloud_control.read
-data:
-  cid: 5964
-```
+![Inverter Controls](inverter-controls.png)
 
-Discharge Time Slot 1 Current
+### Functional
 
-```yaml
-action: solis_cloud_control.read
-data:
-  cid: 5967
-```
+* ⚡ Storage Modes: "Self-Use", "Feed-In Priority"
+* 🛠️ "Battery Reserve" and "Allow Grid Charging" options as Storage Mode attributes
+* ⏱️ Charge/Discharge Slots
+* 🔋 Battery Reserve SOC, Over Discharge SOC and Force Charge SOC
 
-Discharge Time Slot 1 Battery SOC
-
-```yaml
-action: solis_cloud_control.read
-data:
-  cid: 5965
-```
-
-## High-level inverter control
-
-Set Self-Use Mode - Battery Reserve On, Grid Charging Off:
-
-```yaml
-action: solis_cloud_control.set_storage_mode
-data:
-  storage_mode: Self Use
-  battery_reserve: "ON"
-  allow_grid_charging: "OFF"
-```
-
-Set charge time slot:
-
-```yaml
-action: solis_cloud_control.set_charge_time_slot
-data:
-  time_slot: "11:00-13:00"
-  current: "90"
-  battery_soc: "80"
-```
-
-Set discharge time slot:
-
-```yaml
-action: solis_cloud_control.set_discharge_time_slot
-data:
-  time_slot: "11:00-13:00"
-  current: "90"
-  battery_soc: "80"
-```
-
-Disable charge time slot:
-
-```yaml
-action: solis_cloud_control.disable_charge_time_slot
-```
+* 📦 Batch reading of all inverter settings in a single request to fit within the API limits
+* 🔄 Retry logic for API requests to mitigate API stability issues
+* 🏡 Best Home Assistant practices for integration development 😜
 
-Disable discharge time slot:
+## Local Development
 
-```yaml
-action: solis_cloud_control.disable_discharge_time_slot
-```
-
-## Low-level inverter control
-
-### Control storage mode
-
-Self-Use Mode - Battery Reserve On, Grid Charging Off:
-
-```yaml
-action: solis_cloud_control.control
-data:
-  cid: 636
-  value: "17"
-```
-
-Feed-In Priority Mode - Battery Reserve On, Grid Charging Off:
-
-```yaml
-action: solis_cloud_control.control
-data:
-  cid: 636
-  value: "80"
-```
-
-### Control charge time slot
-
-Set Charge Time Slot 1:
-
-```yaml
-action: solis_cloud_control.control
-data:
-  cid: 5946
-  value: "11:00-13:00"
-```
-
-Set Charge Time Slot 1 Current:
-
-```yaml
-action: solis_cloud_control.control
-data:
-  cid: 5948
-  value: "90"
-```
-
-Set Charge Time Slot 1 Battery SOC:
-
-```yaml
-action: solis_cloud_control.control
-data:
-  cid: 5928
-  value: "80"
-```
-
-### Control discharge time slot
-
-Set Discharge Time Slot 1:
-
-```yaml
-action: solis_cloud_control.control
-data:
-  cid: 5964
-  value: "11:00-13:00"
-```
-
-Set Discharge Time Slot 1 Current:
+Install dependencies (once):
 
-```yaml
-action: solis_cloud_control.control
-data:
-  cid: 5967
-  value: "90"
+```bash
+uv sync
 ```
 
-Set Discharge Time Slot 1 Battery SOC:
+Run the integration locally:
 
-```yaml
-action: solis_cloud_control.control
-data:
-  cid: 5965
-  value: "80"
+```bash
+./scripts/run
 ```

custom_components/solis_cloud_control/__init__.py

@@ -9,7 +9,7 @@
 from .api import SolisCloudControlApiClient
 from .const import CONF_INVERTER_SN
 
-PLATFORMS: list[Platform] = [Platform.SELECT]
+PLATFORMS: list[Platform] = [Platform.SELECT, Platform.TEXT, Platform.NUMBER]
 
 
 async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:

custom_components/solis_cloud_control/const.py

@@ -11,6 +11,9 @@
 API_RETRY_DELAY_SECONDS = 5
 API_CONCURRENT_REQUESTS = 2
 
+CID_BATTERY_RESERVE_SOC = 157
+CID_BATTERY_OVER_DISCHARGE_SOC = 158
+CID_BATTERY_FORCE_CHARGE_SOC = 160
 CID_STORAGE_MODE = 636
 CID_CHARGE_SLOT1_TIME = 5946
 CID_CHARGE_SLOT1_CURRENT = 5948

custom_components/solis_cloud_control/coordinator.py

@@ -7,6 +7,9 @@
 
 from custom_components.solis_cloud_control.api import SolisCloudControlApiClient, SolisCloudControlApiError
 from custom_components.solis_cloud_control.const import (
+    CID_BATTERY_FORCE_CHARGE_SOC,
+    CID_BATTERY_OVER_DISCHARGE_SOC,
+    CID_BATTERY_RESERVE_SOC,
     CID_CHARGE_SLOT1_CURRENT,
     CID_CHARGE_SLOT1_SOC,
     CID_CHARGE_SLOT1_TIME,
@@ -24,13 +27,16 @@
 _UPDATE_INTERVAL = timedelta(minutes=5)
 
 _ALL_CIDS = [
-    CID_STORAGE_MODE,
+    CID_BATTERY_RESERVE_SOC,
+    CID_BATTERY_FORCE_CHARGE_SOC,
+    CID_BATTERY_OVER_DISCHARGE_SOC,
     CID_CHARGE_SLOT1_CURRENT,
     CID_CHARGE_SLOT1_SOC,
     CID_CHARGE_SLOT1_TIME,
     CID_DISCHARGE_SLOT1_CURRENT,
     CID_DISCHARGE_SLOT1_SOC,
     CID_DISCHARGE_SLOT1_TIME,
+    CID_STORAGE_MODE,
 ]
 
 

custom_components/solis_cloud_control/entity.py

@@ -6,9 +6,9 @@
 
 
 class SolisCloudControlEntity(CoordinatorEntity[SolisCloudControlCoordinator]):
-    def __init__(self, coordinator: SolisCloudControlCoordinator) -> None:
+    def __init__(self, coordinator: SolisCloudControlCoordinator, cid: int) -> None:
         super().__init__(coordinator)
-        self._attr_unique_id = coordinator.config_entry.entry_id
+        self._attr_unique_id = f"{coordinator.config_entry.entry_id}_{cid}"
         self._attr_device_info = DeviceInfo(
             identifiers={
                 (
@@ -17,3 +17,4 @@ def __init__(self, coordinator: SolisCloudControlCoordinator) -> None:
                 ),
             },
         )
+        self.cid = cid