Schema ThermostatEco

Nest Thermostat 

sdm.devices.traits.ThermostatEco

Questa caratteristica appartiene ai tipi di dispositivi THERMOSTAT che supportano le modalità ECO.

Campi

Campo Descrizione Tipo di dati
availableModes Elenco delle modalità Eco supportate. array(string)
Value: ["MANUAL_ECO", "OFF"]
mode La modalità Eco attuale del termostato. string
Values: "MANUAL_ECO", "OFF"
heatCelsius La temperatura più bassa in gradi Celsius alla quale il termostato inizia a riscaldare in modalità Eco. number
Example: 20.0
coolCelsius La temperatura più alta in gradi Celsius alla quale il termostato inizia a raffreddare in modalità Eco. number
Example: 22.0

Esempio di richiesta GET e risposta

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

Modifica la modalità Eco del termostato.

Per modificare la modalità del termostato in HEAT, COOL o HEATCOOL, utilizza il comando SetMode della caratteristica ThermostatMode.

Questo comando influisce su altre caratteristiche, in base allo stato attuale o alle modifiche della modalità Eco:

  • Se la modalità Eco è OFF, la modalità del termostato verrà impostata per impostazione predefinita sull'ultima modalità standard (HEAT, COOL, HEATCOOL o OFF) attiva.
  • Se la modalità Eco è MANUAL_ECO:

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 in cui modificare il termostato. string
Values: "MANUAL_ECO", "OFF"

Errori

Per questa caratteristica potrebbero essere restituiti i seguenti codici di errore:

Messaggio di errore RPC Risoluzione dei problemi
Il comando non è consentito nella modalità del termostato corrente. FAILED_PRECONDITION Alcuni modelli di termostato non supportano la modifica della modalità Eco quando la modalità del termostato è OFF, in base alla caratteristica ThermostatMode. La modalità del termostato deve essere modificata in HEAT, COOL o HEATCOOL prima di modificare la modalità Eco.
Il comando non è consentito quando il termostato è in modalità MANUAL_ECO. FAILED_PRECONDITION Il set-point di temperatura non può essere impostato quando il termostato è in modalità Eco manuale.

Per l'elenco completo dei codici di errore dell'API, consulta il riferimento ai codici di errore dell'API.