Get basic spa information
<p><strong>A brief description:</strong> </p>
<p>-Interface to get basic information of Spa
-<code>Only applicable to devices whose device type is 6 returned in the 3.3 interface.</code></p>
<p><strong>Request URL:</strong>
-<code>http(s)://test.growatt.com/v1/device/spa/spa_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>Spa device SN</td>
</tr>
</tbody>
</table>
<p><strong>Return example</strong></p>
<pre><code>{
"device_sn": "LHD0847002",
"dataloggerSn": "JPC2827188",
"data": {
"spa_off_grid_enable": "",
"pf_sys_year": "",
"wselectBaudrate": 0,
"fwVersion": "RH1.0",
"loadFirstStopTime3": "0:0",
"loadFirstStopTime1": "23:59",
"loadFirstStopTime2": "7:29",
"disChargePowerCommand": 100,
"plantname": "",
"modbusVersion": 305,
"vacLow": 184,
"pDischarge": 0,
"portName": "port_name",
"wchargeSOCLowLimit2": 100,
"wchargeSOCLowLimit1": 100,
"modelText": "A0B0D0T4P7U2M2S1",
"equipmentType": "",
"loadFirstSwitch3": 0,
"loadFirstSwitch2": 0,
"vbatStartForDischarge": 48,
"loadFirstSwitch1": 0,
"record": null,
"dischargeTime3": "",
"dischargeTime2": "",
"dischargeTime1": "",
"spa_ac_discharge_voltage": "",
"communicationVersion": "",
"upsFreqSet": 0,
"pv_grid_voltage_low": "",
"batFirstSwitch2": 0,
"batFirstSwitch1": 0,
"vbatWarnClr": 5,
"batFirstSwitch3": 0,
"lastUpdateTime": {
"time": 1545206584000,
"minutes": 3,
"seconds": 4,
"hours": 16,
"month": 11,
"year": 118,
"timezoneOffset": -480,
"day": 3,
"date": 19
},
"updating": false,
"countrySelected": 0,
"epsFunEn": 0,
"forcedChargeTimeStop1": "23:59",
"forcedChargeTimeStop2": "4:29",
"forcedChargeTimeStop3": "13:29",
"vbatWarning": 480,
"dataLogSn": "JPC2827188",
"innerVersion": "rHAA020202",
"vacHigh": 264.5,
"forcedChargeTimeStart1": "0:0",
"forcedChargeTimeStart3": "10:30",
"forcedChargeTimeStart2": "1:30",
"activePRate": 100,
"pv_power_factor": "",
"tcpServerIp": "192.168.3.35",
"vbatStartforCharge": 58,
"groupId": -1,
"lastUpdateTimeText": "2018-12-19 16:03:04",
"pCharge": 0,
"spa_ac_discharge_frequency": "",
"bctMode": 0,
"forcedDischargeTimeStop3": "16:29",
"forcedDischargeTimeStop2": "10:29",
"forcedDischargeTimeStop1": "23:59",
"backflow_setting": "",
"epsFreqSet": 0,
"pmax": 3000,
"batTempLowerLimitD": 120,
"pv_pf_cmd_memory_state": "",
"batTempLowerLimitC": 0,
"location": "null",
"treeID": "ST_LHD0847002",
"pv_on_off": "",
"addr": 1,
"chargePowerCommand": 100,
"pfCMDmemoryState": 0,
"priorityChoose": 2,
"floatChargeCurrentLimit": 650,
"bagingTestStep": 0,
"gridFirstSwitch1": 1,
"level": 4,
"gridFirstSwitch3": 0,
"powerFactor": 10000,
"gridFirstSwitch2": 0,
"imgPath": "./css/img/status_gray.gif",
"forcedDischargeTimeStart3": "13:30",
"userName": "",
"forcedDischargeTimeStart2": "7:30",
"forcedDischargeTimeStart1": "0:0",
"serialNum": "LHD0847002",
"dtc": 3701,
"energyMonth": 0,
"powerMax": "",
"pv_grid_voltage_high": "",
"status": -1,
"reactivePRate": 100,
"sysTime": "2018-12-19 15:59",
"pv_reactive_p_rate_two": "",
"comAddress": 1,
"loadFirstStartTime2": "4:30",
"loadFirstStartTime1": "0:0",
"manufacturer": "New Energy ",
"plantId": 0,
"loadFirstStartTime3": "0:0",
"chargeTime3": "",
"chargeTime1": "",
"chargeTime2": "",
"onOff": 1,
"pv_reactive_p_rate": "",
"model": 29136100000,
"treeName": "LHD0847002",
"lost": true,
"lcdLanguage": 1,
"vbatStopForDischarge": 4.699999809265137,
"powerMaxTime": "",
"buckUPSVoltSet": 0,
"children": [],
"statusText": "spa.status.lost",
"energyMonthText": "0",
"id": 0,
"energyDay": 0,
"wdisChargeSOCLowLimit1": 100,
"wdisChargeSOCLowLimit2": 5,
"energyDayMap": {},
"batTempUpperLimitC": 40,
"alias": "LHD0847002",
"batTempUpperLimitD": 55,
"batteryType": 0,
"powerMaxText": "",
"pv_active_p_rate": "",
"vbatStopForCharge": 5.880000114440918,
"parentID": "LIST_JPC2827188_96",
"epsVoltSet": 0,
"bctAdjust": 0,
"buckUpsFunEn": 1
},
"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;">serialNum</td>
<td style="text-align: left;">String</td>
<td>Serial Number</td>
</tr>
<tr>
<td style="text-align: left;">portName</td>
<td style="text-align: left;">String</td>
<td>Communication port information Communication port type and address</td>
</tr>
<tr>
<td style="text-align: left;">alias</td>
<td style="text-align: left;">String</td>
<td>alias</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;">addr=0</td>
<td style="text-align: left;">int</td>
<td>Inverter address</td>
</tr>
<tr>
<td style="text-align: left;">fwVersion</td>
<td style="text-align: left;">String</td>
<td>Firmware version</td>
</tr>
<tr>
<td style="text-align: left;">model</td>
<td style="text-align: left;">long</td>
<td>model</td>
</tr>
<tr>
<td style="text-align: left;">innerVersion</td>
<td style="text-align: left;">String</td>
<td>Internal version number</td>
</tr>
<tr>
<td style="text-align: left;">lost=true</td>
<td style="text-align: left;">boolean</td>
<td>Whether communication is lost</td>
</tr>
<tr>
<td style="text-align: left;">status=-1</td>
<td style="text-align: left;">int</td>
<td>Spa Status 0: Waiting mode 1: Self-checking mode, 3: Failure mode, 4: Upgrading, 5, 6, 7, 8: Normal mode</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;">lastUpdateTime</td>
<td style="text-align: left;">Date</td>
<td>Last update time</td>
</tr>
<tr>
<td style="text-align: left;">sysTime</td>
<td style="text-align: left;">Calendar</td>
<td>System Time</td>
</tr>
<tr>
<td style="text-align: left;">communicationVersion</td>
<td style="text-align: left;">String</td>
<td>Communication version number</td>
</tr>
<tr>
<td style="text-align: left;">onOff</td>
<td style="text-align: left;">int</td>
<td>Switch machine</td>
</tr>
<tr>
<td style="text-align: left;">pmax</td>
<td style="text-align: left;">String</td>
<td>Rated power</td>
</tr>
<tr>
<td style="text-align: left;">lcdLanguage</td>
<td style="text-align: left;">int</td>
<td>LCD</td>
</tr>
<tr>
<td style="text-align: left;">countrySelected</td>
<td style="text-align: left;">int</td>
<td>country selection</td>
</tr>
<tr>
<td style="text-align: left;">wselectBaudrate</td>
<td style="text-align: left;">String</td>
<td>Baud rate selection</td>
</tr>
<tr>
<td style="text-align: left;">comAddress</td>
<td style="text-align: left;">int</td>
<td>Mailing address</td>
</tr>
<tr>
<td style="text-align: left;">manufacturer</td>
<td style="text-align: left;">String</td>
<td>Manufacturer Code</td>
</tr>
<tr>
<td style="text-align: left;">dtc</td>
<td style="text-align: left;">int</td>
<td>Device code 43</td>
</tr>
<tr>
<td style="text-align: left;">modbusVersion</td>
<td style="text-align: left;">int</td>
<td>MODBUS version</td>
</tr>
<tr>
<td style="text-align: left;">floatChargeCurrentLimit</td>
<td style="text-align: left;">float</td>
<td>float charge current limit</td>
</tr>
<tr>
<td style="text-align: left;">vbatWarning</td>
<td style="text-align: left;">String</td>
<td>Low battery voltage alarm point</td>
</tr>
<tr>
<td style="text-align: left;">vbatWarnClr</td>
<td style="text-align: left;">String</td>
<td>Battery voltage low voltage recovery point</td>
</tr>
<tr>
<td style="text-align: left;">vbatStopForDischarge</td>
<td style="text-align: left;">String</td>
<td>Battery discharge stop voltage</td>
</tr>
<tr>
<td style="text-align: left;">vbatStopForCharge</td>
<td style="text-align: left;">String</td>
<td>Battery charging stop voltage</td>
</tr>
<tr>
<td style="text-align: left;">vbatStartForDischarge</td>
<td style="text-align: left;">String</td>
<td>Lower limit of battery discharge voltage</td>
</tr>
<tr>
<td style="text-align: left;">vbatStartforCharge</td>
<td style="text-align: left;">String</td>
<td>Battery charging upper limit voltage</td>
</tr>
<tr>
<td style="text-align: left;">batTempLowerLimitD</td>
<td style="text-align: left;">String</td>
<td>Lower limit of battery discharge temperature</td>
</tr>
<tr>
<td style="text-align: left;">batTempUpperLimitD</td>
<td style="text-align: left;">String</td>
<td>Upper limit of battery discharge temperature</td>
</tr>
<tr>
<td style="text-align: left;">batTempLowerLimitC</td>
<td style="text-align: left;">String</td>
<td>Lower limit of battery charging temperature</td>
</tr>
<tr>
<td style="text-align: left;">batTempUpperLimitC</td>
<td style="text-align: left;">String</td>
<td>Upper limit of battery charging temperature</td>
</tr>
<tr>
<td style="text-align: left;">forcedDischargeTimeStart1</td>
<td style="text-align: left;">String</td>
<td>Discharge 1 start time</td>
</tr>
<tr>
<td style="text-align: left;">forcedDischargeTimeStart2</td>
<td style="text-align: left;">String</td>
<td>Discharge 2 start time</td>
</tr>
<tr>
<td style="text-align: left;">forcedDischargeTimeStart3</td>
<td style="text-align: left;">String</td>
<td>Discharge 3 start time</td>
</tr>
<tr>
<td style="text-align: left;">forcedDischargeTimeStop1</td>
<td style="text-align: left;">String</td>
<td>Discharge 1 stop time</td>
</tr>
<tr>
<td style="text-align: left;">forcedDischargeTimeStop2</td>
<td style="text-align: left;">String</td>
<td>Discharge 2 stop time</td>
</tr>
<tr>
<td style="text-align: left;">forcedDischargeTimeStop3</td>
<td style="text-align: left;">String</td>
<td>Discharge 3 stop time</td>
</tr>
<tr>
<td style="text-align: left;">forcedChargeTimeStart1</td>
<td style="text-align: left;">String</td>
<td>Charge 1 start time</td>
</tr>
<tr>
<td style="text-align: left;">forcedChargeTimeStart2</td>
<td style="text-align: left;">String</td>
<td>Charge 2 start time</td>
</tr>
<tr>
<td style="text-align: left;">forcedChargeTimeStart3</td>
<td style="text-align: left;">String</td>
<td>Charge 3 start time</td>
</tr>
<tr>
<td style="text-align: left;">forcedChargeTimeStop1</td>
<td style="text-align: left;">String</td>
<td>Charge 1 stop time</td>
</tr>
<tr>
<td style="text-align: left;">forcedChargeTimeStop2</td>
<td style="text-align: left;">String</td>
<td>Charge 2 stop time</td>
</tr>
<tr>
<td style="text-align: left;">forcedChargeTimeStop3</td>
<td style="text-align: left;">String</td>
<td>Charge 3 stop time</td>
</tr>
<tr>
<td style="text-align: left;">bctMode</td>
<td style="text-align: left;">int</td>
<td>Sensor type (2:METER;1:cWirelessCT;0:cWiredCT)</td>
</tr>
<tr>
<td style="text-align: left;">bctAdjust</td>
<td style="text-align: left;">int</td>
<td>Sensor adjustment enable</td>
</tr>
<tr>
<td style="text-align: left;">wdisChargeSOCLowLimit1</td>
<td style="text-align: left;">int</td>
<td>Discharge in load priority mode</td>
</tr>
<tr>
<td style="text-align: left;">wdisChargeSOCLowLimit2</td>
<td style="text-align: left;">int</td>
<td>Grid priority mode discharge</td>
</tr>
<tr>
<td style="text-align: left;">wchargeSOCLowLimit1</td>
<td style="text-align: left;">int</td>
<td>Load priority mode charging</td>
</tr>
<tr>
<td style="text-align: left;">wchargeSOCLowLimit2</td>
<td style="text-align: left;">int</td>
<td>Battery priority mode charging</td>
</tr>
<tr>
<td style="text-align: left;">priorityChoose</td>
<td style="text-align: left;">int</td>
<td>Energy priority selection</td>
</tr>
<tr>
<td style="text-align: left;">chargePowerCommand</td>
<td style="text-align: left;">String</td>
<td>Charging power setting</td>
</tr>
<tr>
<td style="text-align: left;">disChargePowerCommand</td>
<td style="text-align: left;">Stringint</td>
<td>Discharge power setting</td>
</tr>
<tr>
<td style="text-align: left;">bagingTestStep</td>
<td style="text-align: left;">int</td>
<td>Battery self-test</td>
</tr>
<tr>
<td style="text-align: left;">batteryType</td>
<td style="text-align: left;">int</td>
<td>Battery type selection</td>
</tr>
<tr>
<td style="text-align: left;">epsFunEn</td>
<td style="text-align: left;">int</td>
<td>Emergency power enable</td>
</tr>
<tr>
<td style="text-align: left;">epsVoltSet</td>
<td style="text-align: left;">int</td>
<td>Emergency power supply voltage</td>
</tr>
<tr>
<td style="text-align: left;">epsFreqSet</td>
<td style="text-align: left;">int</td>
<td>Emergency power frequency</td>
</tr>
<tr>
<td style="text-align: left;">loadFirstStartTime1</td>
<td style="text-align: left;">String</td>
<td>Load priority period 1 start time</td>
</tr>
<tr>
<td style="text-align: left;">loadFirstStopTime1</td>
<td style="text-align: left;">String</td>
<td>Load priority period 1 end time</td>
</tr>
<tr>
<td style="text-align: left;">loadFirstStartTime2</td>
<td style="text-align: left;">String</td>
<td>Load priority period 2 start time</td>
</tr>
<tr>
<td style="text-align: left;">loadFirstStopTime2</td>
<td style="text-align: left;">String</td>
<td>End time of load priority period 2</td>
</tr>
<tr>
<td style="text-align: left;">loadFirstStartTime3</td>
<td style="text-align: left;">String</td>
<td>Load priority period 3 start time</td>
</tr>
<tr>
<td style="text-align: left;">loadFirstStopTime3</td>
<td style="text-align: left;">String</td>
<td>Load priority period 3 end time</td>
</tr>
<tr>
<td style="text-align: left;">gridFirstSwitch1</td>
<td style="text-align: left;">int</td>
<td>Grid priority enable bit 1082</td>
</tr>
<tr>
<td style="text-align: left;">gridFirstSwitch2</td>
<td style="text-align: left;">int</td>
<td>Grid priority enable bit 1085</td>
</tr>
<tr>
<td style="text-align: left;">gridFirstSwitch3</td>
<td style="text-align: left;">int</td>
<td>Grid priority enable bit 1088</td>
</tr>
<tr>
<td style="text-align: left;">batFirstSwitch1</td>
<td style="text-align: left;">int</td>
<td>Battery priority enable bit 1</td>
</tr>
<tr>
<td style="text-align: left;">batFirstSwitch2</td>
<td style="text-align: left;">int</td>
<td>Battery priority enable bit 2</td>
</tr>
<tr>
<td style="text-align: left;">batFirstSwitch3</td>
<td style="text-align: left;">int</td>
<td>Battery priority enable bit 3</td>
</tr>
<tr>
<td style="text-align: left;">loadFirstSwitch1</td>
<td style="text-align: left;">int</td>
<td>Load priority enable bit 1</td>
</tr>
<tr>
<td style="text-align: left;">loadFirstSwitch2</td>
<td style="text-align: left;">int</td>
<td>Load priority enable bit 2</td>
</tr>
<tr>
<td style="text-align: left;">loadFirstSwitch3</td>
<td style="text-align: left;">int</td>
<td>Load priority enable bit 3</td>
</tr>
<tr>
<td style="text-align: left;">vacHigh</td>
<td style="text-align: left;">float</td>
<td>Mains voltage upper limit</td>
</tr>
<tr>
<td style="text-align: left;">vacLow</td>
<td style="text-align: left;">float</td>
<td>Mains voltage lower limit</td>
</tr>
<tr>
<td style="text-align: left;">buckUpsFunEn</td>
<td style="text-align: left;">int</td>
<td>Off-grid enable</td>
</tr>
<tr>
<td style="text-align: left;">buckUPSVoltSet</td>
<td style="text-align: left;">int</td>
<td>Off-grid voltage</td>
</tr>
<tr>
<td style="text-align: left;">upsFreqSet</td>
<td style="text-align: left;">int</td>
<td>Off-grid frequency</td>
</tr>
<tr>
<td style="text-align: left;">pfCMDmemoryState</td>
<td style="text-align: left;">int</td>
<td>Set storage PF command</td>
</tr>
<tr>
<td style="text-align: left;">activePRate</td>
<td style="text-align: left;">String</td>
<td>Set active power</td>
</tr>
<tr>
<td style="text-align: left;">reactivePRate</td>
<td style="text-align: left;">String</td>
<td>Set reactive power</td>
</tr>
<tr>
<td style="text-align: left;">powerFactor</td>
<td style="text-align: left;">int</td>
<td>Set PF value</td>
</tr>
<tr>
<td style="text-align: left;">chargeTime1</td>
<td style="text-align: left;">String</td>
<td>Charging time period 1</td>
</tr>
<tr>
<td style="text-align: left;">chargeTime2</td>
<td style="text-align: left;">String</td>
<td>Charging time period 2</td>
</tr>
<tr>
<td style="text-align: left;">chargeTime3</td>
<td style="text-align: left;">String</td>
<td>Charging time period 3</td>
</tr>
<tr>
<td style="text-align: left;">dischargeTime1</td>
<td style="text-align: left;">String</td>
<td>Discharge time period 1</td>
</tr>
<tr>
<td style="text-align: left;">dischargeTime2</td>
<td style="text-align: left;">String</td>
<td>Discharge time period 2</td>
</tr>
<tr>
<td style="text-align: left;">dischargeTime3</td>
<td style="text-align: left;">String</td>
<td>Discharge time period 3</td>
</tr>
<tr>
<td style="text-align: left;">pv_on_off</td>
<td style="text-align: left;">String</td>
<td>Switch</td>
</tr>
<tr>
<td style="text-align: left;">pf_sys_year</td>
<td style="text-align: left;">String</td>
<td>Set time</td>
</tr>
<tr>
<td style="text-align: left;">pv_grid_voltage_high</td>
<td style="text-align: left;">String</td>
<td>Mains voltage upper limit</td>
</tr>
<tr>
<td style="text-align: left;">pv_grid_voltage_low</td>
<td style="text-align: left;">String</td>
<td>Mains voltage lower limit</td>
</tr>
<tr>
<td style="text-align: left;">spa_off_grid_enable</td>
<td style="text-align: left;">String</td>
<td>Off-grid enable</td>
</tr>
<tr>
<td style="text-align: left;">spa_ac_discharge_frequency</td>
<td style="text-align: left;">String</td>
<td>Off-grid frequency</td>
</tr>
<tr>
<td style="text-align: left;">spa_ac_discharge_voltage</td>
<td style="text-align: left;">String</td>
<td>Off-grid voltage</td>
</tr>
<tr>
<td style="text-align: left;">pv_pf_cmd_memory_state</td>
<td style="text-align: left;">String</td>
<td>Set whether to store the following</td>
</tr>
<tr>
<td style="text-align: left;">pv_active_p_rate</td>
<td style="text-align: left;">String</td>
<td>Set active power</td>
</tr>
<tr>
<td style="text-align: left;">pv_reactive_p_rate</td>
<td style="text-align: left;">String</td>
<td>Set reactive power</td>
</tr>
<tr>
<td style="text-align: left;">pv_reactive_p_rate_two</td>
<td style="text-align: left;">String</td>
<td>No power capacity</td>
</tr>
<tr>
<td style="text-align: left;">backflow_setting</td>
<td style="text-align: left;">String</td>
<td>Backflow prevention setting</td>
</tr>
<tr>
<td style="text-align: left;">pv_power_factor</td>
<td style="text-align: left;">String</td>
<td>Set PF value</td>
</tr>
<tr>
<td style="text-align: left;">plantId</td>
<td style="text-align: left;">int</td>
<td>Power plant ID</td>
</tr>
<tr>
<td style="text-align: left;">plantname</td>
<td style="text-align: left;">String</td>
<td>Plant name</td>
</tr>
<tr>
<td style="text-align: left;">pCharge</td>
<td style="text-align: left;">String</td>
<td>Charging power</td>
</tr>
<tr>
<td style="text-align: left;">pDischarge</td>
<td style="text-align: left;">String</td>
<td>Discharge power</td>
</tr>
<tr>
<td style="text-align: left;">error_code</td>
<td style="text-align: left;">string</td>
<td>0: normal return, 10001: system error</td>
</tr>
<tr>
<td style="text-align: left;">error_msg</td>
<td style="text-align: left;">string</td>
<td>Error message prompt</td>
</tr>
</tbody>
</table>
<p><strong>Remarks</strong>
-The frequency of acquisition is once every 10 seconds</p>