Home Assistant Add-ons Repository

This repository contains a collection of Home Assistant add-ons for monitoring and data collection from various home automation and energy systems.

Overview

This repository hosts Home Assistant add-ons that focus on:

• Energy Monitoring: Solar inverter data collection and HVAC system monitoring
• Reliability: Automatic reconnection and error handling
• MQTT Integration: Integration with Home Assistant via MQTT
• Logging: Monitoring and debugging capabilities

Available Add-ons

🌡️ ComfortZone CE 50 Logger

A Home Assistant add-on that monitors a ComfortZone CE 50 heat pump system via an ESP8266 bridge.

Features:

• Real-time heat pump monitoring (temperatures, compressor status, alarms)
• Connects to ESP8266 running EasyESP via Telnet
• Publishes JSON data to MQTT
• Automatic timeout detection and reconnection (2-minute timeout)

Data Monitored:

• Room and hot water temperatures (instantaneous and average)
• Evaporator and return temperatures
• Compressor status and frequency
• Heating element status (3 supplementary elements)
• System alarms (inverter, pressure, filter, defrost)
• Fan voltage and operational parameters

📁 Location: /comfortzone
📖 Documentation: ComfortZone README

---

☀️ Solis WIFI Stick Scraper

A Home Assistant add-on that scrapes production data from Solis solar inverters and publishes it to MQTT.

Features:

• Real-time solar production monitoring
• Scrapes local Solis inverter web interface (status.html)
• HTTP Basic Authentication support
• Automatic offline detection and recovery
• Retry logic with exponential backoff

Data Collected:

• Current power production (watts)
• Daily energy production (kWh)
• Total lifetime energy production (kWh)

📁 Location: /solis
📖 Documentation: Solis README

Common Features

Both add-ons share an architecture with:

🛡️ Reliability & Error Handling

• Automatic Reconnection: Retry logic for connection failures
• Timeout Detection: Monitors data flow and triggers recovery
• Exponential Backoff: Retry timing to avoid overwhelming systems
• Graceful Shutdown: Cleanup of resources and connections

📊 Monitoring & Debugging

• Logging: Structured logging with multiple levels (INFO, WARNING, ERROR, DEBUG)
• Configuration Validation: Validates required parameters before startup
• Connection Monitoring: Real-time status of connections
• Error Recovery: Multiple layers of error detection and recovery

🏗️ Architecture

• Class-based Design: Object-oriented architecture for maintainability
• Type Hints: Type annotations for better code quality
• Separation of Concerns: Clean separation of configuration, connections, and data processing
• Signal Handling: Handling of shutdown signals

🔌 Home Assistant Integration

• MQTT Publishing: Data published to configurable MQTT topics
• Auto-Discovery Ready: MQTT topics structured for Home Assistant integration
• Real-time Updates: Regular polling with error handling
• Multi-Architecture Support: Works on various hardware platforms (ARM, x86)

Installation

1. Add Repository: Add this repository to your Home Assistant Supervisor
2. Install Add-on: Choose and install the desired add-on from the Supervisor
3. Configure: Set up MQTT and device-specific settings
4. Start: Enable and start the add-on

Configuration

Both add-ons require:

• MQTT Broker: Address, credentials, and topic configuration
• Device Access: Network access to the monitored device
• Authentication: Credentials for device access (where applicable)

See individual add-on documentation for specific configuration details.

Version History

• ComfortZone Logger: Currently v0.0.6 with socket-based telnet implementation
• Solis Scraper: Currently v0.0.6 with enhanced HTTP scraping and error handling

Both add-ons have been enhanced with error handling, automatic reconnection, and logging capabilities.

Support & Troubleshooting

Each add-on includes:

• Documentation: Setup guides, configuration examples, and troubleshooting
• Example Configurations: Configuration templates
• Logging: Debug information for identifying and resolving issues
• Error Recovery: Automatic recovery from common failure scenarios

For specific issues, refer to the individual add-on documentation and logs.

Contributing

This repository focuses on reliable, production-ready Home Assistant add-ons for energy and HVAC monitoring. All add-ons follow consistent patterns for:

• Error handling and recovery
• Configuration management
• Logging and monitoring
• MQTT integration
• Documentation standards

License

Please refer to individual add-on licenses as applicable.