New integration in development, Solax cloud

Development
1

Just to get it out there:

Currently im working on an integration for Solax inverters to pull data from the cloud.
My work is ready to be released for beta user:
See my repositories here:
API wrapper:

Integration:

Development step are:
Get is into hacs, use it there for a while, get feed back, update, get it as an offical HA integration.

There are still some open points for the integration, help is welcome.
Currently the integration is tested with a Solax X3 hybrid inverter, so more inverter types are welcome.

Frank,

1 Like
2

I’d love to help you test this integration! Could you please share some instructions to get started?

Thanks!

3

@frank8the9tank Just tried installing the integration through HACS and got the following error:
Config-flow kon niet geladen worden: {"message":"Invalid handler specified"}

4

I have made 2 small changes, can you redownload the integration trough hacs?

image

5

That is much better!

Screenshot 2024-07-04 at 21.15.57
Screenshot 2024-07-04 at 21.15.57718Ă—502 11.3 KB

Next step for me is to figure out where exactly you can acquire an API-token.
On the cloud portal (Solax Cloud System) I don’t see any API-related sections. I’ll contact the installer to see if they need to give me more access in the portal.
I’ll keep you posted!

6

usage:

  1. Use the PocketLAN or PocketWiFi serial number, NOT the inverter serial number.
  2. Obtain Token from the Solax Cloud website
    Old interface:
    Service → API → API: Real-time display → TokenID
    New interface:
    Support → Third-party ecology → API: Real-Time Display → TokenID
1 Like
7

Hi Frank

I have installed the integration but not sure what I need to do to get the API wrapper installed? I am assuming the integration does not work without the API wrapper installed somehow?

8

You only need to download the integration and place it in the custom component folder.
Restart HA, when you add the integration to HA it will download the dependencies automatically. (The api wrapper is only the source for the PyPI binary)

9

Hi @frank8the9tank please are there some steps needed to be able to use integration sensors in Energy dashboard? Do I need to setup some helpers, e.g. with Utility meter? Thanks

10

I have checked a couple of things. but it looks like the entities don’t have the correct “arguments/categories” for it to show up in the energy dashboard as a selectable entities. So it probably has to do with my code. when i have some time i will try to fix it.
in the mean time i think adding some helpers should fix this.

11

Thank you for implementing this integration.
Regarding the Energy dashboard. Could it be, that the Attribute “state_class” is missing for sensor.yield_total and sensor.yield_today?

12

@frank8the9tank Many thanks for this integration have been on the lookout for this for a while and will follow this development with great interest.

Setting up worked fine according to your instructions - I get values for some sensors, but quite a few remain “unknown”.

For information I have a X3-Hybrid-G1/G2 inverter with battery

13

Using it for a while now and works great for 4 Solax X1 micro 2in1 inverters.
Before I used an self made REST integration, but I had some problems with the API’s limitations
I hope the development continues and you can integrate this in the core repository.

14

Hi Frank, it worked!!! I am super happy. Now I will star testing it!

Super cool this!

15

I have a X3-hybrid-G4. I have the same. Some of the sensors are working and quite a number of them are empty/unknown.

16

Hi Frank, I am using your integration. Of all the entities which appeared I am using just 4-5 of them but it’s enough to operate the full HA energy dashboard.

One thing to keep in mind that power is expressed in W or kW. Energy is the integral of power and is expressed in kWh (in general).

So in your list with entities of your otherwise amazing integration (compared to the others I have tried) in one case it says feedin energy but is expressed in W.

17

I’ve got this running with two solax-x3-FTH inverters.
Works Great!!!

I’ve no battery so only a few data outputs have info available from Solaxcloud.
Each inverter gives the output and its own yield for the day and total for all time.
The master inverter (solax1 usually!) gives the net grid input/output. Input into the meter from the grid is negative.
It doesn’t give the net power used, which can be calculated from export amount and the solar generated, but I have a separate meter reading this and reporting via modbus.
There are 50 entities but only about 6-7 had data available.

Data updates are a bit steady at 5mins but workable.
Add the command to load in the pip script using the terminal add-on in HA.
Download the repository in HACS and then add the integration in the Settings and set up each inverter - has same API code but a different device registration ID for each wifi dongle.

All the login info is on solaxcloud web portal if you’re logged into that… and you must be otherwise you wouldn’t be trying this…
Left hand menu of Service->third party ecosystem
And for the Device ID pick the registration number for the wifi controllers for each inverter (not the inverter ID!)