Schema di ThermostatTemperatureSetpoint

Termostato Nest 

sdm.devices.traits.ThermostatTemperatureSetpoint

Questa caratteristica appartiene ai tipi di dispositivi THERMOSTAT che supportano l'impostazione della temperatura ottimale e dell'intervallo di temperatura.

Campi

Campo Descrizione Tipo di dati
heatCelsius Temperatura ottimale in gradi Celsius per le modalità HEAT e HEATCOOL del termostato. number
Esempio: 20.0
coolCelsius Temperatura ottimale in gradi Celsius per le modalità COOL e HEATCOOL del termostato. number
Esempio: 22.0

Esempio di richiesta GET e risposta - 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 GET e risposta - 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

Prima di modificare i punti di riferimento della temperatura, il termostato deve essere nella modalità corrispondente al comando chiamato. Il comando e i campi per modificare i set-point variano in base alla modalità del termostato.

Ad esempio, per eseguire il SetHeat comando, il termostato deve essere prima in modalità HEAT:

Modalità Comando Campo/i
HEAT SetHeat heatCelsius
COOL SetCool coolCelsius
HEATCOOL SetRange heatCelsius, coolCelsius

Tieni presente che i comandi del setpoint accettano solo gradi Celsius come parametro, anche se il termostato Google Nest può visualizzare la temperatura in gradi Celsius o Fahrenheit.

.

SetHeat

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

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à HEAT. number
Esempio: 22.0

SetCool

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

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à COOL. number
Esempio: 20.0

SetRange

Imposta le temperature minima e 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 massima da impostare quando il termostato è in modalità HEATCOOL. number
Esempio: 22.0

Errori

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

Messaggio di errore RPC Risoluzione dei problemi
Comando non consentito nella modalità 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. Prima di modificare la modalità Eco, è necessario impostare la modalità del termostato su HEAT, COOL o HEATCOOL.
Il valore di raffreddamento deve essere maggiore del valore di riscaldamento. 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 punto di riferimento della 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.