Schema ThermostatEco

Termostato Nest 

sdm.devices.traits.ThermostatEco

Questo tratto appartiene ai tipi di dispositivi TERMOSTATO che supportano le modalità ECO.

Campi

Campo	Descrizione	Tipo di dati
availableModes	Elenco delle modalità Eco supportate.	array(string) Valore: ["MANUAL_ECO", "OFF"]
mode	La modalità Eco attuale del termostato.	string Valori: "MANUAL_ECO", "OFF"
heatCelsius	Temperatura minima in Celsius a cui il termostato avvia il riscaldamento in modalità Eco.	number Esempio: 20,0
coolCelsius	Temperatura massima in Celsius a cui il termostato avvia il raffreddamento in modalità Eco.	number Esempio: 22,0

Esempio di richiesta e risposta GET

Richiesta

GET /enterprises/project-id/devices/device-id

Risposta

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatEco" : {
      "availableModes" : ["MANUAL_ECO", "OFF"],
      "mode" : "MANUAL_ECO",
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    }
  }
}

Comandi

SetMode

Cambia la modalità Eco del termostato.

Per cambiare la modalità del termostato in Caldo, RAFFREDDAMENTO o RISCALDAMENTO, usa il comando SetMode del tratto ThermostatMode.

Questo comando influisce su altri tratti, in base allo stato attuale della modalità Eco o alle sue modifiche:

• Se la modalità Eco è disattivata, il termostato passerà all'ultima modalità standard (RISCALDAMENTO, RAFFREDDAMENTO, RISCALDAMENTO o Spento) che era attiva.
• Se la modalità Eco è MANUAL_ECO:
• I comandi per il trait ThermostatTemperatureSetpoint sono rifiutati.
• I set-point di temperatura non vengono restituiti dal trait ThermostatTemperatureSetpoint .

Alcuni modelli di termostato non supportano la modifica della modalità Eco quando la modalità del termostato è OFF, in base al trait ThermostatMode . Prima di cambiare la modalità Eco, la modalità del termostato deve essere impostata su Caldo, RAFFREDDAMENTO o RISCALDAMENTO.

Richiesta e risposta SetMode

Richiesta

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatEco.SetMode",
  "params" : {
    "mode" : "MANUAL_ECO"
  }
}

Risposta

{}

Campi di richiesta SetMode

Campo	Descrizione	Tipo di dati
mode	La modalità Eco su cui impostare il termostato.	string Valori: "MANUAL_ECO", "OFF"

Errori

In relazione a questa caratteristica, potrebbero essere restituiti i seguenti codici di errore:

Messaggio di errore	RPC	Risolvere i problemi
Comando non consentito nell'attuale modalità termostato.	FAILED_PRECONDITION	Alcuni modelli di termostato non supportano la modifica della modalità Eco quando la modalità del termostato è disattivata, a seconda del trait ThermostatMode . Prima di cambiare la modalità Eco, è necessario impostare la modalità del termostato in Caldo, Freddo o Caldo.
Comando non consentito quando il termostato è in modalità MANUAL_ECO.	FAILED_PRECONDITION	Il set-point della temperatura non può essere impostato quando il termostato è in modalità Eco manuale.

Consulta la pagina Riferimento sui codici di errore delle API per l'elenco completo dei codici di errore delle API.