python-openevse-http 1.7.0__py3-none-any.whl → 1.8.0__py3-none-any.whl

openevsehttp/client.py

@@ -26,6 +26,7 @@ from .const import (
 from .exceptions import (
     AlreadyListening,
     AuthenticationError,
+    CommandFailedError,
     MissingMethod,
     MissingSerial,
     ParseJSONError,
@@ -186,15 +187,16 @@ class OpenEVSE(CommandsMixin, ManagersMixin, SensorsMixin, PropertiesMixin):
 
                 if resp.status == 400:
                     if isinstance(response_content, dict) and "msg" in response_content:
-                        _LOGGER.error("Error 400: %s", response_content["msg"])
+                        msg = str(response_content["msg"])
                     elif (
                         isinstance(response_content, dict)
                         and "error" in response_content
                     ):
-                        _LOGGER.error("Error 400: %s", response_content["error"])
+                        msg = str(response_content["error"])
                     else:
-                        _LOGGER.error("Error 400: %s", response_content)
-                    raise ParseJSONError
+                        msg = str(response_content)
+                    _LOGGER.error("Error 400: %s", msg)
+                    raise CommandFailedError(msg)
                 if resp.status == 401:
                     _LOGGER.error("Authentication error: %s", response_content)
                     raise AuthenticationError

openevsehttp/commands_core.py

@@ -271,17 +271,31 @@ class CoreCommandsMixin(BaseCommandMixin):
 
         # Strict success check:
         # 1. Must be a Mapping
-        # 2. Must have "result" == "OK" OR "success" is True
-        # 3. Must NOT have an "error" key
-        # 4. If "msg" is present, it must be "OK" or contain "ok" (case-insensitive)
+        # 2. Must NOT have an "error" key
+        # 3. Must have "result" in ("OK", "ok", True) OR "success" is True
+        #    OR "msg" indicating restart acknowledgment ("restart gateway", "ok")
         success = (
             isinstance(response, Mapping)
-            and (response.get("result") == "OK" or response.get("success") is True)
             and not response.get("error")
+            and (
+                response.get("result") in ("OK", "ok", True)
+                or response.get("success") is True
+                or (
+                    isinstance(response.get("msg"), str)
+                    and any(
+                        val in response["msg"].lower()
+                        for val in ("ok", "restart gateway")
+                    )
+                )
+            )
         )
         if success and isinstance(response, Mapping) and "msg" in response:
             msg_val = str(response["msg"]).lower()
-            if msg_val != "ok" and "ok" not in msg_val:
+            if (
+                msg_val != "ok"
+                and "ok" not in msg_val
+                and "restart gateway" not in msg_val
+            ):
                 success = False
 
         if not success:

openevsehttp/commands_diagnostics.py

@@ -227,3 +227,107 @@ class DiagnosticsCommandsMixin(BaseCommandMixin):
             raise CommandFailedError(f"Invalid response from /logs: {response}")
 
         return dict(response)
+
+    async def get_notifications(self) -> dict[str, Any]:
+        """Retrieve the advisory notifications list from the gateway.
+
+        Queries 'GET /notifications'.
+        Requires gateway firmware 5.1.0 or higher.
+
+        Expected response shape:
+            {
+                "count": int,
+                "max_severity": "info" | "warning" | "critical" | None,
+                "notifications": [
+                    {
+                        "id": str,
+                        "category": str,
+                        "severity": str,
+                        "sticky": bool,
+                        "acked": bool,
+                        "first_seen": int,
+                        "last_seen": int,
+                    },
+                    ...
+                ]
+            }
+
+        :return: Dict containing 'count', 'max_severity', and 'notifications' list.
+        :raises UnsupportedFeature: If gateway firmware is older than 5.1.0.
+        :raises CommandFailedError: If response is invalid.
+        """
+        self._require_firmware("5.1.0", "get_notifications")
+
+        url = f"{self.url}notifications"
+        _LOGGER.debug("Querying notifications: %s", url)
+        response = await self.process_request(url=url, method="get")
+
+        if not isinstance(response, Mapping):
+            _LOGGER.error("Invalid response from /notifications: %s", response)
+            raise CommandFailedError(
+                f"Invalid response from /notifications: {response}"
+            )
+
+        return dict(response)
+
+    async def acknowledge_notification(self, notification_id: str) -> None:
+        """Acknowledge (mute) an active advisory notification by ID.
+
+        Issues 'POST /notifications/ack' with the notification ID.
+        Requires gateway firmware 5.1.0 or higher.
+
+        :param notification_id: The identifier of the advisory (e.g. 'safety.ground_check').
+        :raises UnsupportedFeature: If gateway firmware is older than 5.1.0.
+        :raises ValueError: If notification_id is empty or not a string.
+        :raises CommandFailedError: If the acknowledgment fails or returns an error.
+        """
+        self._require_firmware("5.1.0", "acknowledge_notification")
+
+        if not isinstance(notification_id, str) or not notification_id.strip():
+            raise ValueError("notification_id must be a non-empty string.")
+
+        url = f"{self.url}notifications/ack"
+        data = {"id": notification_id.strip()}
+
+        _LOGGER.debug(
+            "Acknowledging notification %s at %s", notification_id.strip(), url
+        )
+        response = await self.process_request(url=url, method="post", data=data)
+        response = self._normalize_response(response)
+
+        msg = response.get("msg") if isinstance(response, Mapping) else response
+        if msg not in SUCCESS_ANSWERS:
+            _LOGGER.error("Problem acknowledging notification: %s", response)
+            raise CommandFailedError(f"Problem acknowledging notification: {response}")
+
+    async def reset_energy_meter(
+        self, hard: bool = False, import_from_evse: bool = False
+    ) -> None:
+        """Reset the charger energy meter.
+
+        Issues DELETE /emeter with hard and import flags.
+
+        :param hard: If True, sets total energy and switch counter to 0 (hard reset).
+                     If False, performs a soft reset.
+        :param import_from_evse: If True, allows re-importing total energy counters from EVSE.
+        :raises UnsupportedFeature: If gateway firmware is older than 4.0.0.
+        :raises CommandFailedError: If the reset operation fails.
+        """
+        self._require_firmware("4.0.0", "reset_energy_meter")
+
+        url = f"{self.url}emeter"
+        data = {"hard": bool(hard), "import": bool(import_from_evse)}
+
+        _LOGGER.debug(
+            "Resetting energy meter: %s (hard=%s, import=%s)",
+            url,
+            hard,
+            import_from_evse,
+        )
+        response = await self.process_request(url=url, method="delete", data=data)
+        response = self._normalize_response(response)
+
+        msg = response.get("msg") if isinstance(response, Mapping) else None
+        if msg not in SUCCESS_ANSWERS:
+            _LOGGER.error("Problem resetting energy meter: %s", response)
+            raise CommandFailedError(f"Problem resetting energy meter: {response}")

openevsehttp/const.py

@@ -72,6 +72,8 @@ SUCCESS_ANSWERS = [
     "Deleted",
     "User name saved",
     "User name removed",
+    "acknowledged",
+    "Reset done",
 ]
 
 ERROR_SESSION_REQUIRED = (

openevsehttp/properties.py

@@ -671,3 +671,21 @@ class PropertiesMixin:
         self._github_token = (
             token.strip() if isinstance(token, str) and token.strip() else None
         )
+
+    @property
+    def notifications_count(self) -> int | None:
+        """Return unmuted notification advisories count from status summary."""
+        notifications = self._status.get("notifications")
+        if isinstance(notifications, Mapping):
+            return notifications.get("count")
+        return None
+
+    @property
+    def notifications_severity(self) -> str | None:
+        """Return max severity ('info', 'warning', 'critical') from status summary."""
+        notifications = self._status.get("notifications")
+        if isinstance(notifications, Mapping):
+            severity = notifications.get("severity")
+            if severity is not None:
+                return str(severity)
+        return None

{python_openevse_http-1.7.0.dist-info → python_openevse_http-1.8.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python_openevse_http
-Version: 1.7.0
+Version: 1.8.0
 Summary: Python wrapper for OpenEVSE HTTP API
 Home-page: https://github.com/firstof9/python-openevse-http
 Download-URL: https://github.com/firstof9/python-openevse-http
@@ -54,6 +54,11 @@ A Python library for communicating with [OpenEVSE](https://www.openevse.com/) ch
     - **Time Synchronization & RTC**: Manage time, timezone, and NTP sync (requires firmware 4.0.0+).
     - **Event Logs**: Retrieve diagnostic log blocks and log event history (requires firmware 4.0.0+).
     - **Certificates**: Manage SSL/TLS Root CA and client certificates (requires firmware 4.0.0+).
+    - **RFID Management**: RFID tag pairing mode and tag-to-user mappings (requires firmware 4.0.0+ / 5.0.0+).
+    - **Relay Diagnostics**: Stuck relay recovery cycle and contact-life estimation reset (requires firmware 5.1.0+).
+    - **Cable Temperature Monitoring**: Cable temperature sensor configuration and monitoring (requires firmware 5.1.0+).
+    - **Energy Meter Reset**: Reset the energy meter counters with soft/hard options (requires firmware 4.0.0+).
+    - **Advisory Notifications**: Retrieve gateway advisory notifications and acknowledge/mute active advisories (requires firmware 5.1.0+).
 
 ## Installation
 
@@ -156,7 +161,9 @@ When performing firmware update checks (`charger.firmware_check()`) or automatic
 | `/time` | GET, POST | ✅ | RTC and NTP time settings (v4.0.0+) |
 | `/settime` | POST | ✅ | Legacy time setting interface (v3.x / fallback to `$S1` on v2.x) |
 | `/logs` | GET | ✅ | Event log block bounds and block events (v4.0.0+) |
-| `/emeter` | DELETE | ❌ | Energy meter reset |
+| `/emeter` | DELETE | ✅ | Energy meter reset (v4.0.0+) |
+| `/notifications` | GET | ✅ | Gateway advisory notifications list (v5.1.0+) |
+| `/notifications/ack` | POST | ✅ | Acknowledge/mute active advisory notification (v5.1.0+) |
 | `/wifi` | GET, POST | ❌ | Network scanning and AP configuration |
 | `/tesla` | GET | ❌ | Tesla vehicle integration |
 | `/certificates`| GET, POST, DELETE | ✅ | SSL/TLS certificate management (v4.0.0+) |

{python_openevse_http-1.7.0.dist-info → python_openevse_http-1.8.0.dist-info}/RECORD

@@ -1,24 +1,24 @@
 openevsehttp/__init__.py,sha256=QeXl80ozsK6J9PN-jB_83Bde31YXFGgLuUdmArpZAMM,1363
 openevsehttp/__main__.py,sha256=EHmSdT7GjAVvHQxvLBTjZXsj_V5SB6B2_kpgUAT7mPM,146
-openevsehttp/client.py,sha256=2C2SuRkJaC2r38qo57l1gPV86Fqr8Wp72LBnv2R_tuE,22456
+openevsehttp/client.py,sha256=DRiFOtXEznthZCfD5AGwI6isHMkCd7iiwFgo1W_nux8,22482
 openevsehttp/commands.py,sha256=l9mxdfgpeYzM1M6NPr0KLIaTtTsU10vzcKG1S7Z6O1M,918
 openevsehttp/commands_base.py,sha256=DnHnB-rAI7zLDIMkL66epct6KnjLsm9OhlRFlOojREI,1934
-openevsehttp/commands_core.py,sha256=c6gzsKqBy1t3mHwlZ6TcMMvQresettVeMvYsGhHQ-Ko,18506
-openevsehttp/commands_diagnostics.py,sha256=j23LX0cB9lb2UBkOpmJjNSBQm87AQijlP6qxotAmiTw,9894
+openevsehttp/commands_core.py,sha256=jZZJpD9XolKW0A_1eeec_nB5Kzfbcjih18N7WI_uLvI,18941
+openevsehttp/commands_diagnostics.py,sha256=bPYii1Es4tc-FOFGzb81ODeGIJH_Vmj6093dFe_XVBE,14229
 openevsehttp/commands_firmware.py,sha256=Ej_EdO8z4arA8wkqfORC0Q_zO9qi7SlC2NmPme03Llg,10308
 openevsehttp/commands_schedule.py,sha256=kBZp6hPt1qNjoZUVkhRhzB9pXlA--W1UQkQYzxEFQgw,5995
 openevsehttp/commands_security.py,sha256=--d9weP_Bu-HMhTKphk0qTKgYj1BjM6y2xbD8cccHbI,10911
 openevsehttp/commands_time.py,sha256=v5Hb0rieHi0SrSj_QQSPU8U3gJlEbRKon81FbH159e8,7737
-openevsehttp/const.py,sha256=Dh0hZPSVMXA96QtgxI2BRlmHQuUZWZ1d_U7iHKdmWlM,1801
+openevsehttp/const.py,sha256=jSh-vefm1FE0nQhmgzkWZPOfyjbf2LvcdAlFQYB7vBQ,1839
 openevsehttp/exceptions.py,sha256=sU6VkuJ2VIDcfbwPdEiwPklYPWb_yR6okRq4zdYhHLY,1654
 openevsehttp/managers.py,sha256=h_pI0z01FIH_EDVSlg7ZQ3lQVOlOkcb5EIQNQvqf3Mw,5460
-openevsehttp/properties.py,sha256=Ak9282qLGXSKzVXoj2PVsGs2bfaHB1YvSBgyQSo7vOQ,22396
+openevsehttp/properties.py,sha256=IsCFSY6gUC4--oYGOFlKfX8_Hzijg1fUXXKJYAscfNw,23117
 openevsehttp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 openevsehttp/sensors.py,sha256=XrAaL66jkZqh2IjYXpQI5SJc84GduanBmnbCpbta8lA,5797
 openevsehttp/utils.py,sha256=fPUWL64gFTRw4TtV4WITDAFMJ75VjNhPBaU6diwVlv0,2019
 openevsehttp/websocket.py,sha256=yMuLNsB2qYZLtfYRW7-D7NH7rv-qaSTp7F79OajKm_0,10790
-python_openevse_http-1.7.0.dist-info/licenses/LICENSE,sha256=hSB6TOQ7rmwSGb6XzqRjDGMvmUj5_GlacqQin3tegtA,11341
-python_openevse_http-1.7.0.dist-info/METADATA,sha256=K4DJbt66K11Zqi10mFJhE9krqioECU3Wn9ZY94G4rNY,7011
-python_openevse_http-1.7.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-python_openevse_http-1.7.0.dist-info/top_level.txt,sha256=u8RUkoEIE33Cjn6gmqiEoVpZ0VZ59WJ3FXBwwOg0CPE,13
-python_openevse_http-1.7.0.dist-info/RECORD,,
+python_openevse_http-1.8.0.dist-info/licenses/LICENSE,sha256=hSB6TOQ7rmwSGb6XzqRjDGMvmUj5_GlacqQin3tegtA,11341
+python_openevse_http-1.8.0.dist-info/METADATA,sha256=6XscBROhF-9GvzAci8vBptztH4jdZDMtR9cv-NDv3qo,7803
+python_openevse_http-1.8.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+python_openevse_http-1.8.0.dist-info/top_level.txt,sha256=u8RUkoEIE33Cjn6gmqiEoVpZ0VZ59WJ3FXBwwOg0CPE,13
+python_openevse_http-1.8.0.dist-info/RECORD,,