New API


Minimum basic information

<p><strong>Brief Description:</strong></p> <ul> <li>Data return format for basic information of min devices and description of some basic information parameters</li> <li><code>Only applicable for: batch retrieval of basic device information.</code></li> </ul> <p><strong>Return Example</strong></p> <pre><code>{     &amp;quot;code&amp;quot;: 0,     &amp;quot;data&amp;quot;: {         &amp;quot;min&amp;quot;: [             {                 &amp;quot;id&amp;quot;: 1627,                 &amp;quot;serialNum&amp;quot;: &amp;quot;AFE494403F&amp;quot;,                 &amp;quot;portName&amp;quot;: &amp;quot;ShinePano - BLE094404C&amp;quot;,                 &amp;quot;dataLogSn&amp;quot;: &amp;quot;BLE094404C&amp;quot;,                 &amp;quot;groupId&amp;quot;: -1,                 &amp;quot;alias&amp;quot;: &amp;quot;AFE494403F&amp;quot;,                 &amp;quot;location&amp;quot;: &amp;quot;&amp;quot;,                 &amp;quot;addr&amp;quot;: 1,                 &amp;quot;fwVersion&amp;quot;: &amp;quot;AK1.0&amp;quot;,                 &amp;quot;model&amp;quot;: 720575940630937650,                 &amp;quot;innerVersion&amp;quot;: &amp;quot;AKAA0501&amp;quot;,                 &amp;quot;lost&amp;quot;: false,                 &amp;quot;status&amp;quot;: 1,                 &amp;quot;tcpServerIp&amp;quot;: &amp;quot;47.119.160.91&amp;quot;,                 &amp;quot;lastUpdateTime&amp;quot;: 1716535759000,                 &amp;quot;sysTime&amp;quot;: &amp;quot;&amp;quot;,                 &amp;quot;deviceType&amp;quot;: 0,                 &amp;quot;communicationVersion&amp;quot;: &amp;quot;ZAAA-0004&amp;quot;,                 &amp;quot;pmax&amp;quot;: 5000,                 &amp;quot;comAddress&amp;quot;: 1,                 &amp;quot;dtc&amp;quot;: 5200,                 &amp;quot;countrySelected&amp;quot;: 0,                 &amp;quot;startTime&amp;quot;: 30,                 &amp;quot;restartTime&amp;quot;: 60,                 &amp;quot;wselectBaudrate&amp;quot;: 0,                 &amp;quot;trakerModel&amp;quot;: 0,                 &amp;quot;priorityChoose&amp;quot;: 0,                 &amp;quot;batteryType&amp;quot;: 0,                 &amp;quot;batSeriesNum&amp;quot;: 0,                 &amp;quot;batParallelNum&amp;quot;: 0,                 &amp;quot;bctMode&amp;quot;: 0,                 &amp;quot;bctAdjust&amp;quot;: 0,                 &amp;quot;bagingTestStep&amp;quot;: 0,                 &amp;quot;vnormal&amp;quot;: 1000.0,                 &amp;quot;mppt&amp;quot;: 513.0,                 &amp;quot;batTempLowerLimitD&amp;quot;: 0.0,                 &amp;quot;batTempUpperLimitD&amp;quot;: 0.0,                 &amp;quot;batTempLowerLimitC&amp;quot;: 0.0,                 &amp;quot;batTempUpperLimitC&amp;quot;: 0.0,                 &amp;quot;vbatWarning&amp;quot;: 0.0,                 &amp;quot;vbatWarnClr&amp;quot;: 0.0,                 &amp;quot;modbusVersion&amp;quot;: 305,                 &amp;quot;manufacturer&amp;quot;: &amp;quot;   PV Inverter  &amp;quot;,                 &amp;quot;bdc1Sn&amp;quot;:&amp;quot;����������������&amp;quot;,                 &amp;quot;bdc1Model&amp;quot;: &amp;quot;0&amp;quot;,                 &amp;quot;bdc1Version&amp;quot;:&amp;quot;����-0&amp;quot;,                 &amp;quot;vbatStopForDischarge&amp;quot;: 0.0,                 &amp;quot;vbatStopForCharge&amp;quot;: 0.0,                 &amp;quot;vbatStartForDischarge&amp;quot;: 0.0,                 &amp;quot;userName&amp;quot;: null,                 &amp;quot;modelText&amp;quot;: &amp;quot;S0AB00D00T00P0FU00M0032&amp;quot;,                 &amp;quot;plantId&amp;quot;: 0,                 &amp;quot;plantname&amp;quot;: null,                 &amp;quot;timezone&amp;quot;: 8.0,                 &amp;quot;pCharge&amp;quot;: 0.0,                 &amp;quot;pDischarge&amp;quot;: 0.0,                 &amp;quot;updating&amp;quot;: false,                 &amp;quot;record&amp;quot;: null,                 &amp;quot;power&amp;quot;: 0.0,                 &amp;quot;eToday&amp;quot;: 0.0,                 &amp;quot;eTotal&amp;quot;: 0.0,                 &amp;quot;tlxSetbean&amp;quot;: null,                 &amp;quot;powerMax&amp;quot;: null,                 &amp;quot;powerMaxTime&amp;quot;: null,                 &amp;quot;energyDayMap&amp;quot;: {},                 &amp;quot;energyMonth&amp;quot;: 0.0,                 &amp;quot;optimezerList&amp;quot;: null,                 &amp;quot;strNum&amp;quot;: -1,                 &amp;quot;liBatteryManufacturers&amp;quot;: &amp;quot;&amp;quot;,                 &amp;quot;liBatteryFwVersion&amp;quot;: &amp;quot;&amp;quot;,                 &amp;quot;bmsSoftwareVersion&amp;quot;: &amp;quot;&amp;quot;,                 &amp;quot;bmsCommunicationType&amp;quot;: 0,                 &amp;quot;monitorVersion&amp;quot;: &amp;quot;null&amp;quot;,                 &amp;quot;bdcMode&amp;quot;: 0,                 &amp;quot;bdcAuthversion&amp;quot;: 0,                 &amp;quot;hwVersion&amp;quot;: &amp;quot;null&amp;quot;,                 &amp;quot;vppOpen&amp;quot;: 0,                 &amp;quot;level&amp;quot;: 4,                 &amp;quot;lastUpdateTimeText&amp;quot;: &amp;quot;2024-05-24 15:29:19&amp;quot;,                 &amp;quot;children&amp;quot;: null,                 &amp;quot;treeName&amp;quot;: &amp;quot;AFE494403F&amp;quot;,                 &amp;quot;treeID&amp;quot;: &amp;quot;ST_AFE494403F&amp;quot;,                 &amp;quot;parentID&amp;quot;: &amp;quot;LIST_BLE094404C_22&amp;quot;,                 &amp;quot;imgPath&amp;quot;: &amp;quot;./css/img/status_gray.gif&amp;quot;,                 &amp;quot;statusText&amp;quot;: &amp;quot;tlx.status.checking&amp;quot;,                 &amp;quot;powerMaxText&amp;quot;: &amp;quot;&amp;quot;,                 &amp;quot;energyMonthText&amp;quot;: &amp;quot;0&amp;quot;             }         ]     },     &amp;quot;message&amp;quot;: &amp;quot;SUCCESSFUL_OPERATION&amp;quot; }</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>Device SN</td> </tr> <tr> <td style="text-align: left;">lost</td> <td style="text-align: left;">string</td> <td>Device online status (0: Online, 1: Offline)</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">int</td> <td>Device status (0: Waiting mode, 1: Self-check mode, 3: Fault 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>Data logger serial number</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;">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 generated power</del> (Deprecated)</td> </tr> <tr> <td style="text-align: left;"><del>eTotal</del></td> <td style="text-align: left;">string</td> <td><del>Total generated power</del> (Deprecated)</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>Communication 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 selection</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>Number of battery series</td> </tr> <tr> <td style="text-align: left;">batParallelNum</td> <td style="text-align: left;">string</td> <td>Number of battery parallels</td> </tr> <tr> <td style="text-align: left;">bctMode</td> <td style="text-align: left;">string</td> <td>Sensor type; 2: METER, 1: Wireless CT, 0: Wired CT</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: Charge, 2: Discharge</td> </tr> <tr> <td style="text-align: left;">vnormal</td> <td style="text-align: left;">string</td> <td>Rated 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 lower temperature limit; 0.1℃</td> </tr> <tr> <td style="text-align: left;">batTempUpperLimitD</td> <td style="text-align: left;">string</td> <td>Battery discharge upper temperature limit; 0.1℃</td> </tr> <tr> <td style="text-align: left;">batTempLowerLimitC</td> <td style="text-align: left;">string</td> <td>Battery charge lower temperature limit; 0.1℃</td> </tr> <tr> <td style="text-align: left;">batTempUpperLimitC</td> <td style="text-align: left;">string</td> <td>Battery charge upper temperature limit; 0.1℃</td> </tr> <tr> <td style="text-align: left;">vbatWarning</td> <td style="text-align: left;">string</td> <td>Battery low voltage warning point; 0.1V</td> </tr> <tr> <td style="text-align: left;">vbatWarnClr</td> <td style="text-align: left;">string</td> <td>Battery 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>BDC1 model</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> </tbody> </table> <p><strong>Notes</strong></p> <ul> <li>Retrieval frequency is once every 5 minutes or less</li> </ul>

页面列表

ITEM_HTML