Reverse-engineered documentation for local API on inverters built by Solax Power.
Manufacturer didn't want to provide documentation (and it would be mess, I can see why), but we (users) want to have cloud-free access to real-time data using existing APIs (for instance, to use in Home Assistant) and thus need a way to interpret the data anyway.
The route I took was to extract information from official Android application (version 0.4.5), which turns out is built with Apache Cordova and contains all the necessary logic in minified JavaScript.
This approach allows us to not guess what values mean what and to support all inverters that official app supports.
The information contained in this repository is the result of un-tangling that minified JavaScript and transforming into human-readable pseudo-code.
In order to get the data you'll need to make request to your inverter:
curl -d "?optType=ReadRealTimeData&pwd=PASSWORD" -X POST http://IP_ADDRESSPASSWORDis the password used for local access to the data in the app, it defaults to the serial number of the Pocket Wi-Fi (I don't have Pocket Lan, but it likely works the same way).IP_ADDRESSis the IP address of the inverter given by your router, something like192.168.1.105
Typical response from API looks something like this (X1-Hybrid G4):
{
"sn": "SV********",
"ver": "3.003.02",
"type": 15,
"Data": [ A LOT OF NUMBERS HERE ],
"Information": [ 5.000, 15, "H4************", 8, 1.30, 0.00, 1.28, 1.04, 0.00, 1]
}Inverter type is both contained in type field of the response and, apparently, in Information field as well.
At least this is true for most inverters.
These are the known inverter types based on https://github.com/squishykid/solax, please add yours in PR:
3- Solax Power X1-Hybrid G1, G2, G3
5- Solax Power X3-Hybrid G1, G2, G3
- PEIMAR NOCTIS PSI-X3
8- Solax Power X1-Smart
14- Solax Power X3-Hybrid G4
- Qcells Q.VOLT HYB-G3-3P
- PEIMAR NOCTIS PSI-X3S
15- Solax Power X1-Hybrid G4
- Qcells Q.VOLT HYB-G3-1P
- PEIMAR NOCTIS PSI-X1
Here is how they are named in the application's source code:
| Name | inverterType |
|---|---|
| x1hybridg3 | 3 |
| x1boostairmini | 4 |
| x3hybridg1 | 5 |
| x320k30k | 6 |
| x3mic | 7 |
| x1boostpro | 8 |
| x1ac | 9 |
| a1hybrid | 10,11,12 |
| j1ess | 13 |
| x3hybridg4 | 14 |
| x1hybridg4 | 15 |
| x3micprog2 | 16 |
| x1hybridsplitg4 | 17 |
| x1boostminig4 | 18,22 |
| a1hybridg2 | 19,20,21 |
| x1hybridg5 | 23 |
| x3hybridg5 | 24 |
| x3big | 100,101 |
| x1hybridlv | 102 |
There are a few key files listed below that contain mapping and pseudocode explaining usage or parsing algorithm. Only information in the source code of the app was used to derive mappings, there might be other meaningful fields that are not present in the app.
There might be bugs, for instance I didn't include main battery serial number parsing because it returns garbage on my inverter and I can't guarantee that it makes sense on any model (application doesn't show it despite containing code that parses it).
There are no promises whatsoever, so use this at your own risk.
Application also, naturally, contains code to control the inverter, but due to risks involved with changing those parameters, they are not (yet?) documented here. It would have been nice to automate things with Home Assistant though.
This file helps to get some high-level information about inverter and understand how to interpret the rest of the data
based on Information field of the response.
By knowing which inverter type it is, you can look into Data1.txt or Data2.txt for further details.
Seems to be older version of the API for some earlier inverter models, has generic mapping for all matching models and should be assumed to have many of the fields as optional since I was not able to deduce clear mapping between different models.
Seems to be modern version of the API, has clear mapping between inverter type and decoding rules.
The same parameter doesn't always occupy the same offset in Data field, hence more boilerplate would be necessary to
parse it.
Serial number can apparently be in either sn or SN fields of the response.
Serial numbers starting with "SC" and "SQ" appear to be related to EV chargers. Serial numbers starting with "SD" appear to be related to Adapter Box.
DataEvCharger.txt contains mapping to decode real-time data from such EV chargers.
Public Domain