Interface to get basic information of GroBoost
<p><strong>A brief description:</strong> </p>
<p>-Interface to get basic information of GroBoost
-<code>Only applicable to devices whose device type is 11 returned in the 3.3 interface.</code></p>
<p><strong>Request URL:</strong>
-<code>http(s)://test.growatt.com/v1/device/boost/boost_data_info</code></p>
<p><strong>How to request:</strong>
-get</p>
<p><strong>Parameter:</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">Parameter name</th>
<th style="text-align: left;">Is it required</th>
<th style="text-align: left;">Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">device_sn</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">String</td>
<td>Boost Device SN</td>
</tr>
</tbody>
</table>
<p><strong>Return example</strong></p>
<pre><code>{
"device_sn": "GRO2020102",
"dataloggerSn": "NACTEST128",
"data": {
"treeName": "GRO_BOOST#84",
"lost": false,
"location": "",
"treeID": "OD_NACTEST128_69_addr84",
"lastUpdateTime": {
"time": 1620718391000,
"minutes": 33,
"seconds": 11,
"hours": 15,
"month": 4,
"year": 121,
"timezoneOffset": -480,
"day": 2,
"date": 11
},
"deviceSn": "GRO2020102",
"children": [],
"raillog": 0,
"timezone": 0,
"level": 4,
"deviceName": "GRO_BOOST",
"deviceType": "WIFI_METER",
"imgPath": "./css/img/status_green.gif",
"dataLogSn": "NACTEST128",
"prMonth": 0,
"boxData": null,
"key": "NACTEST128_69_addr84",
"boostData": {
"fwVersion": "",
"bfreq": 0,
"bonOff": 0,
"addr": 0,
"cloadNormalPower": 0,
"bppv": 0,
"temperature": 0,
"aminTemp": 0,
"cipv": 0,
"powerFactor": 0,
"loadPriority": 0,
"totalNumber": 0,
"btotalEnergy": 0,
"power": 0,
"serialNum": "",
"rs485BaudRate": 0,
"cppv": 0,
"status": 0,
"atotalEnergy": 0,
"cminTemp": 0,
"bmaxTemp": 0,
"ctime": "",
"bminTemp": 0,
"cfreq": 0,
"sysTime": "",
"appv": 0,
"targetPower": 0,
"voltage": 0,
"dryContactStatus": 0,
"temp": 0,
"dpower": 0,
"aipv": 0,
"minTime": 0,
"avpv": 0,
"dtotalEnergy": 0,
"loadDeviceType": 0,
"btemp": 0,
"atime": "",
"afreq": 0,
"ajobsModel": 0,
"bipv": 0,
"rfCommand": "",
"astartPower": 0,
"rs485Addr": 0,
"version": "",
"tuningState": 0,
"asetPower": 0,
"waterState": 0,
"totalEneny": 0,
"ctotalEnergy": 0,
"deviceType": "",
"dryContactTime": "",
"current": 0,
"withTime": false,
"cmaxTemp": 0,
"timeText": "2021-05-11 15:39:48",
"bloadNormalPower": 0,
"dataLogSn": "",
"amaxTemp": 0,
"calendar": {
"minimalDaysInFirstWeek": 1,
"weekYear": 2021,
"time": {
"time": 1620718788781,
"minutes": 39,
"seconds": 48,
"hours": 15,
"month": 4,
"year": 121,
"timezoneOffset": -480,
"day": 2,
"date": 11
},
"weeksInWeekYear": 52,
"gregorianChange": {
"time": -12219292800000,
"minutes": 0,
"seconds": 0,
"hours": 8,
"month": 9,
"year": -318,
"timezoneOffset": -480,
"day": 5,
"date": 15
},
"timeZone": {
"lastRuleInstance": null,
"rawOffset": 28800000,
"DSTSavings": 0,
"dirty": false,
"ID": "Asia/Shanghai",
"displayName": "China Standard Time"
},
"timeInMillis": 1620718788781,
"lenient": true,
"firstDayOfWeek": 1,
"weekDateSupported": true
},
"restart": 0,
"rfPair": 0,
"resetFactory": 0,
"btime": "",
"aloadNormalPower": 0,
"bvpv": 0,
"atemp": 0,
"v9420Status": 0,
"maxTemp": 0,
"cstartPower": 0,
"waterHeaterPower": 0,
"cvpv": 0,
"aonOff": 0,
"tempEnable": 0,
"dryContactOnOff": 0,
"bstartPower": 0,
"jobsModel": 0,
"conOff": 0,
"ctemp": 0
},
"deviceTypeInt": 69,
"pidData": null,
"spctData": {
"reactivePower": 0,
"reactiveEnergy": 0,
"lost": false,
"installLocation": 0,
"userEnergyToday": 0,
"gridEnergy": 0,
"addr": 0,
"totalEnergy": 0,
"deviceSN": "",
"feiLvGuZEnergy": 0,
"activeEnergy": 0,
"activePower": 0,
"feiLvBoZEnergy": 0,
"powerFactor": 0,
"gridEnergyToday": 0,
"userEnergy": 0,
"apparentPower": 0,
"feiLvFengZEnergy": 0,
"timeText": "",
"dataLogSn": "",
"feiLvPingZEnergy": 0,
"calendar": null
},
"irradiantion": 0,
"tcpServerIp": "47.107.154.111",
"lastUpdateTimeText": "2021-05-11 15:33:11",
"parentSN": "",
"jdameterData": null,
"parentID": "LIST_NACTEST128_69",
"address": 84,
"plantId": 0,
"envData": {
"windAngle": 0,
"radiant": 0,
"windSpeed": 0,
"envTemp": 0,
"envHumidity": 0,
"panelTemp": 0,
"addr": 0,
"timeText": "",
"dataLogSn": "",
"calendar": null
},
"meterCT": 0,
"ammeterData": {
"reactivePower": 0,
"forwardActiveNeed": 0,
"reverApparentEnergy": 0,
"todayEnergy": 0,
"currentL3Need": 0,
"l3CurrentHarmonic": 0,
"voltageL1": 0,
"activePower": 0,
"voltageL2": 0,
"voltageL3": 0,
"apparentEnergyNeed": 0,
"voltageUbc": 0,
"reverseActiveEnergy": 0,
"l2VoltageHarmonic3": 0,
"reverseInstantlyTotalActivePower": 0,
"gridEnergy": 0,
"activePowerMaxNeedOne": 0,
"activeEnergy": 0,
"activePowerNeedOne": 0,
"powerFactorL1": 0,
"voltage": 0,
"feiLvBoZEnergy": 0,
"powerFactorL3": 0,
"powerFactorL2": 0,
"reverseActiveNeed": 0,
"feiLvPingZEnergy": 0,
"voltageUab": 0,
"bActivePower": 0,
"forwardActiveMaxNeed": 0,
"totalReactiveEnergyL3": 0,
"reverseActiveTotalEnergy": 0,
"totalEnergy": 0,
"totalReactiveEnergyL1": 0,
"totalReactiveEnergyL2": 0,
"currentL3": 0,
"positiveActiveTodayEnergy": 0,
"cPowerFactor": 0,
"aReactivePower": 0,
"apparentEnergy": 0,
"current": 0,
"feiLvFengZEnergy": 0,
"instantlyTotalActivePower": 0,
"timeText": "",
"dataLogSn": "",
"apparentEnergyMaxNeed": 0,
"bReactivePower": 0,
"bPowerFactor": 0,
"posiActivePower": 0,
"monthEnergy": 0,
"currentL1": 0,
"currentHarmonicAvg": 0,
"l3Voltage1": 0,
"currentL2": 0,
"currentMaxNeed": 0,
"zeroLineMaxNeed": 0,
"voltageUca": 0,
"aPowerFactor": 0,
"reactivePowerL2": 0,
"reactivePowerL3": 0,
"reactivePowerL1": 0,
"currentL1Need": 0,
"aCurrent": 0,
"l3VoltageHarmonic1": 0,
"addr": 0,
"currentIc": 0,
"l2VoltageHarmonic": 0,
"currentIb": 0,
"currentIa": 0,
"positiveActiveTotalEnergy": 0,
"powerFactor": 0,
"l2Voltage3": 0,
"activePowerNeed": 0,
"instantaneousTotalApparentPower": 0,
"gridFrequency": 0,
"aActivePower": 0,
"lineVoltageHarmonicAvg": 0,
"posiReactivePower": 0,
"currentL1MaxNeed": 0,
"apparentPowerL1": 0,
"apparentPowerL2": 0,
"apparentPowerL3": 0,
"l2CurrentHarmonic": 0,
"zeroLineNeed": 0,
"cReactivePower": 0,
"l1VoltageHarmonic2": 0,
"activePowerL3": 0,
"reactiveEnergy": 0,
"activePowerL1": 0,
"l1CurrentHarmonic": 0,
"l1VoltageHarmonic": 0,
"activePowerL2": 0,
"lost": false,
"reverseActiveMaxNeed": 0,
"cActivePower": 0,
"frequency": 0,
"currentL2MaxNeed": 0,
"voltageHarmonicAvg": 0,
"reverseActiveTodayEnergy": 0,
"currentNeed": 0,
"apparentPower": 0,
"reverActivePower": 0,
"currentL2Need": 0,
"calendar": null,
"l1Voltage2": 0,
"voltageUb": 0,
"voltageUa": 0,
"totalActiveEnergyL1": 0,
"voltageUc": 0,
"aVoltage": 0,
"totalActiveEnergyL3": 0,
"totalActiveEnergyL2": 0,
"activePowerMaxNeed": 0,
"l3VoltageHarmonic": 0,
"feiLvGuZEnergy": 0,
"reverReactivePower": 0,
"userEnergy": 0,
"instantlyTotalReactivePower":0,
"currentL3MaxNeed": 0
}
},
"error_code": 0,
"error_msg": ""
}</code></pre>
<p><strong>Return parameter description</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">Parameter name</th>
<th style="text-align: left;">Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">device_sn</td>
<td style="text-align: left;">String</td>
<td>Serial number</td>
</tr>
<tr>
<td style="text-align: left;">dataloggerSn</td>
<td style="text-align: left;">String</td>
<td>Collector serial number</td>
</tr>
<tr>
<td style="text-align: left;">treeName</td>
<td style="text-align: left;">String</td>
<td>Device name + device address</td>
</tr>
<tr>
<td style="text-align: left;">lost</td>
<td style="text-align: left;">boolean</td>
<td>Whether communication is lost</td>
</tr>
<tr>
<td style="text-align: left;">location</td>
<td style="text-align: left;">String</td>
<td>location</td>
</tr>
<tr>
<td style="text-align: left;">lastUpDateTime</td>
<td style="text-align: left;">Date</td>
<td>Last update time</td>
</tr>
<tr>
<td style="text-align: left;">deviceSn</td>
<td style="text-align: left;">String</td>
<td>Serial Number</td>
</tr>
<tr>
<td style="text-align: left;">raillog</td>
<td style="text-align: left;">int</td>
<td>Is it ShineLink (0: Yes 1: No)</td>
</tr>
<tr>
<td style="text-align: left;">timezone</td>
<td style="text-align: left;">String</td>
<td>Time zone</td>
</tr>
<tr>
<td style="text-align: left;">deviceName</td>
<td style="text-align: left;">String</td>
<td>Device name</td>
</tr>
<tr>
<td style="text-align: left;">deviceType</td>
<td style="text-align: left;">String</td>
<td>Device type</td>
</tr>
<tr>
<td style="text-align: left;">dataLogSn</td>
<td style="text-align: left;">String</td>
<td>Collector serial number</td>
</tr>
<tr>
<td style="text-align: left;">prMonth</td>
<td style="text-align: left;">String</td>
<td>Monthly Pr value</td>
</tr>
<tr>
<td style="text-align: left;">boxData</td>
<td style="text-align: left;">String</td>
<td>null</td>
</tr>
<tr>
<td style="text-align: left;">key</td>
<td style="text-align: left;">String</td>
<td>Collector serial number + device type value + address</td>
</tr>
<tr>
<td style="text-align: left;">boostData</td>
<td style="text-align: left;">String</td>
<td>null</td>
</tr>
<tr>
<td style="text-align: left;">deviceTypeInt</td>
<td style="text-align: left;">int</td>
<td>Meter type</td>
</tr>
<tr>
<td style="text-align: left;">pidData</td>
<td style="text-align: left;">String</td>
<td>null</td>
</tr>
<tr>
<td style="text-align: left;">spctData</td>
<td style="text-align: left;">String</td>
<td>null</td>
</tr>
<tr>
<td style="text-align: left;">irradiantion</td>
<td style="text-align: left;">String</td>
<td>Insolation</td>
</tr>
<tr>
<td style="text-align: left;">tcpServerIp</td>
<td style="text-align: left;">String</td>
<td>TCP server IP address</td>
</tr>
<tr>
<td style="text-align: left;">lastUpdateTimeText</td>
<td style="text-align: left;">String</td>
<td>Last update time</td>
</tr>
<tr>
<td style="text-align: left;">parentSN</td>
<td style="text-align: left;">String</td>
<td>Owning superior device SN</td>
</tr>
<tr>
<td style="text-align: left;">jdameterData</td>
<td style="text-align: left;">String</td>
<td>null</td>
</tr>
<tr>
<td style="text-align: left;">parentID</td>
<td style="text-align: left;">String</td>
<td>Collector serial number + device type value</td>
</tr>
<tr>
<td style="text-align: left;">address</td>
<td style="text-align: left;">int</td>
<td>address</td>
</tr>
<tr>
<td style="text-align: left;">envData</td>
<td style="text-align: left;">String</td>
<td>null</td>
</tr>
<tr>
<td style="text-align: left;">meterCT</td>
<td style="text-align: left;">String</td>
<td>CT value of electric meter, dedicated for 645 electric meter</td>
</tr>
<tr>
<td style="text-align: left;">ammeterData</td>
<td style="text-align: left;">String</td>
<td>null</td>
</tr>
<tr>
<td style="text-align: left;">string</td>
<td style="text-align: left;">error_code</td>
<td>0: normal return, 10011: no permission</td>
</tr>
<tr>
<td style="text-align: left;">string</td>
<td style="text-align: left;">error_msg</td>
<td>Error message prompt</td>
</tr>
</tbody>
</table>
<p><strong>Remarks</strong>
-The frequency of acquisition is once every 10 seconds</p>