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

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.1.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.1
+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.1.dist-info → python_openevse_http-1.8.0.dist-info}/RECORD

@@ -4,21 +4,21 @@ 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=jZZJpD9XolKW0A_1eeec_nB5Kzfbcjih18N7WI_uLvI,18941
-openevsehttp/commands_diagnostics.py,sha256=j23LX0cB9lb2UBkOpmJjNSBQm87AQijlP6qxotAmiTw,9894
+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.1.dist-info/licenses/LICENSE,sha256=hSB6TOQ7rmwSGb6XzqRjDGMvmUj5_GlacqQin3tegtA,11341
-python_openevse_http-1.7.1.dist-info/METADATA,sha256=5Ymc7plftTfZ9tmIhBRTJws0s9kpIU7KDrVzdYWLQQo,7011
-python_openevse_http-1.7.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-python_openevse_http-1.7.1.dist-info/top_level.txt,sha256=u8RUkoEIE33Cjn6gmqiEoVpZ0VZ59WJ3FXBwwOg0CPE,13
-python_openevse_http-1.7.1.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,,