alphaess-aio 0.0.0__py3-none-any.whl

alphaess_aio-0.0.0.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 zeguramente
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

alphaess_aio-0.0.0.dist-info/METADATA

@@ -0,0 +1,70 @@
+Metadata-Version: 2.1
+Name: alphaess-aio
+Version: 0.0.0
+Summary: Sends get and post requests to available AlphaCloud API endpoints.
+Author-email: Markus Ziegler <frage_n@web.de>
+Maintainer-email: Markus Ziegler <frage_n@web.de>
+License: MIT License
+        
+        Copyright (c) 2024 zeguramente
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Repository, https://github.com/zeguramente/alphaess-aio
+Keywords: alphaess,api
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp==3.9.3
+Requires-Dist: pydantic==2.6.4
+Provides-Extra: lint
+Requires-Dist: ruff>=0.4.2; extra == "lint"
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-mock; extra == "test"
+Requires-Dist: pytest-asyncio; extra == "test"
+Requires-Dist: pytest-aiohttp; extra == "test"
+
+# Alphaess-aio - a Alpha Open API client
+
+## About
+
+Sends get and post requests to available AlphaCloud API endpoints and retrieves data about you AlphaESS system.
+Code generated out of API description.
+
+## Prerequisites
+
+Register account at https://open.alphaess.com/. You will recieve an AppID and AppSecret needed for authentification.
+
+## How to use
+
+```python
+import asyncio
+from alphaessaio import AlphaEssAPI, AlphaEssAuth
+
+# setup auth
+auth = AlphaEssAuth(appid="your_app_id", appsecret="your_app_secret")
+
+#init api
+alphaess_api = AlphaEssAPI(auth)
+
+ess_list = asyncio.run(alphaess_api.get_ess_list())
+```

alphaess_aio-0.0.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+alphaessaio/__init__.py,sha256=BYSefY6wRYNeTACcqmfJkKKTQC_g4e9goaiyJaCFC4o,139
+alphaessaio/client.py,sha256=FpfqWwzQ5J7DxHY5B6RuGHY087-GVe2AkWPZcnGBzX8,14978
+alphaessaio/response.py,sha256=ZNH2NQ7gmmD0G6x_CIo4TbUqw1tqqm7at9rhXobcVdM,21737
+alphaess_aio-0.0.0.dist-info/LICENSE,sha256=mGNPWRhKGcc61AN72O3M7i4CuJu_VuTcFBWNcpe8LaQ,1068
+alphaess_aio-0.0.0.dist-info/METADATA,sha256=2LyQDGJfhj8lN7qnpib18JexHKAVocd3LBnlXXcYsYU,2678
+alphaess_aio-0.0.0.dist-info/WHEEL,sha256=R06PA3UVYHThwHvxuRWMqaGcr-PuniXahwjmQRFMEkY,91
+alphaess_aio-0.0.0.dist-info/top_level.txt,sha256=inFWZRPfHD42viOPGUjT5E30RAxpKp4yLDBkIv7WovA,12
+alphaess_aio-0.0.0.dist-info/RECORD,,

alphaess_aio-0.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (75.5.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

alphaess_aio-0.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+alphaessaio

alphaessaio/__init__.py

@@ -0,0 +1,7 @@
+"""Import stuff"""
+
+from alphaessaio.client import AlphaEssAPI, AlphaEssAuth
+
+__all__ = [AlphaEssAPI, AlphaEssAuth]
+
+__version__ = "0.0.0"

alphaessaio/client.py

@@ -0,0 +1,443 @@
+"""Sending requests to AlphaESS API"""
+
+import logging
+import time
+import hashlib
+import json
+import aiohttp
+import pydantic
+from alphaessaio import response
+
+logger = logging.getLogger(__name__)
+
+
+class AlphaEssRequestError(Exception):
+    def __init__(self, response_data: dict):
+        message = f"Error: {response_data}"
+        super().__init__(message)
+
+
+class AlphaEssAuth(pydantic.BaseModel):
+    appid: str
+    appsecret: pydantic.SecretStr
+
+    def _get_signature(self, timestamp) -> str:
+        return str(
+            hashlib.sha512(
+                (f"{self.appid}{self.appsecret.get_secret_value()}{timestamp}").encode(
+                    "ascii"
+                )
+            ).hexdigest()
+        )
+
+    def create_headers(self):
+        timestamp = str(int(time.time()))
+        sign = self._get_signature(timestamp)
+        return {"appId": self.appid, "timeStamp": timestamp, "sign": sign}
+
+
+class AlphaEssAPI:
+    def __init__(self, auth: AlphaEssAuth):
+        self.auth = auth
+
+    async def _get(self, url, params) -> dict:
+        headers = self.auth.create_headers()
+        async with aiohttp.ClientSession() as session:
+            logger.debug(f"Sending get request to {url=} with {params=}")
+            async with session.get(url, headers=headers, params=params) as resp:
+                return await self._evaluate_response(resp)
+
+    async def _post(self, url, params) -> dict:
+        headers = self.auth.create_headers()
+        async with aiohttp.ClientSession() as session:
+            async with session.post(url, headers=headers, json=params) as resp:
+                return await self._evaluate_response(resp)
+
+    @staticmethod
+    async def _evaluate_response(resp: aiohttp.ClientResponse) -> dict:
+        try:
+            data = await resp.json()
+            logger.debug(f"api response: {data}")
+        except json.JSONDecodeError as json_decode_error:
+            raise AlphaEssRequestError(
+                {"msg": "returned data is not valid json", "err": json_decode_error}
+            )
+        if resp.status == 200 and data.get("code", 0) == 200:
+            logger.debug(f"Request successful. {resp.url}")
+            return data
+        logger.error(f"Request error: {data=}")
+        raise AlphaEssRequestError(data)
+
+    @pydantic.validate_call
+    async def get_ev_charger_config_list(
+        self, sys_sn: str
+    ) -> response.EvChargerConfigList:
+        """Obtain the SN of the charging pile according to the SN, and set the model
+
+        Args:
+            sys_sn (str): System S/N
+
+        Returns:
+            (response.EvChargerConfigList): response data
+        """
+
+        raw_response: dict = await self._get(
+            "https://openapi.alphaess.com/api/getEvChargerConfigList", {"sysSn": sys_sn}
+        )
+
+        return response.EvChargerConfigList(**raw_response)
+
+    @pydantic.validate_call
+    async def get_ev_charger_currents_by_sn(
+        self, sys_sn: str
+    ) -> response.EvChargerCurrentsBySn:
+        """Obtain the current setting of charging pile household according to SN
+
+        Args:
+            sys_sn (str): sys sn
+
+        Returns:
+            (response.EvChargerCurrentsBySn): response data
+        """
+
+        raw_response: dict = await self._get(
+            "https://openapi.alphaess.com/api/getEvChargerCurrentsBySn",
+            {"sysSn": sys_sn},
+        )
+
+        return response.EvChargerCurrentsBySn(**raw_response)
+
+    @pydantic.validate_call
+    async def set_ev_charger_currents_by_sn(
+        self, sys_sn: str, currentsetting: float
+    ) -> response.EvChargerCurrentsBySn:
+        """Set charging pile household current setting according to SN
+
+        Args:
+            sys_sn (str): SN
+        currentsetting (float): Household current setup
+
+        Returns:
+            (response.EvChargerCurrentsBySn): response data
+        """
+
+        raw_response: dict = await self._post(
+            "https://openapi.alphaess.com/api/setEvChargerCurrentsBySn",
+            {"sysSn": sys_sn, "currentsetting": currentsetting},
+        )
+
+        return response.EvChargerCurrentsBySn(**raw_response)
+
+    @pydantic.validate_call
+    async def get_ev_charger_status_by_sn(
+        self, sys_sn: str, evcharger_sn: str
+    ) -> response.EvChargerStatusBySn:
+        """Obtain charging pile status according to SN+charging pile SN
+
+        Args:
+            sys_sn (str): sys SN
+        evcharger_sn (str): EV-charger SN
+
+        Returns:
+            (response.EvChargerStatusBySn): response data
+        """
+
+        raw_response: dict = await self._get(
+            "https://openapi.alphaess.com/api/getEvChargerStatusBySn",
+            {"sysSn": sys_sn, "evchargerSn": evcharger_sn},
+        )
+
+        return response.EvChargerStatusBySn(**raw_response)
+
+    @pydantic.validate_call
+    async def remote_control_ev_charger(
+        self, sys_sn: str, evcharger_sn: str, control_mode: int
+    ) -> response.ControlEvCharger:
+        """According to SN+ charging pile SN remote control charging pile to start charging/stop charging
+
+        Args:
+            sys_sn (str): sys sn
+        evcharger_sn (str): EV-charger SN
+        control_mode (int): 0-Stop Charging，1-Start Charging
+
+        Returns:
+            (response.ControlEvCharger): response data
+        """
+
+        raw_response: dict = await self._post(
+            "https://openapi.alphaess.com/api/remoteControlEvCharger",
+            {"sysSn": sys_sn, "evchargerSn": evcharger_sn, "controlMode": control_mode},
+        )
+
+        return response.ControlEvCharger(**raw_response)
+
+    @pydantic.validate_call
+    async def get_sum_data_for_customer(
+        self, sys_sn: str
+    ) -> response.SumDataForCustomer:
+        """According  SN to get System Summary data
+
+        Args:
+            sys_sn (str): System S/N
+
+        Returns:
+            (response.SumDataForCustomer): response data
+        """
+
+        raw_response: dict = await self._get(
+            "https://openapi.alphaess.com/api/getSumDataForCustomer", {"sysSn": sys_sn}
+        )
+
+        return response.SumDataForCustomer(**raw_response)
+
+    @pydantic.validate_call
+    async def get_last_power_data(self, sys_sn: str) -> response.LastPowerData:
+        """Get real-time power data based on SN
+
+        Args:
+            sys_sn (str): system SN
+
+        Returns:
+            (response.LastPowerData): response data
+        """
+
+        raw_response: dict = await self._get(
+            "https://openapi.alphaess.com/api/getLastPowerData", {"sysSn": sys_sn}
+        )
+
+        return response.LastPowerData(**raw_response)
+
+    @pydantic.validate_call
+    async def get_one_day_power_by_sn(
+        self, query_date: str, sys_sn: str
+    ) -> response.OneDayPowerBySn:
+        """According  SN to get system power data
+
+        Args:
+            query_date (str): Date，Format：yyyy-MM-dd
+        sys_sn (str): System S/N
+
+        Returns:
+            (response.OneDayPowerBySn): response data
+        """
+
+        raw_response: dict = await self._get(
+            "https://openapi.alphaess.com/api/getOneDayPowerBySn",
+            {"queryDate": query_date, "sysSn": sys_sn},
+        )
+
+        return response.OneDayPowerBySn(**raw_response)
+
+    @pydantic.validate_call
+    async def get_one_date_energy_by_sn(
+        self, query_date: str, sys_sn: str
+    ) -> response.OneDateEnergyBySn:
+        """According  SN to get System Energy Data
+
+        Args:
+            query_date (str): Date，Format：yyyy-MM-dd
+        sys_sn (str): System S/N
+
+        Returns:
+            (response.OneDateEnergyBySn): response data
+        """
+
+        raw_response: dict = await self._get(
+            "https://openapi.alphaess.com/api/getOneDateEnergyBySn",
+            {"queryDate": query_date, "sysSn": sys_sn},
+        )
+
+        return response.OneDateEnergyBySn(**raw_response)
+
+    @pydantic.validate_call
+    async def get_charge_config_info(self, sys_sn: str) -> response.ChargeConfigInfo:
+        """According  SN to get charging setting information
+
+        Args:
+            sys_sn (str): System S/N
+
+        Returns:
+            (response.ChargeConfigInfo): response data
+        """
+
+        raw_response: dict = await self._get(
+            "https://openapi.alphaess.com/api/getChargeConfigInfo", {"sysSn": sys_sn}
+        )
+
+        return response.ChargeConfigInfo(**raw_response)
+
+    @pydantic.validate_call
+    async def update_charge_config_info(
+        self,
+        sys_sn: str,
+        bat_high_cap: float,
+        grid_charge: int,
+        time_chae1: str,
+        time_chae2: str,
+        time_chaf1: str,
+        time_chaf2: str,
+    ) -> response.ChargeConfigInfo:
+        """According SN to Set charging information，Setting frequency 24 hours, set once a day
+
+        Args:
+            sys_sn (str): System S/N
+        bat_high_cap (float): Charging Stops at SOC [%]
+        grid_charge (int): Enable Grid Charging Battery
+        time_chae1 (str): Charging Period 1 end time, the time format is HH:mm, such as: 00:00, the maximum is 23:45, the minimum is 00:00, and the interval is 15 minutes, such as: 00:15, 00:30, 00:45, otherwise no effect
+        time_chae2 (str): Charging Period 2 end time, the time format is HH:mm, such as: 00:00, the maximum is 23:45, the minimum is 00:00, and the interval is 15 minutes, such as: 00:15, 00:30, 00:45, otherwise no effect
+        time_chaf1 (str): Charging Period 1 start time, the time format is HH:mm, such as: 00:00, the maximum is 23:45, the minimum is 00:00, and the interval is 15 minutes, such as: 00:15, 00:30, 00:45, otherwise no effect
+        time_chaf2 (str): Charging Period 2 start time, the time format is HH:mm, such as: 00:00, the maximum is 23:45, the minimum is 00:00, and the interval is 15 minutes, such as: 00:15, 00:30, 00:45, otherwise no effect
+
+        Returns:
+            (response.ChargeConfigInfo): response data
+        """
+
+        raw_response: dict = await self._post(
+            "https://openapi.alphaess.com/api/updateChargeConfigInfo",
+            {
+                "sysSn": sys_sn,
+                "batHighCap": bat_high_cap,
+                "gridCharge": grid_charge,
+                "timeChae1": time_chae1,
+                "timeChae2": time_chae2,
+                "timeChaf1": time_chaf1,
+                "timeChaf2": time_chaf2,
+            },
+        )
+
+        return response.ChargeConfigInfo(**raw_response)
+
+    @pydantic.validate_call
+    async def get_dis_charge_config_info(
+        self, sys_sn: str
+    ) -> response.DisChargeConfigInfo:
+        """According to SN discharge setting information
+
+        Args:
+            sys_sn (str): System S/N
+
+        Returns:
+            (response.DisChargeConfigInfo): response data
+        """
+
+        raw_response: dict = await self._get(
+            "https://openapi.alphaess.com/api/getDisChargeConfigInfo", {"sysSn": sys_sn}
+        )
+
+        return response.DisChargeConfigInfo(**raw_response)
+
+    @pydantic.validate_call
+    async def update_dis_charge_config_info(
+        self,
+        bat_use_cap: float,
+        ctr_dis: int,
+        time_dise1: str,
+        time_dise2: str,
+        time_disf1: str,
+        time_disf2: str,
+        sys_sn: str,
+    ) -> response.DisChargeConfigInfo:
+        """According to SN Set discharge information，Setting frequency 24 hours, set once a day
+
+        Args:
+            bat_use_cap (float): Discharging Cutoff SOC [%]
+        ctr_dis (int): Enable Battery Discharge Time Control
+        time_dise1 (str): Discharging Period 1 End time, the time format is HH:mm, such as: 00:00, the maximum is 23:45, the minimum is 00:00, and the interval is 15 minutes, such as: 00:15, 00:30, 00:45, otherwise no effect
+        time_dise2 (str): Discharging Period 2 End time, the time format is HH:mm, such as: 00:00, the maximum is 23:45, the minimum is 00:00, and the interval is 15 minutes, such as: 00:15, 00:30, 00:45, otherwise no effect
+        time_disf1 (str): Discharging Period 1 Start time, the time format is HH:mm, such as: 00:00, the maximum is 23:45, the minimum is 00:00, and the interval is 15 minutes, such as: 00:15, 00:30, 00:45, otherwise no effect
+        time_disf2 (str): Discharging Period 2 Start time, the time format is HH:mm, such as: 00:00, the maximum is 23:45, the minimum is 00:00, and the interval is 15 minutes, such as: 00:15, 00:30, 00:45, otherwise no effect
+        sys_sn (str): System S/N
+
+        Returns:
+            (response.DisChargeConfigInfo): response data
+        """
+
+        raw_response: dict = await self._post(
+            "https://openapi.alphaess.com/api/updateDisChargeConfigInfo",
+            {
+                "batUseCap": bat_use_cap,
+                "ctrDis": ctr_dis,
+                "timeDise1": time_dise1,
+                "timeDise2": time_dise2,
+                "timeDisf1": time_disf1,
+                "timeDisf2": time_disf2,
+                "sysSn": sys_sn,
+            },
+        )
+
+        return response.DisChargeConfigInfo(**raw_response)
+
+    @pydantic.validate_call
+    async def get_verification_code(
+        self, sys_sn: str, check_code: str
+    ) -> response.VerificationCode:
+        """According to SN get the check code according to SN
+
+        Args:
+            sys_sn (str): System S/N
+        check_code (str): checkCode
+
+        Returns:
+            (response.VerificationCode): response data
+        """
+
+        raw_response: dict = await self._get(
+            "https://openapi.alphaess.com/api/getVerificationCode",
+            {"sysSn": sys_sn, "checkCode": check_code},
+        )
+
+        return response.VerificationCode(**raw_response)
+
+    @pydantic.validate_call
+    async def bind_sn(self, sys_sn: str, code: str) -> response.Sn:
+        """According to SN and check code Bind the system bind the system
+
+        Args:
+            sys_sn (str): System S/N
+        code (str): Verification Code
+
+        Returns:
+            (response.Sn): response data
+        """
+
+        raw_response: dict = await self._post(
+            "https://openapi.alphaess.com/api/bindSn", {"sysSn": sys_sn, "code": code}
+        )
+
+        return response.Sn(**raw_response)
+
+    @pydantic.validate_call
+    async def un_bind_sn(self, sys_sn: str) -> response.BindSn:
+        """According to SN and check code Unbind the system
+
+        Args:
+            sys_sn (str): System S/N
+
+        Returns:
+            (response.BindSn): response data
+        """
+
+        raw_response: dict = await self._post(
+            "https://openapi.alphaess.com/api/unBindSn", {"sysSn": sys_sn}
+        )
+
+        return response.BindSn(**raw_response)
+
+    @pydantic.validate_call
+    async def get_ess_list(
+        self,
+    ) -> response.EssList:
+        """According to SN  to get system list data
+
+        Args:
+
+
+        Returns:
+            (response.EssList): response data
+        """
+
+        raw_response: dict = await self._get(
+            "https://openapi.alphaess.com/api/getEssList", {}
+        )
+
+        return response.EssList(**raw_response)

alphaessaio/response.py

@@ -0,0 +1,636 @@
+"""Response classes for alphaess requests."""
+
+import logging
+import datetime
+from typing import List
+from pydantic import BaseModel, Field, model_validator, ConfigDict, AliasChoices
+
+
+class DataSn(BaseModel):
+    "Response data model for Sn"
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        logging.debug(f"extra fields detected: {self.model_extra}")
+        return self
+
+
+class DataVerificationCode(BaseModel):
+    "Response data model for VerificationCode"
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        logging.debug(f"extra fields detected: {self.model_extra}")
+        return self
+
+
+class DataControlEvCharger(BaseModel):
+    "Response data model for ControlEvCharger"
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        logging.debug(f"extra fields detected: {self.model_extra}")
+        return self
+
+
+class DataEvChargerConfigList(BaseModel):
+    "Response data model for getEvChargerConfigList"
+
+    evcharger_sn: str = Field(..., alias="evchargerSn", description="EV-charger SN")
+    evcharger_model: str = Field(
+        ..., alias="evchargerModel", description="EV-charger model"
+    )
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class EvChargerConfigList(BaseModel):
+    "Response data model for getEvChargerConfigList"
+
+    code: int = Field(..., alias="code", description="Return Code")
+    info: str = Field(
+        ..., validation_alias=AliasChoices("info", "msg"), description="Return Message"
+    )
+    data: List[DataEvChargerConfigList] = Field(
+        ..., alias="data", description="Data List"
+    )
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class DataEvChargerCurrentsBySn(BaseModel):
+    "Response data model for getEvChargerCurrentsBySn"
+
+    currentsetting: float = Field(
+        ..., alias="currentsetting", description="Household current setup"
+    )
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class EvChargerCurrentsBySn(BaseModel):
+    "Response data model for set and getEvChargerCurrentsBySn"
+
+    code: int = Field(..., alias="code", description="Return Code")
+    info: str = Field(
+        ..., validation_alias=AliasChoices("info", "msg"), description="Return Message"
+    )
+    data: DataEvChargerCurrentsBySn = Field(..., alias="data", description="Data")
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class DataEvChargerStatusBySn(BaseModel):
+    "Response data model for getEvChargerStatusBySn"
+
+    evcharger_status: int = Field(
+        ...,
+        alias="evchargerStatus",
+        description="1: Available state (not plugged in)2: Preparing state of insertion (plugged in and not activated)3: Charging state (charging with power output)4: SuspendedEVSE pile Suspended at the terminal (already started but no available power)5: SuspendedEV Suspended at the vehicle end (with available power, waiting for the car to respond)6: Finishing The charging end state (actively swiping the card to stop or EMS stop control)9: Faulted fault state (pile failure)",
+    )
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class EvChargerStatusBySn(BaseModel):
+    "Response data model for getEvChargerStatusBySn"
+
+    code: int = Field(..., alias="code", description="Return Code")
+    info: str = Field(
+        ..., validation_alias=AliasChoices("info", "msg"), description="Return Message"
+    )
+    data: List[DataEvChargerStatusBySn] = Field(
+        ..., alias="data", description="Data List"
+    )
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class ControlEvCharger(BaseModel):
+    "Response data model for remoteControlEvCharger"
+
+    code: int = Field(..., alias="code", description="Return Code")
+    info: str = Field(
+        ..., validation_alias=AliasChoices("info", "msg"), description="Return Message"
+    )
+    data: DataControlEvCharger = Field(..., alias="data", description="Data")
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class DataSumDataForCustomer(BaseModel):
+    "Response data model for getSumDataForCustomer"
+
+    epvtoday: float = Field(
+        ..., alias="epvtoday", description="Today's Generation,unit：kwh"
+    )
+    epvtotal: float = Field(
+        ..., alias="epvtotal", description="Total Generation,unit：kwh"
+    )
+    eload: float = Field(..., alias="eload", description="Today's Load,unit：kwh")
+    eoutput: float = Field(
+        ..., alias="eoutput", description="Today's Feed-in,unit：kwh"
+    )
+    einput: float = Field(..., alias="einput", description="Today's Consumed,unit：kwh")
+    echarge: float = Field(
+        ..., alias="echarge", description="Today's Charged,unit：kwh"
+    )
+    edischarge: float = Field(
+        ..., alias="edischarge", description="Today's DisCharged,unit：kwh"
+    )
+    today_income: float = Field(..., alias="todayIncome", description="Today's Income")
+    total_income: float = Field(..., alias="totalIncome", description="Total Profit")
+    eself_consumption: float = Field(
+        ..., alias="eselfConsumption", description="Self-consumption,unit：%"
+    )
+    eself_sufficiency: float = Field(
+        ..., alias="eselfSufficiency", description="Self-sufficiency,unit：%"
+    )
+    tree_num: float = Field(..., alias="treeNum", description="Trees Planted")
+    carbon_num: float = Field(
+        ..., alias="carbonNum", description="CO2 Reduction,unit：kg"
+    )
+    money_type: str = Field(..., alias="moneyType", description="Currencies")
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class SumDataForCustomer(BaseModel):
+    "Response data model for getSumDataForCustomer"
+
+    code: int = Field(..., alias="code", description="Return Code")
+    info: str = Field(
+        ..., validation_alias=AliasChoices("info", "msg"), description="Return Message"
+    )
+    data: DataSumDataForCustomer = Field(..., alias="data", description="Return Data")
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class PevDetail(BaseModel):
+    "Response data model for getLastPowerData"
+
+    ev1_power: float = Field(..., alias="ev1Power", description="ev1Power")
+    ev2_power: float = Field(..., alias="ev2Power", description="ev2Power")
+    ev3_power: float = Field(..., alias="ev3Power", description="ev3Power")
+    ev4_power: float = Field(..., alias="ev4Power", description="ev4Power")
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class PgridDetail(BaseModel):
+    "Response data model for getLastPowerData"
+
+    pmeter_l1: float = Field(..., alias="pmeterL1", description="pmeterL1")
+    pmeter_l2: float = Field(..., alias="pmeterL2", description="pmeterL2")
+    pmeter_l3: float = Field(..., alias="pmeterL3", description="pmeterL3")
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class PpvDetail(BaseModel):
+    "Response data model for getLastPowerData"
+
+    ppv1: float = Field(..., alias="ppv1", description="ppv1")
+    ppv2: float = Field(..., alias="ppv2", description="ppv2")
+    ppv3: float = Field(..., alias="ppv3", description="ppv3")
+    ppv4: float = Field(..., alias="ppv4", description="ppv4")
+    pmeter_dc: float = Field(..., alias="pmeterDc", description="pmeterDc")
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class DataLastPowerData(BaseModel):
+    "Response data model for getLastPowerData"
+
+    ppv: float = Field(..., alias="ppv", description="Pv total power, unit: W")
+    ppv_detail: PpvDetail = Field(..., alias="ppvDetail", description="Data entity")
+    pload: float = Field(..., alias="pload", description="Load, unit: W")
+    soc: float = Field(..., alias="soc", description="soc")
+    pgrid: float = Field(
+        ...,
+        alias="pgrid",
+        description="When pgrid is positive, it means taking electricity from the mains; when pgrid is negative, it means selling electricity. Unit:W",
+    )
+    pgrid_detail: PgridDetail = Field(
+        ..., alias="pgridDetail", description="data entity"
+    )
+    pbat: float = Field(..., alias="pbat", description="Battery power, unit: W")
+    preal_l1: float = Field(..., alias="prealL1", description="prealL1")
+    preal_l2: float = Field(..., alias="prealL2", description="prealL2")
+    preal_l3: float = Field(..., alias="prealL3", description="prealL3")
+    pev: float = Field(
+        ..., alias="pev", description="Total power of charging pile, unit: W"
+    )
+    pev_detail: PevDetail = Field(..., alias="pevDetail", description="Data entity")
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class LastPowerData(BaseModel):
+    "Response data model for getLastPowerData"
+
+    code: int = Field(
+        ...,
+        alias="code",
+        description="Return status. If 200 is returned, the operation is successful. If other codes are returned, you need to check the return code to indicate the description corresponding to this code.",
+    )
+    info: str = Field(
+        ...,
+        validation_alias=AliasChoices("info", "msg"),
+        description="Return information",
+    )
+    data: DataLastPowerData = Field(..., alias="data", description="return data set")
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class DataOneDayPowerBySn(BaseModel):
+    "Response data model for getOneDayPowerBySn"
+
+    cbat: float = Field(
+        ..., validation_alias=AliasChoices("cbat", "cobat"), description="BAT"
+    )
+    feed_in: float = Field(..., alias="feedIn", description="Feed-in")
+    grid_charge: float = Field(
+        ..., alias="gridCharge", description="Grid purchase real-time power"
+    )
+    load: float = Field(..., alias="load", description="Load")
+    pcharging_pile: float = Field(
+        ..., alias="pchargingPile", description="Charging pile power"
+    )
+    ppv: float = Field(..., alias="ppv", description="PV power")
+    sys_sn: str = Field(..., alias="sysSn", description="System S/N")
+    upload_time: datetime.datetime = Field(
+        ..., alias="uploadTime", description="upload Time"
+    )
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class OneDayPowerBySn(BaseModel):
+    "Response data model for getOneDayPowerBySn"
+
+    code: int = Field(..., alias="code", description="Return Code")
+    info: str = Field(
+        ..., validation_alias=AliasChoices("info", "msg"), description="Return Message"
+    )
+    data: List[DataOneDayPowerBySn] = Field(
+        ..., alias="data", description="Return Data"
+    )
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class DataOneDateEnergyBySn(BaseModel):
+    "Response data model for getOneDateEnergyBySn"
+
+    e_charge: float = Field(
+        ..., alias="eCharge", description="total energy charged from battery，unit：kWh"
+    )
+    e_charging_pile: float = Field(
+        ...,
+        alias="eChargingPile",
+        description="Total energy consumed by charging piles，unit：kWh",
+    )
+    e_discharge: float = Field(
+        ..., alias="eDischarge", description="Discharge，unit：kWh"
+    )
+    e_grid_charge: float = Field(
+        ..., alias="eGridCharge", description="Grid-charge，unit：kWh"
+    )
+    e_input: float = Field(
+        ..., alias="eInput", description="Grid consumption，unit：kWh"
+    )
+    e_output: float = Field(..., alias="eOutput", description="Feed-in，unit：kWh")
+    epv: float = Field(..., alias="epv", description="PV generation，unit：kWh")
+    sys_sn: str = Field(..., alias="sysSn", description="System S/N")
+    the_date: str = Field(..., alias="theDate", description="Date")
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class OneDateEnergyBySn(BaseModel):
+    "Response data model for getOneDateEnergyBySn"
+
+    code: int = Field(..., alias="code", description="Return Code")
+    info: str = Field(
+        ..., validation_alias=AliasChoices("info", "msg"), description="Return Message"
+    )
+    data: DataOneDateEnergyBySn = Field(..., alias="data", description="Return Data")
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class DataChargeConfigInfo(BaseModel):
+    "Response data model for getChargeConfigInfo"
+
+    bat_high_cap: float = Field(
+        ..., alias="batHighCap", description="Charging Stops at SOC [%]"
+    )
+    grid_charge: int = Field(
+        ..., alias="gridCharge", description="Enable Grid Charging Battery"
+    )
+    time_chae1: str = Field(
+        ..., alias="timeChae1", description="Charging Period 1 end time"
+    )
+    time_chae2: str = Field(
+        ..., alias="timeChae2", description="Charging Period 2 end time"
+    )
+    time_chaf1: str = Field(
+        ..., alias="timeChaf1", description="Charging Period 1 start time"
+    )
+    time_chaf2: str = Field(
+        ..., alias="timeChaf2", description="Charging Period 2 start time"
+    )
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class ChargeConfigInfo(BaseModel):
+    "Response data model for update and getChargeConfigInfo"
+
+    code: int = Field(..., alias="code", description="Return Code")
+    info: str = Field(
+        ..., validation_alias=AliasChoices("info", "msg"), description="Return Message"
+    )
+    data: DataChargeConfigInfo = Field(..., alias="data", description="Return Data")
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class DataDisChargeConfigInfo(BaseModel):
+    "Response data model for getDisChargeConfigInfo"
+
+    bat_use_cap: float = Field(
+        ..., alias="batUseCap", description="Discharging Cutoff SOC [%]"
+    )
+    ctr_dis: int = Field(
+        ..., alias="ctrDis", description="Enable Battery Discharge Time Control"
+    )
+    time_dise1: str = Field(
+        ..., alias="timeDise1", description="Discharging Period 1 End time"
+    )
+    time_dise2: str = Field(
+        ..., alias="timeDise2", description="Discharging Period 2 End time"
+    )
+    time_disf1: str = Field(
+        ..., alias="timeDisf1", description="Discharging Period 1 Start time"
+    )
+    time_disf2: str = Field(
+        ..., alias="timeDisf2", description="Discharging Period 2 Start time"
+    )
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class DisChargeConfigInfo(BaseModel):
+    "Response data model for update and getDisChargeConfigInfo"
+
+    code: int = Field(..., alias="code", description="Return Code")
+    info: str = Field(
+        ..., validation_alias=AliasChoices("info", "msg"), description="Return Message"
+    )
+    data: DataDisChargeConfigInfo = Field(..., alias="data", description="Return Data")
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class VerificationCode(BaseModel):
+    "Response data model for getVerificationCode"
+
+    code: int = Field(..., alias="code", description="Return Code")
+    info: str = Field(
+        ..., validation_alias=AliasChoices("info", "msg"), description="Return Message"
+    )
+    data: DataVerificationCode = Field(..., alias="data", description="Return Data")
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class Sn(BaseModel):
+    "Response data model for bindSn"
+
+    code: int = Field(..., alias="code", description="Return Code")
+    info: str = Field(
+        ..., validation_alias=AliasChoices("info", "msg"), description="Return Message"
+    )
+    data: DataSn = Field(..., alias="data", description="Return Data")
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class BindSn(BaseModel):
+    "Response data model for unBindSn"
+
+    code: int = Field(..., alias="code", description="Return Code")
+    info: str = Field(
+        ..., validation_alias=AliasChoices("info", "msg"), description="Return Message"
+    )
+    data: DataSn = Field(..., alias="data", description="Return Data")
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class DataEssList(BaseModel):
+    "Response data model for getEssList"
+
+    cbat: float = Field(
+        ...,
+        validation_alias=AliasChoices("cbat", "cobat"),
+        description="battery capacity",
+    )
+    ems_status: str = Field(..., alias="emsStatus", description="EMS status")
+    mbat: str = Field(..., alias="mbat", description="battery model")
+    minv: str = Field(..., alias="minv", description="Inverter model")
+    poinv: float = Field(..., alias="poinv", description="Inverter nominal Power")
+    popv: float = Field(..., alias="popv", description="Pv nominal Power")
+    surplus_cobat: float = Field(
+        ..., alias="surplusCobat", description="Battery capacity remaining"
+    )
+    sys_sn: str = Field(..., alias="sysSn", description="System S/N")
+    us_capacity: float = Field(
+        ..., alias="usCapacity", description="Battery Available Percentage"
+    )
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self
+
+
+class EssList(BaseModel):
+    "Response data model for getEssList"
+
+    code: int = Field(..., alias="code", description="Return Code")
+    info: str = Field(
+        ..., validation_alias=AliasChoices("info", "msg"), description="Return Message"
+    )
+    data: List[DataEssList] = Field(..., alias="data", description="Return Data")
+
+    model_config = ConfigDict(extra="allow")
+
+    @model_validator(mode="after")
+    def check_extras(self):
+        if self.model_extra:
+            logging.debug(f"extra fields detected: {self.model_extra }")
+        return self