Must inverter integration for Home Assistant

The Home Assistant Must Solar Inverter Plugin is a custom integration that adds support for monitoring and controlling Must solar inverters within the Home Assistant platform. This plugin enables you to retrieve real-time data, such as power production, battery status, and more, directly from your Must solar inverter.

Features

• Real-time Monitoring: View live data from your Must solar inverter, including power production, battery status, and other relevant information.
• Integration with Home Assistant: Seamlessly integrate Must solar inverter data into your Home Assistant setup.
• Control Functionality: Control certain aspects of your Must solar inverter directly through Home Assistant.

Supported Devices

This integration is tested using a Must Solar PV18-3024 VPM (aka PV1800). However, it should work with other models that use the same communication protocol, such as the PH1800 and EP1800 series.

This integration will have the wrong min and max range for writable voltages when using it with 12v or 48v inverters (mostly because my model is 24v and I don't own other models to reverse engineer). If you see some values that don't make sense for your inverter, please open an issue or a pull request.

Disclaimer

This integration is not officially supported by Must Solar, I'm not affiliated with Must Solar in any way. This integration is based on reverse engineering the communication protocol used by the Must Solar inverters and by resources found online. Use it at your own risk.

[!CAUTION] There are some modbus registers that cannot be reversed to their original value after being written and can have a huge effect on the inverter operation, such as the calibration coefficients (these entities are disabled by default). This integration DOES NOT write any information to the device via modbus unless you manually change an entity value.

Installation

HACS (Home Assistant Community Store)

If you have HACS just search for Must Inverter and install it from there. Or alternatively, click here.

Manual Installation

1. Download the latest release from the GitHub repository.
2. Extract the downloaded archive.
3. Copy the custom_components/must_inverter directory to your Home Assistant config directory.
4. Restart Home Assistant.

After a correct installation, your configuration directory should look like this:

    └── ...
    └── configuration.yaml
    └── secrets.yaml
    └── custom_components
        └── must_inverter
            └── __init__.py
            └── config_flow.py
            └── const.py
            └── ...

Usage

1. Open the Home Assistant UI.
2. Navigate to "Configuration" -> "Integrations."
3. Click the "+" button to add a new integration.
4. Search for "Must Inverter" and select it.
5. Enter the required configuration for your serial setup (USB, TCP, or UDP).

Support and Contributions

For bug reports, feature requests, or general questions, please create an issue on the GitHub repository.

Contributions are welcome! Feel free to fork the repository, make changes, and submit a pull request.

Acknowledgments

This plugin would not have been possible without the valuable contributions of the following individuals and their projects on reversing engineering the Must solar inverter:

• https://github.com/aquarat/must_inverter
• https://github.com/dylangmiles/docker-must-homeassistant
• https://github.com/thelabexpedition67/MustInverterDataHandler

Their efforts have paved the way for the development of this Home Assistant integration.

License

This project is licensed under the MIT License - see the LICENSE file for details.