austinmroczek / neovolta

NeoVolta integration for Home Assistant

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

NeoVolta

GitHub Release GitHub Activity License

hacs Project Maintenance

Discord Community Forum

Integration to integrate NeoVolta solar home batteries with Home Assistant.

This is a work in progress

You are likely to encounter errors and missing functionality.

So far this integration has only been tested on one battery in one configuration.

Battery Network Tested
NV14 Wired Yes
NV14 Wifi No
NV24 Wired No
NV24 Wifi No

Please report issues.

Platforms

This integration will set up the following platforms. While many of the measurements are clearly of a particular type (voltage, frequency, etc) we do not have a full mapping to specific items shown in the Solarman app, so some items are named "TBD" or "Voltage1" until we know what they are.

Platform Type Description
sensor Battery Current percentage of overall battery, or battery pack that is available.
sensor Total Energy Various measurements of total energy in kiloWatt hours.
sensor Frequency Frequency in Hertz
sensor Voltage Current voltage of various components.

Installation

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

Configuration is done in the UI

Contributions are welcome!

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


About

NeoVolta integration for Home Assistant

License:MIT License


Languages

Language:Python 99.3%Language:Shell 0.7%