This Home Assistant custom component utilizes the hoymiles-wifi Python library, allowing seamless integration with Hoymiles HMS microinverters, specifically designed for the HMS-XXXXW-2T series.
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.
The custom component was successfully tested with:
- Hoymiles HMS-800W-2T
- Hoymiles DTU WLite
-
Open the HACS panel in your Home Assistant frontend.
-
Navigate to the "Integrations" tab.
-
Click the three dots in the top-right corner and select "Custom Repositories."
-
Add a new custom repository:
- URL:
https://github.com/suaveolent/ha-hoymiles-wifi
- Category: Integration
- URL:
-
Click "Add"
-
Click on the
Hoymiles HMS-XXXXW-2T
integration. -
Click "DOWNLOAD"
-
Navigate to "Settings" - "Devices & Services"
-
Click "ADD INTEGRATION" and select the
Hoymiles HMS-XXXXW-2T
integration.
- Download the contents of this repository as a ZIP file.
- Extract the ZIP file.
- Copy the entire
custom_components/hoymiles-wifi
directory to your Home Assistant - Install the python requirements
- Restart your Home Assistant instance to apply the changes.
Configuration is done in the UI
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.
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.
This project was generated from @oncleben31's Home Assistant Custom Component Cookiecutter template.