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

URL: http://[ip]:[porta]/zeroconf/info

Formato del valore restituito: json

Metodo: post HTTP

 { 
    "deviceid": "1000000001", 
    "data": {} 
 }

Corpo della risposta

 { 
    "seq": 2, 
    "error": 0,
    "data": {
        "switch": "off",
        "startup": "off",
        "pulse": "off",
        "pulseWidth": 500,
        "ssid": "eWeLink",
        "otaUnlock": false,
        "fwVersion": "3.5.0",
        "deviceid": "100000140e",
        "bssid": "ec:17:2f:3d:15:e",
        "signalStrength": -25
    }
}

URL: http://[ip]:[porta]/zeroconf/switch

Formato del valore restituito: json

Metodo: post HTTP

 { 
    "deviceid": "1000000001", 
    "data": {
        "switch": "on"
    } 
 }

URL: http://[ip]:[porta]/zeroconf/dimmable

Formato del valore restituito: json

Metodo: post HTTP

 {
//Change the light to cool & warm type
 "deviceid": "1000xxxxxx",
 "data":{
 "ltype": "white",
 "white": {"br": 70, "ct": 100}
 }
}
//Change the light to RGBCW type
{
 "deviceid": "1000xxxxxx",
 "data":{
 "ltype": "color",
 "color": {"br": 100, "r": 255, "g": 0, "b": 0}
 }
}
//Bright
{
 "deviceid": "1000xxxxxx",
 "data":{
 "ltype":"bright",
 "bright":{"r":255,"g":255,"b":255,"br":100} 
 }
}
//Sleep
{
 "deviceid": "1000xxxxxx",
 "data":{
 "ltype": "goodNight",
 "goodNight": {"r":255,"g":250,"b":125,"br":25}
 }
}
//Read
{
 "deviceid": "1000xxxxxx",
 "data":{
 "ltype":"read",
 "read":{"r":255,"g":255,"b":255,"br":60}
 }
}
//Night
{
 "deviceid": "1000xxxxxx",
 "data":{
 "ltype":"nightLight",
 "nightLight":{"r":255,"g":240,"b":225,"br":5}
 }
}
// The following Scene can be modified options in the app
//Party
{
 "deviceid": "1000xxxxxx",
 "data":{
 "ltype":"party",
 "party":{"r":254,"g":132,"b":0,"br":45,"tf":1,"sp":1}
 }
}
//Relax
{
 "deviceid": "1000xxxxxx",
 "data":{
 "ltype":"leisure",
 "leisure":{"r":0,"g":40,"b":254,"br":55,"tf":1,"sp":1}
 }
}
//Soft
{
 "deviceid": "1000xxxxxx",
 "data":{
 "ltype":"soft",
 "soft":{"r":38,"g":254,"b":0,"br":20,"tf":1,"sp":1}
 }
}
//Vivid
{
 "deviceid": "1000xxxxxx",
 "data":{
 "ltype":"colorful",
 "colorful":{"r":255,"g":0,"b":0,"br":100,"tf":1,"sp":1}
 }
}

URL: http://[ip]:[porta]/zeroconf/wifi

Formato del valore restituito: json

Metodo: post HTTP

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

URL: http://[ip]:[porta]/zeroconf/signal_strength

Formato del valore restituito: json

Metodo: post HTTP

 { 
    "deviceid": "1000000001", 
    "data": {} 
 }

Corpo della risposta

 { 
    "seq": 2, 
    "error": 0, 
    "data": { 
        "signalStrength": -67 
    }
}

URL: http://[ip]:[porta]/zeroconf/ota_unlock

Formato del valore restituito: json

Metodo: post HTTP

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

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

– 500: l'operazione non è riuscita e il dispositivo presenta degli errori. Ad esempio, l'ID dispositivo o l'errore della chiave API non sono autenticati dal servizio di sblocco OTA del fornitore;

– 503: L'operazione non è riuscita e il dispositivo non è in grado di richiedere il servizio di sblocco OTA del produttore. Ad esempio, il dispositivo non è connesso al Wi-Fi, non è connesso a Internet, il servizio di sblocco OTA del produttore non è disponibile, ecc.

URL: http://[ip]:[porta]/zeroconf/ota_flash

Formato del valore restituito: json

Metodo: post HTTP

 { 
    "deviceid": "", 
    "data": {
        "downloadUrl": "http://192.168.1.184/ota/new_rom.bin", 
        "sha256sum": "3213b2c34cecbb3bb817030c7f025396b658634c0cf9c4435fc0b52ec9644667"
    } 
}

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

– 403: L'operazione non è riuscita e la funzione OTA non è stata sbloccata. Per prima cosa è necessario chiamare correttamente l'interfaccia "3.2.6 Sblocco funzione OTA".

– 408: Operazione non riuscita e timeout del firmware pre-download. È possibile provare a richiamare questa interfaccia dopo aver ottimizzato l'ambiente di rete o aumentato la velocità di rete.

– 413: L'operazione non è riuscita e la dimensione del corpo della richiesta è troppo grande. La dimensione del nuovo firmware OTA supera il limite di dimensione del firmware consentito dal dispositivo.

– 424: Operazione non riuscita e il firmware non può essere scaricato. L'indirizzo URL non è raggiungibile (indirizzo IP non raggiungibile, protocollo HTTP non raggiungibile, firmware inesistente, server non supporta l'intestazione di richiesta Range, ecc.)

– 471: Operazione non riuscita e controllo di integrità del firmware non riuscito. Il checksum SHA256 del nuovo firmware scaricato non corrisponde al valore del campo sha256sum del corpo della richiesta. Il riavvio del dispositivo causerà un problema di bricking.

Nota:

• La dimensione massima del firmware è 508 KB.

• La modalità di lettura flash SPI deve essere DOUT.