This is my first trial of HA integration, so the HACS install instructions below are not working or might not work!

Kaco 3.7NX Inverter Integration for Home Assistant

A custom integration for Home Assistant to read and monitor data from Kaco 3.7NX inverters. This integration allows you to seamlessly integrate your Kaco inverter into your smart home setup, providing real-time insights and control.

This integration was inspired by Kolja Windeler's Kaco integeration.

Table of Contents

• Kaco 3.7NX Inverter Integration for Home Assistant
  • Table of Contents
  • Features:
  • Requirements
  • Installation
    • Installing via HACS
    • Manual Installation
  • Configuration
    • Setup Steps
      • Steps to Add the Integration
  • Usage
  • Screenshots
    • Main Logo
    • Setup Form
    • Device Page
  • External Links
  • Troubleshooting
  • Contributing

Features:

• Local network: Doesn't require internet connection, all readings are made in the local network.
• Combined Device: Uses the MAC address (if provided) for the device id, which enable Home Assistant to combine the device with other devices provided by other integrations using MAC address i.e. Router, in my case UDMPRO gateway.
• Real-Time Monitoring: Track the performance and status of your Kaco 3.7NX inverter.
• Multiple Inverters Support: Easily integrate and monitor multiple inverters.
• Network Integration: Combine with other networked devices like Unifi Network for enhanced functionality.
• User-Friendly Setup: Simple installation and configuration process via HACS.

Requirements

• Home Assistant Core: Version 2023.9 or higher.
• HACS: Home Assistant Community Store must be installed.
• Kaco 3.7NX Inverter: Connected to the same network as Home Assistant.

Installation

Installing via HACS

note "Getting this into HACS is still Work-In-Progress"

1. **Ensure HACS is Installed**: If you haven't installed HACS yet, follow the [HACS installation guide](https://hacs.xyz/docs/installation/prerequisites).
2. **Add Repository**:
   - Navigate to **HACS** in Home Assistant.
   - Click on **Integrations**.
   - Click the **+** button in the bottom right corner.
   - Search for "Kaco 3.7NX" and select it.
3. **Install the Integration**:
   - Click **Install**.
   - After installation, restart Home Assistant to apply changes.

Manual Installation

1. Download the Repository:
   • Clone or download the repository from GitHub.
2. Copy to Custom Components:
   • Place the kaco_ folder into the custom_components directory of your Home Assistant configuration.
3. Restart Home Assistant:
   • Restart Home Assistant to recognize the new integration.
4. Add the integration:
   • Add the integration and follow the setup wizard.

Configuration

Setup Steps

Important:

• Inverter Availability: Ensure at least one Kaco inverter is functioning and connected to the network, preferably during daylight hours.
• MAC Address Requirement: To have the inverter's page in Home Assistant show the inverter's data and sensors from other integrations in addition to this in the same device page (e.g., Unifi Network), you must enter the inverter's MAC address during setup.

Steps to Add the Integration

1. Access Integrations:

   • Go to Settings > Devices & Services in Home Assistant.

2. Add Integration:

   • Click on Add Integration.
   • Search for "Kaco 3.7NX" and select it.

3. Configure the Inverter:

   • Follow the on-screen prompts to enter necessary details, including the MAC address if combining with other integrations.

   • Refer to the setup form for guidance:

     

4. Finalize Setup:

   • Once configured, the inverter device will appear in your devices list:

     

Usage

After successful installation and configuration, the integration will create various sensors and entities that reflect the inverter's performance metrics. You can:

• Add to Dashboards: Display inverter data on your Home Assistant dashboards.
• Create Automations: Use inverter data to trigger automations, such as adjusting energy consumption based on solar production.
• Monitor Performance: Keep track of energy generation, consumption, and other vital statistics in real-time.

Screenshots

Main Logo

Setup Form

Device Page

External Links

• Kaco Inverters Page: BluePlanet 30 NX1-M2 50 NX1-M2
• Inverter Image: View Image

Troubleshooting

• Inverter Not Detected:
  • Ensure the inverter is powered on and connected to the network.
  • Verify that the MAC address entered is correct.
• Integration Fails to Install via HACS:
  • Check your HACS configuration and ensure it's up to date.
  • Restart Home Assistant and try installing again.
• No Data Displayed:
  • Confirm that the inverter is operational and generating data.
  • Check Home Assistant logs for any error messages related to the integration.

Contributing

Contributions are welcome! Whether it's reporting issues, suggesting features, or submitting pull requests, your input helps improve the integration.

1. Fork the Repository: Click the Fork button at the top right of this repository.
2. Create a Feature Branch:

   git checkout -b feature/YourFeature