API HTTP principale SPM

Il tipo di dispositivo è diy_meter(type=diy_meter) e la versione dell'interfaccia API del dispositivo è 1 (apivers=1).

Quando lo stato del sottodispositivo cambia, il TXT DNS deve contenere il campo "id", che è l'[chip id] del sottodispositivo. Il sottodispositivo trasmette solo il campo modificato. Se lo switch del sottodispositivo cambia, viene segnalato solo il campo switches e il campo threshold overload_00 non viene segnalato.

In questo esempio vengono aggiunti spazi e interruzioni di riga per facilitarne la lettura, ma in realtà non ci sono né interruzioni di riga né spazi.

 //All fields broadcast by sub-device
{
	"switches": [
    {
        "outlet":0,
        "switch":"on"
    },
    {
        "outlet":1,
        "switch":"on"
    },
    {
        "outlet":2,
        "switch":"on"
    },
    {
        "outlet":3,
        "switch":"on"
    }
],

//_00 represents the value of channel 1, _01 represents the value of channel 2, and so on
"current_00":100,
"voltage_00":22000,
"actPow_00":22000,
"reactPow_00":22000,
"apparentPow_00":22000,
  
"overload_00": 
{
    "minAP": {
        "en": 0,
        "val": 110000
    },
    "maxAP": {
        "en": 1,
        "val": 10000
    },
    "minV": {
        "en": 1,
        "val": 1000
    },
    "maxV": {
        "en": 0,
        "val": 22000
    },
    "maxC": {
        "en": 1,
        "val": 2000
    },
    "delayTime": 10
},
"overload_01":{},
"overload_02":{},
"overload_03":{},
"faultState": {
    "subDevCom": 0,
    "overloadTrig": [
        {
            "outlet": 0,
            "rsn": [1]
        },
        {
            "outlet": 2,
            "rsn": [3]
        }
    ],
    "cse7761Com": [
        1,
        0,
        1,
        1
    ],
    "overTemp": [
        0
    ],
    "overLimit": [
        {
            "outlet": 1,
            "rsn": [0]
        },
        {
            "outlet": 3,
            "rsn": [1]
        }
    ]
}
}

//If the switch status of the sub-device changes, only the switches field is reported.
{
"switches": [
    {
        "outlet":0,
        "switch":"on"
    },
    {
        "outlet":1,
        "switch":"on"
    },
    {
        "outlet":2,
        "switch":"on"
    },
    {
        "outlet":3,
        "switch":"on"
    }
]
}

//Report the PVC status of channel 1 in real time
{
"current_00":100,
"voltage_00":22000,
"actPow_00":22000,
"reactPow_00":22000,
"apparentPow_00":22000,
}


//Sub-device failure

{
"faultState": {
    "subDevCom": 0,
    "overloadTrig": [
        {
            "outlet": 0,
            "rsn": [1]
        },
        {
            "outlet": 2,
            "rsn": [3]
        }
    ],
    "cse7761Com": [
        1,
        0,
        1,
        1
    ],
    "overTemp": [
      	1,
        0,
      	1,
      	0
    ],
    "overLimit": [
        {
            "outlet": 1,
            "rsn": [0]
        },
        {
            "outlet": 3,
            "rsn": [1]
        }
    ]
}
}

URL: http://[ip]:[porta]/zeroconf/deviceid
Formato del valore restituito: json
Metodo: post HTTP

 { 
     "data": {} 
 }

Oggetto vuoto, non è richiesto alcun attributo.

Corpo della risposta

 {
"seq": 2,
"error": 0,
"data": {
"deviceid": "1000012345"
}
}

URL: http://[ip]:[porta]/zeroconf/add_sub_devices
Formato del valore restituito: json
Metodo: post HTTP

 { 
    "deviceid": "100000140e", 
    "data": {} 
 }

Oggetto vuoto, non è richiesto alcun attributo.

Corpo della risposta

 {
  "seq": 2,
  "error": 0,
 }

URL: http://[ip]:[porta]/zeroconf/subDevList
Formato del valore restituito: json
Metodo: post HTTP

 { 
    "deviceid": "100000140e", 
    "data": {} 
 }

Oggetto vuoto, non è richiesto alcun attributo.

Corpo della risposta

 {
  "seq": 2,
  "error": 0,
  "data": {
    "subDevList": [
      {
        "subDevId": "123456",
        "type": 130
      }
    ]
  }
}

URL: http://[ip]:[porta]/zeroconf/switches
Formato del valore restituito: json
Metodo: HTTP post.

 {
  "deviceid": "100000140e",
  "data": {
    "subDevId": "123456",
    "switches": [
      {
        "switch": "on",
        "outlet": 0
      },
      {
        "switch": "on",
        "outlet": 1
      },
      {
        "switch": "on",
        "outlet": 2
      },
      {
        "switch": "on",
        "outlet": 3
      }
    ]
  }
}

URL: http://[ip]:[porta]/zeroconf/overload
Formato del valore restituito: json
Metodo: post HTTP

Corpo della richiesta

 {
    "deviceid": "100000140e",
    "data": {
        "subDevId": "123456",
        "overload_00": 
        {
            "minAP": {
                "en": 0,
                "val": 110000
            },
            "maxAP": {
                "en": 1,
                "val": 10000
            },
            "minV": {
                "en": 1,
                "val": 9000
            },
            "maxV": {
                "en": 0,
                "val": 22000
            },
            "maxC": {
                "en": 1,
                "val": 2000
            },
            "delayTime": 10
        },
        "overload_01":{},
        "overload_02":{},
        "overload_03":{}
    },
}

Nota:
-_00 rappresenta il valore del canale 1, _01 rappresenta il valore del canale 2 e così via.
-Quando la potenza, la soglia superiore e la soglia inferiore della tensione sono tutte aperte, la soglia superiore deve essere maggiore della soglia inferiore.

URL: http://[ip]:[porta]/zeroconf/iAmHere
Formato del valore restituito: json
Metodo: post HTTP

 {
  "deviceid": "100000140e",
  "data": {
    "subDevId": "123456"
  }
}

Nota:
-Questa funzione può trovare il sotto-dispositivo designato tramite la spia luminosa.

URL: http://[ip]:[porta]/zeroconf/time
Formato del valore restituito: json
Metodo: post HTTP

 {
    "deviceid":"1000001234",
    "data": {
      "timeZone":8,
      "date":"2020-12-15T06:31:14.115Z"
    }
}

Nota:
- I dati storici dei sottodispositivi avranno effetto solo dopo l'impostazione delle informazioni sul fuso orario e non influiranno sulle statistiche relative a un singolo orario.

URL: http://[ip]:[porta]/zeroconf/historicalData
Formato del valore restituito: json
Metodo: post HTTP

 {
  "deviceid": "100000140e",
  "data": {
    "subDevId": "123456",
    "outlet": 3,
    "dateStart": "2020-07-10 05:30",
    "dateEnd": "2020-07-10 19:10"
  }
}

Risposta

1. Risposta corretta:

Il Content-Type dell'intestazione di risposta è application/octet-stream

Restituisce i dati di un file CSV (Comma-Separated Values). Il file contiene le righe di intestazione e di record normale. L'intestazione del titolo contiene il nome corrispondente del campo del record. Ogni riga di record normale è un record di dati e ogni record è composto da 9 campi, separati da virgole.

I campi nell'ordine da sinistra a destra sono i seguenti:
| Data | ora | Presa | Corrente (A) | Tensione (V) | Potenza reale (W) | Potenza reattiva (W) | Potenza apparente (W) | Consumo energetico 5 minuti (W·s) |

per esempio
Gli utenti interrogano i dati dalle 00:00 alle 00:20 del 10 ottobre 2021.

 Date, time, Outlet, Current(A), Voltage(V),Real power(W), Reactive power(W), 
Apparent power(W), 5 Minutes Power Consumption(W·s)
2021-10-10 , 0:0:0 , 0 , 0.00, 240.94, 0.56, 0.00, 0.55,172.00
2021-10-10 , 0:5:0 , 0 , 0.00, 241.41, 0.60, 0.00, 0.59,172.00
2021-10-10 , 0:10:0 , 0 , 0.00, 241.13, 0.51, 0.00, 0.55,173.00
2021-10-10 , 0:15:0 , 0 , 0.00, 240.94, 0.58, 0.00, 0.56,173.00
2021-10-10 , 0:20:0 , 0 , 0.00, 240.95, 0.57, 0.00, 0.57,173.00

2. Risposta di errore:
   Fare riferimento alla parte generale .

Nota:
-Questa funzione verrà rilasciata dopo la versione firmware 1.1.0.
-Supporta i dati delle query fino a 1 giorno.
Ad esempio, quando dateStart è "2020-07-10 05: 30", dateEnd può essere compilato al massimo come "2020-07-11 00: 00".

URL: http://[ip]:[porta]/zeroconf/monitor
Formato del valore restituito: json
Metodo: post HTTP

 {
    "deviceid": "100000140e",
    "data": {
        "url": "http://www.123.com",
        "port": 7790,
        "subDevId": "123456",
        "outlet": 3,
        "time":180
    }
}

Nota:
-L'URL supporta solo connessioni non crittografate e il formato del report dei dati di monitoraggio è http post request.

Rapporto sul dispositivo:

 {
  "subDevId": 123456,
  "outlet": 3,
  "current": 100,
  "voltage": 22000,
  "actPow": 22000,
  "reactPow": 22000,
  "apparentPow": 22000
}

Condizioni di segnalazione:
-La variazione di corrente supera 0,03 A.
-La variazione di tensione supera i 5 V.
- La variazione della potenza attiva, della potenza reattiva o della potenza apparente supera i 2 W.

URL: http://[ip]:[porta]/zeroconf/wifi
Formato del valore restituito: json
Metodo: post HTTP

 {
  "deviceid": "100000140e",
  "data": {
    "ssid": "eWeLink",
    "password": "WeLoveIoT"
  }
}

Nota:
-La nuova impostazione Wi-Fi avrà effetto la prossima volta che ti connetterai al Wi-Fi.

URL: http://[ip]:[porta]/zeroconf/upgrade
Formato del valore restituito: json
Metodo: post HTTP

 {
  "deviceid": "1000xxxxxx",
  "data": {
    "binList": [
      {
        "downloadUrl": "http://52.83.223.225:8088/ota/rom/hNLhVpovUgFJcipxmDD8fQv9b2BdJNgT/user1.1024.new.2.bin",
        "digest": "56a013b0f2ea151fb337a24025a5abb2f4390d4617c5ec57b27a79c86d6c4174",
        "name": "user1.bin"
      },
      {
        "downloadUrl": "http://52.83.223.225:8088/ota/rom/hNLhVpovUgFJcipxmDD8fQv9b2BdJNgT/user2.1024.new.2.bin",
        "digest": "62503540c241b4783bdc46026d86035b9d0775e2d48c59e40227be8067cadac6",
        "name": "user2.bin"
      }
    ]
  }
}

I seguenti codici di errore vengono aggiunti al campo di errore del corpo della risposta:

1. 404 Non trovato (download fallito).
2. 409 Verifica del firmware fallita.

URL: http://[ip]:[porta]/zeroconf/record
Formato del valore restituito: json
Metodo: post HTTP

 {
  "deviceid": "100000140e",
  "data": {
    "subDevId": "123456",
    "rangeStart": 200,
    "rangeEnd": 229
  }
}

Corpo della risposta

 {
    "seq": 2,
    "error": 0,
    "data": {
        "record": [
            {
                "date": "2020-07-29 18:00:05",
                "trigType": 1,
                "outlet": 1,
                "action": 1
            },
            {
                "date": "2020-07-29 18:02:05",
                "trigType": 0,
                "outlet": 1,
                "action": 0
            }
        ]
    }
}

Nota:
- Devono essere soddisfatte le condizioni: rangeEnd>=rangeStart e rangeEnd-rangeStart<=29.

URL: http://[ip]:[porta]/zeroconf/getState
Formato del valore restituito: json
Metodo: post HTTP

per esempio

1. Ottieni lo stato del gateway:

 {
    "deviceid":"1000001234",
    "data": {
    }
}

Corpo della risposta

 {
    "seq": 2,
    "error": 0,
    "data": {
        "sledOnline":"on",
        "ssid": "eWeLink",
        "fwVersion": "3.5.0",
        "subChipFwVer": "3.5.0",
        "deviceid": "100000140e",
        "bssid": "xx:xx:xx:xx:xx:xx",
        "signalStrength": -10,
        "wifiConnected": true/false
    }
}

2. Ottieni lo stato del sottodispositivo:

 {
    "deviceid":"1000001234",
    "data": {
        "subDevId": "123456"
    }
}

Corpo della risposta

 {
    "seq": 2,
    "error": 0,
    "data": {
      	"fwVersion": "1.1.1",
        "switches": [
            {
                "outlet":0,
                "switch":"on"
            },
            {
                "outlet":1,
                "switch":"on"
            },
            {
                "outlet":2,
                "switch":"on"
            },
            {
                "outlet":3,
                "switch":"on"
            }
        ],
        "overload_00": 
        {
            "minAP": {
                "en": 0,
                "val": 110000
            },
            "maxAP": {
                "en": 1,
                "val": 10000
            },
            "minV": {
                "en": 1,
                "val": 1000
            },
            "maxV": {
                "en": 0,
                "val": 22000
            },
            "maxC": {
                "en": 1,
                "val": 2000
            },
            "delayTime": 10
        },
        "overload_01":{},
        "overload_02":{},
        "overload_03":{},
        "faultState": {
            "subDevCom": 0,
            "cse7761Com": [
                1,
                0,
                1,
                1
            ]
        },
        "threshold": {
            "actPow":{
                "min":10,
                "max":440000
            },
            "voltage":{
                "min":10,
                "max":440000
            },
            "current":{
                "min":10,
                "max":440000
            }
        }
    }
}

URL: http://[ip]:[porta]/zeroconf/ops_mode
Formato del valore restituito: json
Metodo: post HTTP

 {
    "deviceid":"1000001234",
    "data": {
        "ops_mode": "ewelink"
    }
}

Nota:
“ops_mode”: “ewelink” significa tornare alla modalità ewelink.