Skip to content

SMA ennexOS (Data Manager M and Sunny Tripower X) integration for Home Assistant

License

Notifications You must be signed in to change notification settings

shadow578/homeassistant_sma-ennexos

Repository files navigation

SMA ennexOS for Homeassistant

GitHub Release codecov License Project Maintenance

Integration to integrate with SMA ennexOS devices.

Supported Devices

This integration should work with all SMA ennexOS devices. These devices are known to be compatible.

Installation

HACS (recommended)

  1. Add https://github.com/shadow578/homeassistant_sma-ennexos as a custom repository, choose Integration as Category and add.
  2. In the HACS UI, search for SMA ennexOS and install it.
  3. Restart Home Assistant
  4. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "SMA ennexOS"

Manual

  1. Using the tool of choice open the directory for your HA configuration (where you find configuration.yaml).
  2. If you do not have a custom_components directory there, you need to create it.
  3. In the custom_components directory create a new folder called sma_ennexos.
  4. Download all the files from the custom_components/sma_ennexos/ directory in this repository.
  5. Place the files you downloaded in the new directory you created.
  6. Restart Home Assistant
  7. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "SMA ennexOS"

Configuration

Configuration is done using the UI. You'll be prompted to enter the IP and credentials to the SMA ennexOS Device. After the initial setup, all detected devices will be added to Home Assistant.

Tip

To Improve reliability, using the installer password is recommended. Using the login to the ennexOS Portal works too, but may be less stable as it requires the ennexOS device to maintain a cloud connection.

For most devices, there will be unknown sensors named something like Measurement.***, which are disabled by default. Those sensors display measurements that are not yet known to the integration, but can be enabled if you know what they are. Refer to the "Instantaneous Values" section of the ennexOS web portal to find out what they are.

Additionally, feel free to open an issue or PR with the information so it can be added to the integration. That way, the values are displayed more nicely, include a unit. Also, everyone can benefit from new measurement channels being added.

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines

Notice

This integration is not affiliated with SMA Solar Technology AG in any way. Use at your own risk.

The SMA, SMA ennexOS, SMA Data Manager and SMA Sunny Tripower X names and logos are trademarks of SMA Solar Technology AG.


About

SMA ennexOS (Data Manager M and Sunny Tripower X) integration for Home Assistant

Topics

Resources

License

Stars

Watchers

Forks