{"id":39858942,"url":"https://github.com/faanskit/ha-esolar","last_synced_at":"2026-01-18T13:55:52.231Z","repository":{"id":64539698,"uuid":"573737078","full_name":"faanskit/ha-esolar","owner":"faanskit","description":"Custom Integration of SAJ eSOLAR","archived":false,"fork":false,"pushed_at":"2024-11-09T07:02:02.000Z","size":859,"stargazers_count":10,"open_issues_count":10,"forks_count":13,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-10-09T06:32:43.452Z","etag":null,"topics":["esolar","esolar-air","hacs","home-assistant","homeassistant","homeassistant-config","homeassistant-custom-component","homeassistant-integration","saj","saj-h1","saj-inverters","saj-r5","solar"],"latest_commit_sha":null,"homepage":"https://github.com/faanskit/ha-checkwatt","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/faanskit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2022-12-03T09:11:27.000Z","updated_at":"2025-05-05T05:00:28.000Z","dependencies_parsed_at":"2023-01-28T22:15:28.283Z","dependency_job_id":"8ba93f09-bd0b-406c-9479-036de45bb9eb","html_url":"https://github.com/faanskit/ha-esolar","commit_stats":{"total_commits":49,"total_committers":1,"mean_commits":49.0,"dds":0.0,"last_synced_commit":"46294cf448d714c5b30f1d7ade425aae34ed4e72"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/faanskit/ha-esolar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faanskit%2Fha-esolar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faanskit%2Fha-esolar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faanskit%2Fha-esolar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faanskit%2Fha-esolar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/faanskit","download_url":"https://codeload.github.com/faanskit/ha-esolar/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faanskit%2Fha-esolar/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28537436,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T13:04:05.990Z","status":"ssl_error","status_checked_at":"2026-01-18T13:01:44.092Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["esolar","esolar-air","hacs","home-assistant","homeassistant","homeassistant-config","homeassistant-custom-component","homeassistant-integration","saj","saj-h1","saj-inverters","saj-r5","solar"],"created_at":"2026-01-18T13:55:51.668Z","updated_at":"2026-01-18T13:55:52.220Z","avatar_url":"https://github.com/faanskit.png","language":"Python","funding_links":["https://www.paypal.me/faanskit/","https://www.buymeacoffee.com/faanskit","https://img.buymeacoffee.com/button-api/?text=Buy","https://paypal.me/faanskit"],"categories":[],"sub_categories":[],"readme":"[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=faanskit\u0026repository=ha-esolar\u0026category=integration)\n\n[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.me/faanskit/) [![Donate](https://img.shields.io/badge/Donate-BuyMeCoffe-green.svg)](https://www.buymeacoffee.com/faanskit)\n\n# Home Assistant SAJ eSolar Custom Integration\nThis integration uses cloud polling from the SAJ eSolar portal using a reverse engineered private API. \nThanks to [SAJ eSolar](https://github.com/djansen1987/SAJeSolar) for inspiration.\n\nThis integration today support SAJ R5 and SAJ H1. SAJ SEC has not yet been implemented mainly due to lack of access to a SEC system,\n\nThe focus on this integration is to reduce the amount of sensors published while at the same time maximize the information available and provide them as attributes. \n\nAs an example, the H1 Inverter Power sensor has 50 information elements (15 x 3 + 5) published as attributes. This is a bit against the nature of Home Assistant development, but given a system comprising two plants, one R5 and two H1 - the amount of sensors would easly be in the hundreds. Therefore, this integration aims to publish only what is relevant as sensors.\n\n![alt text](https://github.com/faanskit/ha-esolar/blob/main/images/attributes.png)\n\nThese attributes can be fetched by implementing a template sensor using jinja2. An example of that can be found in the advanced section below.\n\n# Installation\n### HACS\n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=faanskit\u0026repository=ha-esolar\u0026category=integration)\n\n### Manual\n- Copy directory `custom_components/saj_esolar_air` to your `\u003cconfig dir\u003e/custom_components` directory.\n- Restart Home-Assistant.\n\n## Enable the integration\nGo to Settings / Devices \u0026 Services / Integrations. Click **+ ADD INTERATION**\n\n![alt text](https://github.com/faanskit/ha-esolar/blob/main/images/setup_step_1.png)\n\nSearch for eSolar and click on it\n\n![alt text](https://github.com/faanskit/ha-esolar/blob/main/images/setup_step_2.png)\n\nEnter your SAJ eSolar username and password\n\n![alt text](https://github.com/faanskit/ha-esolar/blob/main/images/setup_step_3.png)\n\nIf you have more than one site, select which of the sites that shall be installed\n\n![alt text](https://github.com/faanskit/ha-esolar/blob/main/images/setup_step_4.png)\n\nFollowing a succesful installation, a device per plant will be created\n\n![alt text](https://github.com/faanskit/ha-esolar/blob/main/images/setup_step_5.png)\n\nYou can see that a number of devices and entites has been created at the SAJ eSolar integration\n\n![alt text](https://github.com/faanskit/ha-esolar/blob/main/images/setup_done_1.PNG)\n\nIf you click on the devices, you can see this also in the Devices section\n\n![alt text](https://github.com/faanskit/ha-esolar/blob/main/images/setup_done_2.png)\n\nYour home screen will now have a number of new entities depending on your system. A R5 system will have two sensors (Status and Energy) and a H1 System will have five sensors (Status, Sell Energy, Buy, Energy, Charge Energy, Discharge Energy)\n\n![alt text](https://github.com/faanskit/ha-esolar/blob/main/images/setup_done_3.png)\n\n## Configuration\nIf you need more sensor and more detailed attributes in the sensors, you can configure the integration as follows\n\nGo to Settings / Devices \u0026 Services / SAL eSolar. Click **CONFIGURE**.\n\nSelect if you want additional inverter sensors and if you want Photovoltaics and Grid attributes.\nTake note that the Photovoltaics and Grid attributes will pull additional data from the SAJ servers.\n\n![alt text](https://github.com/faanskit/ha-esolar/blob/main/images/configure_step_1.png)\n\nAfter the configuration is done you need to restart the integration. Click **...** and select **Reload**\n\n![alt text](https://github.com/faanskit/ha-esolar/blob/main/images/configure_step_2.png)\n\nThe system will now reload and add two-tre new sensors per inverter (Energy Total, Power and for H1 system Battery SoC)\n\n![alt text](https://github.com/faanskit/ha-esolar/blob/main/images/configure_step_3.png)\n\n## Final result\nWhen the system is fully set-up it can look something like this\n\n![alt text](https://github.com/faanskit/ha-esolar/blob/main/images/all_done.png)\n\n# Advanced\n### Creating a template sensor based on sensor attributes.\nThe below example will fetch the battery direction from the inverter energy total sensor and publish that as a new sensor\n```\ntemplate:\n  - sensor:\n      - name: \"Battery Direction\"\n        unique_id: inverter_ass111111111111111_energy_total_battery_direction\n        state: \u003e\n          {{state_attr('sensor.inverter_ass111111111111111_energy_total', 'Battery Direction')}}\n```\n# Donations\nI mainly did this project as a learning experience for myself and have no expectations from anyone.\n\nIf you like what have been done here and want to help I would recommend that you firstly look into supporting Home\nAssistant. \n\nYou can do this by purchasing some swag from their [store](https://teespring.com/stores/home-assistant-store)\nor paying for a Nabu Casa subscription. None of this could happen without them.\n\nAfter you have done that if you still feel this work has been valuable to you I welcome your support through BuyMeACoffee or Paypal.\n\n\u003ca href=\"https://www.buymeacoffee.com/faanskit\"\u003e\u003cimg src=\"https://img.buymeacoffee.com/button-api/?text=Buy me a coffee\u0026emoji=\u0026slug=faanskit\u0026button_colour=FFDD00\u0026font_colour=000000\u0026font_family=Poppins\u0026outline_colour=000000\u0026coffee_colour=ffffff\"\u003e\u003c/a\u003e [![Paypal](https://www.paypalobjects.com/digitalassets/c/website/marketing/apac/C2/logos-buttons/optimize/44_Yellow_PayPal_Pill_Button.png)](https://paypal.me/faanskit)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaanskit%2Fha-esolar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffaanskit%2Fha-esolar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaanskit%2Fha-esolar/lists"}