QuickApp - Solax Monitor

[SmartHomeEddy 735]

This QuickApp monitors your Solax managed Solar Panels

The QuickApp has (child) devices for Solarpower/m², Today production, Total production, Total Power to Grid, Total Energy to Grid, Energy from Grid, Total Power/m², Battery Energy, AC Power R, AC Power S, AC Power T, Battery Power, Power DC1, Power DC2, Power DC3 and Power DC4
The rateType interface of child device Today Energy is automatically set to "production"
The readings from the child device Today Energy will be shown in the new energy panel 
The readings from the child device Total Energy is automatically set to the right Wh unit (Wh, kWh, MWh or GWh) 

 

Please login or register to see this attachment.

 

See API documentation on

Please login or register to see this link.

User can get a specific range of information through the granted tokenID. Please obtain your tokenID on the API page of Solaxcloud for free.
The tokenID can be used to obtain real-time data of your inverter system. The obtain frequency need to be lower than 10 times/min and 10,000 times/day.

 

Please login or register to see this attachment.

 

Version 3.0 (19th February 2023)

• Changed the descriptions of the Solax Cloud values
• Converted the feedinpower value from positive to negative or from negative to positive
• Added translation for English, Dutch and Portugese
• Added child device for consumeenergy

Version 2.1 (4th December 2022)

• Prevented almost empty responses like these: {"success":false,"exception":"Query success!","result":"this sn did not access!"}
• Added log text to main device if no data from Solax Cloud 

Version 2.0 (16th April 2022)

• Added Child Devices for feedinpower, feedinenergy, consumeenergy, feedinpowerM2, soc, peps1, peps2, peps3, batPower, powerdc1, powerdc2, powerdc3, powerdc4
• Added all values returned from the Solax Cloud to the labels
• Changed all the device types to the most current ones
• Changed the handling of bad responses from the Solax Cloud
• Replaced null values in responses with 0.0
• Optimized some code

Version 1.0 (17th November 2021)

• Tested, ready for release

Version 0.2 (15th November 2021)

• Changed json response

Version 0.1 (13th November 2021)

• First (test) version

 

Variables (mandatory): 

• tokenId = token ID of your Solax Inverter, obtain your tokenID on the API page of Solaxcloud for free
• inverterSN = Unique identifier (Serial No.) of your Solax inverter
• solarM2 = The amount of m2 Solar Panels (use . for decimals) for calculating Solar Power m² (default = 0)
• interval = The default is 300 seconds (5 minutes), the daily API limitation is maximum 10 times/min and 10,000 times/day
• debugLevel = Number (1=some, 2=few, 3=all, 4=simulation mode) (default = 1)

Please login or register to see this image.

/monthly_2021_11/solax_icon_transp.png.f9c734692fbdaca53d5e05ad76976073.png" />

 

API items: Description (Accuracy) (Unit)

• inverterSN: Unique identifier of inverter (Serial No.)
• sn: Unique identifier of communication module (Registration No.)
• acpower: Inverter.AC.power.total (1) (W)
• yieldtoday: Inverter.AC.energy.out.daily (0.1) (KWh)
• yieldtotal: Inverter.AC.energy.out.total (0.1) (KWh)
• feedinpower: Grid.power.total (1) (W)
• feedinenergy: Grid.energy.toGrid.total (0.01) (KWh)
• consumeenergy: Grid.energy.fromGrid.total (0.01) (KWh)
• feedinpowerM2: Inverter.Meter2.AC.power.total (1) (W)
• soc: inverter.DC.battery.energy.SOC (1) (%)
• peps1: Inverter.AC.EPS.power.R (1) (W)
• peps2: Inverter.AC.EPS.power.S (1) (W)
• peps3: Inverter.AC.EPS.power.T (1) (W)
• inverterType: Inverter type, details refer to Table 4 in appendix
• inverterStatus: Inverter status, details refer to Table 5 in appendix
• uploadTime: Update time (format 2016-10-26 17:33:01)
• batPower: Inverter.DC.Battery.power.total (1) (W)
• powerdc1: Inverter.DC.PV.power.MPPT1 (1) (W)
• powerdc2: Inverter.DC.PV.power.MPPT2 (1) (W)
• powerdc3: Inverter.DC.PV.power.MPPT3 (1) (W)
• powerdc4: Inverter.DC.PV.power.MPPT4 (1) (W)

 

Download the QuickApp here (download the file and un-zip):

Please login or register to see this link.

or from the Fibaro Marketplace: 

Please login or register to see this link.

 

How to install: 

1. Open the Configuration Interface
2. Go to Settings > Devices
3. Click  +
4. Choose Other Device
5. Choose Upload File
6. Choose file from your computer with .fqa

 

 

 

 

 

Edited February 19 by SmartHomeEddy

[SmartHomeEddy 735]

Enjoy this new Solax Monitor for your Solax managed solar panels. Thanks for testing @Mats

[messiah.rs 5]

hi, its possible add batery capacity soc:
its possible add solar panel power powerdc1, powerdc2.

i need if will be batery on more 80% i can run more device (for example, climatization)

if will be bathery low than 40 % turn off any hight voltage use device (climatization, washmashine, cooking)

much more information for energy neutral houses

 

i use qubino 3f-meter. information acpower, yieldtoday, yieldtotal have in qubino.

thx soo much

[SmartHomeEddy 735]

Hi @messiah.rs

 

The Solax Cloud returns this these values:

 

Please login or register to see this attachment.

 

Do you mean the value from the API item “soc” ?

 

[messiah.rs 5]

10. link - inventer.DC.battery.energy.SOC

Please login or register to see this code.

[messiah.rs 5]

i obtain this info. i need have offline any device if will be batpower in negative (house is powered on battery, if capacity will be down off more device.
if will be higest "soc":50  (battery have energy), "batPower": +1500 (1,5kw go to battery and i can use 1kw on washmashine, or another hight power consuption device).

Or can use powerDC1,2,3,4: for information how much have now solar energy for redistribution

 

My girlfriend ignore sun and cant wait on 9am (on sun have 2kw free) and turn on washmashine with 2kw power on 8 am and battery kill on 10% and start use global energy. around 1Pm have battery on 100% and i stop use solar energy  

 

 

[SmartHomeEddy 735]

Looks like you get more values from the Solax Cloud than the API documentation shows, because you have batteries. 
 

This extra part: ,"batPower":-355.0,"powerdc1":0.0,"powerdc2":213.0,"powerdc3":null,"powerdc4":null}}

[messiah.rs 5]

Please login or register to see this link.

i have values in official API document

i have third generation. Now its sell 4th generation .... maybe every new version can give more information

Edited April 16, 2022 by messiah.rs

[SmartHomeEddy 735]

Thanks @messiah.rs

 

I made some changes, it now looks like this with all the values in the labels:

 

Please login or register to see this image.

/monthly_2022_04/image.png.a33f823624c86b73b7f985f1901b4db0.png" />

 

I can add Child Devices for all other values, but first I want to know if the labels and units are the right one?

 

 

[messiah.rs 5]

its perfect maybe total energy can be in kWh. i think this value in code have change units automatic.

[SmartHomeEddy 735]

7 minutes ago, messiah.rs said:

its perfect maybe total energy can be in kWh. i think this value in code have change units automatic.

 

Thanks. It changes indeed automatically, but the calculation was wrong, also of the todays energy. 

 

 

 

I don't know yet what the AC Power R, S and T are and when the Power DC1, 2, 3, and 4 are returned. 

 

 

[messiah.rs 5]

if i report API in web browser and refresch screen more than cca 5x on 1 minute, than obtan 60 second ban for next refresh. i test how much times can obtain information. My installer solar system say about standart report on 300s. cant find any value for faster refresh. test looking on him again.

[SmartHomeEddy 735]

The maximum obtain frequency is 10 times/min and 10,000 times/day.

[messiah.rs 5]

My solax app report 1x for 300s.  If will be have data 1x or 2x per minute it best for any automatization. Soo much report its not good, than can block system. 

[SmartHomeEddy 735]

With all the new child devices, it will look like this:

 

Please login or register to see this attachment.

[messiah.rs 5]

wery nice. where can download?

[SmartHomeEddy 735]

The new version is available for download. I don't have a Solax Inverter, so can only test in simulation mode. Please let me know if all works.

 

Please login or register to see this attachment.

 

Version 2.0 (16th April 2022)

• Added Child Devices for feedinpower, feedinenergy, consumeenergy, feedinpowerM2, soc, peps1, peps2, peps3, batPower, powerdc1, powerdc2, powerdc3, powerdc4
• Added all values returned from the Solax Cloud to the labels
• Changed all the device types to the most current ones
• Changed the handling of bad responses from the Solax Cloud
• Replaced null values in responses with 0.0
• Optimized some code

Because of the big changes, you have to install a new QuickApp and disable or delete the old one. 

 

 

 

[messiah.rs 5]

hmm, i now dont see any version

Please login or register to see this attachment.

[SmartHomeEddy 735]

In the first post above in this subject. 

[messiah.rs 5]

instaled, worked. will be tested, soo much thx

Please login or register to see this attachment.

[SmartHomeEddy 735]

Looks good ?
 

(If you fill in the QuickApp variabel solarM2 with the amount of m2 Solar Panels you have (use . for decimals), the Solar Power m² will also be calculated.)