I’m excited to share a new custom integration I’ve developed for Hoymiles Cloud, focusing specifically on HYT inverters with battery storage systems.
Why I created this
My primary motivation was the lack of existing integrations that could properly control battery settings for Hoymiles systems. While some monitoring solutions exist, none provided direct control over the battery operating modes and reserve SOC levels.
Additionally, I wanted a native Home Assistant integration rather than relying on MQTT bridges or external solutions. This provides a much cleaner setup with proper entities and services.
Key Features
Complete monitoring of your solar production, battery status, and energy flows
Full battery mode control - switch between:
Self-Consumption Mode
Economy Mode
Backup Mode
Off-Grid Mode
Peak Shaving Mode
Time of Use Mode
Specialized settings for each mode (e.g., reserve SOC, max SOC, meter power)
Battery Control Capabilities
The standout feature is the ability to control battery parameters that aren’t available in other integrations:
Change operating modes through a dropdown selector
Adjust reserve SOC for each operating mode
Configure Peak Shaving Mode parameters (max SOC, meter power)
Installation
You can install through HACS by adding my repository as a custom repository:
This is the first version focused on core functionality. It successfully reads data and controls all battery modes, but I’m still working on expanding the integration with more sensors and configuration options.
Contributions Welcome
The code was developed with AI assistance, so while functional, there’s room for improvement. I welcome any recommendations, bug reports, or contributions from the community!
Feedback
If you have a Hoymiles system, especially HYT inverters with batteries, please give it a try and let me know your thoughts. I’d love to know if it works for your setup or if you encounter any issues.
It’s definitely not perfect, but the main features are working well so far. I haven’t had a chance to test it with other manufacturers yet, but it’s been running smoothly.
Many thanks for sharing. I’m having a look at this now, as I have struggled to get my Hoymiles batteries to recognise my solar PV Arrays. I am using Shelly smart plugs to monitor the actuall production from two separate arrays (one smart plug for each) but there is no way to get the Hoymiles battery system to recognise the solar output. I might be able to simplify your use of the Hoymiles data with real time PV power date from the shelley smart plugs. It’s easier than having to deal with the complexity of 8 panels and four inverters!
Thanks again for sharing.
Do you need a special Hoymiles cloud account for this? My S-miles Home app credentials are not working, and the Hoymiles Cloud seems to require an ‘installer’ account. How did you guys manage to set this up?
I used the email associated with my account on Hoymiles cloud and it worked. When I put my username it didn’t work (usually I connect with username on Hoymiles cloud)
This integration is great ! However for people without batteries, it would be better to have a default setup without battery related sensors and devices. Or maybe have an option for the user to confirm if the setup has batteries or not ?
Thanks for this integration. Most things work great, but I’m having some issues with writing battery settings.
My setup:
Inverter: HYS-3.6LV-EUG1
Battery: Hoymiles 5.10 kWh
Station ID: 10413160
Reading works correctly:
Battery SOC is shown correctly.
Battery Mode Status updates correctly when I change the mode manually in the Hoymiles/S-Miles app.
Sensor values appear to update normally.
Writing does not work:
Changing Battery Mode from Home Assistant gives a green checkmark, but the mode does not actually change.
The Hoymiles app also still shows the old mode.
Log output:
Failed to set battery mode to Backup Mode (ID: 3)
Failed direct battery write for station 10413160 mode 3: DTO input error
Battery settings are not readable for station 10413160; writes are disabled
Are you familiar with this issue? Could this be related to the HYS-3.6LV-EUG1 firmware or a different API format for this model?
