Integrate SunSynk Account with Home Assistant

This tutorial shows you how to connect Home Assistant with your SunSynk cloud account using the SolarSynk Custom Add-On
Link to the SolarSynk Add-on github.com/mar...
Link to the slipx06-power-flow-card slipx06.github...
For any questions suggestions let me know in the comments.

[@tlamelomojaki6097]

Thanks a lot Martin...you are the problem solver...my sunsynk is now integrated into my HA...

[@manieschutte8570]

Thank you Martin. A few of us at work went from region 1 to region 2 yesterday with the Sunsynk region change and all our home assistant integrations for Sunsynk stopped working. Your integration saved us.

[@Mailmartinviljoen]

Hi Manie, glad to know it works for you. Just FYI since this video I had to migrate to a secondary version of this. you may want to use this repository instead github.com/martinville/solarsynkv2/ , The previous repository may have some bugs in it.

[@manieschutte8570]

Afternoon. There seem to be a problem when no power is used from the grid. The Grid Connected Status is set to '0' even though there is a voltage on the grid side. The amps is '0' and the wattage is '0', but voltage is 220V.

[@Mailmartinviljoen]

@@manieschutte8570 Hi Manie. The script in the addon is fetching the information as is from the sunsynk portal. When the grid is on the status is 1 and when it's off its Null. The script then converts Null to 0 for the sake of HA entity type. (Does not like null) Not sure why in your case the sunsynk portal would report null when the grid is still on. bit strange

[@manieschutte8570]

Afternoon. It is easy to simulate the scenario. Switch off grid feedback. When the solar supply is equal to the house usage the grid feed wattage drop to '0'. The Grid connect is then changed to '0' although the voltage is 220V and the frequency is 50Hz. I have changed my automations to look at voltage instead of Grid Connect value and that seem to work. I did add a notification for the grid connect value and it notifies a lot. If using the grid connect setting in automations, the automations trigger a lot. This never use to happen when I was on region 1. It is only region 2 that causes this. I suspect there is something wrong on region 2 from Sunsynk. Is there a way to contact their support?

[@perfoperfo9910]

forgot to mention. I did try both repositories with the same result... thanks ..

[@MarcelGa84]

This is really great. I have installed it and it was running smoothly in HA. Since a couple of days, HA does not recognize any entities anymore associated with my Sunsynk Inverter. The addon is working fine, the reading is done fine (as per log). Maybe due to a HA Core update? Anyone else having the same issue?

[@antonnagel7770]

Thank Martin In the log I can see the entities with values but no entities when trying to add to a dashboard Where did I go Wrong?

[@birdy6943]

Thanks for the awesome work! Just getting into home assistant and this helped a lot linking up my inverter setup. Just a small heads up that the slipx yaml doesn't work without alterations anymore like it does in the video. The name of the sensors include your inverter serial number within them now it seems. e.g. sensor.solarsynk_xxxxxxx_inverter_power

[@michaelt.2622]

Request: Please support also 3 and 4 strings, thanks a lot

[@KwakuOwusuAddai]

Thanks Martin for the plugin. Is there anyway I can get realtime data updates from the investor? I have set my refresh time to 60 seconds, but that's is still too long to wait when any change occurs.

[@etmorei]

First and foremost congratulations and thank you for such straighforward and clean integration! (Even thought Im struggling to make it working for me. ) Is it possible to add to verbose logging more details about when the connection is trying to be established with the API and whats the error message or others from their side? Once again, thank you

[@perfoperfo9910]

Everything seems to work ok up to a point. I can see data in the log file and it is updating but nothing in entities ? Am I missing a step ? thanks

[@user-yt2te5dt8e]

Hi Martin thanks for your video ,will these work with a deye? Thanks

[@user-rn1rx6qi5y]

Hi Martin, all worked well but not sure if I have my IP correct as I don’t have any entities?

[@rightclickgroup8434]

WOW AMZING THX! I want to put up Gauge showing total PV. Only find Entity PV and 2 seperate. Can it be done?

[@michael0kent]

Add-on looks fantastic! I run HA as a docker so am unable to access add-ons. Is there anyway this add-on could be developed into docker-compose so we can still get it to work with HA Docker?

[@AussieMike-y3o]

Same, that'd be really useful to be able to run this integration on Home Assistant Docker. Would happily donate a coffee

[@mystafa2]

Good day. I added an extension, as if everything connected to my SunsynkMobile_SM3.6kW, but there are no sensors in HA, but I get the values ​​in the log file. And an error occurs /run.sh: line 401: [: ==: unary operator expected

[@JasGawera]

Looks good, I've tried installing it, I'm getting this error in the log Entity does not exist! Manually create it for this inverter using the HA GUI in menu [Settings] -> [Devices & Services] -> [Helpers] tab -> [+ CREATE HELPER]. Choose [Text] and name it [solarsynk_XXXX_inverter_settings] Settings pushback system aborted. It looks like it has fetched the data though. Will create the entity as suggested but didn't see you having to do that in the video, so assume this is a bug? Is there a better place than youtube for discussing this addon?

[@Mailmartinviljoen]

Hi , nothing to worry about, the error you are getting is not critical. It just means that It cannot find the entity for sending settings back to the inverter. I have also not yet documented it. Its optional you don't have to create it and will not affect anything. The functionality that allows you to send data back was added after this video along with many other improvements. See the addon's change log. ;-) There is a discussion taking place here if it helps. powerforum.co.za/topic/24558-connect-home-assistant-with-sunsynk/ Cheers

[@JasGawera]

Excellent, it works. I used to have the node red flow to do it but it broke with the move to region 2 Will look at changing inverter settings after browsing the forum.

[@pretDewie]

Yster!

[@ubergeeksov]

Hi - great Add-on and great video explaining how to use it. I have one question though - it describes it as having multi inverter support. How can you add more than one inverter (I have 3). Successfully added one, but want to add the other two. Thanks, Rich

[@Mailmartinviljoen]

Hi , in the serial number field you put all the serials separated with a semi colon Example: Serial1;Serial2;Serial3 no spaces

[@ubergeeksov]

@@Mailmartinviljoen Hi Martin - thanks for that. However, I think I have a more basic problem as it does not appear to be working correctly. I have HA installed on a raspberry pi 4 with a dedicated HA install (latest version). I have your Solarsynk v.2.1.11. Install went well. I was region 2 until the merger. However, when I "start" the integration the "start" does not turn into a "stop"; the red dot does not turn to green and "Hostname", "CPU usage" and "RAM usage" do not appear on the control panel. There is, however, some communication with the inverter is clearly happening because I do received readings (such as battery charge percentage etc). However, it does not renew after the set time, and the log ends by saying "Entity does not exist!" etc. Are you able to help? I'm happy to post the full log to the Issues page on your GitHub page. Thanks, Richard

[@matimbasolutions2351]

Hi Martin, this helps alot, can you help to guide me how to get the Battery to show time remaining when the Grid is offline?

[@michaelcooper3028]

Hi Martin, Just found your video for setting up HA with SunSynk. Very easy to understand as I'm a novice to HA. The values are appearing in the log of your SolarSynkV2, but updating of the entities don't appear in the log and also when I look under devices and entities and search for "Solar" nothing appears. What have I missed / missing from HA. TIA Mike

[@Mailmartinviljoen]

Hi usually this is because its not able to actually send the values to the entities due to an invalid long live token. Perhaps re create the token and update the config with the new token ?

[@user-rn1rx6qi5y]

Hi Martin, all worked well but not fetching info from inverter, requesting verbose logging ? Any ideas ?

[@NicholasHaupt]

Another thing, is the data on the cards updated in near realtime? I compared the data from the sunsynk website for my inverter to the HA cards and there is a differecde/lag?

[@brianrozs3br]

Hi! Thanks for your efforts. I have installed the Solarsynk addon and have all the required entities. I copied and pasted in the slipx powerflow yaml into the card but it does not show any activity. Any suggestions, please?

[@Mailmartinviljoen]

Hi, there has been allot of changes to the addon since the video so the slipx mapping provided with the addon no longer works you have to manually map the entities. Also entities are now serialized so the is no way to provide a pre mapped config file. It wont take long to map them your self. HA has an auto complete search function and will help you to find the right entity.

[@brianrozs3br]

@@Mailmartinviljoen Thanks again - much appreciated.

[@jonnyfant8148]

Hi Martin. Thanks for this video tried to follow others with no luck - yours took 20 mins and worked fist time with your solarsynk2 solution. After they moved us in SA to Region 2 my HA Sunsynk integration died - thanks for your help. One problem I'm missing the Non-essential load Entity ... did i do something wrong - can I add it in. We running a power hungry kiln here and need to keep an eye on it.

[@Mailmartinviljoen]

Hi Jonny, Good to know it works. I dont recall adding a Non-essential load entities. I will have to take a look, Doubt that you are doing something wrong its probably not added. My system is very basic and I think my non-essential loads are simply bypassed on the DB by the electrician. Didn't even know it can be monitored. Is this done using a CT Clamp of some sorts or does it actually feed into the inverter and then internally bypassed to not run on batteries?

[@jonnyfant8148]

Thanks for your reply. Correct. In my installation the Non-essential load line is fed via the inverter but is turned off when CT clamp shows the grid is down. The inverter graphic display shows a value for the non-essential load as well as the "UPS" load separately ... so the data does exist. I see in the e-Linter documentation there is an address for Load 1 , Load 2 and Total Load ... not sure if it is relevant but that is as far as my understanding of these things takes me 😏. Nice if you can look into it but dont waste time on my account. Thanks.@@Mailmartinviljoen

[@jaunknoesen]

Hi Martin, I run home assistant core in docker and all my add ons run as separate containers, I do however have HACS running on it. Can I add your add on as a container and if so, how do I pull the data back into HA?

[@Mailmartinviljoen]

Hi, the addon is just a bash script. You could make minor modifications to it by hard coding the variables right at the top of the script. You don't even need to run it on the same hardware it can run on a totally different host because its posting data to HA entities using HA's Rest API. It also does not have any out of the ordinary dependencies. It just needs curl and jq which is a JSON parser/poster. You will see in the documentation I mentioned that you cannot point it to a local loop back in the addon's config. This is because the addon is actually running in a docker and it's communicating with HA as if its a totally different machine. My suggestion is take a look at run.sh in the repository to see how it works. github.com/martinville/solarsynkv2/

[@perfoperfo9910]

After trying all the suggestions and assistance I received on this you tube video I couldn't get it to work. A complete rebuild of home assistant from scratch fixed it though and it 's now working fine. I thought 'd come back and update in case anyone else found it useful. Not expecting a reply but does anyone know if this can be used with a rs485/modbus converter of ethernet I'd hope. This is mainly just due to the lag on the sunsynk platform makes the setup on here very very useful but very slow...

[@Mailmartinviljoen]

Hi I specifically developed this addon to integrate with the Sunsynk.net API. It does not have the ability to communicated via RS485. There are other solutions out there that can. A good place to start searching would be on the power forum powerforum.co.za/forum/121-home-automation/. You may want to have a look at the KellerZa solution github.com/kellerza/sunsynk. I'm unfortunately not able to assist with that. Regarding to the update frequency of the data. On the sunsynk portal you can set your gateway to update up to 60s instead of the default 300 seconds. Hence the reason I added the option to increase the update rate in this addon.

[@perfoperfo9910]

Thanks. I have reduced the update time to 60seconds and really for most users looking at data once in a while this will be ok. I have four inverters and solar arrays on site. Three sunsynk and one sunny boy with 40kwh battery storage. Tweaking things needs a much greater resolution than 60s but only whilst tweaking probably.. if you decide to make this modbus over Ethernet tcp at anytime please let me know as it is perfect other than the update time… cheers dude..

[@hardusnieuwoudt1164]

Hi Martim, thanks for the tutorial. I het this error and not sure why "Custom element doesn't exist: sunsynk-power-flow-card". Can you please advise

[@dysonman2009]

I am getting this too did u get this working

[@Mailmartinviljoen]

Hi. The sunsynk-power-flow-card is not a repository that I manage. Looks like you have something t hat is pointing to the power flow card that is not installed properly. Its maintained by SlipX You may find a solution here, Some people mention the same error, powerforum.co.za/topic/17970-home-assistant-sunsynk-power-flow-card-and-dashboard/

[@albertludick505]

Does this support writing setting changes back to the sunsynk app?

[@Mailmartinviljoen]

Settings are technically not written to the app. Its written to the cloud and the inverter then fetches the settings. Same with the App it reads and send settings to the cloud. Yes this addon does support sending settings to the inverter via the cloud.

[@Nemean90]

@@MailmartinviljoenHi Amy chance you could walk me through how to do this. I would love to set up some logic as to when to export and stuff but not sure how I send changes to the cloud.

[@mdeakin]

Hi. I have Sunsynk inverter going in today (AC coupled battery) and would like to integrate into Home Assistant and found this integration. Most of the integrations require RS485 modules but this appears to work with Sunsynk cloud direct. Out of interest, what is the delay between inverter > cloud > home assistant. Wondering if I can use it for 'real time' or just totals for the day.

[@Mailmartinviljoen]

Hi , Correct it connects to the SunSynk cloud, fetches the information then publishes it to Homeassitant entities. If you have a sunsynk admin account you can set the rate up to 1 minute and if you dont the default is 5 minutes.

[@mdeakin]

@@Mailmartinviljoen Added the addin and log shows values (which i think is good) but for some reason I can find the entities in HA. Any ideas what I should look for in the log or am I not looking for the entities correctly (searching for synk)

[@Mailmartinviljoen]

@@mdeakin not sure which log you are looking at but if you go to Settings->Devices & Services and then click the Entities Tab, from there search Synk then it they should show up prefixed with the inverter's serial number.. The entities are static and will be created once the addon sends the Inverter values so if you dont see them there's probably an issue with the config. Make sure the long lived token is correctly configured.

[@mdeakin]

@@Mailmartinviljoen I was looking at logs in Settings > Addons> SolarSynk > Log. I will have a play as I suspect I have put in the incorrect IP/Hostname. I used the external nabu casa url (I pay for the home assistant cloud service) and changed port to 443 (instead of default) and its come alive. Many thanks.

[@Mailmartinviljoen]

​@@mdeakin Have fun! 🙂

[@mutley247365]

Hi Dude, Thanks for this, But I seam to be having issues with the add on starting.

[@Mailmartinviljoen]

Hi when you start the add-on you can click on the log tab to see whats going on. The script is fairly simple so there shouldnt be any issues unless you entered the wrong credentials. After makimg this post i already started a v2 that supports multiple inverters so you can also try the new version github.com/martinville/solarsynkv2

[@mutley247365]

@@Mailmartinviljoen I seam to have it all up and running now, Thanks for the video dude

[@Mysterious_RSA]

what about multi inverter setups?

[@Mailmartinviljoen]

It supports multiple inverters

[@brookejonny]

Is it possible to change inverter settings via this integration (via Sunsynk dongle)? Thank you!

[@Mailmartinviljoen]

Hi. No its not possible.

[@Mailmartinviljoen]

Let me add by saying , not right now but its coming soon. ;-)

[@brookejonny]

​@@Mailmartinviljoenthat is very exciting 🤞🏼... Something that you have figured out, or is it something sunsynk is looking to roll out? 😁🎉

[@Mailmartinviljoen]

@@brookejonny Its always been possible via the sunsynk cloud, but not using this add-on. If your dongle is linked and setup with the sunsynk app you can change settings using the portal. sunsynk.net/ I have now added functionality to this add-on that will allow you to create automation in HA to change settings when certain conditions are met. I realize now I may have misunderstood you, this addon does not do any direct comms with the inverter via the dongle its merely piggybacking off the Sunsynk.Net API.

[@brookejonny]

​@@MailmartinviljoenHi, thanks for explaining. So I'm able to change settings via the sunsynk link that you sent, but I got excited at the thought of being able to create automations via the Sunsynk API or Sunsynk dongle? I know it won't respond as quickly as some of the other home assistant integrations but if possible it would avoid the need of any wiring which would be amazing?!

[@wernerbotes4261]

Hi Martin having an issue with the app I start the app it fetches the data then the service stops and the app stops completely. Updating the following sensor entities ------------------------------------------------------------------------------ s6-rc: info: service legacy-services: stopping s6-rc: info: service legacy-services successfully stopped s6-rc: info: service legacy-cont-init: stopping s6-rc: info: service legacy-cont-init successfully stopped s6-rc: info: service fix-attrs: stopping s6-rc: info: service fix-attrs successfully stopped s6-rc: info: service s6rc-oneshot-runner: stopping s6-rc: info: service s6rc-oneshot-runner successfully stopped

[@Mailmartinviljoen]

Hi Werner, Unfortunatley your log doesnt say much. It seems like its not even getting past fetching the Sunsynk token. The only thing I can think of is the configuration is not filled in properly. Also not if you still have a "Region 1" account it will most probably not work.

[@wernerbotes4261]

@@Mailmartinviljoen Thx for the reply it pulls all the data from the portal Inverter information voltages. Is there a place where I can sent you the complete log

[@Mailmartinviljoen]

Welcome to send it to [e-mail]

[@xkalib3r]

@@MailmartinviljoenAwesome integration, thank you! I am however having the same issue as @wernerbotes4261. From the little bit of digging I have done, I am wondering if this has to do with the fact that my (possibly our) HA's are configured with https?

[@Mailmartinviljoen]

@@xkalib3r are you using port 8123 or a non standard port by any chance ? My HA is using HTTPS over 8123.

[@Tristao]

Hi Martin I'm not sure what happened to my previous comment, but the log instructed me: "Entity does not exist! Manually create it for this inverter using the HA GUI in menu [Settings] -> [Devices & Services] -> [Helpers] tab -> [+ CREATE HELPER]. Choose [Text] and name it [solarsynk_210...." which I did, and now get the following log: Helper entity input_text.solarsynk_210xxxxxxx_inverter_settings has no value. Therefore no inverter setting will be sent for change. Please help.

[@Mailmartinviljoen]

Hi this is not an error. It just means it doesn't have any settings to send to the inverter.

[@NicholasHaupt]

Hi. thanks SO MUCH for this. It is exactly the solution I have been looking for... I do have a question if you don't mind : the data feed works for about 3 minutes and and then suddenly stops with this error log (any help you can give me)? /run.sh: line 152: [: ==: unary operator expected jq: error: Could not open file pvindata.json: No such file or directory /run.sh: line 153: [: ==: unary operator expected jq: error: Could not open file pvindata.json: No such file or directory /run.sh: line 154: [: ==: unary operator expected jq: error: Could not open file pvindata.json: No such file or directory /run.sh: line 155: [: ==: unary operator expected jq: error: Could not open file pvindata.json: No such file or directory /run.sh: line 156: [: ==: unary operator expected jq: error: Could not open file pvindata.json: No such file or directory /run.sh: line 157: [: ==: unary operator expected jq: error: Could not open file inverterinfo.json: No such file or directory /run.sh: line 158: [: ==: unary operator expected jq: error: Could not open file dcactemp.json: No such file or directory jq: error: Could not open file dcactemp.json: No such file or directory

[@olivermcdermott]

Same issue here

[@NicholasHaupt]

new release last night. Seems to work better