Subscription of real-time data
The real-time data of the device can be subscribed by using the MQTT protocol.
- The details of real-time information can be queried through
Appendix - Real-time Data of Inverter
&Appendix-Smart Device Realtime Data
. - The data will be pushed at a frequency of 1 minute/package.
✨ Demonstration account
Demo Account | # |
---|---|
Protocol | mqtt:// |
Account | openapi@gmail.com |
Password | openapi4test |
Client ID | af5bac1a-b1cf-931a-6902-f622cab51f9c |
Remote Address | mqtt.solinteg-cloud.com |
Remote Port | 7783 |
Topic | /acGmtzpqJCKk |
Test through MQTTX)
Breakpoint resume
Feature Overview
When the inverter encounters a network failure and the Breakpoint resume feature is enabled on the device side, the inverter will store real-time data locally. The inverter can store up to 14 days of data. Once the limit is exceeded, the oldest data will be continuously deleted to maintain a rolling 14-day storage. When the inverter regains network access and reconnects to the server, the locally stored data will be uploaded to the cloud.
Prerequistes
- Ensure that the Breakpoint resume switch is enabled on the inverter.
- The Resumable Data Push service of Solinteg OpenAPI must be enabled for your account. Please contact your account manager to submit a request.
Usage Instructions
- When the above conditions are met, your Topic will receive resumable data pushed by Solinteg OpenAPI. The data format is almost identical to the real-time operational data from the device, except that resumeType = 1 (under normal circumstances, this value is 0).
- You can directly insert the data into your database based on the rtcTime field in the payload.
- Currently, this feature is only supported by inverters.
Data format
Inverter Data
{
"metric": {
"backupAf": 232.7,
"backupAi": 0.3,
"backupAp": 0.068,
"backupAv": 232,
"backupBf": 49.99,
"backupBi": 0.5,
"backupBp": 0.065,
"backupBv": "--",
"backupCf": 49.99,
"backupCi": 0.3,
"backupCp": 0.07,
"backupCv": 233.5,
"batteryI": 0,
"batteryP": 0,
"batteryStatus": 0,
"batteryV": 401.7,
"bmsPackTemperature": 37,
"busVoltage": 744.5,
"creationDate": "2024-08-22 07:40:07 +0000",
"eBatteryChargeDaily": 54.3,
"eBatteryDischargeDaily": 50.1,
"eBuyDay": 0,
"eDay": "--",
"eInverterUseDay": 54.8,
"eLoadUpDay": 0,
"eMeterTotalBuy": 0,
"eMeterTotalSell": 0,
"eSellDay": 0,
"eTotal": "--",
"eTotalBatteryCharge": 22984.5,
"eTotalBatteryDischarge": 21648.8,
"eTotalInverterUse": 23176.2,
"eTotalLoadUplink": 0,
"eTotalPv": 0,
"epvDay": 0,
"fGrid": 49.99,
"faultArmFlag1": 4,
"faultArmFlag2": 0,
"faultFlag1": 0,
"faultFlag2": 0,
"faultFlag3": 0,
"iChargingLimit": 0,
"iDischargeLimit": 160,
"iGridPhaseA": 1.8,
"iGridPhaseB": 1.8,
"iGridPhaseC": 1.7,
"invtAp": 0.349,
"invtBp": 0.381,
"invtCp": 0.347,
"ipv1": 0.1,
"ipv10": "--",
"ipv2": 0.2,
"ipv3": 0.1,
"ipv4": 0.2,
"ipv5": 2000,
"ipv6": 2000,
"ipv7": "--",
"ipv8": "--",
"ipv9": "--",
"masterSn": "--",
"maxCellVoltage": 3.383,
"meterStatus": 0,
"minCellVoltage": 3.327,
"pLoad": 0,
"pMeterPhaseA": 0,
"pMeterPhaseB": 0,
"pMeterPhaseC": 0,
"pMeterTotal": 0,
"pac": 0.026,
"ppvInput": 0,
"rtcTime": "--",
"soc": 100,
"soh": "91.6",
"temperature1": 33.2,
"temperature2": "33.9",
"temperature3": "34.0",
"temperature4": "33.4",
"timeTotal": 6269,
"totalBackupP": "--",
"vGridAb": 405.4,
"vGridBc": 406.4,
"vGridCa": 406.4,
"vGridPhaseA": 234.5,
"vGridPhaseB": 234.2,
"vGridPhaseC": 234.6,
"vpv1": 0,
"vpv10": "--",
"vpv2": 0,
"vpv3": 0,
"vpv4": 0,
"vpv5": 4045,
"vpv6": 2000,
"vpv7": "--",
"vpv8": "--",
"vpv9": "--",
"workStatus": 2,
"workStatus2": 0
},
"tag": {
"sn": "A112300100932038",
"modelType": "MHT-40K-100"
},
"resumeType": 0,
"timestamp": 1724312407474
}
Smart Device Realtime Data
{
"metric": {
"activePowerA": null,
"activePowerB": null,
"activePowerC": null,
"creationDate": "2024-10-21 03:31:48 +0000",
"freA": null,
"freB": null,
"freC": null,
"iac1": null,
"iac2": null,
"iac3": null,
"invSn": "A1M230008333100B",
"modelType": "RMK-MA(3P)",
"pfA": null,
"pfB": null,
"pfC": null,
"rsved60330": null,
"rsved60340": null,
"rtcTime": "2024-10-21 11:31:48",
"totalActivePower": null,
"totalBuyElectricity": null,
"totalLoadPower": null,
"totalSoldElectricity": null,
"vab": null,
"vac1": null,
"vac2": null,
"vac3": null,
"vbc": null,
"vca": null
},
"modelType": "RMK-MA(3P)",
"sn": "A1M230008333100B",
"timestamp": 1729481508520
}