How lnagel/hass-eaton-ups-mqtt works
This is a Home Assistant integration for monitoring Eaton Network-M2/M3 UPS devices. The user configures the host and port, the integration provisions or enrols TLS client credentials, then connects to the UPS MQTT broker; MQTT updates flow through a coordinator into measurement and status entities. The README documents broad power, battery, device, and environmental monitoring, plus configurable measurement-write debouncing and diagnostics. Several runtime paths are supported by excerpts or README rather than full source inspection.
Main entry points: coordinator.py Update Coordinator · __init__.py Entry Setup · api.py MQTT Client · enrolment.py Certificate Enrolment
Components 15
Setup & Security
- Config Flow
custom_components/eaton_ups_mqtt/config_flow.py - Certificate Handling
custom_components/eaton_ups_mqtt/certificates.py - Certificate Enrolment
custom_components/eaton_ups_mqtt/enrolment.py - Entry Setup
custom_components/eaton_ups_mqtt/__init__.py
UPS Connection
- MQTT Client
custom_components/eaton_ups_mqtt/api.py - Runtime Data
custom_components/eaton_ups_mqtt/data.py
State & Entities
- Update Coordinator
custom_components/eaton_ups_mqtt/coordinator.py - Entity Base
custom_components/eaton_ups_mqtt/entity.py - Measurement Sensors
custom_components/eaton_ups_mqtt/sensor.py - Status Sensors
custom_components/eaton_ups_mqtt/binary_sensor.py
Operations
- Diagnostics
custom_components/eaton_ups_mqtt/diagnostics.py
Other components
- Home Assistant User
- Home Assistant
- UPS Certificate API
- Eaton UPS MQTT Broker
Connections 20
- Home Assistant User → Config Flow: configures
README.md - Config Flow → UPS Certificate API: checks connection
custom_components/eaton_ups_mqtt/config_flow.py - Home Assistant → Entry Setup: sets up entry
custom_components/eaton_ups_mqtt/__init__.py - Entry Setup → Certificate Handling: generates credentials
custom_components/eaton_ups_mqtt/__init__.py - Entry Setup → Certificate Enrolment: enrols client cert
custom_components/eaton_ups_mqtt/__init__.py - Certificate Enrolment → Certificate Handling: hashes certificate
custom_components/eaton_ups_mqtt/enrolment.py - Certificate Enrolment → UPS Certificate API: checks and uploads
custom_components/eaton_ups_mqtt/enrolment.py - Entry Setup → MQTT Client: creates connection
custom_components/eaton_ups_mqtt/__init__.py - MQTT Client → Eaton UPS MQTT Broker: connects and subscribes
custom_components/eaton_ups_mqtt/api.py - MQTT Client → Update Coordinator: sends update callbacks
custom_components/eaton_ups_mqtt/coordinator.py - Update Coordinator → MQTT Client: reads current data
custom_components/eaton_ups_mqtt/coordinator.py - Update Coordinator → Runtime Data: uses entry runtime
custom_components/eaton_ups_mqtt/coordinator.py - Entry Setup → Runtime Data: stores client and coordinator
custom_components/eaton_ups_mqtt/__init__.py - Measurement Sensors → Entity Base: extends base
custom_components/eaton_ups_mqtt/sensor.py - Status Sensors → Entity Base: extends base
custom_components/eaton_ups_mqtt/binary_sensor.py - Measurement Sensors → Update Coordinator: reads measurements
custom_components/eaton_ups_mqtt/sensor.py - Status Sensors → Update Coordinator: reads status data
custom_components/eaton_ups_mqtt/binary_sensor.py - Home Assistant → Diagnostics: requests diagnostics
custom_components/eaton_ups_mqtt/diagnostics.py - Diagnostics → Update Coordinator: reads coordinator state
custom_components/eaton_ups_mqtt/diagnostics.py - Update Coordinator → Home Assistant: publishes entity updates
custom_components/eaton_ups_mqtt/coordinator.py