ShineServer_English version


Get Min basic information

<p><strong>A brief description:</strong> </p> <ul> <li>Interface to get basic information of Min</li> <li><code>Applies only to devices with device type 7 returned in the 3.3 interface.</code></li> </ul> <p><strong>Request URL:</strong></p> <ul> <li><code>http(s)://test.growatt.com/v1/device/tlx/tlx_data_info</code></li> </ul> <p><strong>Request method:</strong></p> <ul> <li>get</li> </ul> <p><strong>Parameters:</strong></p> <table> <thead> <tr> <th style="text-align: left;">Parameter name</th> <th style="text-align: left;">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>tlx Device SN</td> </tr> </tbody> </table> <p><strong>Back to example</strong></p> <pre><code>{ "device_sn": "FDCJQ00003", "dataloggerSn": "VC51030322020001", "data": { "trakerModel": 0, "optimezerList": [], "wselectBaudrate": 0, "fwVersion": "xx1.0", "restartTime": 300, "batTempLowerLimitD": 0, "batTempLowerLimitC": 0, "location": "", "treeID": "ST_FDCJQ00003", "addr": 1, "bdcAuthversion": 0, "bmsCommunicationType": 0, "priorityChoose": 0, "startTime": 300, "bagingTestStep": 0, "bdc1Version": " -0", "timezone": 8, "plantname": "", "batParallelNum": 0, "level": 4, "modbusVersion": 305, "imgPath": "./css/img/status_gray.gif", "userName": "", "power": 0, "serialNum": "FDCJQ00003", "pDischarge": 0, "dtc": 5300, "portName": "port_name", "energyMonth": 0, "tlxSetbean": { "delayTime": 0, "exportLimitPowerRateStr": "", "charge_power": "", "uwHVRTEE": 264, "activePowerEnable": 0, "tlx_on_off": "", "backflowDefaultPower": 0, "season3Time9": "0_0_0_0_0_0_0", "season3Time8": "0_0_0_0_0_0_0", "season3Time7": "0_0_0_0_0_0_0", "season3Time6": "0_0_0_0_0_0_0", "time3Mode": 0, "season3Time5": "0_0_0_0_0_0_0", "tlx_pflinep4_pf": "", "season3Time4": "0_0_0_0_0_0_0", "season3Time3": "0_0_0_0_0_0_0", "season3Time2": "0_0_0_0_0_0_0", "season3Time1": "0_0_0_0_0_0_0", "time6Mode": 0, "tlx_pflinep3_pf": "", "uwHVRT2EE": 288, "pflinep2_pf": 1, "pflinep1_pf": 1, "tlx_limit_device": "", "bgridType": 0, "uwHFRT2EE": 52, "pv_grid_voltage_low": "", "lastUpdateTime": { "time": 1649752763000, "minutes": 39, "seconds": 23, "hours": 16, "month": 3, "year": 122, "timezoneOffset": -480, "day": 2, "date": 12 }, "afciSelfCheck": -1, "tlx_lcd_Language": "", "tlx_pflinep2_lp": "", "wdisChargeSOCLowLimit": 5, "vbatWarning": 0, "tlx_backflow_default_power": "", "loadingRate": 20, "tlx_dry_contact_enable": "", "vbatStartforCharge": 5800, "lastUpdateTimeText": "2022-04-12 16:39:23", "tlx_dry_contact_power": "", "wchargeSOCLowLimit": 100, "uwLFRT2EE": 46.5, "tlx_pflinep4_lp": "", "chargePowerCommand": 100, "dryContactOnRate": 40, "serialNum": "FDCJQ00003", "pv_grid_voltage_high": "", "sysTime": "2022-04-12 16:39:21", "overFreLoRedDelayTime": 0, "tlx_pflinep3_lp": "", "pflinep3_lp": 255, "pflinep1_lp": 255, "tlx_ac_discharge_frequency": "", "pflinep2_lp": 255, "exportLimit": 0, "vbatStopForDischarge": 0, "time2Mode": 0, "time8Mode": 0, "bdcMode": -1, "tlx_cc_current": "", "time9Mode": 0, "exportLimitPowerRate": 0, "special2Time5": "0_0_0_0_0_0", "special2Time4": "0_0_0_0_0_0", "charge_stop_soc": "", "bsystemWorkMode": 500, "special2Time3": "0_0_0_0_0_0", "special2Time2": "0_0_0_0_0_0", "special2Time1": "0_0_0_0_0_0", "tlx_pf": "", "time1Mode": 0, "qvH2": 256.79998779296875, "season2MonthTime": "0_0_0", "qvH1": 247.1999969482422, "acChargeEnable": 0, "epsVoltSet": 2, "special2Time8": "0_0_0_0_0_0", "special2Time9": "0_0_0_0_0_0", "special2Time6": "0_0_0_0_0_0", "special2Time7": "0_0_0_0_0_0", "pf_sys_year": "", "season2Time2": "0_0_0_0_0_0_0", "season2Time3": "0_0_0_0_0_0_0", "overFreLoRedSlope": 41, "season2Time1": "0_0_0_0_0_0_0", "season2Time6": "0_0_0_0_0_0_0", "season2Time7": "0_0_0_0_0_0_0", "season2Time4": "0_0_0_0_0_0_0", "season2Time5": "0_0_0_0_0_0_0", "season2Time8": "0_0_0_0_0_0_0", "season2Time9": "0_0_0_0_0_0_0", "disChargePowerCommand": 100, "forcedStopSwitch2": 0, "forcedStopSwitch1": 0, "forcedStopSwitch4": 0, "forcedStopSwitch3": 0, "forcedStopSwitch6": 0, "forcedStopSwitch5": 0, "reactiveRate": 0, "forcedStopSwitch8": 0, "forcedStopSwitch7": 0, "forcedStopSwitch9": 0, "season4Time7": "0_0_0_0_0_0_0", "forcedTimeStart1": "0:0", "season4Time6": "0_0_0_0_0_0_0", "forcedTimeStart2": "0:0", "season4Time9": "0_0_0_0_0_0_0", "afciThresholdL": -1, "forcedTimeStart3": "0:0", "season4Time8": "0_0_0_0_0_0_0", "afciThresholdH": -1, "pflinep4_lp": 255, "forcedTimeStart8": "0:0", "forcedTimeStart9": "0:0", "season4Time1": "0_0_0_0_0_0_0", "afciThresholdD": -1, "vbatStartForDischarge": 0, "forcedTimeStart4": "0:0", "season4Time3": "0_0_0_0_0_0_0", "dryContactOffRate": 40, "forcedTimeStart5": "0:0", "season4Time2": "0_0_0_0_0_0_0", "forcedTimeStart6": "0:0", "season4Time5": "0_0_0_0_0_0_0", "forcedTimeStart7": "0:0", "season4Time4": "0_0_0_0_0_0_0", "pf": 0.8899999856948853, "discharge_stop_soc": "", "pflinep3_pf": 1, "fftThresholdCount": -1, "season1Time5": "0_0_0_0_0_0_0", "season1Time6": "0_0_0_0_0_0_0", "tlx_off_grid_enable": "", "season1Time3": "0_0_0_0_0_0_0", "season1Time4": "0_0_0_0_0_0_0", "vbatWarnClr": 0, "season1Time9": "0_0_0_0_0_0_0", "season1Time7": "0_0_0_0_0_0_0", "season1Time8": "0_0_0_0_0_0_0", "qvL1": 232, "qvL2": 220.8000030517578, "season1Time1": "0_0_0_0_0_0_0", "overFreDropPoint": 50.029998779296875, "season1Time2": "0_0_0_0_0_0_0", "epsFunEn": 1, "discharge_power": "", "dryContactPower": 50, "season1MonthTime": "0_0_0", "frequencyLowLimit": 49.5, "limitDevice": -1, "tlx_pflinep1_lp": "", "ac_charge": "", "tlx_exter_comm_Off_GridEn": "", "activeRate": 100, "epsFreqSet": 0, "voltageHighLimit": 252, "pv_grid_frequency_low": "", "floatChargeCurrentLimit": 600, "uwLVRT2EE": 120, "dryContactFuncEn": 0, "special2MonthTime": "0_0_0", "time7Mode": 0, "pv_grid_frequency_high": "", "afciEnabled": -1, "special1Time3": "0_0_0_0_0_0", "special1Time4": "0_0_0_0_0_0", "special1Time1": "0_0_0_0_0_0", "special1Time2": "0_0_0_0_0_0", "special1Time8": "0_0_0_0_0_0", "special1Time7": "0_0_0_0_0_0", "pflinep4_pf": 1, "special1Time6": "0_0_0_0_0_0", "special1Time5": "0_0_0_0_0_0", "tlx_pflinep2_pf": "", "special1Time9": "0_0_0_0_0_0", "restartLoadingRate": 20, "season4MonthTime": "0_0_0", "onOff": 1, "forcedTimeStop8": "0:0", "time4Mode": 0, "qPercentMax": 44, "forcedTimeStop9": "0:0", "lcdLanguage": 1, "uwLVRTEE": 211.1999969482422, "pfModel": 0, "time5Mode": 0, "forcedTimeStop3": "0:0", "pvPfCmdMemoryState": 0, "forcedTimeStop2": "0:0", "forcedTimeStop1": "0:0", "tlx_ac_discharge_voltage": "", "forcedTimeStop7": "0:0", "forcedTimeStop6": "0:0", "forcedTimeStop5": "0:0", "tlx_cv_voltage": "", "frequencyHighLimit": 50.099998474121094, "forcedTimeStop4": "0:0", "uwHFRTEE": 51.20000076293945, "exterCommOffGridEn": 0, "voltageLowLimit": 220, "special1MonthTime": "0_0_0", "vbatStopForCharge": 0, "tlx_pflinep1_pf": "", "season3MonthTime": "0_0_0", "uwLFRTEE": 48.5, "afciReset": -1, "sysTimeText": "2022-04-12 16:39:21", "tlx_dry_contact_off_power": "" }, "powerMax": "", "modelText": "S25B00D00T00P0FU01M0072", "status": 0, "eToday": 0, "vnormal": 800, "vbatStartForDischarge": 0, "bdc1Sn": "XXXXXXXXXXXXXXXX", "sysTime": "", "record": null, "batSeriesNum": 0, "comAddress": 1, "plantId": 0, "manufacturer": "PV Inverter", "communicationVersion": "ZAca-0017", "model": 2666130979655057522, "treeName": "FDCJQ00003", "lost": false, "vbatWarnClr": 0, "vbatStopForDischarge": 0, "powerMaxTime": "", "lastUpdateTime": { "time": 1649753182000, "minutes": 46, "seconds": 22, "hours": 16, "month": 3, "year": 122, "timezoneOffset": -480, "day": 2, "date": 12 }, "children": [], "statusText": "tlx.status.operating", "liBatteryFwVersion": "0", "energyMonthText": "0", "updating": false, "countrySelected": 0, "id": 0, "bdc1Model": "0", "bdcMode": -1, "vbatWarning": 0, "liBatteryManufacturers": "0", "deviceType": 2, "bmsSoftwareVersion": "0", "dataLogSn": "VC51030322020001", "innerVersion": "xxxxxxxx", "energyDayMap": {}, "strNum": 0, "alias": "FDCJQ00003", "batTempUpperLimitC": 0, "batTempUpperLimitD": 0, "batteryType": 0, "powerMaxText": "", "eTotal": 0, "tcpServerIp": "47.107.154.111", "vbatStopForCharge": 0, "mppt": 513, "groupId": -1, "lastUpdateTimeText": "2022-04-12 16:46:22", "monitorVersion": "\u0000\u0000\u0000\u00000", "pCharge": 0, "parentID": "LIST_VC51030322020001_22", "bctMode": 0, "bctAdjust": 0, "pmax": 11400 }, "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;">int</td> <td>Device SN</td> </tr> <tr> <td style="text-align: left;">serialNum</td> <td style="text-align: left;">string</td> <td>Device SN</td> </tr> <tr> <td style="text-align: left;">dataloggerSn</td> <td style="text-align: left;">string</td> <td>The SN of the collector to which the inverter belongs</td> </tr> <tr> <td style="text-align: left;">lost</td> <td style="text-align: left;">string</td> <td>The status of the device online or not (0: online, 1: disconnected)</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">int</td> <td>Device status, 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;">alias</td> <td style="text-align: left;">int</td> <td>alias</td> </tr> <tr> <td style="text-align: left;">location</td> <td style="text-align: left;">string</td> <td>address</td> </tr> <tr> <td style="text-align: left;">dataLogSn</td> <td style="text-align: left;">string</td> <td>The serial number of the collector</td> </tr> <tr> <td style="text-align: left;">pmax</td> <td style="text-align: left;">string</td> <td>nominal power</td> </tr> <tr> <td style="text-align: left;">power</td> <td style="text-align: left;">string</td> <td>Current power</td> </tr> <tr> <td style="text-align: left;"><del>eToday</del></td> <td style="text-align: left;">string</td> <td><del>Today's power generation</del>(Expired)</td> </tr> <tr> <td style="text-align: left;"><del>eTotal</del></td> <td style="text-align: left;">string</td> <td><del>Total Power Generation</del>(Expired)</td> </tr> <tr> <td style="text-align: left;">lastUpdateTime</td> <td style="text-align: left;">string</td> <td>Last update time</td> </tr> <tr> <td style="text-align: left;">tcpServerIp</td> <td style="text-align: left;">string</td> <td>Server address</td> </tr> <tr> <td style="text-align: left;">fwVersion</td> <td style="text-align: left;">string</td> <td>Inverter version</td> </tr> <tr> <td style="text-align: left;">addr = 0</td> <td style="text-align: left;">string</td> <td>Inverter address</td> </tr> <tr> <td style="text-align: left;">model</td> <td style="text-align: left;">string</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;">sysTime</td> <td style="text-align: left;">string</td> <td>System time</td> </tr> <tr> <td style="text-align: left;">deviceType</td> <td style="text-align: left;">string</td> <td>1:Mix,0:Inverter</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;">pmax</td> <td style="text-align: left;">string</td> <td>Rated power; 0.1VA</td> </tr> <tr> <td style="text-align: left;">comAddress</td> <td style="text-align: left;">string</td> <td>Mailing address 30</td> </tr> <tr> <td style="text-align: left;">dtc</td> <td style="text-align: left;">string</td> <td>Device code</td> </tr> <tr> <td style="text-align: left;">countrySelected</td> <td style="text-align: left;">string</td> <td>country selected</td> </tr> <tr> <td style="text-align: left;">startTime</td> <td style="text-align: left;">string</td> <td>Startup countdown</td> </tr> <tr> <td style="text-align: left;">restartTime</td> <td style="text-align: left;">string</td> <td>Reconnection countdown</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;">trakerModel</td> <td style="text-align: left;">string</td> <td>task model</td> </tr> <tr> <td style="text-align: left;">priorityChoose</td> <td style="text-align: left;">string</td> <td>Energy priority selection;0:Load;1:Battery;2:Grid</td> </tr> <tr> <td style="text-align: left;">batteryType</td> <td style="text-align: left;">string</td> <td>Battery type selection;0:Lithium;1:Lead-acid;2:other</td> </tr> <tr> <td style="text-align: left;">batSeriesNum</td> <td style="text-align: left;">string</td> <td>The number of battery cells in series</td> </tr> <tr> <td style="text-align: left;">batParallelNum</td> <td style="text-align: left;">string</td> <td>Number of parallel battery cells</td> </tr> <tr> <td style="text-align: left;">bctMode</td> <td style="text-align: left;">string</td> <td>sensor classType;2:METER;1:cWirelessCT;0:cWiredCT</td> </tr> <tr> <td style="text-align: left;">bctAdjust</td> <td style="text-align: left;">string</td> <td>Sensor adjustment enable;0:disable;1:enable</td> </tr> <tr> <td style="text-align: left;">bagingTestStep</td> <td style="text-align: left;">string</td> <td>battery self-test;0: default;1: charge2: discharge</td> </tr> <tr> <td style="text-align: left;">vnormal</td> <td style="text-align: left;">string</td> <td>Nominal PV voltage; 0.1V</td> </tr> <tr> <td style="text-align: left;">mppt</td> <td style="text-align: left;">string</td> <td>MPPT voltage</td> </tr> <tr> <td style="text-align: left;">batTempLowerLimitD</td> <td style="text-align: left;">string</td> <td>Battery discharge temperature lower limit; 0.1℃</td> </tr> <tr> <td style="text-align: left;">batTempUpperLimitD</td> <td style="text-align: left;">string</td> <td>Battery discharge temperature upper limit; 0.1℃</td> </tr> <tr> <td style="text-align: left;">batTempLowerLimitC</td> <td style="text-align: left;">string</td> <td>Battery charging temperature lower limit; 0.1℃</td> </tr> <tr> <td style="text-align: left;">batTempUpperLimitC</td> <td style="text-align: left;">string</td> <td>Battery charging temperature upper limit; 0.1℃</td> </tr> <tr> <td style="text-align: left;">vbatWarning</td> <td style="text-align: left;">string</td> <td>Battery voltage low voltage alarm point; 0.1V</td> </tr> <tr> <td style="text-align: left;">vbatWarnClr</td> <td style="text-align: left;">string</td> <td>Battery voltage low voltage recovery point; 0.1V</td> </tr> <tr> <td style="text-align: left;">modbusVersion</td> <td style="text-align: left;">string</td> <td>modbus version</td> </tr> <tr> <td style="text-align: left;">manufacturer</td> <td style="text-align: left;">string</td> <td>Manufacturer code 34-41</td> </tr> <tr> <td style="text-align: left;">bdc1Sn</td> <td style="text-align: left;">string</td> <td>BDC1 serial number</td> </tr> <tr> <td style="text-align: left;">bdc1Model</td> <td style="text-align: left;">string</td> <td>BDC1Model</td> </tr> <tr> <td style="text-align: left;">bdc1Version</td> <td style="text-align: left;">string</td> <td>BDC1 version</td> </tr> <tr> <td style="text-align: left;">vbatStopForDischarge</td> <td style="text-align: left;">string</td> <td>Battery discharge stop voltage; 0.01V</td> </tr> <tr> <td style="text-align: left;">vbatStopForCharge</td> <td style="text-align: left;">string</td> <td>Battery charge stop voltage; 0.01V</td> </tr> <tr> <td style="text-align: left;">vbatStartForDischarge</td> <td style="text-align: left;">string</td> <td>Battery discharge lower limit voltage;0.01V</td> </tr> <tr> <td style="text-align: left;">modelText</td> <td style="text-align: left;">string</td> <td>model</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</td> </tr> </tbody> </table> <p><strong>Remark</strong> </p> <ul> <li>The acquisition frequency is once every 5 minutes</li> </ul>

页面列表

ITEM_HTML