apsystems_power_local

Home Assistant custom component used to scrape the value of Solar Generated Today: from an APSystems ECU's local web interface (http://{local_ip}/index.php/realtimedata/power_graph).

ECU-R (SunSpec logo/ECU-ID starting with 2162xxxxxxxx)

Make sure that your APSystems ECU-R has this web page visible on your network.

This custom component is currently working on my HA system:

Core              2024.2.3
Supervisor        2024.02.0
Operating System  11.5
Frontend          20240207.1

Manual Installation:

Copy the apsystems_power_local folder into the Custom Compenents folder of you HA instance.

/homeassistant/custom_components/apsystems_power_local

The foler apsystems_power_local should contain the files:

custom_components/
│
└─── apsystems_power_local/
    │   __init__.py
    |   config_flow.py
    │   manifest.json
    │   sensor.py
    │   const.py

HACS Installation Instructions

To manually add this repository to HACS and install the component:

1. Open HACS in Home Assistant.
2. Navigate to "Integrations" section.
3. In the top right corner, click on the three dots and select "Custom repositories".
4. In the dialog that appears, paste the URL of this repository (https://github.com/imonlinux/apsystems_power_local) into the 'Repository' field.
5. Select 'Integration' as the category.
6. Click 'Add'.
7. The component should now appear in the HACS integrations list. Search for "APSystems Power Local" and select it.
8. Click on "Install" to install the component.

Once installed, you can proceed with the configuration steps as outlined in this README.

Configuration

After installation, you need to configure the component:

1. Navigate the the Add Integration page in Settings/Devices & Services.
2. Click Add Integration button at the bottom of the page.
3. Search for APSystems Power Local.
4. Select APSystems Power Local from the list.

5. In the entry form enter the local IP address of your APSystems ECU and click Submit.

Restart Home Assistant.

Usage

To add the APSystems Power entity to the Energy Dashboard for solar energy monitoring, follow these steps:

1. Ensure that the apsystems_power_local component is correctly installed and configured.
2. Navigate to the Energy Dashboard in your Home Assistant interface.
3. Click on 'Settings' in the top right corner of the Energy Dashboard.
4. Under 'Solar Panels', select 'Add Solar Production'.
5. From the list of available entities, choose the APSystems Power entity.
6. Follow the prompts to configure and add the entity to your Energy Dashboard.
7. Once added, your Energy Dashboard will display solar energy production data from your APSystems device.

Your Energy Dashboard should look like this:

Troubleshooting and Support

For common issues and their resolutions, visit this link. To report issues or seek support, please use the issue tracker.

Contributing

Contributions to this project are welcome! To contribute, please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Submit a pull request.

Changelog

For information about the latest changes and updates, refer to the changelog.

ToDo:

Change the sensor state class to total_increasing.

Implement requirements for installation via HACS

Implement the custom component to allow configuration of the sensor from the UI.

Add the option to stop polling the website after sunset and then start at sunrise.