Hoymiles for Home Assistant

This Home Assistant custom component utilizes the hoymiles-wifi Python library, allowing seamless integration with Hoymiles HMS microinverters via Hoymiles DTUs and the HMS-XXXXW-2T microinverters.

Disclaimer: This custom component is an independent project and is not affiliated with Hoymiles. It has been developed to provide Home Assistant users with tools for interacting with Hoymiles HMS-XXXXW-2T series micro-inverters featuring integrated WiFi DTU. Any trademarks or product names mentioned are the property of their respective owners.

Supported Devices

The custom component was successfully tested with:

• Hoymiles HMS-800W-2T
• Hoymiles DTU Wlite

Warning

Please refrain from using the current power limitation feature for zero feed-in, as it may lead to damaging the inverter due to excessive writes to the EEPROM.

Installation

1. Open the HACS panel in your Home Assistant frontend.

2. Navigate to the "Integrations" tab.

3. Click the three dots in the top-right corner and select "Custom Repositories."

4. Add a new custom repository:

   • URL: https://github.com/suaveolent/ha-hoymiles-wifi
   • Category: Integration

5. Click "Add"

6. Click on the Hoymiles integration.

7. Click "DOWNLOAD"

8. Navigate to "Settings" - "Devices & Services"

9. Click "ADD INTEGRATION" and select the Hoymiles integration.

Option 2: Manual Installation

1. Download the contents of this repository as a ZIP file.
2. Extract the ZIP file.
3. Copy the entire custom_components/hoymiles-wifi directory to your Home Assistant
4. Install the python requirements
5. Restart your Home Assistant instance to apply the changes.

Configuration

Configuration is done in the UI

Caution

Use this custom component responsibly and be aware of potential risks. There are no guarantees provided, and any misuse or incorrect implementation may result in undesirable outcomes. Ensure that your inverter is not compromised during communication.

Known Limitations

Update Frequency: The library may experience limitations in fetching updates, potentially around twice per minute. The inverter firmware may enforce a mandatory wait period of approximately 30 seconds between requests.

Compatibility: While developed for the HMS-800W-2T inverter, compatibility with other inverters from the series is untested at the time of writing. Exercise caution and conduct thorough testing if using with different inverter models.

Attribution

This project was generated from @oncleben31's Home Assistant Custom Component Cookiecutter template.