Skip to content
View in the app

A better way to browse. Learn more.

Power Forum - Renewable Energy Discussion

A full-screen app on your home screen with push notifications, badges and more.

To install this app on iOS and iPadOS
  1. Tap the Share icon in Safari
  2. Scroll the menu and tap Add to Home Screen.
  3. Tap Add in the top-right corner.
To install this app on Android
  1. Tap the 3-dot menu (⋮) in the top-right corner of the browser.
  2. Tap Add to Home screen or Install app.
  3. Confirm by tapping Install.

Connect Home Assistant with Sunsynk

Featured Replies

  • 3 months later...
  • Replies 97
  • Views 26.6k
  • Created
  • Last Reply

Top Posters In This Topic

Most Popular Posts

  • MartinViljoen
    MartinViljoen

    I made a major change to this add-on which resulted to a change in the entity names. Therefore I copied it over to a new repository and versioned it v2. The new version supports multiple inverters.

  • MartinViljoen
    MartinViljoen

    Update 2.1.8 now available. https://github.com/martinville/solarsynkv2 This update lets you send  inverter settings back to your inverter via HA -> SunsynkCloud -> Your inverter If you st

  • Giving it a go quickly. Worked well and recommend for someone not wanting to go through the whole node red process.

Posted Images

  • Author
On 2025/06/07 at 9:06 PM, JanKotze said:

Hi @MartinViljoen

Any news on the latest build in Python? Our system got commissioned today and I was hoping to connect it with HA with the new add-on.

Hi There.

Yes its been running for quite some time already --> https://github.com/martinville/solarsynkv3

Also fully supports sending system mode and battery settings.

  • 3 weeks later...

Hi everybody, first of all, thank you for the time and effort to get SolarSynk running on Home Assistant. I've been using it successfully for some time. I do have a one noob question though, currently I am getting a lot of variables/entities from my inverter, but I am not seeing my Monthly Cumulative PV values. (i.e. how much power was generated by my solar panels, month to date).

I am sure it is available, but I can't seem to find it.

(Basically, I have month to date battery discharge, grid power in for month to date etc, but missing the PV month to date)

  • 2 months later...
  • Author
4 hours ago, DoubleP said:

Hi Martin

Noticed my v2 addon stopped giving any data back and have just installed the v3 addon, but its giving authentication problems with api.sunsynk.net even though I can log into https://api.sunsynk.net with same credentials.
image.png

v2 just logs this
image.png

Not sure if anyone else is having the same issue

Thanks in advance

Hi.

Yes there was an issue earlier on. Looks like Sunsynk is preparing to use a more secure authentication method. Both new and old Auth method is now working again. I suspect that soon the old method will be phased out.

FYI when that happens the v2 integration will most probably stop. I don't maintain the repository anymore. V3 on the other hand has already been adapted to the new Auth method. Once the old methos is phased out the new end point will most probably take the place of the original which will again cause a hiccup in V3, but it will be a super quick fix.

Hi,

Are there instructions on how to install v3?

I didn't see any here.

GitHub
No image preview

GitHub - martinville/solarsynkv3: Integrate your Sunsynk...

Integrate your Sunsynk account with Home Assistant for real-time solar energy monitoring. Track power generation, battery storage, and grid usage while enabling smart automations and custom alerts....

Google's answer:
To install solarsynkv3 for Sunsynk inverters on Home Assistant, you need to add the martinville/solarsynkv3 custom integration repository to HACS, install the integration, and then configure it using your Sunsynk account credentials and Home Assistant details. First, get your Sunsynk Connect username and password, find your Sunsynk Device ID from the app, and note the IP address and port of your Home Assistant instance. Next, add the repository to Home Assistant's HACS, install the integration, and finally, add the integration under your Home Assistant's Settings > Devices & Services. 

My question, does anyone have the entities mapped to the slipx6 solar power card fields?

thanks

Firstly, sorry to semi-hijack this thread, but it seems likely to be the most relevant to what I'm trying to achieve!

I'm UK-based, Easee EV charger, Sunsynk solar set up and HA running on a Raspberry Pi 5.

I'm essentially trying to do three )I think simple...!) things:

1) I want HA to monitor the output of my Easee charger so that when it's charging my car, it pulls solely from the grid, changing the SOC of the batteries, protecting the stored battery power. I'm on a smart tariff with my energy provider and as long as I allow the charger to smart charge when the grid deems fit, it's cheap. I've managed to install the Easee add-on through HACS and have linked my portal account. This now shows the charger activity on my dashboard. (Halfway there...maybe!?)

2) My wife works from home and when she does, more power is used during the day. I'd like to have a button that changes the battery SOC to it lowest possible setting (20%) in order that we aren't pulling from the grid at expensive times. Likewise a button to reverse this.

3) I've seen the amazing cards that have been created showing the energy flow. In an ideal world this would be displayed alongside the aforementioned "Working from home" button, which would make it clear if it's solar or grid that's being used. I currently have no need to store any data for stats or long-term monitoring and am limited my the SD card in the pi for that purpose anyway.

This forum is the most useful source I've found so far, but there's so much information, it's tough to know where to start or if what I want to do is even achievable!

I'll await confirmation of the plethora of errors I've inevitably made!

Thanks.

23 hours ago, solazzz said:

Google's answer:
To install solarsynkv3 for Sunsynk inverters on Home Assistant, you need to add the martinville/solarsynkv3 custom integration repository to HACS, install the integration, and then configure it using your Sunsynk account credentials and Home Assistant details. First, get your Sunsynk Connect username and password, find your Sunsynk Device ID from the app, and note the IP address and port of your Home Assistant instance. Next, add the repository to Home Assistant's HACS, install the integration, and finally, add the integration under your Home Assistant's Settings > Devices & Services. 

My question, does anyone have the entities mapped to the slipx6 solar power card fields?

thanks

Thanks,

Google was not quite right - this is an Add-on, not an integration. (I'm still not clear what the distinction is)

But yes, the add-on repository needs adding to Home assistant, then install and configure with your sunsynk username and password, and an access token (I used the same one from the old version).

Then I noticed in the logs that it wants me to create a helper for settings, so followed those instructions.

I then stopped the old v2 add-on

Probably a HA issue, but the friendly name for the old and new entities are the same. I was trying to use the History view to see if it was getting data. It shows me two entities called "Battery SOC", but no way to see the actual entity ID to see which is from v2 and which is from v3

Hopefully the v2 ones will disappear after some time/reboots?

Hmm, I've just realised where the instructions are:

Not here:

https://github.com/martinville/solarsynkv3

But here

https://github.com/martinville/solarsynkv3/blob/main/DOCS.md

  • Author

On 2025/09/05 at 9:34 AM, solazzz said:

Google's answer:
To install solarsynkv3 for Sunsynk inverters on Home Assistant, you need to add the martinville/solarsynkv3 custom integration repository to HACS, install the integration, and then configure it using your Sunsynk account credentials and Home Assistant details. First, get your Sunsynk Connect username and password, find your Sunsynk Device ID from the app, and note the IP address and port of your Home Assistant instance. Next, add the repository to Home Assistant's HACS, install the integration, and finally, add the integration under your Home Assistant's Settings > Devices & Services. 

My question, does anyone have the entities mapped to the slipx6 solar power card fields?

thanks

An Addon is a docker. Almost like a VM but not quite. ;-)
You dont need hacs, you simply add the repository, refresh you list of addons and install from your addon-store.

I stopped mapping entities between the addon and the slipx card. Reason is simple, too much work to maintain it. 😁
Besides its not possible to provide a direct copy and paste without intervention due to the serial number mentioned in the entity.

With regards to old entities. Make sure the entities are no longer updated by stopping the addon. then give the system a full reboot.
Make sure addon is not set to auto start else it will appear as if they were not removed because it will repopulate the entities after reboot. (Best to un install the addon)

Thanks, yes I've removed the old addon, all seems to be fine. Thanks

As for the distinction between Add-on and integration. It is more from the Home Assistant POV, what is the difference.

To my mind Octopus, Hive etc are doing a similar job to SolarSynk - talking to some cloud API and updating entities etc.
Yours is an add-on and others are integrations. I'm just curious why there are two mechanisms for doing seemingly similar jobs, and what the pros and cons of each are.

Anyway, thanks for the hard work you've put in to this!

  • 1 month later...

HI,

I'm very new to HA and am currently trying to set up this awesome V3!

I've managed to get it to log in with my cloud details, but when it runs, the log gives out this message:

Inverter Settings fetch complete

All API calls completed successfully!

Checking if settings can be processed and flushed...

URL --> http://supervisor/core/api/states/input_text.solarsynkv3_********_settings

Error: Failed to connect to Home Assistant Settings via API. Status code: 404. Settings will not be processed and flushed out.

Script completion time: 2025-10-23 13:42:07.525495

Script execution completed.

All Done! Waiting 60 seconds to rinse and repeat.

Like I say, I'm really new to all this and I'm not sure where to start with trying to fix this...!

Thanks.

  • Author
On 2025/10/23 at 3:11 PM, PaMan said:

HI,

I'm very new to HA and am currently trying to set up this awesome V3!

I've managed to get it to log in with my cloud details, but when it runs, the log gives out this message:

Inverter Settings fetch complete

All API calls completed successfully!

Checking if settings can be processed and flushed...

URL --> http://supervisor/core/api/states/input_text.solarsynkv3_********_settings

Error: Failed to connect to Home Assistant Settings via API. Status code: 404. Settings will not be processed and flushed out.

Script completion time: 2025-10-23 13:42:07.525495

Script execution completed.

All Done! Waiting 60 seconds to rinse and repeat.

Like I say, I'm really new to all this and I'm not sure where to start with trying to fix this...!

Thanks.

Go to Settings --> Devices and services -- Helpers Tab
Create new helper, select "Text" as the type and call it solarsynkv3_********_settings be sure to replace the redacted text with your inverter serial.

Entities created via the API are static and unmanageable, therefore it requires you to manual create it.

  • 3 weeks later...

Hi @MartinViljoen not sure if this was discussed already but I get No Permission errors. Is this due to SunSynk auth?

See log below:

------------------------------------------------------------------------------

-- Running Script SolarSynkV3

-- Using API Endpoint: api.sunsynk.net

-- https://github.com/martinville/solarsynkv3

------------------------------------------------------------------------------

Sunsynk Login: Success

Getting ****************** @ 2025-11-23 07:22:39.681922

Script refresh rate set to: 300 milliseconds

Cleaning cache...

Testing HA API

HA Entity: sensor.solarsynkv3_test_connection_test_current: 100 A OK

Connection Success

Fetching Inverter Information...

Fetching PV Data...

Fetching Grid Data...

Fetching Battery Data...

Fetching Load Data...

Fetching Output Data...

Fetching DC & AC Temperature Data...

Fetching Inverter Settings...

PV data fetch response: No Permissions

Output data fetch response: No Permissions

Grid data fetch response: No Permissions

Battery data fetch response: No Permissions

Inverter fetch response: No Permissions

PV data fetch response: No Permissions

Inverter data fetch response: No Permissions

Load data fetch response: No Permissions

All API calls completed successfully!

Checking if settings can be processed and flushed...

URL --> http://supervisor/core/api/states/input_text.solarsynkv3_***********_settings

URL exists (Status code: 200) Settings may be processed and flushed.

Settings fetch response: No Permissions

Traceback (most recent call last):

File "/main.py", line 159, in <module>

settingsmanager.GetNewSettingsFromHAEntity(BearerToken, str(serialitem))

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

File "/settingsmanager.py", line 92, in GetNewSettingsFromHAEntity

print(ConsoleColor.WARNING + BuildLocalBatterySettings() + ConsoleColor.ENDC)

^^^^^^^^^^^^^^^^^^^^^^^^^^^

File "/settingsmanager.py", line 329, in BuildLocalBatterySettings

with open(source_file, 'r') as src:

^^^^^^^^^^^^^^^^^^^^^^

FileNotFoundError: [Errno 2] No such file or directory: 'svr_settings.json'

All Done! Waiting 300 seconds to rinse and repeat.

Hi

Anyone experiencing issues with integration connectivity to the cloud API? From last night?

Values not updating but sunsynk app is correct.

Login error, failed to retrieve bearer token. Running v3

On 2025/09/02 at 6:43 PM, MartinViljoen said:

Hi.

Yes there was an issue earlier on. Looks like Sunsynk is preparing to use a more secure authentication method. Both new and old Auth method is now working again. I suspect that soon the old method will be phased out.

FYI when that happens the v2 integration will most probably stop. I don't maintain the repository anymore. V3 on the other hand has already been adapted to the new Auth method. Once the old methos is phased out the new end point will most probably take the place of the original which will again cause a hiccup in V3, but it will be a super quick fix.

Just checking if the above reported issue is linked to this and what change is needed in V3 to fix?

Thanks for support.

3 hours ago, Dharmesh said:

Just checking if the above reported issue is linked to this and what change is needed in V3 to fix?

Thanks for support.

All sorted. Fix with new version released. Awesome...

On another issue, the logs show the following error:

Error: Unable to connect to Home Assistant Settings via the API HTTP Error: 404. Settings will not be processed or applied. Please create a text entity manually named:....

I don't intend writing back settings to the inverter. Should I worry about above or just leave.?

  • Author

There was an issue with the Addon today , SunSynk enhanced their security and the addon had to be adapted.

https://github.com/martinville/solarsynkv3/issues/48#issuecomment-3576239133

45 minutes ago, Dharmesh said:

On another issue, the logs show the following error:

Error: Unable to connect to Home Assistant Settings via the API HTTP Error: 404. Settings will not be processed or applied. Please create a text entity manually named:....

I don't intend writing back settings to the inverter. Should I worry about above or just leave.?

If you wont write settings back , You can just ignore the message it wont do any harm. But if it bothers you just create the Helper entity.

  • 5 months later...

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Reply to this topic...

Account

Navigation

Search

Search

Configure browser push notifications

Chrome (Android)
  1. Tap the lock icon next to the address bar.
  2. Tap Permissions → Notifications.
  3. Adjust your preference.
Chrome (Desktop)
  1. Click the padlock icon in the address bar.
  2. Select Site settings.
  3. Find Notifications and adjust your preference.