Skip to content

Home Assistant customcomponent for SunSpec modbus devices

License

Notifications You must be signed in to change notification settings

CJNE/ha-sunspec

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Aug 18, 2024
8ac104d · Aug 18, 2024
May 26, 2021
Aug 18, 2024
May 26, 2021
Aug 18, 2024
Aug 18, 2024
Jun 10, 2021
Aug 16, 2024
May 26, 2021
Sep 26, 2021
Aug 16, 2024
May 26, 2021
May 26, 2021
Apr 25, 2024
Sep 22, 2022
Jun 1, 2021
Aug 16, 2024
Feb 19, 2024
Apr 2, 2023

Repository files navigation

SunSpec

This custom component for home assistant will let you monitor any SunSpec Modbus compliant device, most commonly a solar inverter or energy meter. A list of compliant devices and manufacturers can be found on the sunspec website.

It will auto discover and create sensors depending on the available data of the device. By default only the most common sensors are created, there is an optional configuration that lets you control exactly what data to use.

Currenlty supports Modbus TCP connections. Modbus serial connection is planned.

Works out of the box with the energy dashboard.

GitHub Release GitHub Activity License

pre-commit Black

hacs Project Maintenance BuyMeCoffee

Discord Community Forum

This component will set up the following platforms.

Platform Description
sensor Show info from SunSpec API.

logo

HACS Installation

  1. Add and search for sunspec in HACS
  2. Install

Manual 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 sunspec.
  4. Download all the files from the custom_components/sunspec/ 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 "SunSpec"

Using your HA configuration directory (folder) as a starting point you should now also have this:

custom_components/sunspec/translations/en.json
custom_components/sunspec/__init__.py
custom_components/sunspec/api.py
custom_components/sunspec/config_flow.py
custom_components/sunspec/const.py
custom_components/sunspec/entity.py
custom_components/sunspec/manifest.json
custom_components/sunspec/sensor.py

Configuration is done in the UI

Contributions are welcome!

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

Credits

This project was generated from @oncleben31's Home Assistant Custom Component Cookiecutter template.

Code template was mainly taken from @Ludeeus's integration_blueprint template