Of note:
- The responses are pretty similar between websocket requests and HTTP requests
- The
result_codeis 1 for success, varying other values for different types of errors - The
result_msgis a usually "success", but contains more detail for certain errors. In at least one observed error response, the key was missing entirely.
The requests in the Web UI often have other parameters, including the token included. But if they are omitted below, it's because they were not found to be necessary.
❯ curl http://$INVERTER_IP/i18n/en_US.properties
I18N_COMMON_SENIOR_SET_TEN_ENABLE=10 Min Over Vtg En.
I18N_COMMON_AB_VOLTAGE=A-B Line Voltage
I18N_CONFIG_KEY_796=AFCI Self Inspection Failure
I18N_COMMON_A_PHARE_POWER=Phase A Active Power
I18N_COMMON_BC_VOLTAGE=B-C Line Voltage
I18N_CONFIG_KEY_854=Bin Document CRC Checkout Error
I18N_COMMON_B_PHARE_POWER=Phase B Active Power
I18N_COMMON_CA_VOLTAGE=C-A Line Voltage
I18N_COMMON_C_PHARE_POWER=Phase C Active Power
...❯ curl http://$INVERTER_IP/about/list
{
"result_code": 1,
"result_msg": "success",
"result_data": {
"list": [{
"data_name": "I18N_COMMON_DEVICE_SN",
"data_value": "REDACTED",
"data_unit": "",
"type": "1"
}, {
"data_name": "I18N_COMMON_APPLI_SOFT_VERSION",
"data_value": "WINET-SV200.001.00.P012",
"data_unit": "",
"type": "2"
}, {
"data_name": "I18N_COMMON_BUILD_SOFT_VERSION",
"data_value": "WINET-SV200.001.00.B001",
"data_unit": "",
"type": "2"
}, {
"data_name": "I18N_COMMON_VERSION",
"data_value": "M_WiNet-S_V01_V01_A",
"data_unit": "",
"type": "0"
}]
}
}This seems to return the values used in dev_id field for devices from list
❯ curl http://$INVERTER_IP/device/getType
{
"result_code": 1,
"result_msg": "success",
"result_data": {
"count": 5,
"list": [{
"name": "I18N_COMMON_STRING_INVERTER",
"value": 1
}, {
"name": "I18N_COMMON_SOLAR_INVERTER",
"value": 21
}, {
"name": "I18N_COMMON_STORE_INVERTER",
"value": 35
}, {
"name": "I18N_COMMON_AMMETER",
"value": 18
}, {
"name": "I18N_COMMON_CHARGING_PILE",
"value": 46
}]
}
}❯ curl http://$INVERTER_IP/inverter/list -X POST
{
"result_code": 1,
"result_msg": "success",
"result_data": {
"list": [{
"id": 1,
"dev_id": 1,
"dev_code": 3343,
"dev_type": 35,
"dev_procotol": 2,
"inv_type": 0,
"dev_sn": "REDACTED",
"dev_name": "SH5.0RS(COM1-001)",
"dev_model": "SH5.0RS",
"port_name": "COM1",
"phys_addr": "1",
"logc_addr": "1",
"link_status": 1,
"init_status": 1,
"dev_special": "0"
}, {
"id": 2,
"dev_id": 2,
"dev_code": 8424,
"dev_type": 44,
"dev_procotol": 0,
"inv_type": 0,
"dev_sn": "REDACTED",
"dev_name": "SBR128(COM1-200)",
"dev_model": "SBR128",
"port_name": "COM1",
"phys_addr": "200",
"logc_addr": "2",
"link_status": 1,
"init_status": 255,
"dev_special": "0"
}],
"count": 2
}
}See also device listing over websocket.
Weirdly, this needs to be authenticated of all things.
❯ curl http://$INVERTER_IP/time/get?token=$TOKEN
{
"result_code": 1,
"result_msg": "success",
"result_data": {
"time": "2022-08-29 20:14",
"sync_device": "0",
"dispatching_mode": "0",
"ntp_server_jp": "re-ene.kyuden.co.jp",
"curr_timezone": "UTC+10:00",
"source": "7",
"ntp_server": "au.pool.ntp.org",
"ntp_port": "123",
"ntp_interval": "5",
"ntp_timestamp": "2022-08-29 20:12:44",
"tz_reboot_flag": "0",
"data_name": "I18N_COMMON_LONGITUDE",
"data_value": "--",
"data_unit": "",
"data_name": "I18N_COMMON_LATITUDE",
"data_value": "--",
"data_unit": "",
"timezone_gps": "UTC"
}
}❯ curl http://$INVERTER_IP/device/overview?token=fd919fa6-6ff4-46ac-90c5-6d367edc84ad
{
"result_code": 1,
"result_msg": "success",
"result_data": {
"module_info": {
"module_sn": "REDACTED",
"module_ver": "M_WiNet-S_V01_V01_A"
},
"net_info": {
"wifi_conn_sts": 0,
"eth_conn_sts": 1,
"eth2_conn_sts": 0,
"wifi_cmd": 170
},
"remote_info": {
"module_sn": "REDACTED",
"ip": "app.isolarcloud.com"
},
"sys_time": {
"sync_device": 0,
"time": "2022-08-29 20:19",
"timezone": "UTC+10:00"
},
"list": [{
"dev_name": "SH5.0RS(COM1-001)",
"dev_sn": "REDACTED",
"link_status": 1,
"country_code": 6,
"country": "I18N_COMMON_AUSTRALIA",
"company": "AS/NZS 4777.2:2020 Australia A",
"company_code": "13"
}]
}
}Used to generate a Word Doc report, based on the template at /template.docx.
❯ curl http://$INVERTER_IP/device/getInitParam?token=$TOKEN
{
"result_code": 1,
"result_msg": "success",
"result_data": {
"list": [{
"dev_name": "SH5.0RS(COM1-001)",
"dev_sn": "REDACTED",
"list": [{
"param_addr": 31605,
"param_name": "I18N_COMMON_REACTIVE_REGULATION_MODE",
"param_value": "164",
"unit": "",
"value_name": "Q(U)"
}, {
"param_addr": 31700,
"param_name": "I18N_COMMON_Q_U_CURVE",
"param_value": "0",
"unit": "",
"value_name": "I18N_COMMON_A_CURVE"
}, {
"param_addr": 31712,
"param_name": "QU_EnableMode",
"param_value": "170",
"unit": "",
"value_name": "I18N_COMMON_YES"
}, {
"param_addr": 32578,
"param_name": "I18N_10RT_RNNN_1527766",
"param_value": "162",
"unit": "",
"value_name": "I18N_COMMON_MAXIMUM_POWER"
}, {
"param_addr": 30092,
"param_name": "I18N_COMMON_FAULT_RECOVERY_TIME",
"param_value": "60",
"unit": "s",
"value_name": ""
}, {
"param_addr": 31400,
"param_name": "I18N_COMMON_FREQUENCY_DROP_STATUS",
"param_value": "170",
"unit": "",
"value_name": "I18N_COMMON_ENABLE"
}, {
"param_addr": 31404,
"param_name": "F1",
"param_value": "50.25",
"unit": "Hz",
"value_name": ""
}, {
"param_addr": 31405,
"param_name": "F2",
"param_value": "50.75",
"unit": "Hz",
"value_name": ""
}, {
"param_addr": 31406,
"param_name": "F3",
"param_value": "52.00",
"unit": "Hz",
"value_name": ""
}, {
"param_addr": 31409,
"param_name": "P1",
"param_value": "200.0",
"unit": "%",
"value_name": ""
}, {
"param_addr": 31410,
"param_name": "P2",
"param_value": "100.0",
"unit": "%",
"value_name": ""
}, {
"param_addr": 31411,
"param_name": "P3",
"param_value": "0.0",
"unit": "%",
"value_name": ""
}, {
"param_addr": 31412,
"param_name": "I18N_COMMON_OVER_FREQUENCY_DROP_RECOVERY_POINT",
"param_value": "50.15",
"unit": "Hz",
"value_name": ""
}, {
"param_addr": 31413,
"param_name": "I18N_COMMON_OVER_FREQUENCY_DROP_CURVE",
"param_value": "1",
"unit": "",
"value_name": "I18N_COMMON_B_CURVE"
}, {
"param_addr": 31414,
"param_name": "I18N_COMMON_OVER_FREQUENCY_DROP_ACTIVE_RATE",
"param_value": "6000",
"unit": "%/min",
"value_name": ""
}, {
"param_addr": 31415,
"param_name": "I18N_COMMON_OVER_FREQUENCY_DROP_WAIT_RESTORE_TIME",
"param_value": "20.0",
"unit": "s",
"value_name": ""
}, {
"param_addr": 31416,
"param_name": "I18N_COMMON_OVER_FREQUENCY_DROP_ACTIVE_RESTORE_RATE",
"param_value": "16",
"unit": "%/min",
"value_name": ""
}, {
"param_addr": 31417,
"param_name": "I18N_COMMON_OVER_FREQUENCY_DROP_RESPONSE_TIME",
"param_value": "0.00",
"unit": "s",
"value_name": ""
}, {
"param_addr": 31420,
"param_name": "I18N_COMMON_FRE_INCREMENT",
"param_value": "170",
"unit": "",
"value_name": "I18N_COMMON_ENABLE"
}, {
"param_addr": 31421,
"param_name": "F1",
"param_value": "49.75",
"unit": "Hz",
"value_name": ""
}, {
"param_addr": 31422,
"param_name": "F2",
"param_value": "49.00",
"unit": "Hz",
"value_name": ""
}, {
"param_addr": 31423,
"param_name": "F3",
"param_value": "48.00",
"unit": "Hz",
"value_name": ""
}, {
"param_addr": 31427,
"param_name": "P1",
"param_value": "0.0",
"unit": "%",
"value_name": ""
}, {
"param_addr": 31428,
"param_name": "P2",
"param_value": "100.0",
"unit": "%",
"value_name": ""
}, {
"param_addr": 31429,
"param_name": "P3",
"param_value": "200.0",
"unit": "%",
"value_name": ""
}, {
"param_addr": 31433,
"param_name": "I18N_COMMON_UNDER_FREQUENCY_UP_RESTORE_POINT",
"param_value": "49.85",
"unit": "Hz",
"value_name": ""
}, {
"param_addr": 31434,
"param_name": "I18N_COMMON_UNDER_FREQUENCY_UP_CURVE",
"param_value": "1",
"unit": "",
"value_name": "I18N_COMMON_B_CURVE"
}, {
"param_addr": 31435,
"param_name": "I18N_COMMON_UNDER_FREQUENCY_UP_ACTIVE_RATE",
"param_value": "6000",
"unit": "%/min",
"value_name": ""
}, {
"param_addr": 31436,
"param_name": "I18N_COMMON_UNDER_FREQUENCY_UP_WAIT_RESTORE_TIME",
"param_value": "20.0",
"unit": "s",
"value_name": ""
}, {
"param_addr": 31437,
"param_name": "I18N_COMMON_UNDER_FREQUENCY_UP_ACTIVE_RESTORE_RATE",
"param_value": "16",
"unit": "%/min",
"value_name": ""
}, {
"param_addr": 31438,
"param_name": "I18N_COMMON_UNDER_FREQUENCY_UP_RESPONSE_TIME",
"param_value": "0.00",
"unit": "s",
"value_name": ""
}, {
"param_addr": 31196,
"param_name": "I18N_COMMON_FAULT_ACTIVE_SLOWDOWN",
"param_value": "170",
"unit": "",
"value_name": "I18N_COMMON_ENABLE"
}, {
"param_addr": 31197,
"param_name": "I18N_COMMON_FAULT_ACTIVE_SLOWDOWN_TIME",
"param_value": "360",
"unit": "s",
"value_name": ""
}, {
"param_addr": 31200,
"param_name": "I18N_COMMON_ACTIVE_SPEED_CONTROL",
"param_value": "170",
"unit": "",
"value_name": "I18N_COMMON_ENABLE"
}, {
"param_addr": 31201,
"param_name": "I18N_COMMON_ACTIVE_REACTIVE_DOWN",
"param_value": "16",
"unit": "%/min",
"value_name": ""
}, {
"param_addr": 31202,
"param_name": "I18N_COMMON_ACTIVE_REACTIVE_UP",
"param_value": "16",
"unit": "%/min",
"value_name": ""
}, {
"param_addr": 31230,
"param_name": "I18N_COMMON_GRID_VOLTAGE_ACTIVE_ADJUST",
"param_value": "170",
"unit": "",
"value_name": "I18N_COMMON_ENABLE"
}, {
"param_addr": 31231,
"param_name": "OPU_V1",
"param_value": "253.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 31232,
"param_name": "OPU_V2",
"param_value": "260.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 31233,
"param_name": "OPU_V3",
"param_value": "260.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 31234,
"param_name": "OPU_V4",
"param_value": "260.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 31235,
"param_name": "OPU_P1",
"param_value": "100.0",
"unit": "%",
"value_name": ""
}, {
"param_addr": 31236,
"param_name": "OPU_P2",
"param_value": "20.0",
"unit": "%",
"value_name": ""
}, {
"param_addr": 31237,
"param_name": "OPU_P3",
"param_value": "20.0",
"unit": "%",
"value_name": ""
}, {
"param_addr": 31238,
"param_name": "OPU_P4",
"param_value": "20.0",
"unit": "%",
"value_name": ""
}, {
"param_addr": 31239,
"param_name": "I18N_CONFIG_KEY_1002331",
"param_value": "1.0",
"unit": "s",
"value_name": ""
}, {
"param_addr": 33006,
"param_name": "I18N_COMMON_GRID_VOLTAGE_CHARGE_REGULATION",
"param_value": "170",
"unit": "",
"value_name": "I18N_COMMON_ENABLE"
}, {
"param_addr": 33007,
"param_name": "UPU_V1",
"param_value": "215.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 33008,
"param_name": "UPU_V2",
"param_value": "207.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 33009,
"param_name": "UPU_V3",
"param_value": "207.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 33010,
"param_name": "UPU_V4",
"param_value": "207.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 33011,
"param_name": "UPU_P1",
"param_value": "0.0",
"unit": "%",
"value_name": ""
}, {
"param_addr": 33012,
"param_name": "UPU_P2",
"param_value": "80.0",
"unit": "%",
"value_name": ""
}, {
"param_addr": 33013,
"param_name": "UPU_P3",
"param_value": "80.0",
"unit": "%",
"value_name": ""
}, {
"param_addr": 33014,
"param_name": "UPU_P4",
"param_value": "80.0",
"unit": "%",
"value_name": ""
}, {
"param_addr": 33015,
"param_name": "I18N_CONFIG_KEY_1002461",
"param_value": "1.0",
"unit": "s",
"value_name": ""
}, {
"param_addr": 31615,
"param_name": "I18N_COMMON_REACTIVE_RESPONSE",
"param_value": "85",
"unit": "",
"value_name": "I18N_COMMON_CLOSE"
}, {
"param_addr": 31865,
"param_name": "QU_V1(AU)",
"param_value": "207.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 31866,
"param_name": "QU_V2(AU)",
"param_value": "220.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 31867,
"param_name": "QU_V3(AU)",
"param_value": "240.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 31868,
"param_name": "QU_V4(AU)",
"param_value": "258.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 31869,
"param_name": "QU_Q1(AU)",
"param_value": "-44.0",
"unit": "%",
"value_name": ""
}, {
"param_addr": 31870,
"param_name": "QU_Q2(AU)",
"param_value": "0.0",
"unit": "%",
"value_name": ""
}, {
"param_addr": 31871,
"param_name": "QU_Q3(AU)",
"param_value": "0.0",
"unit": "%",
"value_name": ""
}, {
"param_addr": 31872,
"param_name": "QU_Q4(AU)",
"param_value": "60.0",
"unit": "%",
"value_name": ""
}, {
"param_addr": 30295,
"param_name": "I18N_COMMON_SENIOR_SET_TEN",
"param_value": "170",
"unit": "",
"value_name": "I18N_COMMON_ENABLE"
}, {
"param_addr": 30296,
"param_name": "I18N_CONFIG_KEY_1001984",
"param_value": "258.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 30297,
"param_name": "I18N_COMMON_10_V_REVERT",
"param_value": "256.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 30800,
"param_name": "I18N_CONFIG_KEY_1001963",
"param_value": "170",
"unit": "",
"value_name": "I18N_COMMON_ENABLE"
}, {
"param_addr": 30801,
"param_name": "I18N_CONFIG_KEY_1001964",
"param_value": "85",
"unit": "",
"value_name": "I18N_COMMON_CLOSE"
}, {
"param_addr": 30799,
"param_name": "I18N_CONFIG_KEY_1001962",
"param_value": "85",
"unit": "",
"value_name": "I18N_COMMON_CLOSE"
}, {
"param_addr": 30798,
"param_name": "I18N_COMMON_LVRT_PROTECTION_SERIES",
"param_value": "2",
"unit": "",
"value_name": "2"
}, {
"param_addr": 30803,
"param_name": "I18N_COMMON_LVRT_VOLTAGE_PH%@1",
"param_value": "180.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 30804,
"param_name": "I18N_COMMON_LVRT_VOLTAGE_PH%@2",
"param_value": "70.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 30813,
"param_name": "I18N_COMMON_LVRT_TIME_PH%@1",
"param_value": "10000",
"unit": "ms",
"value_name": ""
}, {
"param_addr": 30815,
"param_name": "I18N_COMMON_LVRT_TIME_PH%@2",
"param_value": "1000",
"unit": "ms",
"value_name": ""
}, {
"param_addr": 30999,
"param_name": "I18N_CONFIG_KEY_1001971",
"param_value": "170",
"unit": "",
"value_name": "I18N_COMMON_ENABLE"
}, {
"param_addr": 31000,
"param_name": "I18N_CONFIG_KEY_1044",
"param_value": "85",
"unit": "",
"value_name": "I18N_COMMON_CLOSE"
}, {
"param_addr": 30998,
"param_name": "I18N_CONFIG_KEY_1001970",
"param_value": "85",
"unit": "",
"value_name": "I18N_COMMON_CLOSE"
}, {
"param_addr": 30997,
"param_name": "I18N_COMMON_HVRT_PROTECTION_SERIES",
"param_value": "1",
"unit": "",
"value_name": "1"
}, {
"param_addr": 31001,
"param_name": "I18N_COMMON_HVRT_VOLTAGE_PH%@1",
"param_value": "260.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 31012,
"param_name": "I18N_COMMON_HVRT_TIME_PH%@1",
"param_value": "1000",
"unit": "ms",
"value_name": ""
}, {
"param_addr": 32313,
"param_name": "I18N_COMMON_PROTECTION_SERIES",
"param_value": "1",
"unit": "",
"value_name": "2"
}, {
"param_addr": 32322,
"param_name": "I18N_COMMON_UNDER_VOLTAGE_LEVEL_VALUE_PH%@1",
"param_value": "180.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 32323,
"param_name": "I18N_COMMON_OVER_VOLTAGE_LEVEL_VALUE_PH%@1",
"param_value": "260.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 32324,
"param_name": "I18N_COMMON_UNDER_FREQUENCY_LEVEL_VALUE_PH%@1",
"param_value": "47.00",
"unit": "Hz",
"value_name": ""
}, {
"param_addr": 32325,
"param_name": "I18N_COMMON_OVER_FREQUENCY_LEVEL_VALUE_PH%@1",
"param_value": "52.00",
"unit": "Hz",
"value_name": ""
}, {
"param_addr": 32362,
"param_name": "I18N_COMMON_UNDER_VOLTAGE_LEVEL_TIME_PH%@1",
"param_value": "10.50",
"unit": "s",
"value_name": ""
}, {
"param_addr": 32364,
"param_name": "I18N_COMMON_OVER_VOLTAGE_LEVEL_TIME_PH%@1",
"param_value": "1.50",
"unit": "s",
"value_name": ""
}, {
"param_addr": 32366,
"param_name": "I18N_COMMON_UNDER_FREQUENCY_LEVEL_TIME_PH%@1",
"param_value": "1.50",
"unit": "s",
"value_name": ""
}, {
"param_addr": 32368,
"param_name": "I18N_COMMON_OVER_FREQUENCY_LEVEL_TIME_PH%@1",
"param_value": "0.10",
"unit": "s",
"value_name": ""
}, {
"param_addr": 32326,
"param_name": "I18N_COMMON_UNDER_VOLTAGE_LEVEL_VALUE_PH%@2",
"param_value": "180.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 32327,
"param_name": "I18N_COMMON_OVER_VOLTAGE_LEVEL_VALUE_PH%@2",
"param_value": "265.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 32328,
"param_name": "I18N_COMMON_UNDER_FREQUENCY_LEVEL_VALUE_PH%@2",
"param_value": "47.00",
"unit": "Hz",
"value_name": ""
}, {
"param_addr": 32329,
"param_name": "I18N_COMMON_OVER_FREQUENCY_LEVEL_VALUE_PH%@2",
"param_value": "52.00",
"unit": "Hz",
"value_name": ""
}, {
"param_addr": 32370,
"param_name": "I18N_COMMON_UNDER_VOLTAGE_LEVEL_TIME_PH%@2",
"param_value": "1.50",
"unit": "s",
"value_name": ""
}, {
"param_addr": 32372,
"param_name": "I18N_COMMON_OVER_VOLTAGE_LEVEL_TIME_PH%@2",
"param_value": "0.10",
"unit": "s",
"value_name": ""
}, {
"param_addr": 32374,
"param_name": "I18N_COMMON_UNDER_FREQUENCY_LEVEL_TIME_PH%@2",
"param_value": "1.00",
"unit": "s",
"value_name": ""
}, {
"param_addr": 32376,
"param_name": "I18N_COMMON_OVER_FREQUENCY_LEVEL_TIME_PH%@2",
"param_value": "0.10",
"unit": "s",
"value_name": ""
}, {
"param_addr": 32318,
"param_name": "I18N_COMMON_OVERVOLTAGE_PROTECTION_RECOVERY_VALUE",
"param_value": "253.0",
"unit": "V",
"value_name": ""
}, {
"param_addr": 32319,
"param_name": "I18N_COMMON_UNDERVOLTAGE_PROTECTION_RECOVERY_VALUE",
"param_value": "204.9",
"unit": "V",
"value_name": ""
}, {
"param_addr": 32320,
"param_name": "I18N_COMMON_OVERFREQUENCY_PROTECTION_RECOVERY_VALUE",
"param_value": "50.15",
"unit": "Hz",
"value_name": ""
}, {
"param_addr": 32321,
"param_name": "I18N_COMMON_UNDERFREQUENCY_PROTECTION_RECOVERY_VALUE",
"param_value": "47.50",
"unit": "Hz",
"value_name": ""
}, {
"param_addr": 32535,
"param_name": "I18N_COMMON_PARALLEL_CONDITION",
"param_value": "170",
"unit": "",
"value_name": "I18N_COMMON_ENABLE"
}, {
"param_addr": 32536,
"param_name": "I18N_COMMON_PARALLEL_FREQUENCY_LOWER_LIMIT",
"param_value": "47.50",
"unit": "Hz",
"value_name": ""
}, {
"param_addr": 32537,
"param_name": "I18N_COMMON_PARALLEL_FREQUENCY_HIGH_LIMIT",
"param_value": "50.15",
"unit": "Hz",
"value_name": ""
}, {
"param_addr": 32549,
"param_name": "I18N_COMMON_PARALLEL_VOLTAGE_LOWER_LIMIT",
"param_value": "89.1",
"unit": "%",
"value_name": ""
}, {
"param_addr": 32550,
"param_name": "I18N_COMMON_PARALLEL_VOLTAGE_HIGH_LIMIT",
"param_value": "110.0",
"unit": "%",
"value_name": ""
}, {
"param_addr": 32551,
"param_name": "I18N_COMMON_PARALLEL_DETECTION_TIME",
"param_value": "60",
"unit": "s",
"value_name": ""
}, {
"param_addr": 32552,
"param_name": "I18N_COMMON_PARALLEL_ACTIVE_UP_RATE",
"param_value": "16",
"unit": "%",
"value_name": ""
}]
}]
}
}// Request
{"lang":"en_us","token":"","service":"connect"}
// Response, includes token to use
{
"result_code": 1,
"result_msg": "success",
"result_data": {
"service": "connect",
"token": "12345678-9012-4000-0000-abcdef123456",
"uid": 1,
"tips_disable": 1
}
}This is not a WebSocket ping, it's still a WebSocket text message, which the WiNet-S treats as a kind of keep-alive?
// Request
{"lang":"zh_cn","service":"ping","token":"","id":"cf1530ff-71e5-456a-8450-767793ba5781"}
// Response
{
"result_code": 1,
"result_msg": "success"
}Of note:
- the UUID in the
idfield is always random langmust be present, but doesn't have to be zh_cn, even though Web UI uses thattokenis always empty, and the field doesn't have to be included
// Request
{"lang":"en_us","token":"12345678-9012-4000-0000-abcdef123456","service":"login","passwd":"pw8888","username":"admin"}
// Response
{
"result_code": 1,
"result_msg": "success",
"result_data": {
"service": "login",
"token": "c3173fe1-380d-4406-ad54-84d77125b93a",
"passwd": "pw8888",
"uid": 3,
"role": 0,
"tips_disable": 1
}
}// Request
{"lang":"en_us","token":"c3173fe1-380d-4406-ad54-84d77125b93a","service":"logout"}
// Response
{
"result_code": 1,
"result_msg": "success",
"result_data": {
"service": "logout"
}
}// Request
{"lang":"en_us","token":"12345678-9012-4000-0000-abcdef123456","service":"state"}
// Response
{
"result_code": 1,
"result_msg": "success",
"result_data": {
"service": "state",
"total_fault": "0",
"total_alarm": "0",
"wireless_conn_sts": "0",
"wifi_conn_sts": "0",
"eth_conn_sts": "1",
"eth2_conn_sts": "0",
"wireless_cmd": "170",
"wifi_cmd": "170",
"cloud_conn_sts": "1",
"server_net_type": "0"
}
}// Request
{"lang":"en_us","token":"12345678-9012-4000-0000-abcdef123456","service":"statistics"}
// Response
{
"result_code": 1,
"result_msg": "success",
"result_data": {
"service": "statistics",
"list": [{
"today_energy": "--",
"today_energy_unit": "kWh",
"total_energy": "--",
"total_energy_unit": "kWh",
"curr_power": "0.67",
"curr_power_unit": "kW",
"curr_reactive": "0.00",
"curr_reactive_unit": "kvar",
"rated_power": "5.00",
"rated_power_unit": "kW",
"rated_reactive": "3.00",
"rated_reactive_unit": "kvar",
"adjust_power_uplimit": "5.00",
"adjust_power_uplimit_unit": "kW",
"adjust_reactive_uplimit": "3.00",
"adjust_reactive_uplimit_unit": "kvar",
"adjust_reactive_lowlimit": "-3.00",
"adjust_reactive_lowlimit_unit": "kvar"
}, {
"online_num": "2",
"online_num_unit": "",
"offline_num": "0",
"offline_num_unit": ""
}],
"count": 2
}
}// Request
{"lang":"en_us","token":"12345678-9012-4000-0000-abcdef123456","service":"runtime"}
// Response
{
"result_code": 1,
"result_msg": "success",
"result_data": {
"service": "runtime",
"count": 1,
"list": [{
"dev_name": "SH5.0RS(COM1-001)",
"dev_model": "SH5.0RS",
"dev_type": 35,
"dev_procotol": 2,
"today_energy": "--",
"today_energy_unit": "kWh",
"total_energy": "--",
"total_energy_unit": "kWh",
"dev_state": "33280",
"dev_state_unit": "",
"curr_power": "0.67",
"curr_power_unit": "kW",
"reactive_power": "0.00",
"reactive_power_unit": "kvar"
}],
"connect_count": 1,
"off_count": 0
}
}Unclear what type and is_check_token are for.
Response body looks pretty similar to the HTTP request. The actual devices have the same keys and values, except for the
empty list array when requesting over the WS.
// Request
{"lang":"en_us","token":"12345678-9012-4000-0000-abcdef123456","service":"devicelist","type":"0","is_check_token":"0"}
// Response
{
"result_code": 1,
"result_msg": "success",
"result_data": {
"service": "devicelist",
"list": [{
"id": 1,
"dev_id": 1,
"dev_code": 3343,
"dev_type": 35, // This appears to correspond to the `getType` HTTP request
"dev_procotol": 2,
"inv_type": 0,
"dev_sn": "REDACTED",
"dev_name": "SH5.0RS(COM1-001)",
"dev_model": "SH5.0RS",
"port_name": "COM1",
"phys_addr": "1", // This corresponds to the Modbus slave/unit ID
"logc_addr": "1",
"link_status": 1,
"init_status": 1,
"dev_special": "0",
"list": []
}, {
"id": 2,
"dev_id": 2,
"dev_code": 8424,
"dev_type": 44,
"dev_procotol": 0,
"inv_type": 0,
"dev_sn": "REDACTED",
"dev_name": "SBR128(COM1-200)",
"dev_model": "SBR128",
"port_name": "COM1",
"phys_addr": "200",
"logc_addr": "2",
"link_status": 1,
"init_status": 255,
"dev_special": "0",
"list": []
}],
"count": 2
}
}Of note:
time123456is not static; likely just unix timestamp, but unclear if necessary
// Request
{"lang":"en_us","token":"12345678-9012-4000-0000-abcdef123456","dev_id":"1","service":"real","time123456":1661762597181}
// Response
{
"result_code": 1,
"result_msg": "success",
"result_data": {
"service": "real",
"list": [{
"data_name": "I18N_COMMON_TOTAL_GRID_RUNNING_TIME",
"data_value": "--",
"data_unit": "h"
}, {
"data_name": "I18N_COMMON_PV_DAYILY_ENERGY_GENERATION",
"data_value": "7.5",
"data_unit": "kWh"
}, {
"data_name": "I18N_COMMON_PV_TOTAL_ENERGY_GENERATION",
"data_value": "1473.5",
"data_unit": "kWh"
}, {
"data_name": "I18N_COMMON_DAILY_POWER_YIELD",
"data_value": "--",
"data_unit": "kWh"
}, {
"data_name": "I18N_COMMON_TOTAL_YIELD",
"data_value": "--",
"data_unit": "kWh"
}, {
"data_name": "I18N_COMMON_RUNNING_STATE",
"data_value": "I18N_COMMON_DISPATCH_RUN",
"data_unit": ""
}, {
"data_name": "I18N_COMMON_BUS_VOLTAGE",
"data_value": "379.6",
"data_unit": "V"
}, {
"data_name": "I18N_COMMON_AIR_TEM_INSIDE_MACHINE",
"data_value": "25.8",
"data_unit": "�"
}, {
"data_name": "I18N_COMMON_SQUARE_ARRAY_INSULATION_IMPEDANCE",
"data_value": "1107",
"data_unit": "kΩ"
}, {
"data_name": "I18N_CONFIG_KEY_1001188",
"data_value": "100.0",
"data_unit": "%"
}, {
"data_name": "I18N_COMMON_FEED_NETWORK_TOTAL_ACTIVE_POWER",
"data_value": "0.00",
"data_unit": "kW"
}, {
"data_name": "I18N_CONFIG_KEY_4060",
"data_value": "0.00",
"data_unit": "kW"
}, {
"data_name": "I18N_COMMON_DAILY_FEED_NETWORK_VOLUME",
"data_value": "--",
"data_unit": "kWh"
}, {
"data_name": "I18N_COMMON_TOTAL_FEED_NETWORK_VOLUME",
"data_value": "141.1",
"data_unit": "kWh"
}, {
"data_name": "I18N_COMMON_ENERGY_GET_FROM_GRID_DAILY",
"data_value": "--",
"data_unit": "kWh"
}, {
"data_name": "I18N_COMMON_TOTAL_ELECTRIC_GRID_GET_POWER",
"data_value": "283.2",
"data_unit": "kWh"
}, {
"data_name": "I18N_COMMON_DAILY_FEED_NETWORK_PV",
"data_value": "0.0",
"data_unit": "kWh"
}, {
"data_name": "I18N_COMMON_TOTAL_FEED_NETWORK_PV",
"data_value": "129.3",
"data_unit": "kWh"
}, {
"data_name": "I18N_COMMON_LOAD_TOTAL_ACTIVE_POWER",
"data_value": "0.682",
"data_unit": "kW"
}, {
"data_name": "I18N_COMMON_DAILY_DIRECT_CONSUMPTION_ELECTRICITY_PV",
"data_value": "3.8",
"data_unit": "kWh"
}, {
"data_name": "I18N_COMMON_TOTAL_DIRECT_POWER_CONSUMPTION_PV",
"data_value": "523.8",
"data_unit": "kWh"
}, {
"data_name": "I18N_COMMON_TOTAL_DCPOWER",
"data_value": "0.00",
"data_unit": "kW"
}, {
"data_name": "I18N_COMMON_TOTAL_ACTIVE_POWER",
"data_value": "0.68",
"data_unit": "kW"
}, {
"data_name": "I18N_COMMON_TOTAL_REACTIVE_POWER",
"data_value": "0.00",
"data_unit": "kvar"
}, {
"data_name": "I18N_COMMON_TOTAL_APPARENT_POWER",
"data_value": "0.68",
"data_unit": "kVA"
}, {
"data_name": "I18N_COMMON_TOTAL_POWER_FACTOR",
"data_value": "1.000",
"data_unit": ""
}, {
"data_name": "I18N_COMMON_GRID_FREQUENCY",
"data_value": "49.99",
"data_unit": "Hz"
}, {
"data_name": "I18N_COMMONUA",
"data_value": "239.1",
"data_unit": "V"
}, {
"data_name": "I18N_COMMON_FRAGMENT_RUN_TYPE1",
"data_value": "3.2",
"data_unit": "A"
}, {
"data_name": "I18N_COMMON_PHASE_A_BACKUP_CURRENT_QFKYGING",
"data_value": "3.5",
"data_unit": "A"
}, {
"data_name": "I18N_COMMON_PHASE_B_BACKUP_CURRENT_ODXCTVMS",
"data_value": "0.0",
"data_unit": "A"
}, {
"data_name": "I18N_COMMON_PHASE_C_BACKUP_CURRENT_PBSQLZIX",
"data_value": "0.0",
"data_unit": "A"
}, {
"data_name": "I18N_COMMON_PHASE_A_BACKUP_POWER_BRBJDGVB",
"data_value": "0.666",
"data_unit": "kW"
}, {
"data_name": "I18N_COMMON_PHASE_B_BACKUP_POWER_OCDHLMZB",
"data_value": "0.000",
"data_unit": "kW"
}, {
"data_name": "I18N_COMMON_PHASE_C_BACKUP_POWER_HAMBBGNL",
"data_value": "0.000",
"data_unit": "kW"
}, {
"data_name": "I18N_COMMON_TOTAL_BACKUP_POWER_WLECIVPM",
"data_value": "0.666",
"data_unit": "kW"
}],
"count": 36
}
}- I did not always have a separate battery device listed, until Sungrow upgraded the battery firmware remotely. There is a
real_batteryservice below which uses the inverter device ID.
// Request
// Same as inverter realtime values, but with `dev_id` of battery
{"lang":"en_us","token":"12345678-9012-4000-0000-abcdef123456","dev_id":"2","service":"real","time123456":1661762897571}
// Response
{
"result_code": 1,
"result_msg": "success",
"result_data": {
"service": "real",
"list": [{
"data_name": "I18N_COMMON_BATTERY_VOLTAGE",
"data_value": "264.3",
"data_unit": "V"
}, {
"data_name": "I18N_COMMON_BATTERY_CURRENT",
"data_value": "2.6",
"data_unit": "A"
}, {
"data_name": "I18N_COMMON_BATTERY_TEMPERATURE",
"data_value": "16.5",
"data_unit": "�"
}, {
"data_name": "I18N_COMMON_REMAIN_BATTERY_POWER",
"data_value": "90.1",
"data_unit": "%"
}, {
"data_name": "I18N_COMMON_BATTARY_HEALTH",
"data_value": "100",
"data_unit": "%"
}, {
"data_name": "I18N_COMMON_TOTAL_BATTERY_CHARGE",
"data_value": "575.9",
"data_unit": "kWh"
}, {
"data_name": "I18N_COMMON_TOTAL_BATTERY_DISCHARGE_BMS",
"data_value": "534.9",
"data_unit": "kWh"
}, {
"data_name": "I18N_COMMON_BATTERY_OPERATION_STATUS",
"data_value": "I18N_COMMON_STATUS_RUN",
"data_unit": ""
}],
"count": 8
}
}time123456is not static; likely just unix timestamp, but unclear if necessary
// Request
{"lang":"en_us","token":"12345678-9012-4000-0000-abcdef123456","dev_id":"1","service": "real_battery","time123456":1661762736979}
// Response
{
"result_code": 1,
"result_msg": "success",
"result_data": {
"service": "real_battery",
"list": [{
"data_name": "I18N_CONFIG_KEY_3907",
"data_value": "0.000",
"data_unit": "kW"
}, {
"data_name": "I18N_CONFIG_KEY_3921",
"data_value": "1.068",
"data_unit": "kW"
}, {
"data_name": "I18N_COMMON_BATTERY_VOLTAGE",
"data_value": "261.3",
"data_unit": "V"
}, {
"data_name": "I18N_COMMON_BATTERY_CURRENT",
"data_value": "4.0",
"data_unit": "A"
}, {
"data_name": "I18N_COMMON_BATTERY_TEMPERATURE",
"data_value": "16.4",
"data_unit": "�"
}, {
"data_name": "I18N_COMMON_BATTERY_SOC",
"data_value": "79.5",
"data_unit": "%"
}, {
"data_name": "I18N_COMMON_BATTARY_HEALTH",
"data_value": "100.0",
"data_unit": "%"
}, {
"data_name": "I18N_COMMON_MAX_CHARGE_CURRENT_BMS",
"data_value": "30",
"data_unit": "A"
}, {
"data_name": "I18N_COMMON_MAX_DISCHARGE_CURRENT_BMS",
"data_value": "30",
"data_unit": "A"
}, {
"data_name": "I18N_COMMON_DAILY_BATTERY_CHARGE_PV",
"data_value": "3.7",
"data_unit": "kWh"
}, {
"data_name": "I18N_COMMON_TOTAL_BATTERY_CHARGE_PV",
"data_value": "820.4",
"data_unit": "kWh"
}, {
"data_name": "I18N_COMMON_DAILY_BATTERY_DISCHARGE",
"data_value": "7.9",
"data_unit": "kWh"
}, {
"data_name": "I18N_COMMON_TOTAL_BATTRY_DISCHARGE",
"data_value": "511.5",
"data_unit": "kWh"
}, {
"data_name": "I18N_COMMON_DAILY_BATTERY_CHARGE",
"data_value": "6.9",
"data_unit": "kWh"
}, {
"data_name": "I18N_COMMON_TOTAL_BATTERY_CHARGE",
"data_value": "574.5",
"data_unit": "kWh"
}],
"count": 15
}
}