Schema setpoint temperatura termostato

Termostato Nest 

sdm.devices.traits.ThermostatTemperatureSetpoint

Questo tratto appartiene ai tipi di dispositivi TERMOSTATO che supportano l'impostazione della temperatura ottimale e dell'intervallo di temperatura.

Campi

Campo Descrizione Tipo di dati
heatCelsius Temperatura ottimale in Celsius per le modalità HEAT e HEATCOOL del termostato. number
Esempio: 20,0
coolCelsius Temperatura ottimale in Celsius per le modalità COOL e HEATCOOL del termostato. number
Esempio: 22,0

Esempio di richiesta e risposta GET - HEAT

Richiesta

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

Risposta

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
    }
  }
}

Esempio di richiesta e risposta GET - COOL

Richiesta

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

Risposta

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "coolCelsius" : 22.0
    }
  }
}

Esempio di richiesta e risposta GET - HEATCOOL

Richiesta

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

Risposta

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    }
  }
}

Comandi

Il termostato deve trovarsi nella modalità corrispondente al comando che viene chiamato prima di modificare i set-point di temperatura. Il comando e i campi per modificare i set-point variano a seconda della modalità del termostato.

Ad esempio, per inviare il comando SetHeat, il termostato deve essere prima in modalità Caldo:

Modalità Comando Campo/i
RISCALDAMENTO SetHeat heatCelsius
FREDDO SetCool coolCelsius
RISCALDAMENTO SetRange heatCelsius, coolCelsius

Tieni presente che i comandi del set-point utilizzano solo i gradi Celsius come parametro, anche se Google Nest Thermostat può visualizzare la temperatura in gradi Celsius o Fahrenheit.

SetHeat

Imposta la temperatura ottimale quando il termostato è in modalità Caldo.

Richiesta e risposta SetHeat

Richiesta

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetHeat",
  "params" : {
    "heatCelsius" : 22.0
  }
}

Risposta

{}

Campi di richiesta SetHeat

Campo Descrizione Tipo di dati
heatCelsius La temperatura ottimale da impostare quando il termostato è in modalità Caldo. number
Esempio: 22,0

SetCool

Imposta la temperatura ottimale quando il termostato è in modalità FREDDO.

Richiesta e risposta SetCool

Richiesta

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetCool",
  "params" : {
    "coolCelsius" : 20.0
  }
}

Risposta

{}

Campi di richiesta SetCool

Campo Descrizione Tipo di dati
coolCelsius La temperatura ottimale da impostare quando il termostato è in modalità FREDDO. number
Esempio: 20,0

SetRange

Imposta la temperatura minima e la temperatura massima quando il termostato è in modalità HEATCOOL.

Richiesta e risposta SetRange

Richiesta

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetRange",
  "params" : {
    "heatCelsius" : 20.0,
    "coolCelsius" : 22.0
  }
}

Risposta

{}

Campi di richiesta SetRange

Campo Descrizione Tipo di dati
heatCelsius La temperatura ottimale minima da impostare quando il termostato è in modalità HEATCOOL. number
Esempio: 20,0
coolCelsius La temperatura ottimale da impostare quando il termostato è in modalità Caldo. number
Esempio: 22,0

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.
Il valore del raffreddamento deve essere maggiore del valore del calore. INVALID_ARGUMENT Assicurati che il campo heatCelsius sia inferiore al campo coolCelsius nel comando.
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.